问题标签 [dita]
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.
xml - 使用 XSLT 拆分 DITA (CALS) 表 - 身份转换
我有一个基于 Framemaker 错误的主要问题,我试图为此构建一个解决方法。在一个文档中,我们有很多表,我必须按列拆分。这些表在元素中包含一个属性,可以用来识别它们。所以这就是我需要的:
输入:
输出:
我快要放弃了,因为到目前为止我所尝试的一切都没有成功:(
xml - 如何在 Web 输出中为目录指定 navtitle 但不在 pdf 输出中?
鉴于 Web 输出的目录区域相当狭窄,我想假设 Web 的导航标题较小,但继续在 PDF 输出中呈现较长的主题标题。
以下标记似乎根本不起作用(有或没有audience
属性):
添加locktitle="yes"
地图似乎也没有任何区别:
以下适用于网络,但不幸的是在 PDF 目录中也显示了短标题:
我尝试使用以下内容分别针对 Web 和 PDF,但这会导致在转换过程中发生错误,说明我试图引用处理上下文之外的主题。这适用于 Web,但在检查 PDF 输出时,会使用“file:/”协议而不是 PDF 文件中的交叉引用来链接到“.dita”文件。
注意:我使用的是 XML Mind 的Ditac处理器
xslt - 如何从使用 XSL-FO 生成的 PDF 书签中去除 Unicode 软连字符
我正在使用 DITA Open Toolkit 1.7 和 RenderX XEP 将 DITA 映射转换为 PDF。在 DITA 主题中,产品名称是使用 conrefs 插入的。我的一个产品名称很长。在表格中使用时会导致布局问题。因此,我在通过 conref 重用的短语中插入了一个软连字符:
这在生成的页面中效果很好,但在书签中会产生一个问题,其中一个符号代替软连字符显示。
显然,这是一个编码问题。似乎 UTF-8 字符在 PDF 内容中得到了正确处理,但在 PDF 书签中却没有,根据以下来源,可以使用一些 PDF-16 字符(但我不明白哪些字符)。
- http://partners.adobe.com/public/developer/en/pdf/PDFReference.pdf
- http://www.setasign.de/support/tips-and-tricks/use-unicode-in-string-values/
DITA Open Toolkit 似乎使用以下代码片段从主题标题创建书签:
XSL 样式表有 2.0 版。
我想创建一个删除违规字符的覆盖。我怎样才能做到这一点?
- 是否可以正确解决编码问题?(可能不可能)。
- 除了空格、制表符、换行符和回车符之外,是否有任何 XSL 函数或属性可以删除空格?
- 或者我需要对软连字符进行特殊处理吗?
dita - 在 DITA 中使用 prodname 元数据?
DITA 元数据中 prodinfo 元素内的元数据元素的预期用途是什么?
每个 prodinfo(可以是多个)只有一个 prodname,然后在里面可以有组件、品牌、系列等。
prodinfo 本身似乎旨在表明它对特定产品的适用性,并且您可以有多个表明它适用于多种产品。
但是在 prodinfo 中,您有组件、品牌、系列等,在我看来,这似乎是通用元数据 - 即表示该主题适用于更广泛主题的元数据。但如果它在特定的 prodinfo 元素内,则没有任何意义。例如,如果我将 component 解释为表明主题涉及产品的特定组件,例如引擎,那么它可能被用来找到可以重用于多个不同产品的主题,所有这些都以类似的方式描述引擎组件。
例子:
在这种情况下,我认为组件元数据不应附加到特定产品。那么这些部分打算如何在 DITA 元数据中使用呢?
dita - DITA OT 中的主题编号更简单?
如何在 DITA OT 的 PDF 输出中添加主题的章节编号?我的意思是这样编号:
编辑:我意识到我的问题有点不清楚。我的意思是说主题编号(指的是比作为 DITA 元素的部分更通用的部分)。此外,我知道如何在代码中执行此操作,但想知道我是否错过了通过 DITA OT 中的简单配置来执行此操作的更简单方法 - 例如打开或关闭参数或其他东西。这是一个常见的请求,它应该比一直像这样修改样式表更容易:
xml - DITA 中的关键字与数据元数据?
DITA 中有两种“通用”类型的元数据标记,即数据元素和关键字元素。当然还有 othermeta,但显然它应该很快就会被弃用,而且这个名字暗示它无论如何都是最后的手段。
因此,该关键字似乎与 Web 应用程序中的标签非常相似,即通常用于“folksonomies”的标签。但是数据和关键字之间的确切区别是什么,什么时候应该使用哪个?
dita - 如何使用 DITA subjectSchemes?
DITA 中的 subjectScheme 是一种适合创建元数据分类的格式,但它应该如何真正使用呢?具体来说,我的问题涉及以下方面:
- 它可以用于表示元数据元素,还是仅用于表示元数据属性?我只看到它应用于属性,这使得它有点受限,因为据我所知,元素通常用于检索元数据,即不用于过滤的元数据。
- 如果您可以将它用于元素,该值是否仍应位于 subjectdef 的“keys”属性中?
- 如果你想为元数据值添加定义/描述,你会在哪里做呢?
- 您可以/应该发布主题方案吗?我已经看到它暗示它不适合发布,因为它的资源默认属性。但这不是限制吗?如果您使用它来创建分类法,您肯定还想要一种简单的方法来发布它以造福于用户吗?
dita - 如何调试 DITA 转换?
我知道 XSLT 通常是可以调试的,但是考虑到它的模块化 XSLT 结构以及catalog.xml 文件指向样式表这一事实,究竟该如何调试 DITA 转换呢?
我希望能够在运行时单步执行代码,并能够设置断点等。
dita - 在 Mac OS 中运行 DITA OT?
DITA OT 文档有很多关于如何在 Windows 环境中运行 DITA OT 的信息,但对于在 Mac OS 中运行它的信息却很少。在 Mac OS (Mountain Lion) 中运行它的程序是什么?特别是如果您需要设置环境变量(这在 Mac OS 中有点棘手)
xsl-fo - 标题接近编号时的 TOC 格式问题
我遇到过这样一种情况,如果 TOC 标题太接近 TOC 编号,它会将编号向内拉。
在这里,您可以看到几个示例,其中我开始一次添加/删除一个字符,以查看它何时会错误地将编号向内拉动与正确换行到下一行。
这是来自 topic.fo 的两个块。第一个是不拉入 TOC 编号,第二个是拉入编号。
我尝试调整不同的末端缩进,看看我是否可以在没有任何运气的情况下强制它换行。我正在使用 DITA-OT 1.5.4 和 FOP 1.0。