The Linux Documentation Project
首页  |   HOWTOs  |   指南  |   FAQs  |   man pages  |   Linux Gazette  |   LinuxFocus

 Linux 文档项目历史 

TLDP 内部

创建于 2004-03-04
深入了解 Linux 文档项目的发展历程。

TLDP 是 The Linux Documentation Project(Linux 文档项目)的缩写,这是一个由志愿者组成的组织,负责编写、审阅和管理关于 Linux 操作系统文档。文档根据长度主要有两种格式。较短的通常称为 HOWTOs(或 mini-HOWTOs,如果它们真的很短),较长的文档,称为指南,深入探讨 Linux 的某个特性。

这些 HOWTOs 和指南中讨论的主题数量实际上是无限的,从安装 Linux 系统到管理各种设备、服务和环境,再到从头开始创建自己的系统:TLDP 中几乎包含了所有内容,这主要归功于分享经验的志愿者。然而,必须承认的是,该文集仍然缺少一些重要的主题。

所有文档均以多种格式免费提供,适合打印和在线浏览。主要的提交语言是英语,但包括法语、德语、意大利语、韩语和中文在内的多项翻译工作致力于使这大量信息能够为更广泛的公众所用。

这只是一篇文章,而不是一本书。一些做了出色工作的人没有在此提及。我希望这些人理解本文的背景,并且知道我正在考虑他们,即使他们没有全部被列出名字。

如何使用 TLDP

Linux 环境往往以相当快的速度变化,文档也是如此。新的协议和应用程序的提交很快就会到达 TLDP,使旧文档过时。这里的主要问题是 TLDP 维护者通常比较心软,部分是出于忧郁,部分是出于尊重,有时部分是因为缺乏志愿者来升级文档,他们倾向于存档所有内容。有些人还认为,拥有过时的文档总比没有文档好。

鉴于这些信息,在搜索 LDP 文集时,最好坚持以下黄金法则

  • 1. 检查文档的修订日期。如果它超过一年,不要过于依赖它(除非,当然,我们正在讨论已经以相同形式存在多年或数十年的成熟技术)。

  • 2. 检查文档是否定期更新;这是一个额外的迹象,表明它正在被认真维护。

大多数文档在序言或附录中包含修订历史信息。

TLDP 是如何开始的?

1992 - 1996

正如联合创始人之一 Matt Welsh 所说:“LDP 的历史在今天看来是一段相当模糊的记忆。”它始于 1992 年,在万维网存在之前。很难想象我们在没有 HTML 的情况下是如何工作的,但在那时,几乎所有东西都是 FTP 和 Usenet,拨号连接到 BBS 是最有可能的方式。起初,大多数文档都放在一个大文件中,分成几个部分,称为 Linux FAQ

后来,Matt 与 Lars Wirzenius 和 Michael K. Johnson 合作,他们提出了制作印刷版 Linux 文档的想法。Michael 最初着手编写内核黑客指南,Lars 编写了系统管理员指南,Matt 编写了第一个安装指南。所有内容都使用 LaTeX 完成,因此以合理舒适的方式阅读这些文档的唯一方法是打印出来或使用 PostScript 查看器。

但是随着 Linux 功能的增长,一个人不再可能维护所有内容。很快,即使是几个人也无法完成这项工作。因此,HOWTOs 应运而生,每个 HOWTO 描述了原始大块信息的一部分。这创建了一个易于扩展的系统,允许多位作者在其专业领域做出贡献。

这项工作促使人们开始使用 (Linuxdoc) SGML,它可以从一个源文件或一组文件中快速生成各种输出格式,包括 HTML。首次测试是在 Sunsite(北卡罗来纳大学的一个著名服务器)进行的,它是第一个提供有关 Linux 信息的网站。此外,当您想下载 Linux 软件时,Sunsite.unc.edu 就是首选之地。它仍然包含一些内核存档——可能是偶然的,现在也有很多空目录。

在崩溃之前(2003 年 5 月),我能够通过 FTP 找到一份文档,该文档提到了截至 1994 年底在 UNC 运行的 LDP 的两位维护者。它指向 Jon Magid 和一位神秘的 Erik,没有姓氏,他在 1996 年仍在 Sunsite 工作。

在 Google 的地下服务器机房进行了广泛研究之后,我们可以几乎肯定地说,这位神秘的 Erik 最终确实有一个姓氏。最有可能的是,我们这里谈论的是 Erik Troan,他在 1993-1996 年期间可能支持了半数 Linux 用户,后来成为 Red Hat 的工程高级主管。

进一步的研究表明,在 1996 年的某个时候,Greg Hankins 成为 LDP 项目的 HOWTO 协调员。他是 Serial HOWTO 的原始作者,他于 1993 年开始维护该文档;他也是 SGML-tools 开发项目的主要贡献者之一。

发展

1996 - 1999

LDP 变得越来越受欢迎,该文集已多次以部分或全部形式出版成纸质书。LSL(现在的 CheapBytes)是多个版本的出版商。它们被称为《Linux 圣经》、《Linux 博士》、《Linux 入门》、《Linux 完全参考》和《Linux 百科全书》。

1998 年,《Linux Undercover》出版,副标题为“Linux Documentation Project 揭示的 Linux 秘密”。Red Hat 是第一个使用新的准时生产方法的公司。以前的印刷版本通常包含过时的 HOWTOs,但这一版本实际上是直接从在线主文档打印出来的。

