docs-intro-zh_CN.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

<?xml version="1.0" encoding="utf-8"?>
<!-- $Id: docs-intro-zh_CN.xml,v 1.2 2005/12/17 13:28:38 bbbush Exp $ --><preface id="ch-intro">
  <title>介绍</title>
  <para>Docs Project 的目标是为 &FC; 用户和开发者创建易于维护，基于任务的文档。除了 <citetitle>&IG;</citetitle> 之外，所有文档必须是 DocBook XML article 格式，每个主题一篇文章。这样，作者就可以专注于撰写一个主题，不必考虑它如何排版为一个手册，或如何与其他主题协调。</para>
  <para>要用到的工具：</para>
  <itemizedlist>
    <listitem>
      <para>DocBook XML v4.1</para>
    </listitem>
    <listitem>
      <para>自定义的打印版本和 HTML 版本的 XSLT 样式表</para>
    </listitem>
    <listitem>
      <para>自定义的脚本，以生成 PDF 版本和 HTML 版本的输出 (使用 <command>xmlto</command>)</para>
    </listitem>
    <listitem>
      <para>Emacs PSGML 模式 (可选，推荐使用)</para>
    </listitem>
    <listitem>
      <para>Emacs nXML 模式 (可选，同样推荐使用)</para>
    </listitem>
  </itemizedlist>
  <para>本文档的目的是解释 Docs Project 使用的工具，同时提供写作约定和标记约定，使文档一致且易于维护。</para>
</preface>