
                                  HOWTO HOWTO
                                       
: Mark F. Komarinski [1]markk@cgipc.com
: ս [2]softsprite@yeah.net

   v0.13, 19 September 1999 : 09 Feb 1998
     _________________________________________________________________
   
   Ϊһµ LDP ߣ LDP ʹõĹߡ˼·Լ 
     _________________________________________________________________
   
1. 

     * 1.1 ʷ
     * 1.2 °汾 
     * 1.3 Ȩ̱ 
     * 1.4 л 
       
2. LDP  SGML  

     * 2.1 LDP
     * 2.2 SGML
     * 2.3  
       
3. ǿʼ 

     * 3.1 д 
     * 3.2 ʼб 
     * 3.3 زװ
     * 3.4 ֹд SGML 
     * 3.5 ʹд SGML 
     * 3.6 CVS  
     * 3.7 ĵ 
       
4. ָ 

5.  LDP ĳ 

     * 5.1 Ϊ LDP һҸȥ 
     * 5.2  LDP ĵLDP ĵ涨ģ 
     * 5.3 һ LDP ĵҵһ 
     _________________________________________________________________
   
1. 

1.1 ʷ

   1999826 Mark F. Komarinski [3]markk@cgipc.com ڻ
   ѰߵĴῪʼдġκһ LDP ܴеõҾʹ
   ҵԸˡ
   
1.2 °汾

   ĵ°汾ҵҳ [4]http://www.cgipc.com/~markk ҵ SGML
   Դļ ͬʽİ汾 LDP ҳ [5]http://www.linuxdoc.org/
   ҵ
   
  汾ʷ
  
   v0.25, 20 September 1999
   
     * ޸һЩϿ
     * Ϊ½
     * а汾һЩ޸
     * ӰȨ˵ȡǰ URL 
       
   v0.12, 2 September 1999
     * ɴ½
     * бۺ޸
       
   v0.10, 27 August 1999
     * Got up to section 3.4 written
     * Added to the outline some
     * Changed location of LDP mailing list to lists.debian.org from
       thepuffingroup.com.
       
   v0.01, 27 August 27 1999
     * ɣϴҳ򵥴д
     * Take some of what I wrote with a grain of salt. Some things need
       to be verified.
       
1.3 Ȩ̱

   (c) 1999 Mark F. Komarinski
   
   ָϿԱȫ򲿷ָƣҪѣƣ
   
     * The copyright notice above and this permission notice must be
       preserved complete on all complete or partial copies
     * Any translation or derived work must be approved by the author in
       writing before distribution.
     * If you distribute this work in part, instructions for obtaining
       the complete version of this manual must be included, and a means
       for obtaining a complete version provided.
     * Small portions may be reproduced as illustrations for reviews or
       quotes in other works without this permission notice if proper
       citation is given.
       
   Exceptions to these rules may be granted for academic purposes: Write
   to the author and ask. These restrictions are here to protect us as
   authors, not to restrict you as learners and educators. All source
   code in this document is placed under the GNU General Public License,
   available via anonymous FTP from [6]the GNU archive site.
   
1.4 л

   лдиҰˣ Deb Richardson  Daniel
   Barlow Լ LDP бϵˡ
   
   ½ȡ HOWTO Index  sgmltools ĵڱĵָ
   δȡ sgmltools  LDP
   
2. LDP  SGML 

2.1 LDP

   Linux ĵƻ (LDP) ṩûԿȡĳϸϢ
   һϵй춹硢̵ȵ鼮ǰ˴ʹ
   ùдĹĳĽҹ춴ӡϣ
   Բ Printing HOWTOҹϣԲ
   Ethernet HOWTOȵȡ
   
   տʼЩĵı HTML ʽʱƣҳһ
   Щĵĺ÷һ Web ҳĶӹ̵ıļĶ
   ĸĶķѾˣ SGML
   
