- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我是一名技术作家,使用 DITA 编写通用业务流程标准。我之所以选择使用 DITA,是因为它具有出色的主题组合、内容引用和条件分析功能,所有这些都将帮助我控制复杂的、相互关联的文档。
我需要选择要使用的主题类型。
我有三个选择:
选项 1 不现实,因为我无法接触到 DITA 开发人员。再加上设计特化,即使是伪代码也不是微不足道的。
这使选项 2 和 3 成为现实。
选项 2 让我使用主题 topic。这给了我灵 active ,因为它是最宽容的主题类型。它也是最“干净”的,因为我没有使用为其他东西设计的主题类型。然而,主题 topic 实际上是特化的基础,不应该直接使用。
选项 3 让我使用计算机文档主题。我或多或少可以让我的内容适合他们。但是,它们实际上是为以特定方式编写的“三联帮助”类型的内容而设计的。例如,这些主题类型通常用于根据 John Carroll 的极简主义写作,该极简主义鼓励用户实验并关注用户的任务。我的文件类型有强制要求,我不想在我的写作中鼓励极简主义原则。
选项 2 和 3 都涉及妥协。对于编写流程标准,两者哪个更好?
最佳答案
另一种选择是使用 DITA for Publishers 项目提供的主题类型,这些主题类型旨在模拟典型的非技术文档发布组件:文章、章节、小节、边栏和部分。
出版商项目的 DITA 在 http://dita4publishers.sourceforge.net .
请注意,如果您只需要一个有区别的主题类型标签名称,那么定义新的主题类型非常容易:这完全是一个复制、粘贴和重命名的练习,任何人都可以做到。
http://www.xiruss.org/tutorials/dita-specialization/ 的配置和特化教程引导您完成它,尽管现在看它们我发现主题特化教程实际上比只做一个简单的仅根标记名特化更复杂。
关于dita - 当我不编写计算机文档时,我使用哪种 DITA 主题类型?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/15156444/
如何在 DITA OT 的 PDF 输出中添加主题的章节编号?我的意思是这样编号: 1. Heading Some content 1.2. Heading Some more c
DITA 中的 subjectScheme 是一种适合创建元数据分类的格式,但它究竟应该如何使用呢?具体来说,我的问题涉及以下方面: 它可以用来表示元数据元素,还是仅表示元数据属性?我只看到它应用于属
DITA 中的 subjectScheme 是一种适合创建元数据分类的格式,但它究竟应该如何使用呢?具体来说,我的问题涉及以下方面: 它可以用来表示元数据元素,还是仅表示元数据属性?我只看到它应用于属
是否有可用的工具包(付费或其他方式)来帮助以编程方式将 DITA 文档转换为 FrameMaker 文档? 我正在尝试制作一个可以从 DITA 转换为多种格式的应用程序。我知道我可以使用 DITA O
我是一名技术作家,使用 DITA 编写通用业务流程标准。我之所以选择使用 DITA,是因为它具有出色的主题组合、内容引用和条件分析功能,所有这些都将帮助我控制复杂的、相互关联的文档。 我需要选择要使用
DITA 元数据中 prodinfo 元素内元数据元素的预期用途是什么? 每个prodinfo(可以是多个)只有一个prodname,然后里面可以有组件、品牌、系列等。 prodinfo 本身似乎旨在
请问有没有人在工作中实现过DITA1.2的subjectscheme maps?如果是,能否请您分解示例以显示: 怎么做? 什么时候不使用它? 我知道它背后的理论,但我还没有实现它,我想知道在规划和实
问题:是否存在将非 DITA 内容包含在 DITA 文档中的正确标记?它会是什么? 我正在寻找的功能是一个标签,比如说 这样任何内容,包括 , & ,甚至其他标签,在其中被解释为纯文本,或者可能被解释
我使用 deltaxml 一段时间了,它工作正常。但对于特定的 dita 主题,我在日志中收到以下警告: WARNING: Caught com.deltaxml.dita.FilterProcess
DITA 中有两种“通用”类型的元数据标签,即数据元素和关键字元素。当然还有 othermeta,但显然它应该很快就会被弃用,而且这个名字表明它无论如何都是最后的手段。 因此关键字似乎与 Web 应用
我的 python libxml2 以不同的方式处理具有默认属性的文件,具体取决于我想知道什么。使用 DITA DTD 的示例(该包可以在 www.dita-ot.org 上下载): import l
我需要使用 DITA 记录我的项目我想知道我是否可以使用 python 的文档字符串约定和 reStructuredText 来创建 DITA 的 XML。 有什么建议吗? 最佳答案 很抱歉回答这个问
以下 xml 片段使用 Oxygen XML 编辑器从 Xerces 引擎产生以下错误: Unexpected element "codeblock". The content of the pare
我是 Dita 的新手,所以对于任何无知,我深表歉意。 我正在使用 XJC 将基础(且仅是基础)Dita 1.3 模式编译为 Java 类。当我试图编译所有的 XSD 文件时,我收到了元素和组被重新定
这是我正在使用的场景。将 Eclipse 与 IXIASoft DITA CMS 和 Oxygen XML 编辑器结合使用。检索存储在 DITA CMS 中的文件并在氧气中进行编辑。生成 pdf 输出
我正在开发一个 Web 应用程序,它需要处理来自持久存储(可能是 JCR)的 DITA 文档。 DITA Open Toolkit是我所知道的唯一 DITA 实现,但它要求所有文档都存在于文件系统中。
DITA-OT 是否支持使用 CSS 自定义生成 PDF 输出?我认为它支持使用 Apache FOP 生成 PDF。 我生成 HTML 和 PDF 输出并想使用 CSS。 谢谢... 最佳答案 DI
DITA 或 XSL 新手。我面临着为 API 文档构建文档的挑战。目前,我能够在 C# 程序集和 XML 上使用 SandcaSTLe 生成 HTML 和 CHM 帮助。我需要在 DITA 中生成它
我正在使用DITA Open Toolkit将 XML 内容转换为具有不同的标签名称。但我的 XML 文档之一没有转换... BUILD FAILED C:\DITA-OT\build.xml:55:
所以我有一个 Java 程序,可以从不同的地方获取一些数据并写入 DITA 文件。我还想要一个已为其创建自定义 DITA-OT 插件的 PDF 文件。通常我会在程序执行后运行 Dita-OT,但如果我
我是一名优秀的程序员,十分优秀!