问题标签 [dita]

我是一名技术作家，正在使用 DITA 编写通用业务流程标准。我选择使用 DITA 是因为它出色的主题组合、内容引用和条件分析，所有这些都将帮助我控制复杂的、相互关联的文档。

我需要选择要使用的主题类型。

我有三个选择：

1. 我可以专注于我自己的主题类型，以满足我的确切需求
2. 我可以使用主题主题。
3. 我可以使用一个或所有 OASIS 计算机文档主题（概念/任务/参考）。

选项 1 不现实，因为我无权接触 DITA 开发人员。再加上将专业化设计为伪代码也并非易事。

这使得选项 2 和 3 成为现实。

选项 2 让我使用主题 topic。这给了我灵活性，因为它是最宽容的主题类型。它也是最“干净”的，因为我没有使用为其他东西设计的主题类型。然而，主题主题实际上是专业化的基础，不应该直接使用。

选项 3 让我使用计算机文档主题。我可以或多或少地使我的内容适合他们。但是，它们实际上是针对以特定方式编写的“tripane 帮助”类型的内容。例如，这些主题类型通常用于根据约翰卡罗尔的极简主义进行写作，它鼓励用户进行实验并关注用户的任务。我的文件要求要求，我不想在我的写作中鼓励极简主义原则。

选项 2 和 3 都涉及妥协。对于编写流程标准，两者哪个更好？

问题：我想将所有嵌套的无序列表切换为破折号而不是项目符号。

我相信选择这些嵌套列表项的 XPath 表达式是：//ul/li/ul//li

我相信这是修改的适当模板：

它引用 en.xml 中名为“Unordered List Bullet”的变量：

我尝试包装该变量调用以引用另一个变量“Unordered List Dash”（如果它是嵌套的）。我还是有点挂了。什么是最优雅的方法？我应该为这些嵌套项目设置一个额外的模板吗？

我正在使用 DITA-OT 1.5.4。

我们注意到一种情况 (PDF)，其中 TOC 条目中的 reg 标记生成的符号比它在内容中显示的要高一点。

这是一个屏幕截图。顶部是目录，您可以看到注册标记远高于底部示例，即章节标题和内容。

这是使用 DITA-OT 1.7.3 默认 PDF2 插件。

我查看了 topic.fo 并且都使用： <fo:inline line-height="100%" font-family="Helvetica, Arial Unicode MS" baseline-shift="20%" font-size="smaller">®</fo:inline>

但他们每个人都使用不同的包装器。

TOC 使用： <fo:inline end-indent="14pt" keep-together.within-line="auto" line-height-shift-adjustment="disregard-shifts" font-family="Helvetica, Arial Unicode MS">

内容使用： <fo:inline baseline-shift="20%" font-size="75%" line-height-shift-adjustment="disregard-shifts">

我稍微浏览了 TOC 样式，但我没有看到在哪里进行调整。我猜目录需要：baseline-shift="20%" font-size="75%"

这是一个小问题，但是否有任何关于在哪里进行调整以使其保持一致的见解？

想知道有没有人在工作中实现过DITA1.2的subjectscheme maps？如果是，请您分解示例以显示：

• 怎么做？
• 什么时候不使用它？

我知道它背后的理论，但我还没有实施相同的，我想知道在规划和实施阶段是否有一些事情我必须牢记。

我需要使用DITA记录我的项目，我想知道是否可以使用 python 的文档字符串约定并reStructuredText创建 DITA 的 XML。

任何指针？

DITA-OT：1.7.3

问题：我的自定义样式表中的空白章节出现错误：

"fo:block-container" is missing child elements. Required content model: marker* (%block;)+

默认 PDF2 样式呈现良好。

在章节中添加主题会使其消失。该错误仅给了我 topic.fo 的最后一行编号，其列为 0。

这是页面序列（缩进），错误所在的行在 id="d2e394" 之前开始：

这是使用默认 PDF2 样式的等价物：

我的风格完全不同，我很难确定从哪里开始解决这个问题。任何指导表示赞赏。

我有一个 DITA 主题图，其中包含一个定义分类的主题方案图。

我的主题图中的主题已使用分类法中的值进行标记。

如何使用构面呈现我的主题图以允许检索主题，其中构面是主题方案图中的值？

DITA 或 XSL 的新手。我面临着为 API 文档构建文档的挑战。目前，我能够在 C# 程序集和 XML 上使用 Sandcastle 生成 HTML 和 CHM 帮助。我需要在 DITA 中制作它。有什么线索吗？

谢谢

我的最终目标是使用 XSLT 样式表将 HTML 表格转换colspan为 Dita docbook 格式。table

对于不熟悉 DITA 表的人来说，它使用namest和nameend属性来实现colspan；namest和nameend分别是开始和结束列的名称。列名由colspecs元素指定。

我有以下困难：

1）我想colspec自动生成这些元素。

因为我要处理很多表，所以我没有固定数量的列。我正在使用 XSLT 函数进行计数，如下所示：

然后我使用以下内容生成$colNumcolspec 元素，colname并column从 1 递增到$colNum.

当我运行这个样式表时，我得到错误抱怨$colNum不是整数。我尝试$colNum使用多个 xslt 函数将其转换为整数，例如：ceiling(number($colNum))，但 xml 进程坚持$colNum是双精度数！

2) 找到 的起始列的正确位置colspan。

以这张表为例：

对于第 3 行，第 2 td，它实际上是第 4 列！我的 xslt 将无法通过仅研究那一行来判断。我在 sudo 代码中做到了这一点

在这种情况下，这应该给我 3，但我不知道如何解释实际上将 td 1 列向后推的行跨度。

让我知道是否有更好的选择来做到这一点！

我知道这是一个复杂的问题。任何帮助表示赞赏！提前一百万谢谢！

我有以下 XSL 将一堆 XML 文件从一种格式转换为另一种格式。尽管到目前为止我有两个问题尚未解决，但转换工作正常：

1）首先在转换文件时，我需要调整样式表中的参数以仅针对名称超过 7 个字符的文件；

2）其次，我需要能够在保留源文件的文件夹结构的同时转换所有文件。我想知道是否有办法保留与源文件夹相同的文件夹结构。所有文件都位于基于字母命名的文件夹中，例如：A、B、C、D、F .... 所以我需要转换文件夹 A 中的所有文件并将它们放在一个名为 A 的新文件夹中。文件是也按字母顺序命名。

这是我的样式表：

谢谢。