2.2 SGML

   Standard Generalized Markup Language (SGML) һֻ춼Ǻıԡ
   ⷽ棬 Tex  groff  HTML SGML ǿ֮
   WYSIWYG ()㲻Ҫɫȸʽֻ趨Ԫ
   (䡢½ڡб) մλáɫȷ
   顣HTML Ҳģʵ SGML һӼ
   
   SGML ֡һΪ DTD (ΪĵͶ Document Type
   Definition) Ľṹ DTD ÿһԪ֮ĹϵThe LinuxDoc DTD,
   used to create this document, is an example of this. DTD Ϊÿһʹ
   DTD ĵһͨõӾ͸оЧ(content)ǽҪ
   SGML ûĶĲ֡ݣҲ԰ͼ񡢱
   񡢱бȵȡݱ(tag)ΧֿͬԪء
   
   ʱƣLinuxDoc DTD  DocBook DTD ȡΪ SGML 
   ṩһͳһӾ͸оЧ ʵһǽͨ HOWTO
   ʼбΪ LinuxDoc  DocBook ֮Ĳͬ DocBook
   Ǹͬ͵(ļַĿ¼ȵ) LinuxDoc
   ǻıҪʾķʽ(Էǿ)
   
  Ϊʲ SGML ȡ HTML ʽ
  
   SGML ṩĲǸʽԶݱԼĵеӻ
   Ǵ١sgmltools Ҳ LaTeX  info  text  HTML 
   RTFЩʽԴʽĵ(DOCPostScriptȵ)SGML
    HTML ߳ҲΪܿ SGML пıǡ
   춱벻춴д LyX (ʹõñ༭
   )԰д TeXʽĵ SGML ʽȻͿ
    SGML κҪĸʽ
   
   ᣬSGML עԪصĹܶԪصʾһԣ
   дΪ㲻عĶλáСȵȡ
   
2.3 

   ڱ½ڣҽһЩѵ LDP ĵĹߡҽȼ򵥽ܣ
   Ȼϸ˵ΰװǡʹһЩд LDP
   ңһΪġ
   
  sgmltools
  
   ر
   
   sgmltools  SGML ˵ʽ SGML ߡҲ
   LDP ĵ LinuxDoc DTDֻ SGML ĵЩѾ㹻ˡ
   봦ɱ TeX ʽ㻹ҪһЩ߰sgmltools  linux
   а汾пҵߵ [7]http://www.sgmltools.org/ ء
   
  TeX
  
   ѡ
   
   TeX (rhymes with blech!) һֿɹ㷺ѡıԣЩѧ
   еǡ һǵ΢ֿ TeX дɵġҲʹ
   õı֮һ TeX ʵϺ SGML ߱ͬĸTeX 
   ļ DVI (豸޹)Ӷܴʽ ҵǣDVI
   תɴӡ(PostScriptPCL)ʽ HTML TeX 
    Linux а汾жѰװṩ
   
  LyX
  
   ѡ
   
   LyX һͼλṩǳͼӦ SGML
   ֮ϵLyXд TeX ĵʵ TeX 򡣾ٸ
   ½ڱԶţ޷׵زոⱻ TeX Ƴɽֹ SGML
   ͨͬĿոLyXܹ LinuxDoc DTD ṩĵģ԰
   ϰߵķʽ LDP ĵҪ vi Ҫסǡ LyX 
    [8]http://www.lyx.org/ ҵ
   
    KDE һʹ Qt  LyX ԴµַõϢ
   [9]http://www.devel.lyx.org/~ettrich/klyx.html ʹ KLyX д
   SGML ͨ [10]ʼ ʹþ顣
   
3. ǿʼ

   ½ʾλȡдԼ LDP ĵϢȡװߣ
    LDP ϵ Linux ûյ֪ʶ
   
3.1 д

   ո˽ LDP Ҫѡһûά HOWTO дһµ
   HOWTO  mini-HOWTO ĵϵ [11]linux-howto@metalab.unc.edu 
   
   ⽫ HOWTO Э˭άƪĵͬʱҪעе HOWTO ʹ
   SGML ʽ(ǰʹ LinuxDoc DTD)mini-HOWTO ʹ SGML  HTML ʽ
   ֻ SGML ʽ HOWTO Ĵӡ汾С
   
3.2 ʼб

   һЩʼбԶ˽ LDP Ŀǰ
   [12]ldp-discuss@lists.linuxdoc.org LDP Ҫ顣Ҫģ
   Ϊ "subscribe" ʼ
   [13]ldp-discuss-request@lists.linuxdoc.org˶Ϊ
   "unsubscribe" ʼ [14]ldp-discuss-request@lists.linuxdoc.org
   
3.3 زװ

  sgmltools
  
    [15]http://www.sgmltools.org/ sgmltools ֱӴ
   Linux а汾ȡá sgmltools.org ȡõԴʽ
   ĻϱЩԴ롣 Linux а汾ȡõԤõİ
   ЩԲñֱӿʼ༭(ر㲻һԱ)
   
   RedHat а sgmltools ûУԴ ftp.redhat.com 
   վء
   
   ʹ Debianڱ׼а汾Ҳ sgmltools ûѰװ
   İʹ apt-get زװ
     _________________________________________________________________
   
# apt-get install sgml-tools
     _________________________________________________________________
   
   Ҫ˽ Debian ϢԲ
   [16]http://www.debian.org/Packages/stable/text/sgml-tools.html
   
   Դ룬Ҫǣ
   
# tar -zxvf sgmltools-x.x.x.tar.gz
# cd sgmltools-x.x.x
# ./configure
# make
# make install


   滻 sgmltools-x.x.x 㵱ǰ sgmltools İ汾š֧ LinuxDoc ĵǰ
   汾 1.0.9֧ DocBook ĵǰ汾 2.0.2վ
   ҵ
   
   һ߰װᣬͿʹúܶˡ
   
   sgmlcheck file.sgml- ĵľ䷨
   
   sgml2html file.sgml- ת SGML ļ HTML һΪ file.html 
   ļݱȻᴴһϵΪ file-x.html ļ x ½ں
   
   
   sgml2rtf file.sgml- ת SGML ļ Rich Text Format (RTF)
   һ file.rtf  TOCԼ file-0.rtf е½ڡ
   
   sgml2txt file.sgml- ת SGML ļ ASCII ıݷ file.txt
   С
   
   sgml2info file.sgml- Blah SGML blah INFO, ܱ info ʹáе
   ͵ file.info
   
   sgml2latex file.sgml- Blah SGML blah TeX.
   
   sgml2lyx file.sgml- SGML yadda LyX graphical editor. This is great if
   you have pre-generated SGML files and want to convert them for use in
   LyX.
   
3.4 ֹд SGML

   ǳ HTMLֹд SGML , ֻҪҪʹõıǴ뱾
   ½ڽܶЩ룬Ϊÿһṩӡʼõĵط
   ĵԴ룬Դ￴ [17]Introduction. Ϊ SGML Ĵʽ
   ļʽĲͬͬҽ˵ļдӦ֪顣
   
  
  
   ڿʼдˣϲı༭һļļĿͷ£
   
<!doctype linuxdoc system>

   ⽫ SGML ļʱʹõĵ(ʹ LinuxDoc)
   Ǳκ
   
   Ҫݰڱ <article>  </article> ֮С
   ζݵĿʼϤ HTML Ļ춽ݰڱ
   <html>  </html> ֮䡣
   
  ͷϢHeader information
  
   ݵĵһӦðಿֵĸϢһͷҳ
   бҳ(鱾ı⡢ߡڡĿ¼ȵ)
   
   ݵıڱ <title>  </title> ֮䡣߰ڱ <author>
    </author> ֮䡣ʹñ <date>  </date> 
   
   ½ǣ <abstract>  </abstract> ժҪ<toc>
   ָĿ¼λáĿ¼(TOC) SGML Զɵġ潫
   ½ڡ
   
   һпʲأѸղ˵ SGML 
   
   
<!doctype linuxdoc system>
<!-- LinuxDoc file was created by LyX 1.0 (C) 1995-1999 by <markk>
 Fri Aug 27 09:42:28 1999 -->
<article>
<title>HOWTO HOWTO
</title>
<author>Mark F. Komarinski
</author>
<date>Aug 27, 1999
</date>
<abstract>Getting a new LDP author up and running with tools, ideas,
 and conventions used by the LDP
</abstract>
<toc>

   ʹ RTF  HTML ʽδҳʱеϢһҳ
   
   
  ½(Sections)
  
   Ϊ˽Ŀ¼һЩǡ  SGML е½(Sections)춴
   ͳеµĸж½ڣÿ½ڿ½ڣ½»
   ½ڡ
   
   ĵʹ½ڣ㽨١ԽָɶС
   ڡдʱġ
   
   ½ SGML ҪɶԳֵıǡҲ˵û </sect> 
    㲻ù½ڵıţSGML ʽʱԶġ
   
   ½ʹ <sect> Ϊʼġÿһ½ڿʼһ <sect> ǡ
   һ½ڱΪ 1
   
   ½ ( 1.1) ʹ <sect1> ǡҲ 1 ʼš
   
   ½ (1.1.1) ʹ <sect2> ǣҲ 1 ʼš
   
    SGML  <toc> ʱʼɨĵಿ֣е
   ½ڱǱŴĵĿ¼½ڱĿ¼(TOC)УȻᱻĵ
   ಿʹá½ (1.1.1)  TOC УܵĻᱻó
   ǿıʽ
   
  ׼
  
   дݶ HTMLһʹһ <p> ָһеĿʼSGML 
    TABո񡢿С SGML 鵽 <p> ʱʼһС
   </p> ǽö䡣
   
  ǿı
  
   żҪһЩıԲͬıҪб
   ǿıʹ <em>  </em> ǡбֿʹ <tt>  </tt> 
   
   
  б
  
    SGML ʽбһоб1ʼΪÿһб
   
   
    1. This is the first entry in the enumerated list.
    2. This is the second.
    3. Third.
       
   ϵĴ£
   
<enum>
<item>This is the first entry in the enumerated list.
<item>This is the second.
<item>Third.
</enum>


   <enum> ָбҪʼš
   
   һʽбÿһбǰֻһǻԲȦ
   
     * This is the first entry in the itemized list
     * This is the second
     * Third
       
   ϵĴ£
   
<itemize>
<item>This is the first entry in the itemized list
<item>This is the second.
<item>Third.
</itemize>

   ģ<item> ʽбжһ
   
   ʽбԼĶ
   
   LDP
          The Linux Documentation Project
          
   SGML
          Standard Generalized Markup Language
          
   ϵĴ£
   
<descrip>
<tag>LDP</tag>The Linux Documentation Project
<tag>SGML</tag>Standard
 Generalized Markup Language
</descrip>

   ʽͬǰ֣бڱ <descrip>  </descrip> У
   ÿһеÿһҲǶĶ <tag>  </tag> Сеʣ
   ಿǶԶĶ塣
   
  ı
  
   ʱҪȫʾдݣʹ <verb>  </verb> 
   䡣</verb> ֮ǰĿո񡢻سԼı(رַ)
   
   
¾ı

  ͳһԴλ(URL)
  
   SGML ҲͳһԴλ(URL)ע HTML ʽʱã
   ʽҲһЩã˵ RTF ʽ
   
   һ URL ûнǣϢ <url> 档һָ LDP
   ҳ URL [18]http://www.linuxdoc.org/ Ǵ룺
   
<url url="http://www.linuxdoc.org/" name="http://www.linuxdoc.org/">

   url="http://www.linuxdoc.org/" Ŀַ
   name="http://www.linuxdoc.org/" ʾڱһ
   ģҿԴһµ URL ǣ
   
<url url="http://www.linuxdoc.org/" name="LDP">

   ҳϵʾ [19]LDP.
   
  ο(References)
  
   URL ʺӵ LDP ĵ֮ݣʺӵĵΪʵ
   һܣʹ <label>  <ref> ǡ<label> Ǵһ
   תļǺţǳһǩ  <label> ܼ򵥡ҵҪת
   λãȻ£
   
<label id="Introduction">

   ѾĵдһתļǺ "Introduction"
   ǩȷʵĵĿͷҪתʱ£
   
