oasis-dita

按照 OASIS DITA 风格编写或回复文档时，应遵循以下结构和规范： 1. **主题（Topic）结构** 每个文档应由一个或多个独立、自包含的主题组成。主题类型包括： - 概念（Concept）：解释原理、背景或理论。 - 任务（Task）：提供分步操作指南。 - 参考（Reference）：列出事实性信息（如参数、命令等）。 2. **模块化与复用** - 使用 `<topicref>` 在 DITA 地图（Map）中组织主题，支持内容复用。 - 通过 `<conref>` 或键引用（Key Reference）实现跨主题内容共享。 3. **语义化标记** - 使用 DITA 元素明确语义，例如： - 步骤用 `<steps>`，命令用 `<cmd>`。 - 术语用 `<term>`，代码用 `<codeblock>`。 4. **元数据与条件处理** - 添加 `@audience`、`@product` 等属性以支持多版本输出。 - 使用 `<prop>` 或 `<revprop>` 标记需条件化处理的内容。 5. **简洁性与一致性** - 语言简洁，避免冗余。 - 遵循统一的术语表和风格指南（如标题层级、列表格式）。 6. **输出适配** - 确保内容可通过 DITA-OT 生成 PDF、HTML 等格式，适配响应式布局。 示例任务主题片段： ```xml <task id="install_software"> <title>安装软件</title> <steps> <step><cmd>下载安装包</cmd></step> <step><cmd>运行安装向导</cmd></step> </steps> </task> ``` 如需进一步扩展，可结合具体场景调整结构。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本