关于如何书写、管理和发布类似LFS的文档的流程（诚心求教）

youbest

　　因想建立类似的文档项目，所以想对整个流程详细了解。
　　不知道版里是否有精于此道，或者曾经研究过的朋友，希望能提供这方面的资料，如果能整理出详细的流程的话那就最好了。:thank
　　如果没有研究过这方面的朋友，是否有愿意一起研究这个问题的朋友共同研究一下。

晨想

同问，，谢谢。。

csfrank

同样关注...

coolend

LFS 是用 DocBook/XML 编写的，XML文件 可以通过多种工具(比如xslproc)转换成各种其他输出形式的文档（单页HTML/多页HTML/TXT/PDF等）。

大家可以下载其 XML 的源文件看看就知道了，下载地址：
http://www.linuxfromscratch.org/lfs/downloads/stable/LFS-BOOK-6.2-XML.tar.bz2

其实写像 LFS 这样的技术文档，需要用到的 XML 语法不是很复杂，只不过只不过开始用 XML 写的话，会有点不习惯，不像一般的记流水帐，XML 文档的结构很清晰，你必须按照语法约定来写，否则些完后的文件无法编译。还有就是 XML 的编译环境的搭建可能有点麻烦，不同的系统不尽相同，我的编译环境是按照 BLFS 来弄的。

coolend

至于如何使用 DocBook/XML 编写技术文档，大家可以参考“Fedora Project 文档撰写准则”
http://fedora.gro.clinux.org/docs/documentation-guide-zh_CN/

youbest

Post by coolend
LFS 是用 DocBook/XML 编写的，XML文件 可以通过多种工具(比如xslproc)转换成各种其他输出形式的文档（单页HTML/多页HTML/TXT/PDF等）。

大家可以下载其 XML 的源文件看看就知道了，下载地址：
http://www.linuxfromscratch.org/lfs/downloads/stable/LFS-BOOK-6.2-XML.tar.bz2

其实写像 LFS 这样的技术文档，需要用到的 XML 语法不是很复杂，只不过只不过开始用 XML 写的话，会有点不习惯，不像一般的记流水帐，XML 文档的结构很清晰，你必须按照语法约定来写，否则些完后的文件无法编译。还有就是 XML 的编译环境的搭建可能有点麻烦，不同的系统不尽相同，我的编译环境是按照 BLFS 来弄的。

谢谢,能否介绍一下你的搭建过程?

coolend

环境的搭建可以参考 BLFS 的文档

将 III. General Libraries and Utilities
8. General Libraries
提到的 libxml libxml2 libxslt 安装完

还有 XII. Printing, Scanning and Typesetting 部分
44. Standard Generalized Markup Language (SGML)
45. Extensible Markup Language (XML)
中提到的所有软件包安装完

这样就几本OK了，XML 转 HTML 工具用的是 xsltproc

如何开始一个简单的 XML 文件的编写、转换，可以参考
http://www.woodpecker.org.cn:908 ... tep_1.6.6/src/html/

此外网上关于 Docbook写作 的书籍和文档也是很多的，如果你的 English 够好的话，强烈推荐看DocBook 的官方权威指南 DocBook_The_Definitive_Guide，英文虽然看起来没有中文舒服，但是对命令而言，中英文没有分别，如同 LFS 本身一样，别人翻译的时候也不可能将 make install 翻译成 "制造 安装"。

当然，入门的话，看中文文档可能会好一点

youbest

非常感谢!