📄 00000006.htm
字号:
<HTML><HEAD> <TITLE>BBS水木清华站∶精华区</TITLE></HEAD><BODY><CENTER><H1>BBS水木清华站∶精华区</H1></CENTER>发信人: <A HREF="mailto:long@eagle.ee.ntu.edu.tw">long@eagle.ee.ntu.edu.tw</A> (long), 看板: linux <BR>标 题: 如何用Linuxdoc-SGML撰写并维护Linux Howto(纯文字) <BR>发信站: National Taiwan University (Sat May 18 00:46:10 1996) <BR>转信站: maple!news.ee.nthu!news.cis.nctu!news.cc.nctu!spring!netnews.ntu!long <BR> <BR> <BR> 如何用Linuxdoc-SGML撰写并维护Linux Howto <BR> 吴晓龙, <A HREF="mailto:long@eagle.ee.ntu.edu.tw">long@eagle.ee.ntu.edu.tw</A> <BR> v1.0, 17 July 1996 <BR> ______________________________________________________________________ <BR> <BR> Table of Contents: <BR> <BR> 1. 前言 <BR> <BR> 2. 安装 <BR> <BR> 2.1. 安装之前 <BR> <BR> 2.2. 安装 <BR> <BR> 3. 为了与中文big5码相容之修改 <BR> <BR> 3.1. Script file 的修改 <BR> <BR> 3.2. Configuration file(LINUXDOCLIB/rep/xxx/ <BR> <BR> 4. 档案的转换 <BR> <BR> 5. Further Information <BR> ______________________________________________________________________ <BR> <BR> 1. 前言 <BR> <BR> 最近在Linux版上大家开始讨论所谓Taiwan Linux User Group的 <BR> 可能性与其发展方向,我想如果真能产生一些共识与成果, 对於Linux <BR> 以至於U*ix的推广都是一个好的起头吧. <BR> 起码每天看tw.bbs.comp.linux时可以少按几下K.......:-) <BR> 现在大家好像还在讨论阶段,对於应该致力於软体中文化还 是Howto的翻译 <BR> 都还众说纷云.不过我想不管是那个方向, 文件的撰写与维护都是很重要的, <BR> 因为只有这样, 才能够 使每个人的effort不致於孤芳自赏, <BR> 也能使经验传承下来. <BR> <BR> 由於有这个想法,我就花了一点时间看了一下howto中的Writing <BR> 发现Linux的howto早就有了一致的政策与文件规格. <BR> 本土文件的政策还有赖大家讨论,不过他们的文件规格倒是 <BR> 很值得我们来套用.他们是用一种叫SGML(Standard Generalized Markup <BR> Language)来写HOWTO的,更精确地来说,他们是用这种语言 <BR> 来定义HOWTO文件的结构,使得每个人都可以轻易地写出格式相同 <BR> 的文件.如果有人看到这里一头雾水,还搞不清楚这是一种什麽 <BR> 语言的话,没关系,我也搞不太懂这是什麽...:-) <BR> 不过这就是他的优点了,搞不懂也可以照写不误, 大家可以边写边搞, <BR> 搞搞写写.......我是说这个语言啦....:-) <BR> 它最强大的地方是可以轻松地转换成一般文字档,LaTeX(ps,dvi), GNU Info, <BR> LyX(好像是一种WYSIWYG的LaTeX)与RTF(这我就不知道是 <BR> 什麽了).也就是说,你可以专心於撰写维护一份sgml文件,而不须 <BR> 将心力浪费在文件转换上. <BR> <BR> 希望藉著这份文件能够减轻documentation的负担, <BR> 而使得有更多的人开始将自己的经验与其它linuxer分享, <BR> 然後不用每天看"我也要,我也是,as title"的文章 <BR> 然後大家能够因此有更多的心力集中在coding上, <BR> 然後....能够..世界大同,宇宙和平....:-) <BR> <BR> 本文的html版可在<A HREF="http://eagle.ee.ntu.edu.tw/$tilde;long/linux/simple-">http://eagle.ee.ntu.edu.tw/$tilde;long/linux/simple-</A> <BR> sgml.html存在 <BR> <BR> 2. 安装 <BR> <BR> 2.1. 安装之前 <BR> <BR> 有几个package是必须的 <BR> <BR> □ 安装需要 <BR> <BR> □ <A HREF="ftp://nctuccca.edu.tw/Operating-">ftp://nctuccca.edu.tw/Operating-</A> <BR> Systems/Linux/packages/Utils/text/linuxdoc-sgml-1.5.tar.gz <BR> <BR> □ perl <BR> <BR> □ flex <BR> <BR> □ gcc <BR> <BR> □ Format文件需要 <BR> <BR> □ groff 1.08 or 1.09 <BR> <BR> □ TeX and LaTeX (包含CJK套件) <BR> <BR> □ gawk 及 GNU info tools <BR> <BR> □ (optional) LyX <BR> <BR> 2.2. 安装 <BR> <BR> 只需run the install script,回答binaries,library,documentation,man <BR> pages 安放之处 <BR> <BR> 3. 为了与中文big5码相容之修改 <BR> <BR> 假设 LINUXDOCBIN=/usr/local/bin; LINUXDOCLIB=/usr/local/lib/linuxdoc- <BR> sgml <BR> <BR> 注意:由於本人对中文码不太熟悉, 这些修改只是trial and error的结果, <BR> 无法保证所有的中文big5 code都能顺利显示, <BR> 而且修改的部份可能会造成转换後文件的特殊符号(如latex中的_,})无法显示 <BR> <BR> 3.1. Script file 的修改 <BR> <BR> 修改LINUXDOCBIN/sgml2txt <BR> <BR> 第17行,将COL=``no''改为COL=``no'' <BR> <BR> 第105行,将 latin1) cat $SGMLFILE | sed -f $LINUXDOCLIB/latin1.sed <BR> <BR> $LINUXDOCBIN/sgmls $DASHI $SGMLDECL > <BR> <BR> /tmp/sgml2txt$$tmp;; <BR> <BR> 改为latin1) $LINUXDOCBIN/sgmls $DASHI $SGMLDECL $SGMLFILE > <BR> /tmp/sgml2txt$$tmp;; <BR> <BR> 3.2. Configuration file(LINUXDOCLIB/rep/xxx/general,mapping)的修改 <BR> <BR> □ LINUXDOCLIB/rep/latin1/general:第134行`` ''改为``$tilde;'' <BR> <BR> □ LINUXDOCLIB/rep/latex2e/general:第120行``_''改为``_'', <BR> 第169行``''改为``}'' <BR> <BR> □ LINUXDOCLIB/rep/latex2e/mapping: <BR> <BR> 第7行将``\\usepackage\[latin1\]{inputenc}\n''替换成``\\usepackage{CJK}\n'' <BR> 第12行加入``\\begin{CJK*}{Bg5}{kai}'' <BR> 第15行加入``\\end{CJK*}'' <BR> <BR> □ LINUXDOCLIB/rep/html/general:第128行将&nbsp换成~ <BR> <BR> 4. 档案的转换 <BR> <BR> □ 产生文字档 <BR> <BR> sgml2txt -l xxx.sgmL <BR> <BR> □ 产生HTML文件 <BR> <BR> sgml2html xxx.sgml <BR> <BR> □ 产生LaTeX文件 <BR> <BR> sgml2latex -2e xxx.sgml <BR> <BR> 5. Further Information <BR> <BR> □ The QWERTZ User's Guide is available from <BR> <A HREF="ftp://ftp.cs.cornell.edu/pub/mdw/SGML.">ftp://ftp.cs.cornell.edu/pub/mdw/SGML.</A> QWERTZ (and hence, <BR> Linuxdoc-SGML) supports many features such as mathematical <BR> formulae, tables, figures, and so forth. I don't recommend using <BR> most of these features in the Linux HOWTOs because they won't <BR> render well in plain text. If you'd like to write general <BR> documentation in SGML, I suggest using the original QWERTZ DTD <BR> instead of the hacked-up Linuxdoc-SGML DTD, which I've modified for <BR> use particularly by the Linux HOWTOs and other such documentation. <BR> <BR> □ Tom Gordon's original QWERTZ tools can be found at <BR> <A HREF="ftp://ftp.gmd.de/GMD/sgml.">ftp://ftp.gmd.de/GMD/sgml.</A> <BR> <BR> □ More information on SGML can be found at the following WWW pages: <BR> <BR> 1. SGML and the Web <<A HREF="http://www.w3.org/hypertext/WWW/MarkUp/SGML/>">http://www.w3.org/hypertext/WWW/MarkUp/SGML/></A> <BR> <BR> 2. SGML Web Page <<A HREF="http://www.sil.org/sgml/sgml.html>">http://www.sil.org/sgml/sgml.html></A> <BR> <BR> □ James Clark's sgmls parser, and it's successor nsgmls and other <BR> tools can be found at <A HREF="ftp://ftp.jclark.com">ftp://ftp.jclark.com</A> and at James Clark's WWW <BR> Page <<A HREF="http://www.jclark.com>.">http://www.jclark.com>.</A> <BR> <BR> □ You can join the Linuxdoc-SGML mailing list by sending mail to <BR> <A HREF="mailto:majordomo@via.ecp.fr">majordomo@via.ecp.fr</A> with subscribe linuxdoc-sgml in the message <BR> body. The list address is linuxdoc-<A HREF="mailto:sgml@via.ecp.fr.">sgml@via.ecp.fr.</A> <BR> <BR> □ More information on LyX can be found at the LyX WWW Page <BR> <<A HREF="http://wsiserv.informatik.uni-tuebingen.de/~ettrich/>.">http://wsiserv.informatik.uni-tuebingen.de/~ettrich/>.</A> LyX is a <BR> high-level word processor frontend to LaTeX. Quasi-WYSIWYG <BR> interface, many LaTeX styles and layouts automatically generated. <BR> Speeds up learning LaTeX and makes complicated layouts easy and <BR> intuitive. <BR> <BR><CENTER><H1>BBS水木清华站∶精华区</H1></CENTER></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -