问题标签 [docbook]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
135 浏览

docbook - 链接到 DocBook 中其他文档的标题

我正在使用 DocBook 整理一些文档。几乎所有这些都会以某种方式相互引用,所以我整理了一个参考书目部分(使用<bibliography)。是否有某种方式,例如使用<olink>,来自动提取其他文档的标题?

0 投票
1 回答
3378 浏览

xml - ENTITY 声明可以嵌套在引用的 XML 文件中吗?

我正在处理一个相当大的 DocBook XML 文档。主书有章节,但包括使用实体引用的所有小节。像这样的东西:

main.book.xml

第 3 节又分为三个 xml 文件,其内容通过引用包含在内,如下所示:

section3.xml

问题:有没有办法将仅由第 3 节(即 section3_a、section3_b 等)使用的实体声明移动到section3.xml而不是在 中声明它们main.book.xml

0 投票
1 回答
653 浏览

docbook - Docbook Dblatex - 如何省略章节第一页的标题?

我正在使用 dblatex 将使用 Docbook 格式化的书转换为 PDf,并且一切正常,但是对于我的生活,我无法弄清楚如何禁止在每章的第一页包含标题?当然,我希望该页面根据总页数“计数”,但是我不希望书名或页码出现在第一页上。

有任何想法吗?

谢谢!杰森

0 投票
1 回答
267 浏览

phpdoc - 将 phpdoc 与现有 docbook 相结合

我想将一些 phpdoc 生成的文档包含在我已经存在的 docbook 文档中。

我的想法是让 phpdoc 生成 docbook 格式的文档,然后使用 XInclude 导入它的部分(基于包和子包)。我正在使用 Docbook 5 作为我的文档。有什么办法可以做到这一点?


到目前为止,我尝试的是使用XML:DocBook/peardoc2:defaultphpdoc 参数生成文档手册。

PHPDocumentor 的文档分为几个文件 - 很好,但文件看起来像这样

据我了解,这些是外部实体,但需要在 DTD 中引用它们 - 使它们对我的工作毫无用处,因为 phpdoc 没有生成 DTD,我不想为每个类和方法都包含一个文件用手。

0 投票
1 回答
360 浏览

xml - 在 docbook、fo、pdf 输出中强调文本

我试图强调一些静态文本的字符以呈现到我的 pdf 的页脚中,但无法在我的 xsl 中找出正确的标签组合。我怎样才能做到这一点?

例子:

此示例在 xsltproc 中生成错误。帮助!

0 投票
2 回答
704 浏览

docbook - 需要“e-novative DocBook Environment (eDE)”安装文件

