回首页

后一页
前一页
写一份 HOWTO
姓名:Greg Hankins
Email:
地址 :
转摘 : /



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

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


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


例如:
The Linux HOWTO Index
by Greg Hankins
v2.10.29, 31 July 1997


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

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

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

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


[译注]
如果你有兴趣翻译一篇 HOWTO,请先看如何参与 Linux HOWTO 中文翻译计画,并与 C.W.Huang 联络。


后一页
前一页

回首页