linuxdoc.org 域名已注册,整个 Linux 文档文集都迁移到该域名,并立即进行了镜像。在与 SGI 的蜜月期,与 iBiblio(以前的 sunsite.UNC.edu)的关系得以维持,该大学成为了镜像站点。然而,这段美好的时光并没有持续多久,在短暂的 SGI 插曲之后,TLDP 再次迁回 iBiblio。负责在 iBilbio 管理 TLDP 的 Paul Jones 及其同事非常理解,并提供了大量支持,这使得资源能够集中在北卡罗来纳州。

在邮件列表出现之前,讨论主要发生在 Usenet 新闻组中。1996 年,创建了 ldp-l@cornell.edu 邮件列表。它在 1998 年左右迁移到 ldp-l@linux.org.au。邮件列表是一件好事;我记得当时的新闻源产生了巨大的流量,并消耗了——在当时——不合理的带宽。一些 ISP 决定只提供部分源或根本不提供。ldp-l 邮件列表于 1999 年停止使用,并被当前的列表(discuss、feedback、announce、submit 等)取代。

Lars 和他的团队在这个增长时期开始致力于一个用于提交和发布更新的自动化系统,但该系统从未完成。

一些认真的组织工作

1999 - 2001

到 1999 年,Guylhem Aznar 当选为 LDP 协调员。他的工作是统一 LDP:服务器在世界各地运行,当人们生病或无法使用时,没有真正的备份机制。他首先组建了一个工作人员团队,一个可以为 TLDP 提供结构的志愿者团队。

当时的核心团队的确切配置已被保留。它由一个中心组成,包括一名主要协调员,以及 FAQ、指南和 HOWTO 协调员 Greg Ferguson、Joshua Drake 和 Tim Bynum。此外,1994 年开始的大多数翻译工作现在都在或多或少全速运行,并且已任命人员来管理每项翻译工作。一个未在此处列出的项目(尽管它是最早的项目之一)是德语翻译工作。与最近一些意大利翻译人员的加入一样,人们有时需要一段时间才能找到彼此。

1999 年,该项目托管了八个指南,包括 1.0 版本的《Linux 网络管理员指南》和 beta-1 版本的《Linux 用户指南》。这些和其他文档仍然主要使用 SGML 或 LaTeX 编写。

DocBook 首次出现在 2000 年;DocBook 现在是首选的提交格式,因为它能够从源文件轻松生成 HTML、PS、PDF 和其他格式。

21 世纪带来的另一项创新是版本控制系统的创建。Serge Victor 和 Gregory Leblanc 负责设置;Serge 仍然管理我们的 GitHub 存储库。到 2000 年底,他也成为列表管理员。在此之前,Debian 托管了 TLDP 邮件列表。

TLDP 项目在各个方面都日趋成熟和发展。为此,David S. Lawyer 完成了LDP 宣言的最终版本。David 仍然是所有许可问题的联络人。

新的网站布局可能是最明显的改进。新千年带来了今天网站的前身。

从 LinuxDoc.org 到 TLDP.org

2001 - 2003

在某些文档中,您仍然可以看到对旧 linuxdoc.org 域名的引用。不幸的是,域名切换的原因并不光彩,但由于它是 TLDP 故事的一部分,因此应该讲述。

正如经常发生的那样,善意和仁慈让自私自利应运而生。许多人对 TLDP 感兴趣,但并非总是为了项目的利益。

在 Guylhem 当选主席时,只有另一位候选人。Guylhem 不想让那个人感到被冷落,所以他信任他担任网站管理员。TLDP 丢失了 linuxdoc.org 域名,因为网站管理员设法声称拥有该域名。他还购买了 .com 域名,并利用 TLDP 在其上运营了一个商业网站。不用说,这引起了很多摩擦。

故事还有另一面,称网站管理员(无意或有意?)未支付域名的续订费。

无论如何,必须找到一个新的域名,而 tldp.org 简短且免费。Guylhem 认真对待自己的责任,在 2002 年注册了该域名,并将项目迁移到当前域名。该团队还借此机会扩大了项目的范围,并将此次迁移与重组操作相结合,使项目效率更高。

新程序

2003 - 2005

但所有这些努力还不够。越来越多的作者和其他志愿者需要指导,越来越多的文档需要组织。到目前为止,该项目托管了大量过时的文档,这有点令人羞愧。另一个问题是文档的随机发布。有太多的工作要做,但没有足够的人来做,所以几乎任何人都可以发布任何东西。当发现几份带有偏见的文档时,丑闻爆发了,这些文档包含受污染的,有时甚至是明显错误的信息,可能对读者有害。

因此,2003 年成为了改版之年。对整个文集的彻底搜索显示,更多旧的或有疑问的文档被下线进行修订。过于陈旧以至于无用的文档被移至归档。Tabatha Marshall 被任命为审阅协调员,并组建了一个审阅团队。他们一起编辑新的提交内容:他们检查技术正确性、可读性以及语法和拼写错误。此外,他们应用 TLDP 风格,以使文集保持一致性。《每周新闻》被恢复,并通过 RSS 订阅提供。再次跟进了来自反馈邮件列表的输入。作者指南已修订,以列出根据质量控制指南发布文档的新程序。创建了一个 HOWTO 生成器,以方便新作者提交内容。除了这些显而易见的成就之外,现在有数百名作者一起工作,他们每个人都为这个庞大的项目贡献了微薄之力。

负责管理项目的人员经常问我们是如何做到的。这就是方法。没有哪本书会告诉你如何做到这一点。我们正走在一条充满坎坷和起伏的道路上,TLDP 似乎是用钩子和眼睛拼凑在一起的——但它就在那里,并且不会消失。

更多历史

由于《每周新闻》项目也有起伏,目前正处于低谷,我们决定将链接从首页上移除,并将旧期刊放在此处提供。


最后修改时间:2012-07-07 |  feedback@en.tldp.org