'e-novative DocBook Environment' 是一个简单的 DocBook 工具链,由一家名为 e-novative GmbH 的公司专门为 Win32 平台构建。该公司似乎已经倒闭了。他们的网站 [ http://www.e-novative.de]已经死了,显然他们的 DocBook 环境的安装文件不知何故从互联网上消失了。

我已经搜索和搜索[并搜索了更多],我遇到的每个下载链接最终都指向该公司已死的网站。我不敢相信没有其他软件副本。

如果有人可以向我提供安装文件或将我指向拥有它们的地方,我将永远感激不尽。如此之多,以至于我愿意支付我的第一个出生的孩子。好吧,这不是真的,但我会非常非常感激!

提前谢谢了!

0 投票
4 回答
7123 浏览

python - 实现自定义漂亮打印机的最佳方法

定制pprint.PrettyPrinter

pprint模块的文档提到该方法PrettyPrinter.format旨在使自定义格式成为可能。

我收集到可以在子类中覆盖此方法,但这似乎没有提供一种让基类方法应用换行和缩进的方法。

  • 我在这里错过了什么吗?
  • 有没有更好的方法来做到这一点(例如另一个模块)?

备择方案?

我已经检查了该pretty模块,它看起来很有趣,但似乎没有提供一种方法来自定义其他模块的类格式而不修改这些模块。

我认为我正在寻找的东西可以让我提供类型(或者可能是函数)的映射,这些类型(或者可能是函数)可以识别类型到处理节点的例程。处理节点的例程将获取一个节点并返回它的字符串表示形式,以及一个子节点列表。等等。

为什么我要研究漂亮的印刷品

我的最终目标是紧凑地打印 DocBook-formatted 的自定义格式部分xml.etree.ElementTree

(我很惊讶没有找到对 DocBook 的更多 Python 支持。也许我在那里遗漏了一些东西。)

我在使用lxml的名为xmlearn的客户端中构建了一些基本功能。例如,要转储 Docbook 文件,您可以:

这很糟糕,但它让我得到了我正在寻找的信息。

xmlearn还具有其他功能,例如能够构建图形图像并进行转储以显示 XML 文档中标签之间的关系。这些与这个问题几乎完全无关。

您还可以将转储执行到任意深度,或者将 XPath 指定为一组起点。XPath 的东西有点过时了特定于 docbook 的格式,所以它并没有真正得到很好的开发。

这仍然不是这个问题的真正答案。我仍然希望在某个地方有一台易于定制的漂亮打印机。

0 投票
2 回答
438 浏览

python - 使用包含具有相对路径的其他样式表的远程样式表

我想使用lxml.etree.XSLT.

尽管文档中提到etree.XSLT()了第一个参数xslt_input,但我似乎找不到任何有关此参数含义的文档。向它传递一个可供阅读的文件似乎可行;在字符串中传递一个文件名不会。

编辑经过健全性检查,我意识到etree.XSLT需要一个 parsed 的etree._ElementTree. 所以 。. . 也许有一种方法可以解析元素树,从而为其提供用于映射相对路径的路径?. . . 调查。

如果传递的 XML 文件包含其他文件,则这些包含语句中的相对路径取自当前工作目录。

我想使用这个类来转换一个 DocBook 文档,并且希望能够远程访问 DocBook XSL。Docbook XSL 相当复杂,并且包含许多其他文件。有没有办法让我etree.XSLT从远程位置拉出这些文件?

0 投票
1 回答
712 浏览

python - 对 Docbook 元素树的分支进行 XSL 转换

我想使用 docbook XSL 样式表来呈现文档的各个部分,而无需转换整个内容。

复杂之处在于其中一些部分的<footnoteref>元素的linkend属性不在同一个块中。换句话说,我想处理包含<footnoteref>s 但不<footnote>包含它们引用的元素的树的分支。

我尝试使用 Pythonlxml包执行此操作产生了以下错误消息:

这发生在响应,例如etree.XSLT(etree.parse('docbook.xsl'))(some_element)

我正在使用普通的xhtml样式表。不过,我不希望它对我使用的样式表很重要。

有支持的方法吗?或者,例如,我是否希望在文档上应用 XSLT 转换以在执行此渲染之前将<footnoteref>元素更改为元素?<footnote>但是那样就行不通了,因为这样就会有多个<footnote>标签具有相同的 ID。如果标签未包含在结果树中,则必须仅对转换执行此<footnoteref>操作。我希望这已经发生了。但希望我只是错过了某个地方的开关。<footnote><footnote>

编辑

感谢@Jukka 的回答,我发现我可以传递rootid参数来告诉 XSLT 处理器只呈现该 ID。但是,它非常忠实地执行此操作,生成的输出仅引用具有相同片段的脚注,如果将文档呈现为单个 HTML 页面,这将很有用。例如

也许还有另一个参数会导致脚注显示在同一页面上,最好从 1 开始编号?我想它可能会在这个列表中的某个地方。当我有更多时间时,我会完成它。

0 投票
2 回答
546 浏览

documentation - 针对不同目标受众的 Docbook 出版

我喜欢有一个包含多个目标受众内容的 docbook xml 文档。是否有一个过滤器可以让我过滤掉“高级”用户才需要的东西?

level 属性是我发明的,用来表达我的想法。