6

如果有人在 Web 浏览器中查看它们，我希望我的 SVN 存储库中的 DocBook 文档看起来不错。我已经开始编写 CSS 样式表，但我认为它会有很大的限制——尤其是关于超链接的限制。

DocBook 站点上有大量 DocBook XSL 样式表，但它们似乎不适合浏览器呈现。我不想生成静态文档并将它们放入 SVN。我希望它们对于其他开发人员来说基本上是可读的，而不会有太多麻烦。

我可以编写自己的适合浏览器的 XSL 样式表来将 DocBook 转换为 HTML，但似乎其他人一定已经这样做了。我只是不知道在哪里可以找到它。

4

6 回答 6

4

在过去的生活中，我使用了所见即所得的文档：http ://www.cs.hs-rm.de/~werntges/proj/wysiwyg-dbk01.html

于 2012-10-22T18:36:39.330 回答
2

您是对的，DocBook XSL 样式表非常繁重，并不真正适合在浏览器中运行。DocBook Wiki列出了一些 CSS 样式表，也许其中一种对您有用？

我唯一有过的经验是XMLMind XML Editor显然用来呈现 DocBook 文档的那个。

于 2009-09-16T19:58:56.550 回答
2

我已经为浏览器端的 DocBook 样式做了一些非常基本且不完整的 XSLT+CSS 实现。你可以在这里查看http://github.com/arsi/db2xhtml

但如果在某处可用，我希望看到更高级的项目！

于 2010-06-18T10:32:50.320 回答
1

[编辑因为我误读了问题]

您当然不希望通过浏览器和 PI 运行样式表，但是对于任何相当复杂的内容，您也不希望这样做。如果您在 Web 服务器上运行或作为批处理任务运行，请在服务器端执行。有什么方法可以在 svn 中插入服务器端进程？

DocBook 是一种复杂的“语言”，即使是捕捉 DocBook 的大部分细节也非常困难。使用 DocBook XSL 一点也不复杂，如果可以的话，我真的建议您朝那个方向发展。样式表是为定制而设计的，Bob Stayton 在DocBook XSL: The Complete Guide中对这些样式表进行了详细记录。

于 2009-09-17T08:33:25.370 回答
1

经过相当多的搜索后，我相信答案是“没有一个很好的用于客户端 DocBook 呈现的 XSL 样式表”，除了像我实现的那样的定制样式表。

于 2009-09-23T01:31:00.007 回答
0

通常，您会为阅读/显示制作“再现”。再现可以是 PDF、单个 HTML 页面或一组 HTML 页面。您很少将 docbook 直接发送到 Web。

  • 我能问一下你想要完成什么，为什么？
  • 这是内部交付还是外部交付？

我讨厌被问到“你的技术能做 X 吗？”的问题。它假定对产品有很多了解（另外，通常答案是“是”，但这并不能回答真正的问题）。当我问“你想要完成什么”时总是最好的，所以我可以告诉你是否有任何技术适合（或者我可以为你指出其他更适合的技术，或更好的方法）。

于 2010-03-08T18:02:54.423 回答