达尔文体系
DITA一般问题
- 为什么“达尔文”以这种架构的名字命名？
- 在哪里可以了解有关面向主题的写作和用户帮助的更多信息？
- DITA与DocBook有何不同？
- 如何对DTD进行更改和控制？
- 我可以在自己的公司中使用此DTD吗？
- DITA是否已集成到任何IBM产品中？
- DITA DTD是否有XML模式？
DITA的主题架构
技巧与技巧
- 如何将多个主题合并到一个文档中？
- 如果我的信息没有分解成主题怎么办？
- 我什么时候应该专攻？
- 我该如何专攻？
- 如何扩展专业化感知转换？
- 我可以在此DTD中使用HTML吗？
- 在哪里可以看到DITA DTD在使用中？
DITA一般问题
问：为什么“达尔文”以这种架构的名字命名？
答：架构的全称具有以下综合说明：
- 达尔文：它采用专业化和继承的原则
- 信息键入：利用主题（概念，任务，参考）和内容（消息，键入的短语，语义表）的语义
- 体系结构：它提供垂直的净空（新应用程序）和边缘扩展（专业化为新类型）以提供信息
此体系结构支持从任何更高级别的DTD或架构正确构造专用DTD。 基本DTD是ditabase DTD，它包含原型主题结构和三个附加的对等主题，这些对等主题是来自基本主题的专业化类型：概念，任务和引用主题。 专业化和继承的原理类似于查尔斯·达尔文提出的物种变异的原理。 因此，这个名称使我们想起了体系结构固有的关键扩展机制。
问：我在哪里可以了解有关面向主题的写作和用户帮助的更多信息？
答：查看下面的主题体系结构FAQ ，然后尝试以下有关信息体系结构的两个介绍性站点：
问：DITA与DocBook有何不同？
答：认识到DocBook和DITA采用根本不同的方法很重要。
DocBook最初是为单一的，连续的技术叙述（其中的叙述可能是文章，书籍或多卷长度）设计的。 通过转换，DocBook可以将此技术叙述分成主题，以提供对网站和其他信息集的支持。 因为DocBook DTD的目标是处理技术文档的所有标准要求，所以使用模型鼓励进行定制以排除非本地要求的元素。 使用模型支持但不鼓励本地扩展，因为未知的新元素有可能破坏工具支持和互操作性。
相比之下，DITA专为离散技术主题而设计。 DITA可能会使用过滤条件将主题收集到信息集中。 DITA核心信息类型并不旨在涵盖所有需求，而是提供了通过扩展满足新需求的基础。 鼓励扩展，但是必须将新元素识别为现有元素的专业化。 通过概括，DITA提供了工具重用和互操作性。
每种方法都有其优势。 DocBook将是技术叙事的可能选择。 对于大型，复杂的主题集合或同时需要可扩展性和互操作性的应用程序，DITA可能是一种选择。 技术交流小组可能希望对这两种软件包进行试验，以确定哪种方法更适合其过程和输出。
问：如何对DTD进行更改和控制？
答：达尔文信息键入体系结构于2001年4月首次引入。此后，用户在IBM内部和DITA论坛上讨论了有关DITA的问题 ，并且发生了各种变化，并在一年后进行了重大更新。 设计将放慢速度，以便感兴趣的用户社区-您！ -可以专注于学习和使用DITA。
使用DITA论坛来讨论DITA DTD和样式表的使用。 自述文档列出了一些已知的限制，但是无疑，当您使用DTD时，还有其他限制在等待发现。 通过DITA论坛中的讨论，将确定重要思想并将其应用于软件包的后续更新。 DITA项目的建筑师Don Day和Michael Priestley等将积极监视该论坛。
问：我可以在自己的公司中使用此DTD吗？
答：是的，我们鼓励您使用它。
问：DITA是否集成到任何IBM产品中？
答：是的。 我们有几个正在使用DITA的项目。 这些项目的目的是继续验证DITA架构，并在产品开发环境中使用DTD。
问：DITA DTD是否有XML模式？
答：是的，DITA工具包提供了体系结构的DTD和XML Schema表示。 DITA的基本概念与实现无关。 模式和DTD均可用于定义可专用的DITA元素。
DITA的主题架构
问：主题是什么？
答：主题是围绕单个主题组织的大量信息。 从结构上讲，它是一个标题，后跟文本和图像，可以有选择地组织成几个部分。 主题可以有多种类型，最常见的是概念，任务和参考。
问：为什么选主题？
答： DITA基于主题，因为它们是最佳大小，可以在不同的交付上下文中重用而不会影响编写者的效率。 如果我们选择较小的单位，那么编写者需要在所有上下文中检查该单位，以确保信息正确流动。 如果我们选择一个较大的单位，则信息将无法轻松地重新组合成不同的交付上下文（例如网站或书籍）所需的结构。 从作者的角度来看，主题足够大，可以自成体系，但主题足够小，可以在特定交付上下文所需的任何更高层次的结构中有效地重用。
问：架构中的主题结构是什么？
答：主题结构是我们为文档体系结构建立的一些条件的结果：
-
<topic>是单个非嵌套主体和任意数量的嵌套主题的容器。 -
<title>提供自我描述，与创作指南一致。 -
<body>是段落级内容和任意数量的非嵌套节的容器。 - 可以通过序言，简短说明和其他可选的元数据来扩充主题。
这些条件导致以下结构：
<!ELEMENT topic (title, titlealts?, shortdesc?, prolog?, body,
related-links?, (%info-types;)*)>请参阅样本主题及其解释， DITA主题的结构 。
样本主题
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="ss/dit2htm.xsl" type="text/xsl"?>
<topic id="sample1">
<title>Title for the topic</title>
<body>
<p>A topic may contain nearly any combination of text elements, including
lists...</p>
<ul>
<li>List item.</li>
<li>List item.</li>
</ul>
<p>definition lists...</p>
<dl>
<dlentry>
<dt>Term</dt>
<dd>definition</dd>
</dlentry>
</dl>
<p>and so on.</p>
</body>
<concept id="minicncpt">
<title>This is a concept in the "include zone"</title>
<conbody>
<p>Roses are red.</p>
</conbody>
</concept>
</topic>问：什么是主题中的“逐步披露”？
答：因为每个主题除了其全部内容外还具有标题和简短描述，所以应用程序可以提供逐步公开的信息。 例如，用户可以将鼠标悬停在链接上以查看其简短描述，然后确定是否要在其余主题下关注该链接。 渐进式披露还允许在各种查看上下文中有意义地浏览主题，无论是全屏浏览器，集成的帮助窗格，信息弹出窗口还是PDA屏幕。 该应用程序可以披露上下文支持的尽可能多的信息，让用户决定在何处以及如何向下钻取更多内容。
问：可以嵌套主题吗？
答：主题可以嵌套以创建更大的文档结构。 但是，嵌套总是发生在内容边界之外，因此可以轻松地将子主题和父主题分开并在不同的上下文中重复使用（请参阅DITA主题的结构 ）。 这是一个示例嵌套结构：
<topic>
<title>A general topic</title>
<shortdesc>This general topic is pretty general.</shortdesc>
<body><p>General topics are not very specific. They are useful for
the big picture, but they don't get into details in the same way as
more specific topics.</p></body>
<topic>
<title>A specific topic</title>
<shortdesc>This is a more specific topic.</shortdesc>
<body><p>Specifically, this is more specific.</p></body>
</topic>
</topic>您可以将主题编写为嵌套结构或单个独立文档。 在后一种情况下，您可以根据需要将文档组装到嵌套结构中，例如在传递具有零件和章节层次结构的打印或可打印信息时。
嵌套结构给出了主题集合中主题的序列和层次结构。 在Web环境中，您可以将此结构分解为单个主题，并将层次结构保留在生成的导航图或目录中。 但是，如果Web是主要的交付工具，则可能需要将主题编写为单独的文档，然后将几个目录应用于相同的主题集合。
问：什么是信息类型？
答：信息类型描述主题的类别，例如概念，任务或参考。 通常，不同的信息类型支持不同种类的内容。 例如，一个任务通常具有一组步骤，而参考主题具有一组惯用部分，例如语法，属性和用法。
问：为什么是信息类型？
答：使用信息类型，您可以将主题划分为多个类别，与没有信息类型时相比，可以更轻松地管理和保持一致。 信息类型还使用户可以更轻松地查找所需的信息：任务中的操作方法信息，概念中的背景信息以及参考主题中的详细规范。
问：什么是专业化？
答：专业化是创建主题或信息类型的新类别以及元素或域类型的新类别的过程。 您可以使用现有类型作为基础来定义这些新类型。 例如，一个产品组可能会确定三种主要的参考主题类型-消息，实用程序和API-并定义三种域-网络，编程和数据库。 通过为每种参考信息创建专门的主题类型，并为每种主题创建域类型，产品设计师可以确保每种主题都具有适当的结构和内容。 此外，由于用户可以进行细粒度的区分，因此专用主题使支持XML的搜索更加有用。 例如，用户可以搜索XYZ仅在信息或仅在API的，以及在跨一般引用主题搜索xyz的 。
规则控制着如何安全地进行专业化：每种新信息类型必须映射到现有信息类型，并且新信息类型在其允许的内容中必须比现有信息类型更具限制性。 通过这种专业化，新的信息类型可以将通用处理流用于翻译，打印和Web发布。 尽管产品组可以覆盖或扩展这些流程，但是默认情况下，它们可以获取全部现有流程，而无需任何额外的工作或维护。 DITA专业化文章概述了每种专业化（主题类型和领域类型）的规则。
技巧与技巧
问：如何将多个主题合并到一个文档中？
答： DITA设计具有统一的内容重用机制，通过该机制，元素可以将其自身替换为当前主题中或共享相同内容模型的单独主题中其他位置相似元素的内容。 包含在文件实体方案中的可重用内容和可重用内容之间的区别消失了：在任何DITA主题中，具有ID的任何元素都可以被conref重用。
DITA的conref“包含”机制类似于SGML conref机制，该机制使用空元素作为对其他位置的完整元素的引用。 但是，DITA要求至少存在用于引用元素的最小内容模型，并在处理过程中执行检查以确保替换元素在其新上下文中有效。 此机制超出了标准XInclude的范围，因为只有当内容等效时才能合并内容：如果重用和重用元素类型之间不匹配，则不会解析conref。 它也超越了标准实体重用，因为它允许重用的内容位于带有DTD的有效XML文件中。 最终结果是，重用的内容在创作时而不是在重用时得到了验证，从而从源头上发现了问题。
内容引用可以在DITA文档中的任何元素范围内使用，从仅包含PCDATA的关键字短语到具有其他嵌套主题的整个主题。 Conref可以使用与xref元素上的href属性相同的语法来跨越文件边界。 如果您的编写DTD允许主题嵌套，则可以创建一组最小的子主题，然后使用它们的conref属性从其他文件中完全填充的主题中提取内容。
问：如果我的信息没有分解成主题怎么办？
答：大多数信息都可以分为主题（标题和内容）。 但是，如果您的信息需要跨主题边界的更无缝的信息流，请不要使用此体系结构。
问：我什么时候应该专攻？
答：当您有一个主题的限制性类别要保持一致并且用户希望与其他类别区分开时，请创建专门的主题。 当您拥有一组希望跨几种主题类型使用的元素时，请创建专门的域。 确保从正确的基础进行专门化：例如，参考主题的类别应专门化<reference>，任务类别应专门化<task>，并且域类型应始终专门化<topic>或其他域类型。 如果您需要允许的内容结构超出基本类型所允许的范围，则可以直接从主题进行专业化处理，或形成自己的基本类型。 但是，您可以专门研究的层次结构越低越好。 然后，您可以利用针对您所针对的更一般类别开发的任何转换或过程。
问：我该如何专攻？
答：您需要确定新信息类型与您要研究的更通用类型之间的区别。 识别出差异之后，您将创建一个DTD文件来声明所需的新元素。 创建另一个模块为新元素声明一组映射属性，这些映射属性指向它们专用的通用元素类型。 然后在DTD文件中添加导入语句以引入映射模块和所有祖先模块。 最后，添加一行以重新定义信息类型实体以包括您的新类型。 您现在有了一个定制的DTD。
专门化域时，首先需要确定哪些元素必须专门用于该域。 然后，您编写一个实体声明文件以列出专用元素及其主题类型和域类型。 接下来，创建一个文件，在其中定义为域和专业化层次结构引入的元素。 最后，编写外壳DTD以将域与主题和其他域结合起来。
有关这些过程的详细信息，请参见DITA中的“ 专用主题”和DITA中的“ 专用域” 。
问：如何扩展专业化感知转换？
答：请参阅有关主题类型专门化的文章。
问：我可以在此DTD中使用HTML吗？
答：是的。 许多作家至少对HTML作为标记语言有一定的经验。 因此，基本DITA DTD包含了与可能用于主题的技术信息类型一样多HTML元素。 此外，我们定义了XHTML的子集，可以将其非常简单地转换为DITA格式-通常无需更改许多内容元素！ 实际上，如果可以将XHTML文档与XML DITA文档加载到同一编辑器中，则可以将很长的XHTML内容直接复制并粘贴到主题中。 无论如何， 要获得XML的真正优势，应使用DTD的语义。
问：在哪里可以看到DITA DTD在使用中？
A：就在这里！ 该提案随附的原始文档是使用ditabase DTD以XML编写的。
翻译自: https://www.ibm.com/developerworks/xml/library/x-dita3/index.html
达尔文体系
1270
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
