The Linux Documentation Project
 |  HOWTOS  |  Guides  |  Man Pages  |  Linux Gazette  | 
 

LDP 每周新闻
2002-01-15

作者：David Merrill
 

在线编辑，Wiki 风格

我们正在努力为希望使用在线编辑功能的作者提供简单的在线编辑功能，类似于 WikiWikiWeb。它不会拥有真正的 Wiki 的所有功能，但它将提供最近更改的跟踪以及版本之间的差异比较，以及与权威 CVS 版本的差异比较。

由于我们收到了来自作者的反馈，他们担心必须学习新东西，或者必须跟踪两个版本的更改，因此 Web 界面将完全可选，根据作者的要求而定。喜欢使用 CVS 或通过电子邮件发送更新的作者可以像往常一样继续这样做。

我希望在下周的 LDPWN 中至少报告一些最基本的功能。感谢 Martin Wheeler 的最初想法。

是 DocBook 还是文本？

最初的“Wiki”想法衍生出的一个副项目是一个实用程序，它可以将非常简单的 Wiki 风格文本格式转换为 DocBook，这是一个非常庞大且复杂的 XML DTD，我们用它来存储我们的文档。这很难解释，所以这里有一个例子。这是一个标准的 DocBook 格式的简单 DocBook 片段
<sect1><title id='intro'>Introduction</title>
  <para>
    Welcome to the
    <ulink url='http://www.linuxdoc.org'>
      <citetitle>Linux Documentation Project</citetitle>
    </ulink>
  </para>
</sect1>

即使在这个非常简单的例子中，您也可以看到 DocBook 可能很冗长。有些人会说这是一种非常保守的说法。 :-) 这也是许多作者继续使用 LinuxDoc 的原因之一，LinuxDoc 更简单但功能较弱。

在简化的文本格式中，这变成了

=Introduction|intro=
Welcome to the [[http://www.linuxdoc.org|Linux Documentation Project]]

简化的文本格式甚至不会开始涵盖 DocBook 提供的所有标签。那将是一场注定失败的战斗。与其进行那场注定失败的战斗，我们不如允许将 DocBook 内联插入到文本中。不幸的是，我们还没有找到另一种方法——您将无法在任何 DocBook 结构中插入文本提示。

新文档

更新的文档

未维护的文档

这些文档已被其维护者放弃，其中许多文档已有一段时间未更新。如果您愿意成为其中一个文档的维护者，请加入 LDP 讨论列表 lists.linuxdoc.org 并发布消息表明您的兴趣。

关于 LDP

Linux 文档项目正在为 GNU/Linux 操作系统开发免费、高质量的文档。这包括创建 HOWTO 和指南，以及与其他文档组的协作。

如果您一直想帮助 Linux 实现世界统治（Total World Domination(tm)），但您不是程序员，您仍然可以做一些事情。帮助 LDP！

LDP 在 http://www.linuxdoc.org/authors/ 保留了一个作者资源页面。 欢迎投稿。

要获取更多 LDP 每周新闻，请访问 http://www.linuxdoc.org/ldpwn/