Linux 版 (精华区)

发信人: clx (楚留香), 信区: Unix
标  题: Linux HOWTO 中文索引(05)
发信站: 紫 丁 香 (Sat Jun 27 16:19:36 1998), 转信

Linux HOWTO 中文索引 : 写一份 HOWTO
Previous: HOWTO 索引
Next: 版权声明 


4. 写一份 HOWTO

如果你有兴趣写一份 HOWTO 或 mini-HOWTO，请先与我联络!!! 我
的地址是 linux-howto@sunsite.unc.edu.

这里有一些当你写一份 HOWTO 或 mini-HOWTO 时应遵守的准则。

  1.尝试使用有意义的结构与组织，并写得清楚些。请记住许多
     HOWTOs 的读者并非以英文作为母语的。 
  2.如果你在写一份 HOWTO，你必须 使用 SGML-Tools 工具，可从
     http://www.xs4all.nl/~cg/sgmltools/取得。 这个工具可以让我们经
     由单一原始文件产生 LaTeX (DVI 及 PostScript) 文件， 纯
     文字，以及 HTML 格式，而且它是特别设计用来写 HOWTOs 
     的。 这也使得所有的 HOWTOs 文件看起来具有一致的形式。
     你事先将文件格式化并检视 PostScript，纯文字及 HTML 的输
     出是十分重要的。 
  3.如果你在写一份 mini-HOWTO，你可以使用 SGML (如上所述)
     或是 HTML 格式。 如果你使用 SGML 格式，它会和其它
     HOWTOs 一起被放入 LDP 的书中出版。 
  4.请确定所有的资讯都是正确的。不需我强调这点的重要性。 如
     果有所怀疑，不能确定，请在文中清楚的注明你仅仅是在猜测
     而已。 
  5.请确定你包含了最新版本的软体。同时，确定包含了如何取得
     软体的全部资讯(FTP 站名及全部的路径名称)， 目前的版本以
     及发行日期等。 
  6.如果合适的话，在最後面包含一节「常见问题解答(FAQ)」。
     许多的 HOWTO 文件需要「FAQ」或「常见问题」一节来涵盖内
     文所未包含的资讯。 
  7.使用其它的 HOWTOs 或 mini-HOWTOs 做为□本。SGML 的原始
     档也可以从 Linux FTP 站取得。 除此之外，看一下 LDP
     Style Guide 里的一些建议。 
  8.请确定在文件开头处包含了你的名字，email 地址，日期以及
     版本资讯。 如果必要也可以包含你的 WWW 地址或永久住址。
     标准的开头就像这样: 

             标题
             作者姓名及 email 地址
             版本号码及日期
             

     例如: 

             The Linux HOWTO Index
             by Tim Bynum
             v2.10.29, 31 July 1997
             

  9.最後，准备好接到一大堆的问题与意见。全世界每天都有数千
     次造访 HOWTO 文件的收集站。 

在你写完 HOWTO 之後，将它寄给我。如果你用 SGML-Tools，直接
将 SGML 原始档寄给我就行。 我会负责编排这些文件，将它放到 
sunsite.unc.edu 并且在不同的新闻组群上发表。

经由我发表一份 HOWTO 是很重要的，因为我维护这些档案并且追踪
已经写了那些 HOWTOs，以及谁做了什麽等等。

然後，你所要做的就是在定期更新并将文件寄给我。

     [译注]

          如果你有兴趣翻译一篇 HOWTO，请先看如何参与 Linux HOWTO 中文
          翻译计画，并与 CLDP 协调人 黄志伟 联络。


Linux HOWTO 中文索引 : 写一份 HOWTO
Previous: HOWTO 索引
Next: 版权声明 

--
※ 来源:．紫 丁 香 bbs.hit.edu.cn．[FROM: 202.118.244.16]