<ref id="Introduction" name="here">

   SGML ׷һ "here" ӿת Introduction ½ڵλ
   
   
   οһ (indexing) LDP ĵǴĵ
   潨춵ʺ
   
  ַ(Special characters)
  
   ǳ HTMLַԷֹ SGML ͳ SGML 롣
   һ SGML бĿԲ sgmltools ûָϣ
   [20]http://www.sgmltools.org/guide/guide.html
   
     * Use &amp; for the ampersand (&)
     * Use &lt; for a left bracket (<)
     * Use &gt; for a right bracket (>)
     * Use &etago; for a left bracket with a slash (</)
     * Use &dollar; for a dollar sign ($)
     * Use &num; for a hash (#)
     * Use &percnt; for a percent (%)
     * Use &tilde; for a tilde (~)
     * Use `` and '' for quotes, or use &dquot for "
     * Use &shy; for a soft hyphen (that is, an indication that this is a
       good place to break a word for horizontal justification).
       
3.5 ʹд SGML

  LyX
  
   һֱʮϲ LyXƫṩִʹõķ
   ʽд SGMLһó򣬶üӦá
   
   Ҫ LyX һ LinuxDoc ĵزװӦóȷѰװ TeX
    sgmltools (μ [21]װ )Ȼ LyX ѡ "file->new
   from template..."ѡ "Templates" Ȼ linuxdoctemplate.lyx 
   㽫õһ LDP ĵͷϢĵģ塣ĺ(Ҳǣ
   д⡢ߡڡժҪȵ)ȻῪʼдϽǵ˵ѡ
   ݵ(׼б½)̾ǿıȿԵ
   ǿģʽҲѡıٵѡıΪǿı
    SGML Կ Insert ˵ҵ Բ URL
   Լ͵ݡĵᣬԱ LyX ʽȻ
    LinuxDoc õ .sgml ׺ļļԱ sgmlcheck 
   Ҫĸʽ
   
  Emacs
  
   Ҳʹ EmacsҲų Emacs ʹþ˻ǳá
   
   SGML 
  
   г֮ SGML ߣ߼ʹҵ汾ֻҪܱ
   LinuxDoc DTD  LDP ĵҡ
   
3.6 CVS 

   ΪֹLDP ûһֿɹ߱ĵݡǳϣ
   ı״кܶҪʹ CVS ԭ
   
    1. CVS һĵⲿݡ㽫ĵһʱ
       ֻҪ CVS ȡĵͿԼҪȡһĵڰ汾
       ҲԺܿõ
    2. ڶάͬһĵʱǳáԴ CVS ֪༭Ŀʱ
       Щ޸ģӶе޸ĺܺõؽһ
    3. ޸ĵļ¼ SGML ֮ǰʹһЩıǣ
       Щ¼(Լһʱ)ᱻԶز뵽ĵС
    4. ṩһ;ĵɲύͨһԶظ LDP վ㡣
       
3.7 ĵ

  ֮ǰ
  
   㽫ĵǧǱڶ֮ǰұһЩ顣
   
   ȣĵƴд顣ûʲƴд˾ڻ
   ˵٣ɵϡд SGML Ӧó(emacs
   LyX...)ƴд鹦ܡûУеlinuxа汾ж
   װһ ispell ͬҪʹ sgmltools е sgmlcheck 
   SGML ǡ
   
   ΣһЩĵ LDP ĵӦܱ֤ʵȷ
   ΪгǧLinuxûܻμһĽϴģ
   ʼббе˰㡣
   
   һĵվⲢǱģҵ
   ĵԭʼ
   
  Ȩ
  
   In order for an LDP document to be accepted by the LDP, it must be
   licensed to allow for free (as in beer) distribution and publishing.
   As an author, you may retain the copyright and add other restrictions
   (for example, you must approve any translations or derivative works).
   A sample license is available at
   [22]http://www.linuxdoc.org/COPYRIGHT.html. If you choose to use the
   boilerplate copyright, simply copy it into your source code under a
   section called "Copyright and Licenses" or similar. Also include a
   copyright statement of your own (since you still own it). If you are a
   new maintainer for an already-existing HOWTO, you must include the
   previous copyright statements of the previous author(s) and the dates
   they maintained that document.
   
   LDP
  
   һĵһ˿ǵͿԽĵ
   LDPʼ [23]ldp-submit@lists.linuxdoc.org 24Сʱ֮Ϳ
   ֪ǷѱܲҪ LDP վ㡣
   
4. ָ

   ⲢһдɫĵǿƺͿٵָϣд
   
     * Ҫ֪˵ʲᡣ
     * ڿܵĵطʹӡ˿˵ʲᡣ
     * ֯Ҫͬһ½Уȥ
       
   Դµַõ LDP ָϣ
   [24]http://www.linuxdoc.org/HOWTO/LDP-Style-Guide.html.
   
5.  LDP ĳ

5.1 Ϊ LDP һҸȥ

   򵥵İ취ҳһЩȻдҲԲûά HOWTO Ȼ
   Ƿһ˽Լдȥ
   
5.2  LDP ĵLDP ĵ涨ģ

    [25]http://www.linuxdoc.org/COPYRIGHT.html.
   
5.3 һ LDP ĵҵһ

   ϵĵߣ LDP ֯ߣǴڵԼ

References

   1. mailto:markk@cgipc.com
   2. mailto:softsprite@yeah.net
   3. mailto:markk@cgipc.com
   4. http://www.cgipc.com/~markk
   5. http://www.linuxdoc.org/
   6. ftp://prep.ai.mit.edu/pub/GNU/COPYING
   7. http://www.sgmltools.org/
   8. http://www.lyx.org/
   9. http://www.devel.lyx.org/~ettrich/klyx.html
  10. mailto:markk@cgipc.com
  11. mailto:linux-howto@metalab.unc.edu
  12. mailto:ldp-discuss@lists.linuxdoc.org
  13. mailto:ldp-discuss-request@lists.linuxdoc.org
  14. mailto:ldp-discuss-request@lists.linuxdoc.org
  15. http://www.sgmltools.org/
  16. http://www.debian.org/Packages/stable/text/sgml-tools.html
  17. file://localhost/tmp/zh-sgmltools.31452/HOWTO-HOWTO.txt.html#Introduction
  18. http://www.linuxdoc.org/
  19. http://www.linuxdoc.org/
  20. http://www.sgmltools.org/guide/guide.html
  21. file://localhost/tmp/zh-sgmltools.31452/HOWTO-HOWTO.txt.html#tools
  22. http://www.linuxdoc.org/COPYRIGHT.html
  23. mailto:ldp-submit@lists.linuxdoc.org
  24. http://www.linuxdoc.org/HOWTO/LDP-Style-Guide.html
  25. http://www.linuxdoc.org/COPYRIGHT.html
