LDP Author Guide

Mark F. Komarinski

VA Linux Systems

markk@linuxdoc.org

Jorge Godoy

Conectiva S.A. <http://www.conectiva.com>
Publishing Department

godoy@conectiva.com

godoy@metalab.unc.edu

David C. Merrill

dcmerrill@mindspring.com

Revision History                                                       
Revision 3.5          Dec 4, 2000           Revised by: mfk            
Changed mailing list pointers to new lists.                            
Revision 3.4          Dec 1, 2000           Revised by: dcm            
Added Crediting Translators and Converters                             
Revision 3.3          Nov 11, 2000          Revised by: mfk            
Added links to SGML GPL and FDL                                        
Revision 3.1          Oct 10, 2000          Revised by: mfk            
Spelling changes, changed list of LDP policies to now accept DocBook   
XML. More information about how to use *jade with XML will follow.     
Revision 3.0          Aug 24, 2000          Revised by: gjf            
Integrated David Merrill's style guide document. Further clean-up and  
additions.                                                             
Revision 2.0          Jul 13, 2000          Revised by: mfk            
Cleaned up using-docbook a bit. Moved some chapters                    
Revision 1.9          Jun 26, 2000          Revised by: mfk            
Integrated Jorge's using-docbook document.                             
Revision 1.5          Jun 14, 2000          Revised by: mfk            
Documented sgedit                                                      
Revision 1.4          Jun 12, 2000          Revised by: mfk            
Documented vim and sgedit. Spelling and other changes from ldp list.   
Also added LDP guidelines under style guide.                           

LDP 暥彂偺嶌惉幰偑夣揔偵暥彂傪嶌惉偡傞偨傔偺僣乕儖傗庤弴丄偍傛傃僸儞僩
傪丄儕僗僩傾僢僾偟傑偟偨丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Table of Contents
1. 偙偺暥彂偵偮偄偰
   
    1.1. 偙偺暥彂偺栚揑偲幩掱
    1.2. LDP 偵偮偄偰
    1.3. 僼傿乕僪僶僢僋
    1.4. 挊嶌尃偲彜昗
       
        1.4.1. 擔杮岅栿偵偮偄偰
       
    1.5. 幱帿
    1.6. 偙偺暥彂偺昞婰朄
   
2. LDP 偲 SGML 偺徯夘
   
    2.1. LDP
    2.2. SGML
    2.3. 側偤 HTML 偱側偔丄SGML 側偺偐丠
    2.4. SGML 偼 XML 偠傖側偄
    2.5. 弶傔偰婑峞偡傞曽傊
    2.6. 儊乕儕儞僌儕僗僩
   
3. 暥彂嶌惉僣乕儖
   
    3.1. DSSSL
       
        3.1.1. Norman Walsh DSSSL
        3.1.2. LDP DSSSL
       
    3.2. DocBook DTD (version 4.1 偐 3.1)
    3.3. Jade
       
        3.3.1. Jade
           
            3.3.1.1. Jade 傪巊偆
            3.3.1.2. XML 儌乕僪偺 Jade
           
        3.3.2. OpenJade
       
    3.4. Jade wrappers
       
        3.4.1. sgmltools-lite
        3.4.2. Cygnus DocBook Tools
           
            3.4.2.1. Cygnus Tools 偺巊偄曽
           
    3.5. 曇廤僣乕儖
       
        3.5.1. Emacs (PSGML)
           
            3.5.1.1. PSGML 傪巊偭偰 SGML 傪彂偔曽朄
           
        3.5.2. VIM
           
            3.5.2.1. 偼偠傔偵
            3.5.2.2. 怴婯暥彂偺儘乕僪傕偟偔偼嶌惉
           
        3.5.3. WordPerfect 9 (Corel Office 2000)
        3.5.4. sgedit
        3.5.5. nedit
           
            3.5.5.1. nedit 偺巊偄曽
            3.5.5.2. nedit 偺 Tips 偲僐僣
           
    3.6. CVS
       
        3.6.1. CVS 傾僇僂儞僩偺擖庤
        3.6.2. 偦傟埲奜偺 CVS 儕億僕僩儕傊偺傾僋僙僗曽朄
           
            3.6.2.1. 摻柤 CVS 傾僋僙僗
            3.6.2.2. Web 宱桼偱偺 CVS 僼傽僀儖
            3.6.2.3. 僌儔僼傿僇儖僀儞僞乕僼僃僀僗傪巊偆
           
        3.6.3. 僼傽僀儖偺峏怴偲 CVS
       
    3.7. 偦偺懠偺僣乕儖偲儕僼傽儗儞僗
       
        3.7.1. DocBook: The Definitive Guide
        3.7.2. SGML 僥儞僾儗乕僩
        3.7.3. Aspell
        3.7.4. ispell
       
4. DocBook 僞僌偺巊偄曽
   
    4.1. 偼偠傔偵
    4.2. 昁梫側愝掕
    4.3. 僇僞儘僌偺嶌惉偲廋惓
       
        4.3.1. 梡岅偺愢柧
        4.3.2. 僇僞儘僌忋偱偺曋棙側僐儅儞僪
       
    4.4. DocBook 僄儗儊儞僩偺巊偄曽
       
        4.4.1. 曋棙側僐儅儞僪
       
    4.5. 嶕堷傪偮偔傞
    4.6. 夋憸偺憓擖
       
        4.6.1. 忋婰埲奜偺曽朄
       
    4.7. 昞慻
    4.8. 僾儘僌儔儉僐乕僪偲僐儊儞僩
    4.9. 東栿幰傗僐乕僪曄姺幰偺巵柤傪昞帵偡傞
       
        4.9.1. <othercredit> 僞僌
        4.9.2. "幱帿" (Acknowledgements) 偺復偵偮偄偰
        4.9.3. <revremark> 僞僌
       
    4.10. 僣乕儖偲僸儞僩
       
        4.10.1. 僜乕僗偺僐儞僷僀儖
        4.10.2. article 偺嵟弶偺儁乕僕偵梫巪傪憓擖偡傞
        4.10.3. 嶕堷傪帺摦揑偵憓擖偡傞
        4.10.4. 暥彂偺拞偺壓彂偒晹暘傪塀偡
        4.10.5. 昿斏偵棙梡偡傞暥彂傪奜晹偐傜庢傝崬傓
       
    4.11. 暥彂偺僒儞僾儖
       
        4.11.1. article 偺椺
        4.11.2. book 偺椺
       
5. LDP 僗僞僀儖丒僈僀僪
   
    5.1. 庡戣傪寛傔傞
    5.2. 傾僂僩儔僀儞傪嶌惉偡傞
    5.3. 暥復傪彂偔
    5.4. 僥僉僗僩偺悇澣偲峑惓
    5.5. 嶌惉偟偨 HOWTO 偺娗棟
    5.6. 儕僼傽儗儞僗
   
6. 僗僞僀儖娭楢帠崁偺曗懌
   
    6.1. 擔晅偺彂偒曽
    6.2. 夋憸僼僅乕儅僢僩
    6.3. DocBook 偺僶乕僕儑儞
    6.4. 棙梡嬛巭偺僞僌
    6.5. 僞僌偺嵟彫壔
    6.6. 暥彂撪偱偺昞婰朄
   
7. DocBook 偺僥僋僯僢僋偲僐僣
   
    7.1. 夋憸偺憓擖
    7.2. HTML 弌椡僼傽僀儖偺僼傽僀儖柤傪巜掕偡傞
    7.3. ldp.dsl 傪巊偆
   
8. 暥彂偺岞奐偵偮偄偰
   
    8.1. 暥彂岞奐偺傑偊偵
       
        8.1.1. SGML 僐乕僪偺懨摉惈専嵏
       
    8.2. 挊嶌尃偲儔僀僙儞僗偺栤戣
    8.3. LDP 傊偺婑峞
    8.4. 嶌惉偟偨暥彂偺娗棟
   
9. LDP 偵偮偄偰偺 FAQ
梡岅廤
Index

List of Tables
4-1. 曋棙側僐儅儞僪
4-2. 昞偺椺

List of Figures
3-1. sgedit 偺僗僋儕乕儞僔儑僢僩
3-2. nedit 偺僗僋儕乕儞僔儑僢僩
3-3. nedit 傊偺僔僃儖僐儅儞僪偺捛壛
3-4. 僄儔乕偑側偄応崌偺 nsgml 偺弌椡

List of Examples
4-1. 僇僞儘僌偺椺
4-2. 嶕堷惗惉偺偨傔偺僐乕僪
4-3. 懏惈 zone 偺巊偄曽
4-4. 懏惈 class 偱丄抣 startofrange 偲 endofrange 傪巊偆曽朄
4-5. 夋憸偺憓擖
4-6. <imageobject>偺巊偄曽
4-7. 昞偺憓擖
4-8. compiles-sgml 僗僋儕僾僩
4-9. article 偱丄帺摦揑偵梫巪傪憓擖偡傞偨傔偺 stylesheet 偺愝掕
4-10. 嶕堷傪晅偗傞偨傔偵奜晹僄儞僥傿僥傿傪愝掕偡傞
4-11. 僷儔儊乕僞丒僄儞僥傿僥傿傪巊偆

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 1. 偙偺暥彂偵偮偄偰

1.1. 偙偺暥彂偺栚揑偲幩掱

偙偺暥彂偺嶌惉偼丄1999擭8寧26擔丄Mark F. Komarinski 偑暥彂嶌惉僣乕儖傪
摦偐偡偺偵 2 擔傕偐偐偭偨偙偲偵僀儔偮偄偨偺偑偒偭偐偗偱偟偨丅偙偺暥彂偑
偨偲偊堦恖偱傕 LDP 挊幰偺栶偵棫偭偨偲偟偨傜丄傢偨偟偺柋傔偼壥偨偝傟傑偡
丅

偙偺暥彂偺嵟怴僶乕僕儑儞偼丄LDP 偺儂乕儉儁乕僕 http://www.linuxdoc.org
<http://www.linuxdoc.org/> 偵偁傝傑偡丅僆儕僕僫儖偺 DocBook SGML 僼僅乕
儅僢僩傗丄偦偺懠 HTML 摍偺僼僅乕儅僢僩傕偦偙偵偁傝傑偡丅

幚嵺偵僐乕僪傪彂偐偢偲傕丄Linux 儉乕僽儊儞僩偵峷專偡傞曽朄偼偨偔偝傫偁
傝傑偡丅廳梫側傕偺偺傂偲偮偑丄暥彂傪彂偔偙偲偱偡丅偦傟偵傛偭偰屄乆恖偑
悽奅拞偺柍悢偺恖乆偲抦幆傪嫟桳偡傞偙偲偑偱偒傑偡丅偙偺暥彂偼丄撉幰偵
LDP 偺妶摦撪梕傪棟夝偟偰傕傜偄丄帺暘偱 HOWTO 傪彂偔嵺偵昁梫側僣乕儖偵偮
偄偰抦偭偰傕傜偆偨傔偵嶌惉偝傟偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.2. LDP 偵偮偄偰

        Linux Documentation Project 偼丄GNU / Linux 僆儁儗乕僥         
        傿儞僌僔僗僥儉偵偮偄偰偺椙幙偱僼儕乕側暥彂傪奐敪偡傞偨         
        傔偵妶摦偟偰偄傑偡丅LDP 偺嵟戝偺栚揑偼丄Linux 偵娭偡傞         
        偡傋偰偺帠暱偺暥彂壔傪丄嫟摨偱墴偟恑傔傞偙偲偱偡丅             
        HOWTO 傗 Guide 偺嶌惉偼偙傟偵偁偨傝傑偡丅偝傜偵傢傟傢傟        
        偼丄娙扨偵棙梡偲専嶕偑偱偒傞暥彂僔僗僥儉傪峔抸偟偨偄偲         
        峫偊偰偄傑偡丅man 儁乕僕傗 info 暥彂丄HOWTO 偦偺懠偺摑         
        崌偼偙傟偵偁偨傝傑偡丅                                         
                                                                       
     --LDP 儅僯僼僃僗僩: http://www.linuxdoc.org/manifesto.html        

偙偺屻偵偼偩偄偨偄師偺傛偆側偙偲偑彂偄偰偁傝傑偡丅乽LDP 偱偼儃儔儞僥傿
傾偑戝惃廤傑偭偰 Linux OS 梡偺暥彂傪嶌偭偰偄傞丅堦斣栚棫偮偺偑 HOWTO 偱
丄HOWTO 偼 http://www.linuxdoc.org/ 偵偁傞丅乿偙偺暥彂 (LDP Author
Guide) 偺庡側栚揑偼丄帺暘偱 HOWTO 傪彂偄偰 LDP 偵婑峞偡傞曽朄傪愢柧偡傞
偙偲偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.3. 僼傿乕僪僶僢僋

偙偺暥彂傊偺僐儊儞僩偼丄挊幰 (<markk@linuxdoc.org>) 傑偱偍婅偄偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.4. 挊嶌尃偲彜昗

Copyright 1999-2000 Mark F. Komarinski, David C. Merrill, Jorge Godoy

偙偺暥彂偼丄埲壓偺忦審傪庣傞尷傝丄慡晹偁傞偄偼堦晹傪柍椏偱暋惢偱偒傑偡
丅

 丒 慡懱傕偟偔偼晹暘傪暋惢偡傞応崌丄忋婰挊嶌尃昞帵偲偙偺棙梡忦審偲偑丄
    偦傟傜偺暋惢忋偵姰慡側宆偱曐帩偝傟傞偙偲丅
   
 丒 東栿傕偟偔偼擇師揑挊嶌暔傪嶌惉偟偨応崌丄攝晍偵愭棫偪丄挊幰偵楢棈偟
    偰彸擣傪摼傞偙偲丅
   
 丒 偙偺暥彂偺堦晹偺傒傪攝晍偡傞応崌丄偦偺攝晍暔偵偼丄暥彂慡懱偺擖庤偑
    壜擻偱偁傞偙偲傪柧婰偟丄暥彂慡懱偺擖庤曽朄傪昞帵偡傞偙偲丅
   
 丒 偙偺暥彂偺嬐偐側晹暘傪丄斸昡傗愢柧偺嵽椏偲偟偰懠偺挊嶌暔偵揮嵹偡傞
    嵺偼丄偦偺堷梡偑惓摉側傕偺偱偁傞応崌偵尷傝丄偙偺棙梡忦審偺婰嵹傪徣
    棯偱偒傞丅妛弍栚揑偱偺棙梡偵偮偄偰偼丄偙偺棙梡忦審偺揔梡椺奜偲側傞
    応崌偑偁傞偺偱丄挊幰傑偱楢棈偟偰恞偹傞偙偲丅偙傟傜偺惂尷偼丄挊幰偲
    偟偰偺傢傟傢傟偺尃棙傪庣傞偨傔偺傕偺偱偁偭偰丄嫵堢幰傗妛廗幰偵惂尷
    傪壽偡偙偲傪堄恾偟偰偄側偄丅 (偙偺暥彂偺嶌惉僼僅乕儅僢僩偱偁傞 SGML
    僐乕僪傪彍偄偨) 偙偺暥彂撪偺偡傋偰偺僜乕僗僐乕僪偵偼丄GNU General
    Public License 偑揔梡偝傟傞丅嵍婰儔僀僙儞僗偼丄摻柤 FTP 宱桼偱丄GNU
    傾乕僇僀僽偐傜擖庤壜擻偱偁傞丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.4.1. 擔杮岅栿偵偮偄偰

JF Project <JF@linux.or.jp>

東栿愮扷桾巌 <ysenda@pop01.odn.ne.jp >

峑惓嫬恀懢榊 <s_sakai@mxn.mesh.ne.jp >

偙偺擔杮岅栿傕丄忋婰偵廬偭偰攝晍偟偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.5. 幱帿

偙偺暥彂偺嶌惉偵偁偨傝丄僐儊儞僩傪偄偨偩偄偨偡傋偰偺恖乆丄 David
Lawyer, Deb Richardson, Daniel Barlow, Greg Ferguson, Mark Craig, 偦偺
懠偺 <ldp-discuss@lists.linuxdoc.org> 儊乕儕儞僌儕僗僩偺儊儞僶乕偵姶幱
偟傑偡丅HOWTO Index <http://www.linuxdoc.org/HOWTO/> 偲 sgmltools 偺暥
彂偐傜偼丄偄偔偮偐偺僙僋僔儑儞傪敳悎偝偣偰偄偨偩偒傑偟偨丅CVS 傊偺僱僢
僩儚乕僋傾僋僙僗偵娭偡傞僙僋僔儑儞偺堦晹偼丄Serek
(<ser@serek.arch.pwr.wror.pl>)偑彂偄偰偄傑偡丅 DocBook 偵娭偡傞僙僋僔儑
儞偼丄Jorge Godoy (<godoy@conectiva.com>) 偑彂偒傑偟偨丅擇恖偺嫤椡偵戝
曄姶幱偟偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

1.6. 偙偺暥彂偺昞婰朄

偙偺暥彂偼丄埲壓偺昞婰朄傪巊梡偟偰偄傑偡丅 [1]

愢柧                                      昞婰                    
寈崘                                      劇劅劅劅劅劅劅劅劅劅劅劉
                                          劆      Caution       劆
                                          劌劅劅劅劅劅劅劅劅劅劅劎
                                          劆寈崘暥丅            劆
                                          劋劅劅劅劅劅劅劅劅劅劅劊
僸儞僩                                        Tip: 僸儞僩丅       
                                                                  
拲堄                                          Note: 拲堄暥丅      
                                                                  
摿偵拲堄偡傋偒忣曬                        劇劅劅劅劅劅劅劅劅劅劅劉
                                          劆      Warning       劆
                                          劌劅劅劅劅劅劅劅劅劅劅劎
                                          劆摿偵廳梫側寈崘暥丅  劆
                                          劋劅劅劅劅劅劅劅劅劅劅劊
僼傽僀儖柤                                file.extension          
僨傿儗僋僩儕柤                            directory               
擖椡僐儅儞僪                              command                 
傾僾儕働乕僔儑儞柤                        application             
bash 偱偺儐乕僓僐儅儞僪偺僾儘儞僾僩       bash$                   
bash 偱偺儖乕僩儐乕僓僐儅儞僪偺僾儘儞僾僩 bash#                   
tcsh 偱偺儐乕僓僐儅儞僪偺僾儘儞僾僩       tcsh$                   
娐嫬曄悢                                  VARIABLE                
嫮挷偝傟偨扨岅                            word                    
僒儞僾儖僐乕僪                            僷儔僌儔僼偺嵟弶偲嵟屻丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 2. LDP 偲 SGML 偺徯夘

2.1. LDP

Linux Documentation Project (LDP) 偑僗僞乕僩偟偨偺偼丄弶怱幰偑丄摿掕偺
懳徾偵偮偄偰偺忣曬傪偡偽傗偔尒偮偗傞偙偲偑偱偒傞傛偆偵偡傞偨傔偱偟偨丅
LDP 偵偼丄僔僗僥儉娗棟傗僱僢僩儚乕僋丄僾儘僌儔儈儞僌偵偮偄偰偺堦楢偺暥
彂偩偗偱側偔丄屄暿偺暘栰傪懳徾偲偟偰丄偦傟傪巊偭偨偙偲偑偁傞恖偑彂偄偨
傕偭偲嵶偐偄帠暱偵娭偡傞暥彂傕柍悢偵偁傝傑偡丅報嶞偵偮偄偰抦傝偨偄側傜
丄Printing-HOWTO <http://www.linuxdoc.org/HOWTO/Printing-HOWTO.html>, (
擔杮岅栿 <http://www.linux.or.jp/JF/JFdocs/Printing-HOWTO.html>) 偑偁傝
傑偡偟丄庤帩偪偺僀乕僒僱僢僩僇乕僪偑 Linux 偱巊偊傞偐抦傝偨偄偲偒偼丄
Ethernet HOWTO <http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html>, (擔
杮岅栿 <http://www.linux.or.jp/JF/JFdocs/Ethernet-HOWTO.html>) 傪尒傟偽
偩偄偨偄暘偐傝傑偡丅偼偠傔偺崰丄偙偆偟偨暥彂偼丄僥僉僗僩偐 HTML 偱彂偐
傟偰偄傑偟偨偑丄偦偺偆偪丄暥彂傪傕偭偲忋庤偵娗棟偡傞昁梫偑惗偠偰偒傑偟
偨丅偨偲偊偽丄僂僃僽儁乕僕忋偱墈棗偟偨傝丄CD-ROM 忋偐傜傗丄偝傜偵偼僴儞
僪丒僿儖僪偺 PDA 忋偱僥僉僗僩僼傽僀儖偲偟偰撉傔傞傛偆偵偟偨偄偲偄偭偨偙
偲偱偡丅嵟廔揑偵丄偙偺栤戣傪夝寛偟偨偺偑丄SGML 偱偟偨丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

2.2. SGML

SGML (Standard General Markup Language) 偼丄暥彂撪偵僐乕僪傪杽傔崬傓偙
偲偱惉傝棫偭偰偄傞尵岅偱偡丅偦偺堄枴偱偼丄HTML 偲椶帡偟偰偄傑偡偑丄椶帡
揰偼偦傟偩偗偱偡丅SGML 偺僷儚乕偼丄WYSIWYG (What You See Is What You
Get) 偲堘偭偰丄怓傗僼僅儞僩僒僀僘傗偁傞庬偺宍幃側偳傪掕媊偡傞傢偗偱偼側
偄偲偄偆偲偙傠偵偁傝傑偡丅偦偺戙傢傝丄(僷儔僌儔僼傗僙僋僔儑儞丄斣崋晅偒
儕僗僩側偳偺) 僄儗儊儞僩(element)傪掕媊偟偰偍偄偰丄SGML 張棟宯傗屻張棟
梡僾儘僌儔儉偵斉慻傗怓丄僼僅儞僩側偳傪擟偣偰偟傑偄傑偡丅HTML 偱傕摨偠偙
偲傪偟偰偄傑偡偑丄 HTML 偼幚嵺偺偲偙傠 SGML 偺僒僽僙僢僩偱偡丅

SGML 偼丄暥彂偺惗惉偺偨傔偵丄杮幙揑偵 3 偮偺晹暘偐傜惉傝棫偭偰偄傑偡丅1
偮栚偼丄峔憿 (Structure) 偱丄偙傟偼丄捠忢丄DTD 偲偐暥彂宆掕媊 (Document
Type Definition) 偲傛偽傟偰偄傑偡丅 DTD 偱偼丄屄乆偺僄儗儊儞僩
(element) (傕偟偔偼僞僌(tag)) 偺娭學偑掕媊偝傟偰偄傑偡丅偙偺暥彂傪彂偔
偺偵巊偭偰偄傞 DocBook 偼偦偺傂偲偮偱偡丅DTD 偼丄暥彂偺撪梕偱偁傞僐儞僥
儞僩 (content) 偑廬偆傋偒儖乕儖偺売忦彂偒偱偡丅2 偮栚偼丄DSSSL 傕偟偔偼
丄Document Style Semantics and Specification Language 偱偡丅DSSSL 偼丄
暥彂傪儗儞僟儕儞僌偡傞僾儘僌儔儉偵懳偟偰丄SGML 傪恖娫偑撉傔傞宍幃偵偡傞
嵺偺傗傝曽傪巜帵偟傑偡丅偨偲偊偽丄RTF 僼僅乕儅僢僩偵偟偨偄応崌偼丄
<title> 僞僌傪 14 億僀儞僩偺儃乕儖僪懱偵偡傞傛偆儗儞僟儕儞僌僾儘僌儔儉
偵巜帵偟丄 HTML 偵偡傞応崌偵偼丄偦傟傪 <h1> 偵曄姺偡傞傛偆偵巜帵偟傑偡
丅嵟屻偵丄暥彂偺撪梕偱偁傞僐儞僥儞僩 (Content) 偑偁傝丄偙傟偼 SGML 張棟
宯偵傛偭偰儗儞僟儕儞僌偝傟傞懳徾暔偱偁傝丄嵟廔揑偵儐乕僓偑栚偵偡傞晹暘
偱偡丅偨偲偊偽丄偙偺僷儔僌儔僼偼丄傕偪傠傫僐儞僥儞僩偱偡偑丄夋憸傗昞丄
斣崋晅偒儕僗僩側傫偐傕僐儞僥儞僩偱偡丅僐儞僥儞僩偼丄僞僌 (tag) 偱埻傑傟
偰丄屄暿偺僄儗儊儞僩偲偟偰嬫暿偝傟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

2.3. 側偤 HTML 偱側偔丄SGML 側偺偐丠

SGML 偼丄暥彂偺僼僅乕儅僢僩傪曄姺偡傞偩偗偱偼偁傝傑偣傫丅嶕堷傗栚師丄暥
彂偺撪奜傊偺儕儞僋傕帺摦揑偵惗惉偱偒傑偡丅Jade 傗 OpenJade 僷僢働乕僕
(埲屻偼丄儗儞僟儔乕偲屇傃傑偡) 傪巊偊偽丄SGML 傪 LaTeX 傗 info丄僥僉僗
僩丄 HTML丄RTF 偵傕曄姺偱偒傑偡丅偙偆偟偨婎杮僼僅乕儅僢僩偐傜丄MS Word
傗 PostScript, PDF 側偳偺僼僅乕儅僢僩偺暥彂傪嶌傞偙偲傕偱偒傑偡偟丄LyX
偺傛偆側僾儘僌儔儉傪巊偊偽丄TeX 僼僅乕儅僢僩偱暥彂傪彂偄偰丄偦偺屻偱
SGML 偵曄姺偟丄SGML 偐傜岲偒側僼僅乕儅僢僩偵儗儞僟儕儞僌偱偒傑偡丅偮傑
傝丄SGML 偼丄暥彂偺尒偨栚偵偼娭怱偑側偔丄傕偭傁傜僄儗儊儞僩偺婡擻偵拲栚
偟偰偄傑偡丅偙偺揰偐傜惗偠傞戝偒側堘偄偼丄僷儔僌儔僼偺埵抲傗僼僅儞僩僒
僀僘丄僼僅儞僩僞僀僾側偳偱擸傑側偔偰傕偄偄偺偱丄暥彂傪彂偔僗僺乕僪偑忋
偑傞偲偄偆偙偲偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

2.4. SGML 偼 XML 偠傖側偄

嵟嬤偼 XML 傪巊偄偨偄偲偄偆梫朷偑懡偄偺偱丄DocBook 偱偼 XML 偑僒億乕僩
偝傟偰偄傑偡丅DocBook 偼丄堦掕偺奒憌峔憿傪帩偭偨儅乕僋傾僢僾僞僌偺廤傑
傝偱偡丅 XML DocBook v4.1.2 偼丄尰嵼 LDP 偱惓幃偵僒億乕僩偝傟偰偄傑偡丅
SGML 偵偮偄偰偼婛偵抦偭偰偄偰丄XML 傪巊偄偨偄応崌偼丄師偺偙偲偵拲堄偟偰
偔偩偝偄丅 (埲壓偼丄乽DocBook: The Definitive Guide乿偐傜攓庁偟傑偟偨
丅)

 丒 偡傋偰偺 XML 儅乕僋傾僢僾偼丄戝暥帤彫暥帤傪嬫暿偡傞丅偁傜備傞僄儗儊
    儞僩柤丄傾僩儕價儏乕僩柤丄僄儞僥傿僥傿柤偼丄彫暥帤偱側偗傟偽側傜側
    偄丅偙偺揰偱丄SGML 偲偼堎側傞丅
   
 丒 偡傋偰偺傾僩儕價儏乕僩偼丄僔儞僌儖僋僆乕僩 (') 偐丄僟僽儖僋僆乕僩
    (") 偱埻傑傟側偗傟偽側傜側偄丅
   
 丒 嬻僄儗儊儞僩 (偨偲偊偽丄xref) 偼丄/: <xref/> 偱廔椆偟側偗傟偽側傜側
    偄丅
   
 丒 僞僌偺抁弅 (</>) 偼僒億乕僩偟側偄丅偙傟偼 LDP 偵偍偄偰傕丄 SGML 撪
    偱巊梡偡傞偙偲偼悇彠偝傟偰偄側偄丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

2.5. 弶傔偰婑峞偡傞曽傊

傕偟丄LDP 偼弶傔偰偱丄峏怴偝傟偰偄側偄 HOWTO 偺娗棟傪偟偨傝丄怴婯偵
HOWTO 傪彂偄偨傝偟傛偆偲巚偭偨応崌偼丄<discuss@linuxdoc.org> 偺 HOWTO
僐乕僨傿僱乕僞偵楢棈偟偰偔偩偝偄丅偙傟偼丄扤偑偳偺暥彂傪扴摉偟偰偄傞偺
偐 HOWTO 僐乕僨傿僱乕僞偵暘偐傞傛偆偵偡傞偨傔偱偡丅

偙傟偑廔傢傞偲丄岲偒側僼僅乕儅僢僩偱暥彂傪彂偄偰丄偦偺僪儔僼僩傪
<submit@linuxdoc.org> 偵憲偭偰偄偨偩偒傑偡丅 LDP 偺儃儔儞僥傿傾偑偦傟傪
峑惓偟偰丄悢擔拞偵儃儔儞僥傿傾偐傜憪峞偲僐儊儞僩偑曉偭偰偒傑偡偺偱丄偦
傟傜偺僐儊儞僩傪暥彂偵斀塮偝偣偰丄崱搙偼 LDP 傊偺嵟廔峞偲偟偰嵞搙
ldp-submit 儊乕儕儞僌儕僗僩偵怴僶乕僕儑儞傪搳峞偟傑偡丅

偙偺帪揰偱丄暿偺儃儔儞僥傿傾偑搳峞偝傟偨暥彂傪 DocBook 宍幃偵曄姺偟偰丄
姰惉偝傟偨 DocBook 暥彂偲偟偰庤尦偵憲傜傟偰偒傑偡丅偙偙偐傜愭丄LDP 傊偺
搳峞偼偡傋偰 DocBook 宍幃偵側傝傑偡丅儅乕僋傾僢僾偵偮偄偰媈栤偑偁傟偽丄
曄姺傪扴摉偟偨儃儔儞僥傿傾偵暦偔偐丄LDP DocBook 儊乕儕儞僌儕僗僩偱幙栤
偟偰偔偩偝偄丅

偼偠傔偐傜 DocBook 宍幃偱彂偒巒傔傞応崌偼丄嶲峫偵側傞僥儞僾儗乕僩偑偨偔
偝傫偁傝傑偡丅

 丒 http://www.linuxdoc.org/authors/template-ld/
    big-howto-template-ld.sgml <http://www.linuxdoc.org/authors/
    template-ld/big-howto-template-ld.sgml> - Stein Gojen 偑彂偄偨偙偺
    僥儞僾儗乕僩偼丄LinuxDoc 宍幃偱彂偔偲偒偺傕偺偱偡丅
   
 丒 http://www.linuxdoc.org/authors/template/big-howto-template.sgml
    <http://www.linuxdoc.org/authors/template/big-howto-template.sgml>
    - 偙偺僥儞僾儗乕僩傕 Stein 偑嶌偭偨傕偺偱偡偑丄忋婰傛傝傕偢偭偲戝偒
    偔偰暋嶨偵側偭偰偄傑偡丅偙傟偼丄DocBook 偺朙晉側婡擻傪妶梡偟偨傕偺
    偱偡丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

2.6. 儊乕儕儞僌儕僗僩

儊乕儕儞僌儕僗僩偑偄偔偮偐偁傞偺偱丄搊榐偡傟偽 LDP 偺妶摦偵嶲壛偱偒傑偡
丅傑偢丄<discuss@linuxdoc.org> 偼丄LDP 偺拞怱揑側儊乕儕儞僌儕僗僩偱丄搊
榐偡傞偵偼丄subject 棑偵 "subscribe" 偲彂偄偨儊乕儖傪
<discuss-subscribe@linuxdoc.org> 偵偍憲傝偔偩偝偄丅搊榐傪庢傝徚偡応崌偼
丄subject 棑偵 "unsubscribe" 偲彂偄偨儊乕儖傪
<discuss-unsubscribe@linuxdoc.org> 傑偱憲偭偰偔偩偝偄丅

懠偵傕丄<docbook@linuxdoc.org> 儊乕儕儞僌儕僗僩偼丄儅乕僋傾僢僾傗丄
DocBook 帺懱偵娭偡傞幙栤傪偡傞偲偙傠偱偡丅摿掕偺儅乕僋傾僢僾僞僌偱崲偭
偨偲偒偼丄偙偙偵幙栤傪憲偭偰曉帠傪懸偭偰偔偩偝偄丅 DocBook 儊乕儕儞僌儕
僗僩偵搊榐偡傞偵偼丄"subscribe" 偲彂偄偨儊乕儖傪
<docbook-subscribe@linuxdoc.org> 偵偍憲傝偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 3. 暥彂嶌惉僣乕儖

偙偺僙僋僔儑儞偱偼丄LDP 暥彂傪嶌惉偡傞偺偵昁梫側僣乕儖傗曋棙側僣乕儖傪
偄偔偮偐徯夘偟傑偡丅偙偙偱偼丄僀儞僗僩乕儖曽朄偲僣乕儖偺奣梫傪愢柧偟偰
丄徻偟偄巊偄曽偼屻偱夝愢偡傞偙偲偵偟傑偡丅傕偟偁側偨偑偙偙偵偁傞傕偺埲
奜偺僣乕儖傪巊偭偰 LDP 暥彂傪偍彂偒偺応崌丄偙偺僙僋僔儑儞偱愰揱偟傑偡偺
偱丄惀旕偦偺僣乕儖傪偍抦傜偣偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.1. DSSSL

捠忢偺 Walsh 僶乕僕儑儞偺 DSSSL 偑昁梫偱丄偦偺僆僾僔儑儞偲偟偰 LDP 偺
DSSSL 偑偁傝傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.1.1. Norman Walsh DSSSL

http://nwalsh.com/docbook/dsssl/ <http://nwalsh.com/docbook/dsssl/>

DSSSL (Document Style Semantics and Specification Language) 偼丄偳偆偄
偆曽朄偱 SGML 暥彂傪報嶞傗僆儞儔僀儞梡偺暥彂偵偡傞偐傪 jade 偵巜帵偡傞
傕偺偱偡丅偨偲偊偽丄DSSSL 偵廬偭偰丄title 僞僌偑丄HTML 偱偼 <H1> 僞僌偵
曄姺偝傟丄RTF 偱偼 14 億僀儞僩偺 Times Roman 儃乕儖僪懱偵曄姺偝傟傑偡丅
DSSSL 偵娭偡傞暥彂傕忋婰偵偁傝傑偡丅DSSSL 傪廋惓偡傞偙偲偼丄 DocBook 帺
懱傪廋惓偡傞偙偲偵偼側傜側偄揰偵拲堄偟偰偔偩偝偄丅儗儞僟儕儞僌偝傟偨僥
僉僗僩偺尒塰偊傪曄偊偰偄傞偵偡偓傑偣傫丅LDP 偱偼丄師偺廋惓偝傟偨 DSSSL
傪巊偭偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.1.2. LDP DSSSL

http://www.linuxdoc.org/authors/tools/ldp.dsl <http://www.linuxdoc.org/
authors/tools/ldp.dsl>

LDP DSSSL 偼丄(忋婰偺) Norman Walsh 僶乕僕儑儞偺 DSSSL 偑偁傞偙偲傪慜採
偵偟偰丄栚師側偳傪惗惉偡傞偨傔偵庒姳偺曄峏傪壛偊偨傕偺偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.2. DocBook DTD (version 4.1 偐 3.1)

昁梫側偺偼丄 http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip
<http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip> 偐丄 http://
www.oasis-open.org/docbook/sgml/3.1/docbk31.zip <http://
www.oasis-open.org/docbook/sgml/3.1/docbk31.zip>丅

XML DTD 傪巊偆応崌偼丄 http://www.oasis-open.org/xml/4.1.2/ <http://
www.oasis-open.org/docbook/xml/4.1.2> 偱偡丅

DocBook DTD 偼丄DocBook SGML 暥彂偺僞僌偲暥彂峔憿偲傪掕媊偟偰偄傑偡丅偦
傟備偊丄怴婯僞僌傪壛偊偨傝偟偰 DTD 傪廋惓偡傞偲丄DocBook 偱偼側偔側偭偰
偟傑偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.3. Jade

Jade 偲 OpenJade 偼丄傆偨偮偲傕丄DTD 偲 DSSSL 偵婎偯偄偰僐乕僪偺儗儞僟
儕儞僌傗懨摉惈専嵏偺戝敿傪張棟偡傞僾儘僌儔儉偱偡丅偳偪傜偐偑昁梫側偺偱
丄 DTD 偲 DSSSL 偺僀儞僗僩乕儖偑廔傢偭偰偐傜丄僀儞僗僩乕儖偟偰偔偩偝偄
丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.3.1. Jade

ftp://ftp.jclark.com/pub/jade/jade-1.2.1.tar.gz <ftp://ftp.jclark.com/
pub/jade/jade-1.2.1.tar.gz>

Jade 偼丄SGML 偺僼儘儞僩丒僄儞僪僾儘僙僢僒偱偡丅DocBook 偲 DSSSL 傪巊偭
偰丄懨摉惈専嵏傗丄栚揑偺僼僅乕儅僢僩傊偺 SGML 僜乕僗偺儗儞僟儕儞僌傪峴
偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.3.1.1. Jade 傪巊偆

偙偙偱偼丄巊偭偰偄傞僨傿僗僩儕價儏乕僔儑儞傪栤傢偢丄偳偺僨傿僗僩儕價儏
乕僔儑儞偱傕丄偲偵偐偔偡偖偵巊偊傞傛偆偵偡傞曽朄傪徯夘偟傑偡丅

 1. 偄傠傫側僼傽僀儖傪擖傟傞偨傔偵丄/usr/local/sgml/ 偲偄偭偨儀乕僗丒僨
    傿儗僋僩儕傪嶌惉偟傑偡丅埲壓偱偼丄偦偺僨傿儗僋僩儕傪 $_toolroot 偲
    屇傃傑偡丅
   
 2. Jade, DocBook DTD, DSSSL 傪丄$_toolroot 偑偦傟偧傟偺儀乕僗僨傿儗僋
    僩儕偵側傞傛偆丄師偺傛偆側僨傿儗僋僩儕傪嶌惉偟偰丄僀儞僗僩乕儖偟傑
    偡丅
   
     仩 $_toolroot/jade-1.2.1
       
     仩 $_toolroot/dtd
       
     仩 $_toolroot/dsssl
       
 3. 娐嫬曄悢 SGML_CATALOG_FILES 偵 $_toolroot 偵偁傞僇僞儘僌僼傽僀儖柤
    傪愝掕偡傞昁梫偑偁傝傑偡丅偦傟偵偼師偺僐儅儞僪傪巊偭偰偔偩偝偄丅
    劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
    劆bash$ export SGML_CATALOG_FILES=$_toolroot/dtd/docbook.cat:\          劆
    劆$_toolroot/dsssl/docbook/catalog:$_toolroot/jade-1.2.1/dsssl/catalog  劆
    劆                                                                      劆
    劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
   
 4. 偙傟偱 Jade 傪巊偆弨旛偑偱偒傑偟偨丅僙僋僔儑儞暿偺 HTML 僼傽僀儖傪
    嶌惉偡傞偵偼丄師偺僐儅儞僪傪巊偄傑偡丅
   
    劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
    劆$_toolroot/jade-1.2.1/jade/jade -t sgml -i html \       劆
    劆-d $_toolroot/dsssl/docbook/html/docbook.dsl howto.sgml 劆
    劆                                                        劆
    劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
 5. 堦枃偺 HTML 僼傽僀儖偵傑偲傔傞偵偼丄忋婰偺 Jade 僐儅儞僪偵 -V
    nochunks 傪晅偗偰偔偩偝偄丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.3.1.2. XML 儌乕僪偺 Jade

偄偭偨傫 XML 梡偺愝掕偑嵪傔偽丄Jade 傕 OpenJade 傕 SGML DocBook 偲摨偠
傗傝曽偱巊偊傑偡丅

XML DTD 傪夝搥偟偨傜丄jade/openjade 偺僇僞儘僌僼傽僀儖偺僨僼僅儖僩僼傽
僀儖柤偲偟偰丄docbook.cat 僼傽僀儖偐傜 "catalog" 偵僔儞儃儕僢僋儕儞僋傪
挘傞偙偲傕偱偒傑偡丅師偺 $_xml_root 偺晹暘偼丄僀儞僗僩乕儖偟偨 XML_DTD
偺応強偵抲偒姺偊偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ cd $_xml_root                                                           劆
劆bash$ ln -s docbook.cat catalog                                               劆
劆bash$ export SGML_CATALOG_FILES=$_xml_root/catalog:$_toolroot/dsssl/catalog:\ 劆
劆$_toolroot/dtd/docbook/catalog (1)                                            劆
劆bash$ jade -t sgml -i html -d style $_jade_path/pubtext/xml.dcl foo.xml (2)   劆
劆                                                                              劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

(1) XML, DSSSL, DocBook 偦傟偧傟偺僇僞儘僌僼傽僀儖偑昁梫偱偡丅
    $_toolroot 偼丄愭傎偳偺椺偲摨偠偱偡丅
(2) 僗僞僀儖僼傽僀儖偼丄岲傒偺僗僞僀儖僼傽僀儖偵抲偒姺偊偰偔偩偝偄丅
    jade 偑摦偔偵偼丄xml.dcl 傊偺億僀儞僞偑昁梫偱丄偙傟偼丄XML 暥彂柤偺
    捈慜偵巜掕偝傟傞昁梫偑偁傝傑偡丅
   
    XML 暥彂傪張棟拞偵師偺傛偆側寈崘偑昞帵偝傟傞偐傕偟傟傑偣傫丅偙傟偼
    弌椡偵偼塭嬁偟傑偣傫偑丄尨場偼挷嵏拞偱偡丅
   
    劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
    劆/ent/iso-lat2.ent:119:18:E: "X0176" is not a function name      劆
    劆/ent/iso-lat2.ent:120:17:E: "X0178" is not a function name      劆
    劆                                                                劆
    劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

婛懚偺 SGML DocBook 暥彂傪 XML 暥彂偵曄姺偟偨偄応崌偼丄(暥彂偺朻摢偺峴
偺)暥彂宆愰尵(declaration)偺偲偙傠偱師偺傛偆偵彂偄偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆                                                                    劆
劆                                                                    劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

LDP 偺暥彂婯懃偵廬偭偰偄傞応崌丄偙傟埲奜偵暥彂偵曄峏傪壛偊傞昁梫偼偁傝
傑偣傫丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.3.2. OpenJade

http://openjade.sourceforge.net/ <http://openjade.sourceforge.net/>

DSSSL 僐儈儏僯僥傿乕偑嶌惉偟偨丄Jade 偺僄僋僗僥儞僔儑儞偱偡丅傾僾儕働乕
僔儑儞偺側偐偵偼 jade 傪昁梫偲偡傞傕偺傕偁傝傑偡偑丄偳偪傜傕僒億乕僩偱
偒傞傛偆偵傾僢僾僨乕僩偝傟偮偮偁傝傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.4. Jade wrappers

僆僾僔儑儞偱埲壓偺僣乕儖偑偁傞偺偱丄Jade, DSSSL, DTD 偺僀儞僗僩乕儖屻偵
丄僀儞僗僩乕儖偱偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.4.1. sgmltools-lite

http://sgmltools-lite.sourceforge.net/ <http://
sgmltools-lite.sourceforge.net/>

偙傟偼丄堦擭埲忋慜偵惓幃偵夝嶶偟偨 sgmltools 僾儘僕僃僋僩傪堷偒宲偄偩傕
偺偱丄偦傟埲棃丄Cees de Groot 偑庒姳堎側傞僾儘僕僃僋僩傪棫偪忋偘偰丄
jade SGML 張棟宯傊偺儔僢僷偲偟偰僣乕儖傪嶌偭偰偄傑偡丅峔暥偺墭偝偼偐側
傝夝徚偝傟傑偟偨丅嶌幰偼丄屆偄 sgmltools 僷僢働乕僕傪僀儞僗僩乕儖偟偰丄
偦偺偁偲偵 sgml-tools-lite 傪擖傟傞偙偲偱丄偙偺暥彂傪旕忢偵娙扨偵僼僅乕
儅僢僩偱偒偨偦偆偱偡丅峔暥傪昞帵偡傞 sgmltools 梡偺 man 儁乕僕傕偁傝傑
偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.4.2. Cygnus DocBook Tools

Red Hat 愱梡偱偡偑 - http://www.redhat.com/

Red Hat 偱偼丄6.2 儕儕乕僗偐傜丄DocBook 傪僒億乕僩偡傞僣乕儖偦偺懠傪娷
傔偨 3 偮偺僷僢働乕僕傪攝晍偟偰偄傑偡丅偙傟傜偺僣乕儖偼丄娙扨偵僀儞僗僩
乕儖偱偒傞偺偱丄僣乕儖偲奿摤偟側偔偰傕幏昅偵愱擮偱偒傑偡丅TeTeX, Jade,
JadeTeX 傪偁傜偐偠傔僀儞僗僩乕儖偟偰偍偔偙偲偑昁梫偱偡丅僷僢働乕僕偼 3
偮偲傕丄僀儞僗僩乕儖 CD 偵擖偭偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.4.2.1. Cygnus Tools 偺巊偄曽

偙傟傜偺僣乕儖偼丄Red Hat 6.2 偵晅懏偟偰偄傑偡丅傑偢丄師偺僷僢働乕僕偑
僀儞僗僩乕儖偝傟偰偄傞偐妋擣偟偰偔偩偝偄丅

 丒 sgml-common-0.1-8.noarch
   
 丒 docbook-3.1-4.noarch
   
 丒 stylesheets-1.54.13rh-1.noarch
   
嵟怴僶乕僕儑儞偼丄Red Hat 偺僂僃僽僒僀僩偵偁傝傑偡: http://
www.redhat.com/support/errata/RHBA-2000022-01.html <http://
www.redhat.com/support/errata/RHBA-2000022-01.html>.

RPM 僼傽僀儖傪儅僔儞偵僟僂儞儘乕僪偡傞偐丄偳偙偐偐傜庢偭偰偔傞偐偟偰丄
偄偮傕捠傝僀儞僗僩乕儖偟偰偔偩偝偄丅(root 偵側偭偰丄rpm -Uhv 僼傽僀儖柤
丅) RPM 偑僀儞僗僩乕儖偝傟偨傜丄師偺僐儅儞僪傪巊偭偰 DocBook 傪儗儞僟儕
儞僌偱偒傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ db2html filename                                              劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

DocBook 傪 HTML 偵儗儞僟儕儞僌偟傑偡丅( .sgml 奼挘巕傪彍偄偨)僼傽僀儖柤
偲摨偠柤慜偱僒僽僨傿儗僋僩儕偑嶌惉偝傟丄偦偙偵 HTML 僼傽僀儖偑抲偐傟傑
偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ db2pdf filename                                               劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

DocBook 傪 PDF 僼傽僀儖偵儗儞僟儕儞僌偟傑偡丅JadeTeX 傪巊偭偨 db2pdf 偲
pd2ps 偱丄尰嵼栤戣偑惗偠偰偄傞偺偵拲堄偟偰偔偩偝偄丅偙傟偼丄Red Hat 偵
僶僌偲偟偰搊榐 <http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=
9670>偝傟偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5. 曇廤僣乕儖

埲壓偱偼丄HOWTO 偺嶌惉傗曇廤丄懨摉惈専嵏偵巊偊傞僣乕儖傪徯夘偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1. Emacs (PSGML)

僆僾僔儑儞偱偡丅 - http://www.lysator.liu.se/~lenst/about_psgml/ <http:
//www.lysator.liu.se/~lenst/about_psgml/>

Emacs 偵偼丄SGML 傗 XML 暥彂偺曇廤偺偨傔偵嶌傜傟偨儊僕儍乕儌乕僪偲偟偰
丄 SGML 暥彂嶌惉梡偺 psgml 偲屇偽傟傞儌乕僪偑偁傝傑偡丅偙傟偵傛傞 "峔暥
嫮挷 (syntax highlighting)" 傗 "偒傟偄側昞帵 (pretty printing)" 婡擻傪
巊偆偲丄SGML 僞僌偑嫮挷偝傟偨傝丄庤偱僞僀僾偟側偔偰傕僞僌傪擖傟傞偙偲偑
偱偒偨傝丄彂偒側偑傜懨摉惈専嵏偑偱偒偨傝偟傑偡丅

Emacs 儐乕僓偵偼偆傟偟偄婡擻偱偡偟丄懠偺偳傫側 SGML 曇廤僣乕儖傛傝傕廩
幚偟偨婡擻傪旛偊偰偄傞偲丄懡偔偺儐乕僓偼巚偭偰偄傑偡丅DocBook 傗
LinuxDoc丄偦偺懠偺 DTD 偱傕巊偊傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1.1. PSGML 傪巊偭偰 SGML 傪彂偔曽朄

3.5.1.1.1. 偼偠傔偵

嵟嬤偺僨傿僗僩儕價儏乕僔儑儞傪僀儞僗僩乕儖偟偰偄傞側傜丄Emacs 偱巊偊傞
傛偆偵婛偵 PSGML 偑僀儞僗僩乕儖偝傟偰偄傞偲巚偄傑偡丅妋擣偺偨傔偵丄
Emacs 傪婲摦偟偰丄PSGML 暥彂傪憑偟偰傒傑偟傚偆丅(C-himpsgml)

偙偙偐傜偼丄斾妑揑怴偟偄僶乕僕儑儞偺 Emacs 偵 PSGML 偑僀儞僗僩乕儖偝傟
偰巊偊傞傛偆偵側偭偰偄傞偺傪慜採偵偟傑偡丅榖偑憗偔恑傒偡偓傞偲巚偆曽偼
丄Bob Ducharme 偺 SGML CD book 偺僼儕乕偱岞奐偝傟偰偄傞師偺復傪偛棗偔偩
偝偄丅 http://www.snee.com/bob/sgmlfree/

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1.1.2. .emacs 傪傾僢僾僨乕僩偟偰 PSGML 傪巊偆曽朄

.sgml 僼傽僀儖傪奐偄偨偲偒偵 GNU Emacs 偑 PSGML 儌乕僪偵擖偭偰丄SGML 傪
曇廤偱偒傞弨旛偑惍偆傛偆偵偟偨偄応崌偼丄PSGML 偑 DocBook DTD 傪尒偮偗傜
傟傞傛偆偵偟側偗傟偽側傝傑偣傫丅 GNU Emacs 偱 PSGML 偑巊偊傞傛偆偵僨傿
僗僩儕價儏乕僔儑儞偱婛偵愝掕嵪傒側傜丄壗傕偟側偔偰傕懡暘偆傑偔峴偔偼偢
偱偡偑丄偦偆偱側偄応崌偼丄娐嫬曄悢傪愝掕偟偰丄SGML 僇僞儘僌 (偮傑傝 DTD
偺儕僗僩) 傪憑偡傋偒応強傪 PSGML 偵嫵偊傞昁梫偑偁傝傑偡丅

偨偲偊偽丄傑偢

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ export SGML_CATALOG_FILES=/usr/lib/sgml/catalog               劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

偲懪偭偰丄師偵丄.emacs 僼傽僀儖偵師偓偺傛偆側撪梕偺峴傪捛壛偟傑偡丅

;; ******************************************************************* 
;; set up psgml mode...                                                
;; use psgml-mode instead of emacs native sgml-mode                    
;;                                                                     
                                                                       
(autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t )      
(setq auto-mode-alist                                                  
  (append                                                              
  (list                                                                
    '("\\.sgm$" . sgml-mode)                                           
    '("\\.sgml$" . sgml-mode)                                          
    )                                                                  
  auto-mode-alist))                                                    
                                                                       
;; set some psgml variables                                            
                                                                       
(setq sgml-auto-activate-dtd t)                                        
(setq sgml-omittag-transparent t)                                      
(setq sgml-balanced-tag-edit t)                                        
(setq sgml-auto-insert-required-elements t)                            
(setq sgml-live-element-indicator t)                                   
(setq sgml-indent-step nil)                                            
                                                                       
;; create faces to assign to markup categories                         
                                                                       
(make-face 'sgml-comment-face)                                         
(make-face 'sgml-start-tag-face)                                       
(make-face 'sgml-end-tag-face)                                         
(make-face 'sgml-entity-face)                                          
(make-face 'sgml-doctype-face) ; DOCTYPE data                          
(make-face 'sgml-ignored-face) ; data ignored by PSGML                 
(make-face 'sgml-ms-start-face) ; marked sections start                
(make-face 'sgml-ms-end-face) ; end of marked section                  
(make-face 'sgml-pi-face) ; processing instructions                    
(make-face 'sgml-sgml-face) ; the SGML declaration                     
(make-face 'sgml-shortref-face) ; short references                     
                                                                       
;; view a list of available colors with the emacs-lisp command:        
;;                                                                     
;; list-colors-display                                                 
;;                                                                     
;; please assign your own groovy colors, because these are pretty bad  
(set-face-foreground 'sgml-comment-face "coral")                       
;(set-face-background 'sgml-comment-face "cornflowerblue")             
(set-face-foreground 'sgml-start-tag-face "slateblue")                 
;(set-face-background 'sgml-start-tag-face "cornflowerblue")           
(set-face-foreground 'sgml-end-tag-face "slateblue")                   
;(set-face-background 'sgml-end-tag-face "cornflowerblue")             
(set-face-foreground 'sgml-entity-face "lavender")                     
;(set-face-background 'sgml-entity-face "cornflowerblue")              
(set-face-foreground 'sgml-doctype-face "lavender")                    
;(set-face-background 'sgml-doctype-face "cornflowerblue")             
(set-face-foreground 'sgml-ignored-face "cornflowerblue")              
;(set-face-background 'sgml-ignored-face "cornflowerblue")             
(set-face-foreground 'sgml-ms-start-face "coral")                      
;(set-face-background 'sgml-ms-start-face "cornflowerblue")            
(set-face-foreground 'sgml-ms-end-face "coral")                        
;(set-face-background 'sgml-ms-end-face "cornflowerblue")              
(set-face-foreground 'sgml-pi-face "coral")                            
;(set-face-background 'sgml-pi-face "cornflowerblue")                  
(set-face-foreground 'sgml-sgml-face "coral")                          
;(set-face-background 'sgml-sgml-face "cornflowerblue")                
(set-face-foreground 'sgml-shortref-face "coral")                      
;(set-face-background 'sgml-shortref-face "cornflowerblue")            
                                                                       
;; assign faces to markup categories                                   
                                                                       
(setq sgml-markup-faces '                                              
  (                                                                    
  (comment . sgml-comment-face)                                        
  (start-tag . sgml-start-tag-face)                                    
  (end-tag . sgml-end-tag-face)                                        
  (entity . sgml-entity-face)                                          
  (doctype . sgml-doctype-face)                                        
  (ignored . sgml-ignored-face)                                        
  (ms-start . sgml-ms-start-face)                                      
  (ms-end . sgml-ms-end-face)                                          
  (pi . sgml-pi-face)                                                  
  (sgml . sgml-sgml-face)                                              
  (shortref . sgml-shortref-face)                                      
  ))                                                                   
                                                                       
;; tell PSGML to pay attention to face settings                        
(setq sgml-set-face t)                                                 
;; ...done setting up psgml-mode.                                      
;; ******************************************************************* 

偁偲偼丄Emacs 傪嵞婲摦偟偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1.1.3. SGML 偺偪傚偭偲偟偨僥僗僩

偪傚偭偲偟偨僥僗僩傪偟偰傒傑偟傚偆丅椺偲偟偰丄怴婯僼傽僀儖 /tmp/
test.sgml 傪奐偄偰丄師偺傛偆偵彂偒崬傒傑偡丅

]>                                                                     

偦偟偰丄C-cC-p 偲擖椡偟傑偡丅 Emacs 偑 DTD 傪撉傒崬傕偆偲偟偰偄傞側傜丄
儈僯僶僢僼傽偵 Parsing prolog....done 偲昞帵偝傟傑偡丅偦偟偨傜丄C-c C-e
RETURN 偲懪偭偰丄<test> 偲擖椡偟偰傒傑偟傚偆丅惓偟偔摦偄偰偄傞応崌偼丄
Emacs 偵師偺傛偆偵昞帵偝傟傑偡丅

]>                                                                     

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1.1.4. DocBook 宍幃偱怴婯偵 HOWTO 傪彂偔曽朄

HOWTO 梡偵怴婯僼傽僀儖傪奐偄偰丄師偺傛偆偵擖椡偟傑偡丅

C-cC-p 偲懪偭偰丄夋柺偵拲栚丅偡傋偰梊掕捠傝側傜丄悢昩娫 Emacs 偑撉傒崬
傒張棟傪偟偰丄儈僯僶僢僼傽偵 Parsing prolog....done 偲昞帵偝傟傞偺偑暘
偐傝傑偡丅

偙偙偱丄C-cC-eRETURN 偲懪偪丄<article> 僄儗儊儞僩傪彂偒崬傫偱丄HOWTO 偺
幏昅偵庢傝偐偐傝傑偟傚偆丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.1.1.5. PSGML 傪巊偭偨 Emacs 偺僋僀僢僋儕僼傽儗儞僗

FreeBSD 暥彂偵偁傞 Nik Clayton 偺擖栧彂傪偛棗偔偩偝偄丅 http://
www.freebsd.org/tutorials/docproj-primer/psgml-mode.html <http://
www.freebsd.org/tutorials/docproj-primer/psgml-mode.html>

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.2. VIM

http://www.vim.org

Emacs 偵偮偄偰偺榖傪偟傑偟偨偺偱丄摉慠丄師偼 vi 偺偍榖偱偡丅VIM (Vi
IMproved) 僄僨傿僞偼丄vi 偺昗弨婡擻傪帩偪側偑傜丄僞僌偺埵抲傪僗僋儕乕儞
忋偱怓暘偗偟偰嫵偊偰偔傟傑偡 SGML 儌乕僪傕帩偭偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.2.1. 偼偠傔偵

vim 僾儘僌儔儉偼幚嵺偵暋悢偺晹暘偐傜弌棃偰偄傑偡丅傑偢丄慺偺 vim 僾儘僌
儔儉偑偁偭偰丄偙傟偼丄vi 僾儘僌儔儉傗偦偺僐儅儞僪偲屳姺惈傪帩偭偰偄傑偡
丅Red Hat 儐乕僓側傜丄vim-common 偲 vim-minimal 僷僢働乕僕偑昁梫偱偡丅
師偵丄奼挘婡擻傪帩偭偨 vim 偱丄偙傟偼昗弨偺 vi 偵懳偟偰丄峔暥嫮挷側偳偺
婡擻偑偁傝傑偡丅Red Hat 儐乕僓側傜丄vim-enhanced 偑昁梫偱偡丅嵟屻偺尒摝
偣側偄婡擻偲偟偰丄 X 僀儞僞乕僼僃僀僗偑偁傝丄偙傟偼丄僌儔僼傿僇儖僀儞僞
乕僼僃僀僗傗儊僯儏乕丄儅僂僗憖嶌側偳傪採嫙偟偰偄傑偡丅vim 傗 vi 偐傜偙
傟傪嬫暿偡傞応崌丄僌儔僼傿僇儖憖嶌偱偺僐儅儞僪偼丄gvim 偲屇偽傟偰偄傑偡
丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.2.2. 怴婯暥彂偺儘乕僪傕偟偔偼嶌惉

vim 偲 gvim 儌乕僪偱偼丄 .sgml 僼傽僀儖偼帺摦揑偵擣幆偝傟偰丄"sgml 儌乕
僪" 偵擖傝傑偡丅偁傜偐偠傔暘偐偭偰偄傞堦楢偺 DocBook 僞僌偑 vim 偵撉傒
崬傑傟傞偲丄擣幆偝傟偨僞僌偼拑怓偱嫮挷偝傟傑偡丅擣幆偝傟側偄応崌丄儔僀
僩僽儖乕偱昞帵偝傟傑偡丅擣幆偝傟偨僞僌偺懏惈(attribute)傕儔僀僩僽儖乕偵
側傝丄懏惈偺抣(value)偼丄僺儞僋偵側傝傑偡丅偙偙偐傜偼丄捠忢偺 vi 僐儅儞
僪傪巊偭偰丄僇乕僜儖堏摦偲曇廤偑偱偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.3. WordPerfect 9 (Corel Office 2000)

http://www.corel.com/

MS Windows 僾儔僢僩僼僅乕儉偺 WordPerfect 9 偼丄SGML 偲 DocBook 3.0 傪
僒億乕僩偟偰偄傑偡丅Linux 梡 WordPerfect 9 偵 SGML 婡擻偼偁傝傑偣傫丅

偙傟偼丄SGML 傪僒億乕僩偟偰偄傞彜梡傾僾儕働乕僔儑儞偲偟偰偼堦斣埨壙側傕
偺偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.4. sgedit

http://www.tksgml.de/

sgedit 偼丄SGML 僼傽僀儖傪價僕儏傾儖偵曇廤偱偒傞僾儘僌儔儉偱偡丅偙偺僾
儘僌儔儉偺挿強偼丄偁傜偐偠傔 Emacs 傗 VI 偺巊偄曽傪抦傜側偔偰傕傛偄揰偲
丄僋儘僗僾儔僢僩僼僅乕儉側偺偱丄Windows 偱傕 Linux 偱傕摦偔偲偄偆揰偱偡
丅彜梡傾僾儕働乕僔儑儞偱偡偑丄抣抜偼愝掕偝傟偰偄傑偣傫丅屄恖傗嫵堢婡娭
偱偺棙梡偵偮偄偰偼丄僼儕乕儔僀僙儞僗斉偑弌傞傛偆偱偡丅

價僕儏傾儖曇廤偺懠偵傕丄sgedit 偼丄儘乕僪帪傗昁梫側帪偵丄 Document->
Validate 僐儅儞僪傪巊偭偰丄暥彂偺懨摉惈専嵏偑偱偒傑偡丅

Figure 3-1. sgedit 偺僗僋儕乕儞僔儑僢僩

sgedit 僾儘僌儔儉偺僗僋儕乕儞僔儑僢僩丅嵍懁偵偼丄奒憌傪帩偭偨 SGML 暥彂
偺僣儕乕峔憿偑昞帵偝傟丄塃懁偵偼丄暥彂帺懱偑昞帵偝傟偰偄傞丅僞僌偼丄僌
儗乕偺攚宨偱昞帵偝傟傞丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.5. nedit

http://nedit.org

棪捈偵尵偭偰丄nedit 偼丄僾儘僌儔儅岦偗偱丄怴婯儐乕僓傗摿偵僾儘僌儔儅偱
側偄儐乕僓偵偲偭偰偼偪傚偭偲偒偮偄偐傕偟傟傑偣傫丅偦傟傪彍偗偽丄僞僌偺
怓偯偗偑帺桼偵偱偒偨傝偟偰丄偐側傝僷儚僼儖偱偡丅sgedit 偲堎側傝丄nedit
偱偼丄僞僌傪帺摦偱擖傟偨傝丄暥彂偺懨摉惈専嵏傪帺摦揑偵峴偭偨傝偼偟傑偣
傫丅偦偺偐傢傝丄僂傿儞僪僂偺撪梕偵懳偟偰僔僃儖僐儅儞僪偑巊偊傞傛偆偵側
偭偰偄傑偡丅(僼傽僀儖傪曐懚偟偨屻偱丄僠僃僢僋偟傑偡丅) 傢偨偟偼丄SGML
偺懨摉惈専嵏偺偨傔偵 nsgmls 傪愝掕偟丄僗儁儖僠僃僢僋偺偨傔偵 aspell 傪
愝掕偟傑偟偨偑丄偩偄偨偄悢暘偱廔傢傝傑偟偨丅

Figure 3-2. nedit 偺僗僋儕乕儞僔儑僢僩

nedit 偱偼丄夋柺偺嵍抂偵峴斣崋偑昞帵偝傟傞偺偱丄nsgmls 偱僄儔乕偑弌偨応
崌偵曋棙偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.5.1. nedit 偺巊偄曽

怴婯暥彂傪嶌傞偲偒偼丄LDP DocBook 僥儞僾儗乕僩傪僟僂儞儘乕僪偟偰巊偆偙
偲偑悇彠偝傟偰偄傑偡丅偦偺僼傽僀儖偑偁傟偽丄nedit 傪婲摦偟偰偡偖曇廤偵
庢傝偐偐傟傑偡丅僼傽僀儖偵 .sgml 奼挘巕傪晅偗偰曐懚偟偰偍偗偽丄nedit 偼
丄 SGML/HTML 僞僌婡擻傪桳岠偵偟偰僼傽僀儖傪儘乕僪偟傑偡丅偙偺婡擻偼丄
Preferences->Language Mode->SGML HTML 僐儅儞僪傪巊偭偰柧帵揑偵桳岠偵偡
傞偙偲傕偱偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.5.5.2. nedit 偺 Tips 偲僐僣

nedit 偱偼丄僂傿儞僪僂偺撪梕傪奜晹僾儘僌儔儉偵弌椡偡傞偙偲偑偱偒傞偺偱
丄偙偺婡擻傪巊偭偰丄晛抜巊偭偰偄傞娭悢傪幚峴偱偒傑偡丅偙偙偱庢傝忋偘傞
椺戣偱偼丄 nsgmls 傪巊偄丄SGML 偺懨摉惈専嵏傪峴偆曽朄傪徯夘偟傑偡丅

傑偢丄 Preferences->Default Settings->Customize Menus->Shell Menu... 傪
慖戰偟傑偡丅偡傞偲丄Shell 儊僯儏乕偵搊榐偝傟偰偄傞慡僔僃儖僐儅儞僪傪昞
帵偡傞僟僀傾儘僌儃僢僋僗偑弌偰偔傞偺偱丄偦偺 Menu Entry 偺棑偵 "SGML
validate" 偲彂偒崬傒傑偡丅偙偺僄儞僩儕乕偼丄僗僋儕乕儞忋偱尒傞偙偲偑偱
偒傑偡丅師偵丄Accelerator 偺棑偱丄 Alt-S 傪墴偟偰丄 SGML 偺懨摉惈専嵏偑
帺摦偱峴傢傟傞傛偆偵偟傑偡丅Command Input 偺晹暘偱偼丄 window 傪慖戰偟
偰丄Command Output 偺晹暘偱偼丄dialog 傪慖戰偟傑偡丅 Command to Execute
偱偼丄nsgmls -sv 偲擖椡偟傑偟傚偆丅偙傟偑偆傑偔摦偔偨傔偵偼丄 PATH 偵 
nsgmls 傊偺僷僗偑愝掕偝傟偰偄側偄偲偄偗側偄偺偱拲堄偟偰偔偩偝偄丅

Figure 3-3. nedit 傊偺僔僃儖僐儅儞僪偺捛壛

僔僃儖僐儅儞僪傪捛壛偡傞帪偺僟僀傾儘僌儃僢僋僗丅

OK 傪僋儕僢僋偟偰丄偙傟偱尦偺儊僀儞僗僋儕乕儞偵栠傝傑偡丅SGML 僼傽僀儖
傪儘乕僪偟偰丄Shell+SGML Validate 傪慖戰偡傞偐丄Alt-S 傪墴偡偲丄nsgmls
偑婲摦偝傟偰丄僂傿儞僪僂偺撪梕傪僠僃僢僋偟傑偡丅-sv 傪巊偆棟桼偼丄-v 傪
巜掕偡傞偲丄nsgmls 偼僾儘僌儔儉偺僶乕僕儑儞傪弌椡偡傞偺偱丄偦偺弌椡傪尒
傟偽 nsgmls 偑幚峴偝傟偨偙偲偑昁偢暘偐傞傛偆偵側傞偐傜偱偡丅僶乕僕儑儞
斣崋偟偐弌椡偝傟側偄応崌偼丄暥彂偵僄儔乕偑側偐偭偨偙偲偵側傝傑偡丅僄儔
乕偑偁傟偽丄偦偺僄儔乕偑暘偐傞傛偆偵丄暿偺僂傿儞僪僂偑奐偄偰昞帵偝傟傑
偡丅峴斣崋婡擻傪桳岠偵偟偰偁傞側傜 (偙傟偵偼丄 Preferences->Show Line
Numbers 傪巊偄傑偡丅)丄nsgmls 偼僄儔乕傪峴斣崋偱昞帵偡傞偺偱丄僄儔乕傪
尒偮偗傞偺偑偢偭偲妝偵側傝傑偡丅

Figure 3-4. 僄儔乕偑側偄応崌偺 nsgml 偺弌椡

nsgmls 偑僄儔乕傪専弌偟側偐偭偨応崌偼丄僶乕僕儑儞斣崋偩偗傪曬崘偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6. CVS

LDP 偱偼丄暥彂偺挊幰偵 CVS 傾僇僂儞僩傪敪峴偟傛偆偲偟偰偄傑偡丅偦傟偵偼
丄師偺傛偆側棟桼偑偁傝傑偡丅

 1. CVS 側傜丄嶌惉偟偨暥彂偺僆僼僒僀僩丒僶僢僋傾僢僾偑帩偰傞丅懠偺挊幰
    傊暥彂偺堷偒宲偓傪偡傞偲偒偱傕丄CVS 偐傜偦偺暥彂傪庢偭偰偒偰丄捈偖
    偵嶌嬈偵擖傟傞丅埲慜偺僶乕僕儑儞偺暥彂偑昁梫偵側偭偨偲偒偱傕丄栤戣
    側偔庢傝弌偡偙偲偑偱偒傞丅
   
 2. 壗恖偐偱丄傂偲偮偺暥彂傪嶌傞嵺偵旕忢偵曋棙丅CVS 傪巊偊偽丄帺暘偑曇
    廤拞偺帪偵丄懠恖偑壛偊偨曄峏偺撪梕傪抦傞偙偲偑偱偒傞偟丄偦偆偟偨曄
    峏傪偦偺傑傑庢傝崬傓偙偲傕偱偒傞丅
   
 3. 曄峏売強偺儘僌傪曐懚偱偒傞丅SGML 張棟宯偑幚嵺偺張棟偵庢傝偐偐傞傛傝
    愭偵丄慜傕偭偰張棟偝傟傞傛偆側摿暿側僞僌傪巊偊偽丄偦偆偟偨儘僌(傗擔
    晅僗僞儞僾)傪帺摦揑偵暥彂偵杽傔崬傓偙偲偑偱偒傞丅
   
 4. 怴婯暥彂傪嶌惉偟偰採弌偡傞偲丄LDP 僂僃僽僒僀僩傕帺摦揑偵峏怴偝傟傞
    傛偆側僾儘僌儔儉傪嶌傞偙偲偑偱偒傞丅偙傟偼傑偩幚尰偝傟偰偼偄側偄偗
    傟偳惀旕傗偭偰傒偨偄偙偲偱偡丅崱偺偲偙傠丄CVS 偺峏怴偵傛偭偰丄HOWTO
    僐乕僨傿僱乕僞偵 LDP 僂僃僽儁乕僕傪峏怴偡傞傛偆捠抦偑峴偔傛偆偵側偭
    偰偄傑偡偑丄偙偺巇慻傒傪巊偆偲 SGML 僐乕僪傪儊乕儖偱憲傞昁梫偑側偔
    側傝傑偡丅
   
CVS 偑慡偔弶傔偰側傜丄偄偔偮偐僂僃僽儁乕僕偑偁傞偺偱丄尒偰偍偔偲栶偵棫
偮偐傕偟傟傑偣傫丅

 丒 http://www.sourcegear.com/CVS/Docs/blandy <http://
    www.sourcegear.com/CVS/Docs/blandy>
   
 丒 https://wroclaw.art.pl/~ser/docs/cvs.html <https://wroclaw.art.pl/
    ~ser/docs/cvs.html>
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6.1. CVS 傾僇僂儞僩偺擖庤

傑偢丄LDP 偵偁傞 CVS 儕億僕僩儕偺傾僇僂儞僩傪擖庤偡傞昁梫偑偁傝傑偡丅偙
傟偼丄CVS 偑巊偆儖乕僩僨傿儗僋僩儕偦偺傕偺偱丄偦偺僒僽僨傿儗僋僩儕偲偟
偰 (HOWTO 傗 mini HOWTO 側偳偺)偄偔偮偐偺僾儘僕僃僋僩梡偺僨傿儗僋僩儕偑
嶌惉偝傟偰偄傑偡丅

傾僇僂儞僩傪庢傞偵偼丄僴僢僔儏壔偝傟偨僷僗儚乕僪偲儐乕僓 ID 傪嶌惉偟側
偗傟偽側傝傑偣傫丅僴僢僔儏壔偝傟偨僷僗儚乕僪傪巊偆偲丄CVS 僌儖乕僾偑憲
怣幰偺僷僗儚乕僪傪抦傜偢偲傕丄埫崋壔偝傟偨僷僗儚乕僪傪 CVS 僌儖乕僾偵憲
傞偙偲偑偱偒傑偡丅偦傟偵偼丄師偺傛偆側僐儅儞僪傪 bash (傕偟偔偼 sh) 偐
傜懪偭偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ echo your_password | perl -e "print crypt(<>,\                    劆
劆join '',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\"" 劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

忋婰僐儅儞僪偺弌椡傪丄婓朷偡傞儐乕僓 ID 偲堦弿偵
<cvsadmin@cvslist.linuxdoc.org> 傑偱偍憲傝偔偩偝偄丅奺帺偺 CVSROOT 僨傿
儗僋僩儕偑嶌惉偝傟偨偁偲偱丄偦偺巪偺曉摎儊乕儖偑撏偔偺偱丄偦傟偑撏偄偨
帪揰偱丄CVSROOT 偵儘僌僀儞偟偰丄偡傋偰偑揔愗偵愝掕偝傟偰傞偙偲傪妋擣偟
偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ export CVSROOT=:pserver:your_userid@cvs.linuxdoc.org:/cvsroot 劆
劆bash$ cvs -d $CVSROOT login                                         劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

(your_userid 偺晹暘偼丄庴偗庢偭偨曉摎儊乕儖偵偁傞儐乕僓 ID 偵抲偒姺偊傑
偡丅)

僷僗儚乕僪傪恞偹傜傟偰丄偦偺偁偲偱丄CVS 儕億僕僩儕偵撉傒彂偒儌乕僪偱偺
傾僋僙僗尃偑梌偊傜傟傑偡丅cvs login 僐儅儞僪偼堦搙巊偆偩偗偱僔僗僥儉傊
偺傾僋僙僗尃偑摼傜傟丄.cvspass 偵僷僗儚乕僪偑曐懚偝傟傞偺偱丄師偐傜偼 
cvs login 傪懪偮昁梫偼偁傝傑偣傫丅 CVSROOT 傪愝掕偟偰丄嶌嬈傪懕偗傑偟傚
偆丅師偺僐儅儞僪偱丄LinuxDoc 儕億僕僩儕慡懱傪僐僺乕偡傞偙偲偑偱偒傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ cvs get LDP                                                   劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

傎偐偵傕丄帺暘偱嶌惉偟偨暥彂偺 SGML 僜乕僗偑梸偟偄偲偒偼丄師偺僐儅儞僪
傪懪偭偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ cvs get LDP/howto/docbook/YOUR-HOWTO.sgml                     劆
劆bash$ cvs get guide/docbook/YOURGUIDE                               劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6.2. 偦傟埲奜偺 CVS 儕億僕僩儕傊偺傾僋僙僗曽朄

3.6.2.1. 摻柤 CVS 傾僋僙僗

(LDP 暥彂偺弌斉傪婓朷偡傞曽側偳丄)傾僇僂儞僩偺晄梫側曽偱傕丄摻柤 CVS 傾
僋僙僗偑棙梡偱偒傑偡丅偦偺応崌丄儕億僕僩儕偼撉傒弌偟愱梡偵側傝傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ cvs -d :pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login       劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

僷僗儚乕僪偵偼丄"cvs" 傪巊偄傑偡丅偦偆偡傟偽丄忋婰偲摨偠傛偆偵 LinuxDoc
儌僕儏乕儖偑擖庤偱偒傑偡丅摻柤 CVS 僒僀僩偺峏怴偼丄儊僀儞僒僀僩傛傝 30
暘傎偳抶傟傞偺偱拲堄偟偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6.2.2. Web 宱桼偱偺 CVS 僼傽僀儖

CVS 儕億僕僩儕偵偼丄Web 宱桼偱傕傾僋僙僗偱偒傑偡丅 http://
cvsweb.linuxdoc.org/index.cgi/LDP <http://cvsweb.linuxdoc.org/index.cgi
/LDP>

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6.2.3. 僌儔僼傿僇儖僀儞僞乕僼僃僀僗傪巊偆

CVS 偵偼僌儔僼傿僇儖僀儞僞乕僼僃僀僗偑偁傝傑偡丅 http://freshmeat.net/
appindex 偱 CVS 傪僉乕儚乕僪偵専嶕偡傟偽丄堦棗偑昞帵偝傟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.6.3. 僼傽僀儖偺峏怴偲 CVS

CVS 偵偼丄$Id$ 偲偄偆摿暿側僞僌偑偁傝丄偙傟傪巊偭偰暥彂偵捈愙擔晅偲僶乕
僕儑儞傪帺摦揑偵擖傟傞偙偲偑偱偒傑偡丅 commit 偟偨屻偱丄CVS 偑偙偺僞僌
傪 $Id: cvs.sgml,v 1.3 2000/08/24 20:31:01 markk Exp $ 偺傛偆偵曄峏偟傑
偡丅偙偺僞僌傪暥彂撪偵彂偄偰偍偔偲丄僼傽僀儖傪曄峏偡傞偨傃偵帺摦揑偵偦
偺僞僌偑彂偒姺偊傜傟丄曄峏偡傞偛偲偵儕價僕儑儞斣崋傪忋偘傞偙偲偑偱偒傑
偡丅

峏怴偟偨暥彂傪 CVS 僒乕僶偵傾僢僾儘乕僪偡傞弨旛偑惍偭偨傜丄 cvs ci -m
"comment" 暥彂柤.sgml 偲僐儅儞僪傪懪偭偰偔偩偝偄丅-m "comment" 偼昁梫偱
偼偁傝傑偣傫偑丄偙傟傪擖傟側偄偲丄(晛捠偼 vi 偐丄娐嫬曄悢 EDITOR 偵愝掕
偝傟偨壗傜偐偺)僄僨傿僞偑棫偪忋偑偭偰丄曄峏揰偵偮偄偰偺僐儊儞僩傪捛壛偡
傞傛偆媮傔傜傟傑偡丅

ldp-discuss 儊乕儕儞僌儕僗僩忋偱偺媍榑偐傜傕徻偟偄忣曬偑摼傜傟傑偡丅

暥彂偺嶌惉拞偵 LDP CVS 僣儕乕傪巊偭偰偄傞応崌偼丄岞奐弨旛偑惍偭偨帪揰偱
LDP 偵抦傜偣傞昁梫偑偁傝傑偡丅<ldb-submit@lists.linuxdoc.org> 偵儊乕儖
傪憲偭偰偔偩偝偄丅偦偺嵺丄暥彂偺僞僀僩儖偲丄暥彂僼傽僀儖偺 LDP CVS 僣儕
乕撪偱偺憡懳僷僗柤傪杮暥偵彂偄偰偍偄偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.7. 偦偺懠偺僣乕儖偲儕僼傽儗儞僗

偙偺僙僋僔儑儞偱偼丄崱偺偲偙傠暘椶偟偒傟偰偄側偄儕僼傽儗儞僗杮傗儐乕僥
傿儕僥傿傪徯夘偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.7.1. DocBook: The Definitive Guide

http://www.docbook.org/

偙傟偼丄1999擭10寧偵 O'Reilly 偐傜弌斉偝傟偨丄DocBook 偵偮偄偰偺偡偽傜
偟偄儕僼傽儗儞僗杮偱偡丅偦傟傎偳幚梡揑偱偼側偄傛偆偵巚傢傟傞偟丄 XML 偵
廳揰偑抲偐傟偰偼偄傑偡偑丄僶乕僕儑儞 3.1 偺 DocBook 僞僌偼偡傋偰暘偐傝
傗偡偔堦棗昞帵偝傟偰偄傑偡丅彂揦偱攦偆偙偲傕偱偒傞偟丄杮偺偡傋偰偺撪梕
傪忋婰 URL 偐傜僆儞儔僀儞偱 (HTML 偲 SGML 僼僅乕儅僢僩偵偍偄偰) 撉傓偙
偲傕偱偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.7.2. SGML 僥儞僾儗乕僩

僆僾僔儑儞偱偡丅- http://www.linuxdoc.org/authors/index.html#resources
<http://www.linuxdoc.org/authors/index.html#resources> (擔杮岅栿 <../..
/authors/index.html#resources>)

SGML 僥儞僾儗乕僩偲丄曄姺偟偨屻偺 HTML 弌椡偵偮偄偰偺儕儞僋偑偁傞偺偱丄
暥彂偺懱嵸傪棟夝偡傞庤彆偗偵側傝傑偡丅僞僌偺懡偔偼丄嶌惉偡傞暥彂偺撪梕
偵崌傢偣偰抲偒姺偊傞偙偲偑昁梫偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.7.3. Aspell

僆僾僔儑儞偱偡丅 - http://aspell.sourceforge.net/ <http://
aspell.sourceforge.net/>

僗儁儖僠僃僢僋梡偺偙偺傾僾儕働乕僔儑儞偼丄SGML 僞僌傪旔偗偰丄僞僌偵嫴傑
傟偨撪梕偩偗傪僠僃僢僋偡傞偙偲偑偱偒傑偡丅ispell 偺傛偆側僨僼僅儖僩偺僗
儁儖僠僃僢僇乕偩偲丄僞僌帺懱傕僠僃僢僋偟傛偆偲偡傞偺偱丄怴婯僞僌偑偁傞
偲丄偄偮傕僄儔乕偵側偭偰偟傑偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

3.7.4. ispell

僆僾僔儑儞偱偡丅 - http://www.cs.hmc.edu/~geoff/ispell.html <http://
www.cs.hmc.edu/~geoff/ispell.html>

偙偺 ispell 僾儘僌儔儉偼丄Red Hat (傗丄偍偦傜偔懠偺僨傿僗僩儕價儏乕僔儑
儞 )偵摨崼偝傟偰偄傞傕偺偱丄儅乕僋傾僢僾僞僌傪柍帇偡傞偙偲偑偱偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 4. DocBook 僞僌偺巊偄曽

4.1. 偼偠傔偵

DocBook 偱偼丄僥僉僗僩傪儅乕僋傾僢僾(markup)偡傞堦楢偺曋棙側儅乕僋傾僢
僾僄儗儊儞僩(element)傪掕媊偟偰丄僥僉僗僩傪偄傠偄傠側堎側傞僼僅乕儅僢僩
偵曄姺偱偒傞傛偆偵偟偰偄傑偡丅

DocBook 傪巊偆偲丄HTML 傗 XML, RTF, TeX 偦偺懠偺堎側傞僼僅乕儅僢僩偺暥
彂傪惗惉偱偒傑偡丅

偙傟偼丄偮傑傝丄DocBook 偱暥彂傪嶌惉偟偰偍偗偽丄壜擻側尷傝嵟戝懡悢偺傂
偲偨偪偵忣曬傪揱偊傞偙偲偑偱偒傞偲偄偆偙偲偱偡丅

揔愗偵曐娗偝傟偰偄側偄僨僕僞儖忣曬偼丄偄偞偲偄偆帪偵尒偮偐傜側偐偭偨傝
偡傞傕偺偱偡丅(僶僀僫儕僼僅乕儅僢僩偺傛偆側)捠忢偲偼堎側傞暥帤偼娷傑傟
偰偄側偄偺偱丄SGML 側偄偟 DocBook 偱彂偐傟偨暥彂側傜丄捈愙嶕堷晅偗傗専
嶕傪偡傞偙偲偑偱偒傑偡丅

SGML 僔僗僥儉偱偼丄儅乕僋傾僢僾(markup)傪巊偭偰丄暥彂傪婰弎偟偰偄傑偡丅
DocBook 偵偼 300 埲忋偺儅乕僋傾僢僾丒僄儗儊儞僩(element)偑偁傝丄屄乆偺
僄儗儊儞僩偵偄偔偮偐偺懏惈偑偁傝丄懏惈偑偄偔偮偐偺抣傪庢傝傑偡丅偙傟傜
傪偳偆妶梡偡傞偐偼丄嶌幰偑巊偆暥彂偺僗僞僀儖偵傛偭偰寛傑傝傑偡丅

DocBook 偺掕媊僼傽僀儖偱偁傞 DTD 偵彮偟偱傕曄峏傪壛偊傞偲丄偦傟偼傕偆
DocBook 偱偼側偔側傞偙偲傪朰傟側偄偱偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.2. 昁梫側愝掕

SGML 傗偁傞庬偺僣乕儖側偳偺傛偆偵幆暿巕(identifier)傪巊偆僔僗僥儉偱偼丄
僇僞儘僌(catalogue)偑儀乕僗偵側偭偰偄偰丄偦偺僇僞儘僌偑丄偦偆偟偨幆暿巕
傪撉傒庢偭偰丄昁梫側掕媊偑彂偐傟偨僼傽僀儖傪尒偮偗偩偟傑偡丅

僇僞儘僌僼傽僀儖偺撪梕偵偮偄偰偼丄僇僞儘僌偺愝掕偵偮偄偰彂偐傟偨僙僋僔
儑儞 (Section 4.3 嶲徠)偱丄傕偆彮偟徻偟偔愢柧偟傑偡丅

偦偆偟偨僣乕儖偑昁梫側僇僞儘僌傪尒偮偗傜傟傞傛偆偵丄娐嫬曄悢
SGML_CATALOG_FILES 偺抣傪丄師偺傛偆偵愝掕偟側偗傟偽側傝傑偣傫丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆$ export SGML_CATALOG_FILES="/usr/lib/sgml/catalog"                 劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

DocBook 傗偦偺懠偺僣乕儖椶傪僐儞僺儏乕僞忋偱惓偟偔摦偐偡偺偵昁梫側捛壛
愝掕偼丄偙傟偩偗偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.3. 僇僞儘僌偺嶌惉偲廋惓

僇僞儘僌(catalogue)偼丄岞奐幆暿巕(public identifier)傪夝庍偟偰僔僗僥儉
僼傽僀儖傪尒偮偗偩偡嵺偺儖乕儖偑婰弎偝傟偨僥僉僗僩僼傽僀儖偱偡丅

僇僞儘僌僼傽僀儖偼丄DocBook 偼巊偄傗偡偔偡傞偨傔偺傕偺偱偡丅屄乆偺儐乕
僓偼丄僇僞儘僌僼傽僀儖傪(偨偲偊偽丄儂乕儉僨傿儗僋僩儕丄/usr/local/sgml
丄偦偺懠偺)偳偙偵僀儞僗僩乕儖偟偰傕偄偄偱偡偟丄僀儞僗僩乕儖偝偊偡傟偽丄
偦傟埲忋張棟偟偨傝僐儞僷僀儖偟偨傝偡傞昁梫傕偁傝傑偣傫丅

Example 4-1. 僇僞儘僌偺椺

-- Catalogue for the Conectiva Styles --                   (1)         
                                                                       
OVERRIDE YES                                                           
                                                                       
PUBLIC "-//Conectiva SA//DTD DocBook Conectiva variant V1.0//EN" (2)   
       "/home/ldp/styles/books.dtd"                                    
                                                                       
DELEGATE "-//OASIS"                                                    
         "/home/ldp/SGML/dtds/catalog.dtd"                             
                                                                       
DOCTYPE BOOK /home/ldp/SGML/dtds/docbook/db31/docbook.dtd              
                                                                       
-- EOF --                                                  (3)         
                                                                       

(1) 僐儊儞僩丅僐儊儞僩偼丄"--" 偱巒傑傝丄夵峴偱廔傢傝傑偡丅
(2) 岞奐宆愰尵(public type declaration) "-//Connectiva SA//DTD books
    V1.0//EN" 偲 /home/ldp/styles 偵偁傞 books.dtd 僼傽僀儖丅
(3) 僼傽僀儖偺廔椆傪帵偡僐儊儞僩丅

忋婰偺椺偱偼丄幆暿巕傪僼傽僀儖偵懳墳偝偣傞偨傔偵丄師偺傛偆側弴彉偵廬偭
偰偄傑偡丅

 1. 幆暿巕 PUBLIC 傪僐僺乕偡傞丅
   
 2. 幆暿偡傞僥僉僗僩傪彂偒崬傓丅
   
 3. 懳墳偡傞僼傽僀儖傊偺僷僗傪帵偡丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.3.1. 梡岅偺愢柧

師偺幆暿巕偵拲栚偟偰偔偩偝偄丅

"-//Conectiva SA//DTD books V1.0//EN"                                  

偙偺暲傃曽偼丄儔儞僟儉偱偼側偔丄偁傜偐偠傔寛傔傜傟偨婯懃偵廬偭偰偄傑偡
丅

" - " 偲偄偆岅嬪偼丄巊梡偝傟傞幆暿巕偑丄搊榐嵪傒偺僞僀僾偱偼側偄偙偲傪
帵偟偰偄傑偡丅搊榐嵪傒幆暿巕偼傢偢偐偟偐側偔丄偦傟傜偼捠忢丄 ISO 傗
IEEE 偲偄偭偨僄儞僥傿僥傿 (entity)偵懏偟偰偄傑偡丅

幆暿巕偺師偺晹暘偱偼丄偦傟傪嶌惉偟偨慻怐柤偑掕媊偝傟傑偡丅忋婰偺椺偱偼
丄Conectiva S.A. 偱偡丅

嵟屻偐傜傂偲偮庤慜偵晹暘偱偼丄僐儞僥儞僩(content) (杮彂偺応崌偼丄DTD 
[2] 偱偡丅) 偲丄幆暿偝傟偰偄傞僥僉僗僩柤偑掕媊偝傟傑偡丅

嵟屻偺僄儗儊儞僩偼丄暥彂傪婰弎偟偨尵岅傪帵偟偰偄傑偡丅DocBook 偼丄塸岅
偱彂偐傟偨 DTD 側偺偱丄尵岅偼 EN 偲側傝傑偡丅 2 暥帤偺僐乕僪偑悇彠偝傟
偰偄傞偺偼丄ISO 偺尵岅幆暿婎弨偵廬偭偰偄傞偐傜偱偡丅

徻偟偔偼丄OASIS Technical Resolution 9401:1997 (Amendment 2 to TR 9401)
<http://www.oasis-open.org/html/a401.htm> 傪偛棗偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.3.2. 僇僞儘僌忋偱偺曋棙側僐儅儞僪

僇僞儘僌忋偱巊傢傟傞僐儅儞僪偺偆偪丄戙昞揑側傕偺傪埲壓偱愢柧偟傑偡丅

PUBLIC
   
    僉乕儚乕僪 PUBLIC 偼丄岞奐幆暿巕(public identifier) 傪僔僗僥儉忋偺
    幆暿巕偵儅僢僾偟傑偡丅
   
SYSTEM
   
    僉乕儚乕僪 SYSTEM 偼丄僔僗僥儉幆暿巕(system identifier)傪僔僗僥儉忋
    偺僼傽僀儖偵儅僢僾偟傑偡丅
   
    SYSTEM "http://nexus.conectiva/utilidades/publicacoes/livros.dtd"
    "publicacoes/livros.dtd"
   
SGMLDECL
   
    僉乕儚乕僪 SGMLDECL 偼丄巊梡偝傟傞傋偒 SGML 暥尵 (SGML statement)偺
    僔僗僥儉幆暿巕傪巜帵偟傑偡丅
   
    SGMLDECL "publishings/books.dcl"
   
DTDDECL
   
    SGMLDECL 偲摨條丄僉乕儚乕僪 DTDDECL 偼丄巊梡偝傟傞傋偒 SGML 暥尵傪
    巜帵偟傑偡丅DTDDECL 偵傛偭偰丄SGML 暥尵偼丄DTD 偵懳偡傞岞奐幆暿巕偵
    懳墳晅偗傜傟傑偡丅巆擮側偑傜丄偙偺懳墳晅偗偼丄柍椏偱擖庤偱偒傞婛懚
    偺僣乕儖偱偼僒億乕僩偝傟偰偄傑偣傫丅偙偺暥尵偼丄暋悢偺僇僞儘僌僼傽
    僀儖傪巊偆偲偒偵岠壥偑偁傝傑偡丅
   
    DTDDECL "-//Conectiva SA//DTD livros V1.0//EN" "publicacoes/
    livros.dcl"
   
CATALOG
   
    僉乕儚乕僪 CATALOG 傪巊偆偲丄偁傞僇僞儘僌僼傽僀儖傪暿偺僇僞儘僌僼傽
    僀儖撪偵娷傔傞偙偲偑偱偒傑偡丅偦傟偵傛偭偰丄僇僞儘僌僼傽僀儖偦偺傕
    偺傪曄峏偣偢偵丄堎側傞暋悢偺僇僞儘僌傪棙梡偱偒傞傛偆偵側傝傑偡丅
   
OVERRIDE
   
    僉乕儚乕僪 OVERRIDE 偼丄岞奐幆暿巕偑僔僗僥儉幆暿巕偵桪愭偡傞偐偳偆
    偐傪巜帵偱偒傑偡丅戝晹暘偺僔僗僥儉偱偺昗弨偼丄僔僗僥儉幆暿巕偑岞奐
    幆暿巕偵桪愭偟偰偄傑偡丅
   
DELEGATE
   
    僉乕儚乕僪 DELEGATE 傪巊偆偲丄偁傞僇僞儘僌傪摿掕僞僀僾偺岞奐幆暿巕
    偵懳墳晅偗傞偙偲偑偱偒傑偡丅DELEGATE 僐儅儞僪偼丄CATALOG 偲旕忢偵帡
    偰偄傑偡偑丄摿掕偺僷僞乕儞偑巜掕偝傟側偄尷傝壗傕偟側偄揰偱堎側偭偰
    偄傑偡丅
   
DOCTYPE
   
    暥彂宆偑嵟弶偵彂偐傟偰偄偰傕丄岞奐幆暿巕傗僔僗僥儉幆暿巕偑彂偐傟偰
    偄側偄応崌丄DOCTYPE 僐儅儞僪偑丄偦偺暥彂傪摿掕偺 DTD 偵懳墳晅偗傑偡
    丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.4. DocBook 僄儗儊儞僩偺巊偄曽

DTD 傪夝愅偟偰丄偦傟偵婎偯偄偰僄儗儊儞僩傪憓擖偡傞婡擻偺晅偄偨僄僨傿僞
傪棙梡偡傞偲丄僇乕僜儖埵抲偱摿掕偺僄儗儊儞僩傪巊偊傞偐偳偆偐偑暘偐傞偺
偱偐側傝曋棙偱偡丅偙傟側傜丄暥彂偺偳偙偵傕柍岠側僄儗儊儞僩傪擖傟傞偙偲
偑側偔側傝傑偡丅

彨棃曄峏偑偁偭偰傕側傞傋偔娙扨偵堏峴偱偒傞傛偆偵丄暥彂偺嶌惉幰偼丄
DocBook DTD 偺 XML 僶乕僕儑儞偲偺屳姺惈傪偱偒傞偩偗曐偮傛偆偵怱偑偗偨傎
偆偑偄偄偱偟傚偆丅偮傑傝丄僄儗儊儞僩柤偵偼戝暥帤傪巊偄丄懏惈撪偱偼僟僽
儖僋僆乕僩偱偔偔傝丄"抁弅僞僌"(壓婰嶲徠)偼巊傢側偄傛偆偵偟偰丄廔椆僞僌
傕徣棯偟側偄傛偆偵偟傑偟傚偆丅(psgml + emacs 偺傛偆側)帺摦偱僞僌傪憓擖
偡傞僣乕儖偺戝晹暘偼丄偙偆偟偨儖乕儖偵帺摦揑偵廬偭偰偄傞偐丄偪傚偭偲愝
掕偡傞偩偗偱廬偄傑偡丅

僞僌偺嵟彫壔(minimization)偵偼偄偔偮偐偺傗傝曽偑偁傝傑偡丅嬻僞僌(empty
tag)傕偦傟偵偁偨傝傑偡丅僞僌偺嵟彫壔偺椺偲偟偰偼丄廔椆僞僌傪擖傟傞偐傢
傝偵丄</> 偲偩偗懪偮偙偲偱偡丅埲慜偵傕弎傋傑偟偨偑丄懠偵傕丄僞僌偺徣棯
(tag omission)偲偄偆偺偑偁傝傑偡丅師偵偦偺椉曽偺椺傪嫇偘傑偡丅

 嫮挷僞僌傪椺偵偲傞偲丄傑偢丄偙偙偱偼廔椆僞僌偑徣棯偝傟丄              
偝傜偵丄<>偙偙偱偼嬻僞僌傕巊傢傟偰偄傑偡丅                             

屄乆偺暥彂宆偵偼摿掕偺峔憿偑偁傞偺偱丄偦偆偟偨暥彂偺椺偼偺偪傎偳徯夘偟
傑偡丅(Section 4.11嶲徠)

忋婰偺愢柧傪峫椂偟偨忋偱丄師偵 DocBook 傪巊偭偰暥彂傪彂偔曽朄傪愢柧偟偰
偄偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.4.1. 曋棙側僐儅儞僪

Table 4-1偱偼丄堦斒揑側暥彂傪嶌惉偡傞嵺偵曋棙側僐儅儞僪傪堦棗昞帵偟偰偄
傑偡丅偨偩丄偄偔偮偐偺僄儗儊儞僩偼丄摿掕偺暥柆偱偺傒桳岠偱偁傞偙偲傪朰
傟側偄偱偔偩偝偄丅

(栿拲: 壓婰 Table 4-1 偱偼丄<to> </to> 偲彂偐傟偨晹暘偑偁傝傑偟偨偑丄偦
偺傑傑巊偆偲僄儔乕偵側傝暣傜傢偟偄偺偱丄<para></para> 偵廋惓偟偰偄傑偡
丅)

    Tip: 曄姺偡傞僼僅乕儅僢僩偑曄傢傞偲丄摿掕偺僞僌偱偺昞帵寢壥傕曄傢傞
    偙偲偑偲偒偳偒偁傝傑偡丅DocBook 偱弶傔偰暥彂傪嶌惉偡傞応崌偼丄岞奐
    慜偵丄偄偔偮偐偺僼僅乕儅僢僩偱嶌惉偟偨暥彂偑偳偆偄偆懱嵸偵側傞偺偐
    傪妋擣偟偨傎偆偑傛偄偱偟傚偆丅
   
    Note: 曄姺寢壥偼丄曄姺偺嵺偵巊偭偨僗僞僀儖僔乕僩偵埶懚偡傞偺偱丄儅
    乕僋傾僢僾偼偱偒傞偩偗偨偔偝傫巊偆偙偲傪偍慐傔偟傑偡丅昗弨偺僗僞僀
    儖僔乕僩偱偼弌椡寢壥偵偁傑傝堘偄偑尒偊側偄偲偒偱傕丄偦偆偟偨僞僌傪
    栚棫偨偣傞摿掕偺弌椡僼僅乕儅僢僩偑偁傞偐傕偟傟側偄偐傜偱偡丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Table 4-1. 曋棙側僐儅儞僪

劇劅劅劅劅劅劍劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劍劅劅劅劅劅劅劅劅劅劉
劆梡搑      劆僐儅儞僪                          劆弌椡寢壥          劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆儊乕儖傾僪劆address@domain                    劆                  劆
劆儗僗      劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆挊幰偵偮偄劆...                               劆(壓婰偺椺傪嶲徠)  劆
劆偰        劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆挊幰柤    劆First_Name                        劆First Name Middle 劆
劆          劆Middle_Name                       劆Name Surname      劆
劆          劆Surname                           劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僉乕柤(僉 劆F1                                劆F1                劆
劆乕儃乕僪忋劆                                  劆                  劆
劆偺昞婰)   劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僉乕偺僔儞劆KEY_F1                            劆KEY_F1            劆
劆儃儖柤    劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僉乕偺僐乕劆0x3B                              劆0x3B              劆
劆僪        劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僉乕擖椡  劆   Ctrl                           劆Ctrl-S            劆
劆          劆   S                              劆                  劆
劆          劆                                  劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僾儘僌儔儉劆僼傽僀儖                          劆僼傽僀儖          劆
劆儊僯儏乕  劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆儊僯儏乕傾劆曐懚                              劆曐懚              劆
劆僀僥儉    劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆儊僯儏乕慖劆                                  劆僼傽僀儖->曐懚 (  劆
劆戰        劆                                  劆Ctrl-S)           劆
劆          劆         Ctrl                     劆                  劆
劆          劆         S                        劆                  劆
劆          劆                                  劆                  劆
劆          劆                                  劆                  劆
劆          劆   僼傽僀儖                       劆                  劆
劆          劆   曐懚                           劆                  劆
劆          劆                                  劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆儅僂僗儃僞劆left                              劆left              劆
劆儞        劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僐儅儞僪柤劆comando                           劆command           劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆傾僾儕働乕劆application                       劆application       劆
劆僔儑儞柤  劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆嶲峫暥專昞劆reference                         劆[reference]       劆
劆帵        劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆堷梡      劆       挊幰柤                     劆  堷梡暥          劆
劆          劆       堷梡暥                     劆                  劆
劆          劆                                  劆       --挊幰柤   劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆嶕堷      劆塃婰嶲徠                          劆Section 4.5嶲徠   劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僼傽僀儖柤劆file                              劆file              劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僨傿儗僋僩劆directory                         劆directory/        劆
劆儕        劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆嫮挷[a]   劆text                              劆text              劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆媟拲      劆   媟拲暥                         劆(偙偺昞慻偵嵟屻傪 劆
劆          劆                                  劆嶲徠)             劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆URL       劆                                  劆Conectiva S.A.    劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆儅乕僋晅偒劆                                  劆 丒 傾僀僥儉      劆
劆売忦彂偒  劆      傾僀僥儉                    劆                  劆
劆          劆                                  劆 丒 傾僀僥儉      劆
劆          劆                                  劆                  劆
劆          劆      傾僀僥儉                    劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆斣崋晅偒売劆                                  劆 1. 傾僀僥儉      劆
劆忦彂偒    劆      傾僀僥儉                    劆                  劆
劆          劆                                  劆 2. 傾僀僥儉      劆
劆          劆                                  劆                  劆
劆          劆      傾僀僥儉                    劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆彂偒暘偗偨劆                                     劆2 恑悢偐傜 10 恑悢劆
劆売忦彂偒  劆    2 恑悢                        劆傊偺曄姺昞        劆
劆          劆   10 恑悢                        劆                  劆
劆          劆   000                            劆2 恑悢: 00        劆
劆          劆                                  劆                  劆
劆          劆   011                            劆10 恑悢: 0        劆
劆          劆                                  劆                  劆
劆          劆   102                            劆2 恑悢: 01        劆
劆          劆                                  劆                  劆
劆          劆                                  劆10 恑悢: 1        劆
劆          劆                                  劆                  劆
劆          劆                                  劆2 恑悢: 10        劆
劆          劆                                  劆                  劆
劆          劆                                  劆10 恑悢: 2        劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆尒弌偟晅偒劆                                  劆尒弌偟 1          劆
劆売忦彂偒  劆      尒弌偟 1                    劆                  劆
劆          劆                                  劆    愢柧          劆
劆          劆         愢柧                     劆                  劆
劆          劆                                  劆尒弌偟 2          劆
劆          劆                                  劆                  劆
劆          劆                                  劆    愢柧          劆
劆          劆      尒弌偟 2                    劆                  劆
劆          劆                                  劆                  劆
劆          劆         愢柧                     劆                  劆
劆          劆                                  劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僔儞僾儖側劆   1                              劆1 2 3             劆
劆売忦彂偒  劆   2                              劆4 5 6             劆
劆          劆   3                              劆                  劆
劆          劆   4                              劆A, B, C, D, E, F  劆
劆          劆   5                              劆                  劆
劆          劆   6                              劆                  劆
劆          劆                                  劆                  劆
劆          劆                                  劆                  劆
劆          劆   A                              劆                  劆
劆          劆   B                              劆                  劆
劆          劆   C                              劆                  劆
劆          劆   D                              劆                  劆
劆          劆   E                              劆                  劆
劆          劆   F                              劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆夋憸      劆塃婰嶲徠                          劆Section 4.6嶲徠   劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆昞慻傒    劆塃婰嶲徠                          劆Section 4.7嶲徠   劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆僾儘僌儔儉劆塃婰嶲徠                          劆Section 4.8嶲徠   劆
劆傊偺僐儊儞劆                                  劆                  劆
劆僩憓擖    劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆梡岅廤    劆   Term                           劆偙偺暥彂偺姫枛偵偁劆
劆          劆                                  劆傞梡岅廤嶲徠      劆
劆          劆      Definition                  劆                  劆
劆          劆                                  劆                  劆
劌劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劅劅劎
劆憡屳嶲徠  劆...                               劆(夋憸摍偺弌椡寢壥 劆
劆          劆                                  劆棑嶲徠)           劆
劆          劆                                  劆                  劆
劆          劆...                               劆                  劆
劆          劆Please, see for more information. 劆                  劆
劌劅劅劅劅劅劏劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劏劅劅劅劅劅劅劅劅劅劎
劆Notes:                                                            劆
劆a. 嫮挷昞帵偵偼偄偮偔偐偺曽朄偑偁傝傑偡丅幬懱偺懢帤偑嵟傕堦斒揑偱 劆
劆偡偑丄 DocBook 偱偼幬懱偟偐僒億乕僩偟偰偄傑偣傫丅懢帤傪巊偆偵偼丄 劆
劆棙梡偟偰偄傞僗僞僀儖僔乕僩偵愝掕傪捛壛偡傞昁梫偑偁傝傑偡丅        劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.5. 嶕堷傪偮偔傞

暥拞偵儅乕僋傾僢僾傪憓擖偡傞偙偲偱丄嶕堷傪惗惉偡傞偙偲偑偱偒傑偡丅

偦偆偟偨儅乕僋傾僢僾偼丄偁偲偱奜晹僣乕儖偵傛偭偰張棟偝傟偰丄嶕堷傪惗惉
偟傑偡丅偦偆偟偨僣乕儖偺堦椺偵丄collateindex.pl 僗僋儕僾僩偑偁傝傑偡丅
嶕堷傪惗惉偡傞偨傔偺張棟偼丄Section 4.10.3偱徻偟偔弎傋傑偡丅

嶕堷偵偼丄擖傟巕儗儀儖(nesting level)偑偁傝傑偡丅嶕堷偺儅乕僋傾僢僾偵偼
丄師偺僐乕僪傪巊偄傑偡丅Example 4-2

Example 4-2. 嶕堷惗惉偺偨傔偺僐乕僪

   Main level                                                          
   Second level                                                        
   Third level                                                         
                                                                       
                                                                       

懏惈 zone 傪巊偆偙偲偱丄暥彂偺僠儍僾僞乕傗僙僋僔儑儞偍傛傃偦偺懠偺晹暘
傪嶲徠偡傞偙偲偑偱偒傑偡丅

Example 4-3. 懏惈 zone 偺巊偄曽

                                                                           
                                                                       
                                                                       
      edition                                                          
      index                                                            
                                                                       
                                                                       
    嶕堷偼丄暥拞偵儅乕僋傾僢僾傪憓擖偡傞偙偲偱惗惉偝傟傑偡丅           
                                                                       

Example 4-3 偺僐乕僪偼丄嶕堷忋偵偙偺 edition 偲偄偆僄儞僩儕乕傪惗惉偡傞
偺偵巊傢傟偰偄傞傕偺偱偡丅幚嵺丄懏惈 zone 傪巊偊偽丄暥彂撪偱傕丄暥彂奜
偺暿僼傽僀儖偵偱傕偳偙偵偱傕嶕堷儁乕僕傪抲偔偙偲偑偱偒傑偡丅

偨偩丄娙扨偵儊儞僥僫儞僗偑偱偒傞傛偆偵丄嶕堷偺僄儞僩儕乕偼丄嶕堷晅偗傪
偟偨暥彂偺嵟屻偺儁乕僕偵偄偮傕抲偐傟偰偄傑偡丅

Example 4-4. 懏惈 class 偱丄抣 startofrange 偲 endofrange 傪巊偆曽朄

    晛抜丄暥復傪懪偪崬傫偱偄傞偲丄偲偒偳偒                              
                                                                        
      examples                                                          
      index                                                             
                                                                        
  挿暥傪偛偭偦傝儅乕僋偡傞昁梫偑惗偠傞偙偲偑偁傝傑偡丅                  
                                                                        
   偦偆偄偆応崌偱傕丄偄偮傕捠傝偵彂偒恑傔傑偟傚偆丅                     
                                                                        
   偦偟偰丄嶕堷晅偗偟偨偄晹暘偺嵟屻偵棃偨傜丄師偺傛偆偵掲傔偔偔傝傑偡丅 
                                                                        
   .                                                                    
                                                                        

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.6. 夋憸偺憓擖

夋憸偺憓擖偼丄偳偆偄偆儊僨傿傾偱暥彂傪岞奐偡傞応崌偱傕昁梫側傕偺偱偡丅

TeX 僼僅乕儅僢僩傪巊偆側傜丄PostScript 僼傽僀儖偺僀儊乕僕偑昁梫偱偡丅僆
儞儔僀儞偱岞奐偡傞側傜丄JPG 傗 GIF丄 PNG 偲偄偭偨堦斒揑側僀儊乕僕僼傽僀
儖偑巊偊傑偡丅

夋憸傪憓擖偡傞堦斣娙扨側曽朄偼丄懏惈 fileref 傪巊偆偙偲偱偡丅捠忢丄夋憸
偼丄JPG 傗 PostScript (PS 傕偟偔偼 EPS) 偱惗惉偝傟傑偡丅

Example 4-5. 夋憸偺憓擖

                                                                          
                                                                       

<figure> 傪 <informalfigure> 偵抲偒姺偊傞偲丄夋憸偺僞僀僩儖傪擖傟傞昁梫
偑側偔側傝傑偡丅

偝傜偵丄懏惈 float 偑偁傝丄偙偺抣偲偟偰 0 傪巜掕偡傞偲丄夋憸偼丄暥偺棳
傟偵増偭偨惓妋側埵抲偵抲偐傟傑偡丅抣偲偟偰 1 傪巜掕偡傞偲丄傛傝揔愗偲峫
偊傜傟傞偲偙傠偵夋憸偑摦偐偝傟偰丄偦偺埵抲偵抲偐傟傑偡丅 (偙偺埵抲偼丄
僗僞僀儖僔乕僩偵婰弎偝傟偰偄傞応崌偑偁傞偟丄傕偟偔偼巊梡偡傞傾僾儕働乕
僔儑儞偵傛偭偰娗棟偝傟偰偄傞応崌傕偁傝傑偡丅)

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.6.1. 忋婰埲奜偺曽朄

Example 4-5 埲奜偺曽朄偲偟偰丄<figure> 傗 <informalfigure> 傪巊傢側偄曽
朄傕偁傝傑偡丅

懠偵傕丄夋憸偑巊偊側偄儊僨傿傾偱岞奐偟傛偆偲偡傞応崌丄嫽枴怺偄戙懼慬抲
偲偟偰丄<imageobject> 儔僢僷乕傪巊偆曽朄偑偁傝傑偡丅

Example 4-6. <imageobject>偺巊偄曽

                                                                          
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
         偙偺晹暘偵偼丄偙偺椺偱偺夋憸偑抲偐傟偰偄傑偡丅                
                                                                       
      夋憸偵傛傞愢柧(僆僾僔儑儞)                                       
                                                                       

師偺傛偆側僼僅乕儅僢僩偺僼傽僀儖偑巊偊傑偡丅 BMP, CGM-BINARY, CGM-CHAR,
CGM-CLEAR, DITROFF, DVI, EPS, EQN, FAX, GIF, GIF87A, GIF89A, IGES,
JPEG, JPG, LINESPECIFIC, PCX, PIC, PS, SGML, TBL, TEX, TIFF, WMF, WPG.

偙偺曽朄偵偼丄傛傝揔愗偵傾僾儕働乕僔儑儞傪娗棟偱偒傞偲偄偆棙揰偑偁傝傑
偡丅<imageobject> 僄儗儊儞僩偼丄棙梡壜擻側僼僅乕儅僢僩偑尒偮偐傞傑偱弴
斣偵僥僗僩偝傟丄弌椡僼僅乕儅僢僩偲偟偰夋憸傪僒億乕僩偟偰偄側偄応崌偼丄
<textobject> 僄儗儊儞僩偑巊梡偝傟傑偡丅偟偐偟丄Example 4-6 宍幃傪巊偆嵟
戝偺棙揰偼丄DocBook 偺儕儕乕僗 5.0 偱偼丄 <graphic> 僄儗儊儞僩偼懚嵼偟
側偔側傞偲偄偆揰偱偡丅

寚揰偲偟偰偼丄摨偠傂偲偮偺忣曬傪昞尰偡傞偨傔偵偄偔偮傕偺僐乕僪傪昁梫偲
偡傞偲偄偆揰偱偡丅暥彂撪偵僀儔僗僩傗幨恀傪擖傟傞偺偵偳偪傜傪巊偆偐偼暥
彂惂嶌幰偟偩偄偱偡偑丄彨棃偺僶乕僕儑儞偲偺屳姺惈偐傜偡傞偲丄杔偲偟偰偼
丄夋憸偺憓擖曽朄偲偟偰偙偪傜傪悇彠偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.7. 昞慻

昞偵偡傞偲忣曬偺堄枴偑柧椖偵側傞働乕僗偼悢懡偔偁傝傑偡丅

昞傪嶌惉偡傞娙扨側曽朄偼丄<simplelist> 傪巊偭偨 Table 4-1 偱傕婛偵徯夘
偟傑偟偨偑丄DocBook 偵偼丄偙偺庬偺忣曬傪埖偆傕偭偲愻楙偝傟偨曽朄偑偁傝
傑偡丅

Example 4-7. 昞偺憓擖

悈暯曽岦偺僗僷儞僿僢僟 2 僿僢僟 3 僿僢僟 4 僼僢僞 1 僼僢僞 2 僼僢僞 3  
僼僢僞 4 僼僢僞 5 僨乕僞 1-1 僨乕僞 1-2 僨乕僞 1-3 僨乕僞 1-4 僨乕僞   
1-5 僨乕僞 2-1 僨乕僞 2-2 僨乕僞 2-3 僨乕僞 2-4 悅捈曽岦偺僗僷儞僨乕僞 
3-1 僟僽儖僗僷儞僨乕僞 3-4 僨乕僞 4-1 僨乕僞 4-4 僨乕僞 4-5            

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Table 4-2. 昞偺椺

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劍劅劅劅劅劅劅劅劍劅劅劍劅劅劅劅劅劅劅劉
劆       悈暯曽岦偺僗僷儞       劆僿僢僟 2      劆僿僢劆僿僢僟 4      劆
劆                              劆              劆僟 3劆              劆
劌劅劅劅劅劅劅劅劍劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劑劅劅劑劅劅劅劅劅劅劅劎
劆僨乕僞 1-1    劆僨乕僞 1-2    劆僨乕僞 1-3    劆僨乕劆僨乕僞 1-5    劆
劆              劆              劆              劆僞  劆              劆
劆              劆              劆              劆1-4 劆              劆
劌劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劑劅劅劑劅劅劅劅劅劅劅劎
劆僨乕僞 2-1    劆僨乕僞 2-2    劆僨乕僞 2-3    劆僨乕劆              劆
劆              劆              劆              劆僞  劆              劆
劆              劆              劆              劆2-4 劆悅捈曽岦偺僗僷劆
劌劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劏劅劅劅劅劅劅劅劑劅劅劎儞            劆
劆僨乕僞 3-1    劆                              劆僨乕劆              劆
劆              劆                              劆僞  劆              劆
劆              劆                              劆3-4 劆              劆
劌劅劅劅劅劅劅劅劎                              劌劅劅劑劅劅劅劅劅劅劅劎
劆僨乕僞 4-1    劆                              劆僨乕劆僨乕僞 4-5    劆
劆              劆                              劆僞  劆              劆
劆              劆         僟僽儖僗僷儞         劆4-4 劆              劆
劌劅劅劅劅劅劅劅劑劅劅劅劅劅劅劅劍劅劅劅劅劅劅劅劑劅劅劑劅劅劅劅劅劅劅劎
劆僼僢僞 1      劆僼僢僞 2      劆僼僢僞 3      劆僼僢劆僼僢僞 5      劆
劆              劆              劆              劆僞 4劆              劆
劋劅劅劅劅劅劅劅劏劅劅劅劅劅劅劅劏劅劅劅劅劅劅劅劏劅劅劏劅劅劅劅劅劅劅劊
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.8. 僾儘僌儔儉僐乕僪偲僐儊儞僩

柺敀偄婡擻偲偟偰丄僐乕僪偺堦晹傪巜掕偟偰丄偦傟偵僐儊儞僩傪晅偗傞偲偄偆
偺偑偁傝傑偡丅DocBook 傪巊偊偽丄僾儘僌儔儉僐乕僪傪暥彂偵憓擖偟偰丄偦偺
僐乕僪偺摿掕偺峴偵乽偟傞偟(callout)乿傪晅偗傞偙偲偑偱偒傑偡丅

偙偺婡擻偼丄椺偊偽丄僇僞儘僌僼傽僀儖偺愝掕曽朄傪愢柧偟偨嵺偵丄巊梡偟偰
偄傑偡丅(Section 4.3 嶲徠)

偦偺嵺偵巊偭偨僐乕僪傪埲壓偵帵偟傑偡丅乽偟傞偟(callout)乿婡擻偺巊梡偑朷
傑偟偔側偄働乕僗偱偼丄<areaspec> 偲 <calloutlist> 偵嫴傑傟偨嬻娫傪徚嫀
偡傞偙偲傕偱偒傑偡丅

(栿拲: Table 4-1摨條丄<to> </to> 偼 <para> </para> 偵廋惓偟傑偟偨丅)

                                                                               
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
-- Catalogues for the Conectiva S.A. Style --                                
                                                                             
OVERRIDE YES                                                                 
                                                                             
PUBLIC "-//Conectiva SA//DTD books V1.0//EN" "/home/ldp/estilos/livros.dtd"  
                                                                             
DELEGATE "-//OASIS" "/home/ldp/SGML/dtds/catalog.dtd"                        
                                                                             
DOCTYPE BOOK /home/ldp/SGML/dtds/docbook/db31/docbook.dtd                    
                                                                             
-- EOF --                                                                    
                                                                             
                                                                             
                                                                             
         Comment. Comments begin with --                                     
        and follows to the end of the line.                                  
                                                                             
                                                                             
         The public type association                                         
           "-//Conectiva SA//DTD books V1.0//EN"                             
           with the file books.dtd on the directory                          
           /home/ldp/estilos.                                                
                                                                             
                                                                             
         Comment informing the end of the file.                              
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             

<example> 傗 <para> 僄儗儊儞僩傪巊傢側偔偲傕丄僐儊儞僩(listing)偼丄捈愙
杮暥撪偵彂偔偙偲偑偱偒傑偡丅

乽偟傞偟乿偺埵抲偼丄僐儊儞僩偑彂偐傟偨僐乕僪埵抲偵崌偆傛偆偵張棟偝傟傑
偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.9. 東栿幰傗僐乕僪曄姺幰偺巵柤傪昞帵偡傞

扤偐偑 LDP 暥彂嶌惉偺庤彆偗傪偟偰偔傟偨偲偒偼丄偦傟傪暥彂撪偱柧傜偐偵偡
傋偒偱偡偟丄DocBook 偵傕偦偺偨傔偺僞僌偑偁傝傑偡丅偙偺僙僋僔儑儞偱偼丄
偦偆偟偨壗傜偐偺宍偱峷專幰偺巵柤 (credit) 傪昞帵偡傋偒応崌偵巊偆僞僌偵
偮偄偰徯夘偟傑偡丅傑偢丄曇廤幰偵偮偄偰側傜娙扨偱偡丅DocBook 偵偼偁傜偐
偠傔 <editor> 偲偄偆偺偑偁傝傑偡丅偟偐偟丄巵柤傪昞帵偡傋偒偱傕 DocBook
偵奩摉偡傞僞僌偺側偄摿暿側働乕僗偑 2 偮偁傝傑偡丅東栿幰偲僐乕僪曄姺幰偱
偡丅

僐乕僪曄姺幰偲偼丄椺偊偽 HTML 傪 DocBook SGML 偵曄姺偡傞側偳丄僜乕僗僐
乕僪偺曄姺傪峴偆恖偺偙偲偱偡丅僜乕僗僐乕僪偺曄姺偑峴傢傟傞偙偲偱丄LDP
傾乕僇僀僽偼丄儊僞僨乕僞偺嶌惉偲偄偆偙傟偐傜偺栚昗偺払惉偵傛傝揔偟偨傕
偺偵側傝傑偡偟丄暥彂傪懡條側弌椡僼僅乕儅僢僩偱採嫙偡傞偙偲偑偱偒傞傛偆
偵側傝傑偡丅

東栿幰偼丄僆儕僕僫儖暥彂傪丄椺偊偽塸岅偐傜擔杮岅丄僪僀僣岅偐傜塸岅偲偄
偭偨暿偺抧堟偺尵岅傊偲堏偟姺偊傑偡丅屄乆偺東栿暥彂偵傛偭偰丄悽奅拞偺傛
傝懡偔偺恖乆偑偁側偨偺暥彂傪棙梡偱偒傞傛偆偵側傝傑偡偟丄Linux 傾乕僇僀
僽偺媶嬌偺栰朷偱偁傞丄乽慡悽奅惂攅 "Total World Dominion (tm)" 乿偵傑偨
堦曕嬤偯偔偙偲偑偱偒傑偡丅

埲壓偺僙僋僔儑儞偵帵偡傛偆側曽朄偱丄偦偆偟偨恖偨偪傗丄偁側偨偺暥彂嶌惉
偵峷專偟偨偦傟埲奜偺恖偨偪偵懳偟偰丄偦偺巟墖撪梕傪柧傜偐偵偡傞偙偲偑偱
偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.9.1. <othercredit> 僞僌

東栿幰傗僐乕僪曄姺幰偺巵柤傪昞帵偡傞応崌偵偼丄<othercredit> 偲偄偆僞僌
丒僄儞僩儕乕傪巊偭偰偔偩偝偄丅東栿傗僐乕僪曄姺偲偄偭偨偦傟偧傟偺栶妱傪
柧帵偡傞偵偼丄<othercredit> 僞僌偺 <role> 懏惈偵丄"converter" (僐乕僪曄
姺幰) 傗 "translator" (東栿幰) 偲偄偭偨抣傪愝掕偟傑偡丅偙傟偼丄椺偊偽丄
師偺傛偆偵側傝傑偡丅

  David                                                                
  Merrill                                                              
  Conversion from HTML to DocBook v3.1 (SGML).                         

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.9.2. "幱帿" (Acknowledgements) 偺復偵偮偄偰

暥彂撪偵偼丄"幱帿" (Acknowledgements) 偲戣偟偨僙僋僔儑儞傪嶌偭偰丄偦偙
偱丄偦偺暥彂偵堄枴偺偁傞峷專傪偟偨偡傋偰偺恖偺偙偲傪彂偔傛偆偵偟傑偟傚
偆丅東栿幰傗僐乕僪曄姺幰偩偗偱側偔丄懡偔偺桳堄媊側僼傿乕僪僶僢僋傪憲偭
偰偔傟偨恖傗丄偁側偨偑抦傠偆偲偟偰偄偨抦幆傪嫵偊偰偔傟偨恖丄偁傞偄偼丄
尰嵼偺暥彂偑弌棃忋偑傞傑偱偵庤懌偲側偭偰庤揱偭偰偔傟偨恖偨偪側偳偑偦傟
偵娷傑傟傑偡丅戝晹暘偺挊幰偑丄暥彂偺嵟屻偵偙偺僙僋僔儑儞傪抲偄偰偄傑偡
丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.9.3. <revremark> 僞僌

<revision> 僞僌偵偼奒憌偑偁傝丄偦偺拞偵丄<revremark> 偲偄偆僞僌偑偁傝傑
偡丅偙偺僞僌偱埻傫偩椞堟偵偼丄暥彂傪夵掶偟偨嵺偺娙扨側妎偊彂偒傪彂偒崬
傫偱偍偔偙偲偑偱偒傑偡丅怴偟偄僼僅乕儅僢僩偱儕儕乕僗偟偨嵟弶偺僶乕僕儑
儞偺僐儊儞僩偲偟偰僐乕僪曄姺幰偵懳偡傞幱帿傪彂偄偰偍偄偨傝丄東栿幰偺巵
柤傪東栿偟偨僶乕僕儑儞偛偲偵彂偄偰偍偄偨傝偡傞偙偲傪偍慐傔偟偨偄偲巚偄
傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10. 僣乕儖偲僸儞僩

弌椡寢壥傪尒偨傝嶕堷傪嶌偭偨傝偡傞張棟偼丄暥彂嶌惉拞偵壗搙傕孞傝曉偝傟
傑偡偟丄僄儔乕偑弌傞偙偲傕懡偄偼偢偱偡丅偙偆偟偨張棟傪妝偵峴偆偨傔偵丄
偄偔偮偐偺僗僋儕僾僩傪梡堄偟傑偟偨丅傛傠偟偗傟偽僇僗僞儅僀僘偟偰巊偭偰
偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10.1. 僜乕僗偺僐儞僷僀儖

compiles-sgml 僗僋儕僾僩偼丄堦楢偺僐儅儞僪傪僌儖乕僾壔偟偨傕偺偱偡丅僷
儔儊乕僞偲偟偰丄SGML 偺暥彂柤偲弌椡偟偨偄僼僅乕儅僢僩柤傪搉偡昁梫偑偁傝
傑偡丅

壓婰偺僶乕僕儑儞偺僗僋儕僾僩偱偼丄 XML, HTML, TeX, RTF, PS, DVI 偍傛傃
幨憸 PS (mirrored PS) 僼僅乕儅僢僩傪僒億乕僩偟偰偄傞偺偱丄僼僅僩儕僩僌
儔僼傪惗惉偡傞応崌偵偼棟憐揑偱偡丅

嶕堷偺惗惉偼丄collateindex.pl[3] 僗僋儕僾僩偑帺摦揑偵峴偆偺偱丄嵍婰僗僋
儕僾僩傪偁傜偐偠傔僔僗僥儉偵僀儞僗僩乕儖偟偰偍偄偰偔偩偝偄丅

條乆側僼僅乕儅僢僩偱弌椡傪惗惉偡傞壓婰偺僐儅儞僪偲偼暿偵丄懠偵傕捈愙曄
姺傪峴偆僣乕儖偑 Cygnus&trade; 偐傜採嫙偝傟偰偄傑偡丅偦偺僣乕儖偼丄偙偙
<http://sourceware.cygnus.com/docbook-tools/>偐傜擖庤偡傞偙偲偑偱偒傑偡
丅

埲壓偺僗僋儕僾僩偼丄偙偙 <http://www.linuxdoc.org/LDP/LDP-Author-Guide/
compile-sgml> 偐傜庤偵擖傟傞偙偲傕偱偒傑偡丅

忋婰偺応強偵偼丄 collateindex.pl <http://www.linuxdoc.org/LDP/
LDP-Author-Guide/collateindex.pl> 傕偁傝傑偡丅

Example 4-8. compiles-sgml 僗僋儕僾僩

#!/bin/bash                                                                                                                                            
#                                                                                                                                                      
# Compile DocBook documents into several output formats.                                                                                               
#                                                                                                                                                      
# Godoy.                                                                                                                                               
# 19991230 - Initial release.                                                                                                                          
# 20000117 - Placed the options using "case" and parameters passed                                                                                     
#            via command line. The pages on the Zope are already updated.                                                                              
#             --- Removed to public version (/home/ldp).                                                                                               
# 20000120 - Placed the call to use the books.dtd.                                                                                                     
# 20000126 - Placed the commands for the index generation.                                                                                             
#                                                                                                                                                      
                                                                                                                                                       
# If the jade is already installed, disconsider the line bellow.                                                                                       
 JADE=/usr/bin/jade                                                                                                                                    
                                                                                                                                                       
# If the jade package is already installed, disconsider the line bellow.                                                                               
# JADE=/usr/bin/openjade                                                                                                                               
                                                                                                                                                       
DOCUMENT=$1                                                                                                                                            
shift 1                                                                                                                                                
TYPE=$1                                                                                                                                                
                                                                                                                                                       
. ~/.bash_profile                                                                                                                                      
. ~/.bashrc                                                                                                                                            
                                                                                                                                                       
case $TYPE in                                                                                                                                          
    html)                                                                                                                                              
       rm -f *.htm                                                                                                                                     
       rm -f *.html                                                                                                                                    
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o index.sgml                                                                    
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o index.sgml HTML.index                                                            
       $JADE -t sgml -i html -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl -d /home/ldp/SGML/conectiva/livros.dsl#html $DOCUMENT.sgml         
    ;;                                                                                                                                                 
    rtf)                                                                                                                                               
       rm -f $DOCUMENT.rtf                                                                                                                             
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o index.sgml                                                                    
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t rtf -V rtf-backend -d /home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl -d /home/ldp/SGML/conectiva/books.dsl#print $DOCUMENT.sgml  
    ;;                                                                                                                                                 
    xml)                                                                                                                                               
       rm -f $DOCUMENT.xml                                                                                                                             
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o index.sgml                                                                    
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t sgml -i xml -d /home/ldp/SGML/style/xsl/docbook/html/docbook.xsl $DOCUMENT.sgml                                                        
    ;;                                                                                                                                                 
    tex)                                                                                                                                               
       rm -f $DOCUMENT.tex                                                                                                                             
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o indice.sgml                                                                   
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t tex -V tex-backend -d /home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl -d /home/ldp/SGML/conectiva/livros.dsl#print $DOCUMENT.sgml 
    ;;                                                                                                                                                 
    dvi)                                                                                                                                               
       rm -f $DOCUMENT.tex                                                                                                                             
       rm -f $DOCUMENT.dvi                                                                                                                             
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o indice.sgml                                                                   
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t tex -V tex-backend -d /home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl -d /home/ldp/SGML/conectiva/livros.dsl#print $DOCUMENT.sgml 
       jadetex $DOCUMENT.tex                                                                                                                           
    ;;                                                                                                                                                 
    mirror)                                                                                                                                            
       rm -f $DOCUMENT.tex                                                                                                                             
       rm -f $DOCUMENT.dvi                                                                                                                             
       rm -f $DOCUMENT.mirror.ps                                                                                                                       
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o indice.sgml                                                                   
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t tex -V tex-backend -d /home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl -d /home/ldp/SGML/conectiva/livros.dsl#print $DOCUMENT.sgml 
       jadetex $DOCUMENT.tex                                                                                                                           
       dvips -h /home/ldp/estilos/skel/mirr.hd -O 1.5cm,3cm -f $DOCUMENT.dvi -o $DOCUMENT.mirror.ps                                                    
    ;;                                                                                                                                                 
    ps)                                                                                                                                                
       rm -f $DOCUMENT.tex                                                                                                                             
       rm -f $DOCUMENT.dvi                                                                                                                             
       rm -f $DOCUMENT.ps                                                                                                                              
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -N -o indice.sgml                                                                   
       jade -t sgml -V html-index -d /home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl $DOCUMENT.sgml                                                
       perl /home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl -o indice.sgml HTML.index                                                           
       $JADE -t tex -V tex-backend -d /home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl -d /home/ldp/SGML/conectiva/livros.dsl#print $DOCUMENT.sgml 
       jadetex $DOCUMENT.tex                                                                                                                           
       dvips -The 1.5cm,3cm -f $DOCUMENT.dvi -o $DOCUMENT.ps                                                                                           
    ;;                                                                                                                                                 
    *)                                                                                                                                                 
       echo "How to use: $0 file {html|tex|rtf|xml|ps|dvi|mirror}"                                                                                     
       exit 1                                                                                                                                          
       esac                                                                                                                                            
                                                                                                                                                       
exit 0                                                                                                                                                 
                                                                                                                                                       
                                                                                                                                                       

偙偆偟偨僗僋儕僾僩偼丄Makefile 傪嶌偭偰丄娭悢偺偄偔偮偐傪嵟揔壔偡傞偙偲
偱丄廋惓偱偒傞偺偑偍暘偐傝偵側傞偲巚偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10.2. article 偺嵟弶偺儁乕僕偵梫巪傪憓擖偡傞

article 偺嵟弶偺儁乕僕偵梫巪傪昞帵偱偒傞婡擻偑梸偟偄偲巚偆応崌偑偁傞偐
傕偟傟傑偣傫丅偨偩丄DocBook 偺 article 偼丄昗弨偱偼丄偙偺婡擻傪帩偭偰偄
傑偣傫丅 (栿拲: DocBook 偺 book 傪巊偆応崌偼丄栤戣偁傝傑偣傫丅)

偙傟傪桳岠偵偡傞偵偼丄棙梡偟偰偄傞僗僞僀儖僔乕僩偵廋惓傪壛偊傞昁梫偑偁
傝傑偡丅

埲壓偺椺偼丄偦偺応崌偺張棟偵偮偄偰弎傋偰偄傑偡丅巊偄曽偼丄 Example 4-8
傪偛棗偔偩偝偄丅

Example 4-9. article 偱丄帺摦揑偵梫巪傪憓擖偡傞偨傔偺 stylesheet 偺愝掕

                                                                       
]>                                                                     
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
; Includes a summary at the beginning of an item.                      
(define %generate-article-toc% #t)                                     
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
; Includes a summary at the beginning of an item.                      
(define %generate-article-toc% #t)                                     
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10.3. 嶕堷傪帺摦揑偵憓擖偡傞

DocBook 偵偼嶕堷晅偗傪偡傞偨傔偺儅乕僋傾僢僾偑偁傝傑偡偑丄偦傟傜偼帺摦
揑偵偼惗惉偝傟傑偣傫丅偟偐偟丄collateindex.pl <http://www.linuxdoc.org/
LDP/LDP-Author-Guide/collateindex.pl> 僣乕儖傪巊偊偽丄嶕堷惗惉偼帺摦壔
偱偒傑偡丅

師偵偙偺僗僋儕僾僩偺巊偄曽傪愢柧偟傑偡丅幚嵺偺椺偼丄偙偺暥彂偱愭傎偳偛
棗偵側偭偨偲巚偄傑偡丅(Example 4-8嶲徠)

 1. HTML 僗僞僀儖僔乕僩偲丄僆僾僔儑儞 -V html-index 傪巊偭偰丄jade 偱暥
    彂傪張棟偟傑偡丅
   
    劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
    劆$ jade -t sgml -d html/docbook.dsl -V html-index document.sgml劆
    劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
   
 2. collateindex.pl <http://www.linuxdoc.org/LDP/LDP-Author-Guide/
    collateindex.pl> 傪巊偭偰丄index.sgml 暥彂傪惗惉偟傑偡丅
   
    劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
    劆$ perl collateindex.pl -o index.sgml HTML.index         劆
    劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
   
忋婰偺椺偑婡擻偡傞偵偼丄奜晹僄儞僥傿僥傿(external entity) 傪掕媊偟偰
index.sgml 僼傽僀儖傪庢傝崬傓昁梫偑偁傝傑偡丅

Example 4-10. 嶕堷傪晅偗傞偨傔偵奜晹僄儞僥傿僥傿傪愝掕偡傞

                                                                       
]>                                                                     
                                                                       

暥拞偵昁梫側忣曬傪庢傝崬傓曽朄偵偮偄偰偼丄Section 4.5 傕偛棗偔偩偝偄丅

    Note: PS 偐 PDF 偱偺弌椡偺嵺偵栚師傗嶕堷傪庢傝崬傕偆偲偟偰偄傞応崌
    偼丄 jadetex 偐 pdfjadetex 傪嵟掅 3 夞偼幚峴偡傞昁梫偑偁傞偙偲偵拲
    堄偟偰偔偩偝偄丅偙傟偼丄TeX 偑昁梫偲偡傞張棟偱偁傝丄DocBook 傕偟偔
    偼偦傟偵娭楢偟偨傾僾儕働乕僔儑儞偺栤戣偱偼偁傝傑偣傫丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10.4. 暥彂偺拞偺壓彂偒晹暘傪塀偡

柺敀偄婡擻偲偟偰丄暥彂偺嶌惉拞偵丄偦偺嶌惉晹暘傪嵟廔峞偲偟偰岞奐偡傞偐
偳偆偐傪娙扨側僠僃僢僋偩偗偱寛傔傞偙偲偑偱偒傞婡擻偑偁傝傑偡丅婛懚偺暥
彂傪峏怴偟傛偆偲偟偰偄傞応崌側偳偵偼摿偵丄暥彂撪偵憪峞偲偟偰埵抲偯偗傜
傟偰偄傞晹暘偑偄偔偮傕懚嵼偡傞応崌偑傛偔偁傝傑偡丅

DocBook 偱偼丄僷儔儊乕僞丒僄儞僥傿僥傿(parameter entity)傪巊偭偰丄暥彂
撪偵嶶傜偽偭偨摿掕晹暘偺暥復傪丄忬嫷偵墳偠偰塀偟偨傝昞帵偟偨傝偡傞偙偲
偑偱偒傑偡丅暥彂傪峏怴偟偰偄傞応崌偵偼丄暥彂偑偳偆尒偊傞偺偐傪妋擣偟偨
傝丄怴偟偄復傗曇偺偍偍傑偐側弌棃嬶崌傪妋擣偟偨傝偡傞昁梫偑偁傝傑偡偑丄
偦偺憪峞晹暘傪嵟廔峞偵偼昞帵偟偨偔側偄偲偄偆偙偲偑傛偔偁傝傑偡丅

僷儔儊乕僞丒僄儞僥傿僥傿傪巊偆偲丄暥彂偺朻摢偺堦峴傪曄峏偡傞偩偗偱丄偦
偆偟偨憪峞晹暘傪暥彂撪偵娷傔偨傝丄暥彂偐傜嶍彍偟偨傝偡傞偙偲偑偱偒傑偡
丅

Example 4-11. 僷儔儊乕僞丒僄儞僥傿僥傿傪巊偆

...                                                                    
偙偺抜棊偼丄忋婰僄儞僥傿僥傿 "review" 偺抣偑 "INCLUDE" 偲              
掕媊偝傟偨偲偒偵丄暥彂拞偺堦晹偲側傝傑偡丅                             
]]>                                                                    
                                                                       

忋婰僄儞僥傿僥傿 review 偼丄暥彂撪偺偄傠偄傠側売強偵彂偒崬傓偙偲偑偱偒
傑偡丅偦偺晹暘傊偺曄峏偑廔椆偟偨傜丄忋婰偺椺側傜偽丄 3 峴栚偲 6 峴栚傪
嶍彍偡傞偩偗偱偡丅

憪峞偺傑傑偱曐帩偟偰丄嵟廔峞偵偼娷傔側偄傛偆偵偡傞偵偼丄僄儞僥傿僥傿偺
抣傪 INCLUDE 偐傜 IGNORE 偵彂偒姺偊傞偩偗偱嵪傒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.10.5. 昿斏偵棙梡偡傞暥彂傪奜晹偐傜庢傝崬傓

奜晹僄儞僥傿僥傿(external entity)偺廳梫側摿惈偼丄傛偔巊傢傟傞儊儌傗暥彂
傪庢傝埖偆嵺偵敪婗偝傟傑偡丅

偙偺摿惈傪妶偐偟偰丄(椺偊偽丄儔僀僙儞僗傗幮懃側偳偺)昿斏偵棙梡偝傟傞暥
復傪僼傽僀儖偵偟偰丄偦偆偟偨僼傽僀儖傪暥彂偺揔愗側埵抲偵庢傝崬傓偙偲偑
偱偒傑偡丅

偙偺摿惈傪墳梡偟偨椺偵丄愭傎偳偺 Example 4-10 偑偁傝傑偡丅傑偨丄偙偺
HOWTO 暥彂帺懱偺 SGML 僐乕僪傕偦偺堦椺偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.11. 暥彂偺僒儞僾儖

孞傝曉偟偵側傝傑偡偑丄屄乆偺暥彂宆偵偼丄偦偺暥彂宆摿桳偺僿僢僟偲桳岠側
僐儅儞僪偺奒憌偑偁傝傑偡丅埲壓偺僒僽僙僋僔儑儞偱偼丄article 偲 book 偵
偮偄偰偺僿僢僟偲桳岠側僐儅儞僪奒憌傪徯夘偟傑偡丅

偙偙偱偺椺偼丄偁傜備傞棙梡曽朄傪僇僶乕偟偰偄傞傢偗偱偼側偄偺偱丄埲壓偱
偼丄巊偄曽偺堦斒椺傪採嫙偡傞堄枴偱徯夘偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.11.1. article 偺椺

                                                                             
                                                                             
                                                                                 
                                                                             
      Jorge                                                                  
      Luiz                                                                   
      Godoy                                                                  
      Filho                                                                  
                                                                             
        Conectiva S.A.                                                       
        Publishing Departmentt;/orgdiv>                                      
                                                                             
godoy@conectiva.com                                                          
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
        1.0                                                                  
        27 de janeiro de 2000                                                
        godoy                                                                
        Verso inicial.                                                       
                                                                             
                                                                             
                                                                             
                                                                             
      This document can be freely translated and distributed. It's released  
      under the LDP License.                                                 
                                                                             
                                                                             
                                                                             
      SGML                                                                   
      DocBook                                                                
      DTD                                                                    
      XML                                                                    
      catalogs                                                               
      documents                                                              
      Publishingdlt;/keyword>                                                
      Conectiva                                                              
      configuration                                                          
      use                                                                    
      tools                                                                  
      HOWTO                                                                  
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

4.11.2. book 偺椺

嶌惉拞                                                                 
                                                                       

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 5. LDP 僗僞僀儖丒僈僀僪

5.1. 庡戣傪寛傔傞

HOWTO 傪彂偒巒傔傞慜偵丄僇僶乕偟傛偆偲偡傞庡戣偺斖埻傪柧妋偵偡傞偙偲偑
愭寛偱偡丅庡戣偺斖埻偼丄埲壓偺忦審偵崌抳偡傞偙偲偑儀僗僩偱偡丅

 1. 峀偡偓偢丄嫹偡偓偢. 峀斖側忣曬傪僇僶乕偟傛偆偲偡傞偲丄怺偝偑媇惖偵
    側傝傑偡丅峀偄庡戣傪昻庛偵僇僶乕偡傞傛傝傕丄嫹偄庡戣傪廩暘偵僇僶乕
    偡傞傎偆偑儀僞乕偱偡丅 Linux 偺僣乕儖椶偼丄傂偲偮偺巇帠偟偐偟傑偣傫
    偑丄偦傟傪揑妋偵偙側偡偙偲偱桳柤偱偡丅摨條偵丄HOWTO 偱傕傂偲偮偺庡
    戣傪揑妋偵僇僶乕偡傞傛偆偵偟偰偔偩偝偄丅
   
    庡戣偲側傞帠暱偑旕忢偵嫹偄応崌偼丄懠偺 HOWTO 偺堦晹偲偟偰嶌惉偡傞傎
    偆偑偄偄偐傕偟傟傑偣傫丅偦偆偡傟偽丄撉幰偼昁梫偲偡傞 HOWTO 傪尒偮偗
    傗偡偔側傝傑偡丅娭楢偡傞僩僺僢僋偺 HOWTO 傪 LDP 儕億僕僩儕偱専嶕偟
    偰丄婛懚偺 HOWTO 偺側偐偵偙傟偐傜彂偙偆偲偡傞忣曬傪捛壛偱偒傞応強偑
    側偄偐妋擣偟偰偔偩偝偄丅
   
    偳偺掱搙偩偲彂偒偡偓偐丄偳偺掱搙偩偲彂偒懌傝側偄偐偼丄慖傫偩庡戣偵
    傕傛傝傑偡偟丄偦偺庡戣偵偳傟偩偗廗弉偟偰偄傞偐側偳偵傕傛傝傑偡丅偦
    偺偙偲傪擮摢偵抲偄偰丄揔愗側敾抐傪壓偟偰偔偩偝偄丅
   
 2. 庡戣偼柧妋偵. 彂偒巒傔傞慜偵丄庡戣偲側傞椞堟偺嫬奅傪偳偙偵悩偊傞偐
    傪惓妋偵堄幆偡傞傛偆偵偟偰偔偩偝偄丅懠偺 HOWTO 偲摨偠椞堟傪僇僶乕偡
    傞傋偒偱偼偁傝傑偣傫偟丄嶌惉偡傞 HOWTO 偲娭楢偡傞婛懚偺 HOWTO 偲偺
    娫偵側傞傋偔僊儍僢僾傪嶌傜側偄傛偆偵偟偰偔偩偝偄丅
   
 3. 怴偟偄庡戣偱偁傞偙偲. 摿掕偺庡戣偵偮偄偰彂偔慜偵丄LDP 偱懠偺 HOWTO
    傪僠僃僢僋偟偰丄偍側偠僩僺僢僋偑婛偵暥彂壔偝傟偰偄側偄偐妋擣偟偰偔
    偩偝偄丅傕偟婛偵偁傞側傜丄摨偠暥彂傪傆偨偮嶌傞傛傝傕丄婛懚偺暥彂傪
    妶梡偡傞傛偆偵偟偰偔偩偝偄丅
   
    傕偟婛懚偺 HOWTO 偱偼晄廫暘側応崌傗丄峏怴偑昁梫側応崌偼丄偦偺挊幰偵
    楢棈偟偰丄嫤椡傪怽偟弌傞傛偆偵偟偰偔偩偝偄丅LDP 偺挊幰偼丄偨偄偰偄
    偄偄儎僣偱偡丅寢嬊丄斵傜偼丄抦傝傕偟側偄傂偲傪彆偗傞偨傔偵婱廳側帪
    娫傪妱偄偨傢偗偱偡丅偱偡偺偱丄怽偟弌偼夣偔庴偗擖傟偰偔傟傞偱偟傚偆
    丅偨偩丄偳偆偐嶌嬈寢壥偼堦杮壔偟偰偔偩偝偄丅偱側偄偲丄奆偑崿棎偟傑
    偡丅
   
 4. LDP 偱帠慜偵彸擣偝傟傞偙偲. HOWTO 嶌惉偵擖傞慜偵丄ldp-discuss 儊乕
    儕儞僌儕僗僩偵偦偺巪楢棈偟偰丄 LDP 儃儔儞僥傿傾偐傜偺僼傿乕僪僶僢僋
    傪庢傞傛偆偵偟偰偔偩偝偄丅帠慜偵儊乕儕儞僌儕僗僩傪僠僃僢僋偟偰偍偔
    偲丄屻偱擸傑偢偵偡傒傑偡丅宱尡幰偺択偱偡丅
   
    億僗僩偟側偔偲傕丄ldp-discuss 儊乕儕儞僌儕僗僩偵嶲壛偟偰丄掕婜揑偵
    僼僅儘乕偟偰偍偔偺偼丄偲偰傕偄偄偙偲偱偡丅LDP 偺妶摦傗僯乕僘丄億儕
    僔乕偺尰忬傪抦傞偺偵栶棫偪傑偡丅LDP 儃儔儞僥傿傾偼傓傠傫墖彆偼惿偟
    傒傑偣傫偑丄 LDP 偺億儕僔乕傪妛傃丄偦傟偵廬偆偐偳偆偐偼丄嵟廔揑偵偁
    側偨偑偍寛傔偵側傞偙偲偱偡丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

5.2. 傾僂僩儔僀儞傪嶌惉偡傞

幚嵺偵彂偒巒傔傞偵偁偨傝丄帠慜偵傾僂僩儔僀儞傪嶌惉偟偰偔偩偝偄丅傾僂僩
儔僀儞傪弨旛偟偰偍偔偲丄庡戣偵偮偄偰偺柧妋側僀儊乕僕傪帩偮偙偲偑偱偒傞
傛偆偵側傝傑偡偟丄偦偺帪乆偱丄HOWTO 偺嵶偐側晹暘偵廤拞偱偒傑偡丅

嬌抂偵抁偄 HOWTO 偱側偄尷傝丄傾僂僩儔僀儞偼偍偦傜偔壗抜奒偐偺儗儀儖偵傢
偐傟傞偼偢偱偡丅奒憌傪帩偭偨傾僂僩儔僀儞傪嶌惉偡傞応崌偼丄庡戣偵娭偡傞
堦斒揑側帠暱偑嵟忋埵偵娷傑傟丄僒僽僙僋僔儑儞偵摿掕偺徻偟偄帠暱偑棃傞傛
偆偵偟偰偔偩偝偄丅屄乆偺傾僂僩儔僀儞偺儗儀儖傪屄暿偵挱傔偰丄庡戣偵偮偄
偰偺庡梫椞堟偑偡傋偰僇僶乕偝傟偰偄傞偐偳偆偐傪妋擣偟偰偔偩偝偄丅僒僽僙
僋僔儑儞慡懱偱丄僙僋僔儑儞偵娷傑傟傞傋偒偡傋偰偺庡梫椞堟偑僇僶乕偝傟傞
傛偆偵偟偰偔偩偝偄丅

傾僂僩儔僀儞偺屄乆偺崁栚偼丄慜偺崁栚傪庴偗丄屻偺崁栚傪摫偔傛偆側榑棟娭
學偵側傞傛偆偵偟偰偔偩偝偄丅偨偲偊偽丄摿掕偺僾儘僌儔儉偵娭偡傞 HOWTO 偺
応崌丄偁傜偐偠傔僀儞僗僩乕儖偺僙僋僔儑儞傪彂偐偢偵丄偄偒側傝愝掕偺僙僋
僔儑儞傪嶌傜側偄傛偆偵偟偰偔偩偝偄丅

傾僂僩儔僀儞偑偱偒偨傜丄崱搙偼丄偦傟傪斸敾揑側栚偱傕偆堦搙挱傔偰偔偩偝
偄丅偡傋偰偺娭楢僩僺僢僋傪揔摉側徻偟偝偱僇僶乕偟偰偄傞偱偟傚偆偐丠
HOWTO 偺幩掱奜偺偙偲偑彂偐傟偰偄傑偣傫偐丠偦傟傪扤偐偵尒偣偰丄堄尒傪媮
傔傞偲偄偄偐傕偟傟傑偣傫丅彂偒巒傔偨屻傛傝傕丄傾僂僩儔僀儞偺抜奒偺曽偑
帺暘偺 HOWTO 偺慡懱憸傪捦傒傗偡偄傕偺偱偡丅懡偔偺僼傿乕僪僶僢僋偑梸偟偄
偲偒偼丄傾僂僩儔僀儞傪 ldp-discuss 儊乕儕儞僌儕僗僩偵搳峞偡傞偙偲傕峫偊
偰偔偩偝偄丅

    Note: 偙偙偱弎傋傛偆偲偟偰偄傞僥乕儅偵傕偆婥晅偄偨曽傕偄傜偭偟傖傞
    偱偟傚偆丅僼儕乕僜僼僩僂僃傾偲摨條偵丄僼儕乕僪僉儏儊儞僩傕丄"偼傗傔
    偺儕儕乕僗丄偟傚偭偪傘偆儕儕乕僗 (release early, release often)
    <http://cruel.org/freeware/cathedral.html#4>" 偑儀僗僩偱偡丅
    ldp-discuss 儊乕儕儞僌儕僗僩偵偼丄LDP 暥彂嶌惉偺宱尡幰偑戝惃偄傑偡
    偐傜丄 HOWTO 嶌惉帪偵柪偆偙偲偑偁偭偨傜丄傾僪僶僀僗傪媮傔傞偲偄偄偐
    傕偟傟傑偣傫丅
   
Linus 偺朄懃傪巚偄弌偟傑偟傚偆丅

        "栚嬍偺悢偝偊廩暘偁傟偽丄偳傫側 typo 傕怺崗偱偼側偄丅          
        [4] "                                                          
                                                                       
                                              --Eric S. Raymond        

(Mr. Raymond 偛傔傫側偝偄丅)

FIXME: 僋儗僕僢僩傗儔僀僙儞僗丄僐僺乕儔僀僩側偳側偳偺僩僺僢僋偵娭偡傞 "
昗弨揑" 側儗僀傾僂僩傪採帵偡傞偙偲丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

5.3. 暥復傪彂偔

偙偺帪揰偱丄HOWTO 偺榞慻偑寛傑傝丄枹壛岺偺抐曅揑側忣曬偑廤傔傜傟丄暥彂
壔偝傟丄傾僂僩儔僀儞偵慻傒崬傑傟偰偄傞偲巚偄傑偡丅傛偄僯儏乕僗偱偡丅偙
傟偱拞娫抧揰傪夁偓傑偟偨丅偁偲偼壓傝嶁偱偡丅

師偵僠儍儗儞僕偡傞偺偼丄偙傟傑偱廤傔偨惗偺傑傑偺僨乕僞慡晹偵儅僢僒乕僕
傪巤偟側偑傜丄撉傫偱丄妝偟傫偱丄棟夝偱偒傞傛偆側姰惉昳偵巇忋偘傞偙偲偱
偡丅

幚嵺偵暥復傪彂偒巒傔傞偙偲偑偱偒傞抧揰傑偱偨偳傝拝偔偵偼丄戝曄側嶌嬈偑
昁梫偩偭偨偲巚偄傑偡丅偟偐偟丄偦偺僴乕僪儚乕僋偑曬傢傟傞帪偑棃傑偟偨丅
偙偺抜奒偱偼丄偁側偨撈帺偺曽朄偱柍枴姡憞側戝検偺忣曬傪嬦枴偟偰丄僀儅僕
僱乕僔儑儞偲撈憂惈傪敪婗偱偒傑偡丅

岠棪傛偔暥復傪彂偔曽朄慡斒傪夝愢偡傞偙偲偼丄偙偺暥彂偺斖醗傪墇偊傞偺偱
丄婎杮揑側偙偲偩偗傪愢柧偟傛偆偲巚偄傑偡丅"儕僼傽儗儞僗" 偺僙僋僔儑儞偱
丄偙偺暥彂側偳傛傝傕揑妋偵偙傟傪埖偭偨暥專傪徯夘偟偰偄傑偡丅偦傟傜偺暥
專傪偁偨偭偰丄傾僪僶僀僗偵廬偭偰偔偩偝偄丅

傑偢偼丄Politics and the English Language <http://www.resort.com/
~prime8/Orwell/patee.html> 偐傜偄偔偮偐傾僪僶僀僗傪徯夘偟傑偡丅

        拲堄怺偄儔僀僞乕偼丄暥復傪堦峴彂偔偨傃偵丄彮側偔偲傕師         
        偺 4 偮偺偙偲傪帺栤偡傞丅                                      
                                                                       
         1. 帺暘偼壗傪尵偍偆偲偟偰偄傞傫偩傠偆丠                       
                                                                       
         2. 偳傫側尵梩偱偦傟傪昞尰偱偒傞偩傠偆丠                       
                                                                       
         3. 偳偆偄偆僀儊乕僕傗尵偄夞偟傪巊偆偲傕偭偲偼偭偒傝偡         
            傞偩傠偆偐丠                                               
                                                                       
         4. 偙偺僀儊乕僕偼丄怴慛側岠壥傪敪婗偡傞偩傠偆偐丠             
                                                                       
        偍偦傜偔偼丄師偺傆偨偮傕帺栤偡傞偩傠偆丅                       
                                                                       
         1. 傕偭偲抂揑偵昞尰偱偒側偄偩傠偆偐丠                         
                                                                       
         2. 捖晠偱梋寁側偙偲傪尵偭偰偄側偄偩傠偆偐丠                   
                                                                       
        ...尵梩偺岠壥傪寁傝偐偹傞偺偼傛偔偁傞偙偲偱偡丅偦傟備偊        
        丄捈娤傪偁偰偵偱偒側偄偲偒偵丄棅傟傞儖乕儖偑昁梫偵側傞         
        丅偨偄偰偄偺働乕僗偼師偺儖乕儖偱僇僶乕偱偒傞偲丄傢偨偟         
        偼巚偆丅                                                       
                                                                       
         1. 晛抜栚偵偡傞偙偲偑懡偄塀歡傗捈歡丄偦偺懠偺斾歡揑昞         
            尰偼巊傢側偄偙偲丅                                         
                                                                       
         2. 娙扨側扨岅傪巊偊傞偲偒偼丄擄偟偄扨岅傪巊傢側偄偙偲         
            丅                                                         
                                                                       
         3. 巊傢側偔偰傕偄偄扨岅偼丄寛偟偰巊傢側偄偙偲丅               
                                                                       
         4. 擻摦懺偑巊偊傞応崌偵丄庴摦懺傪巊傢側偄偙偲丅               
                                                                       
         5. 奜崙岅偺僼儗乕僘丄壢妛梡岅丄愱栧梡岅偺椶偼丄擔忢塸         
            岅偺側偐偱奩摉偡傞岅嬪偑巚偄晜偐傇応崌偼巊傢側偄偙         
            偲丅                                                       
                                                                       
         6. 埲忋偺儖乕儖傪傂偲偮偱傕攋傞偲丄偦偺偲偨傫偵丄尵梩         
            偼栰曢側傕偺偵側傞丅                                       
                                                                       
                                                --George Orwell        

偦傟偐傜丄弮悎偵僗僞僀儖偺娤揰偐傜尵偆偲丄懡偔偺 HOWTO 偑巊偭偰偄傞堦恖
徧偱偺彂偒曽偼丄傢偨偟偵偼枺椡偑偁傞傛偆偵巚偊傑偡丅偙偺枺椡偼丄偦偆偱
側偄戝晹暘偺暥彂偐傜偼摼擄偄傕偺偱偡丅帺暘帺恎偲偟偰榖偡偙偲傪嫲傟偢偵
丄 " I " 傪巊偄丄懱尡択傗帺暘偺堄尒傪彂偄偰偔偩偝偄丅

偙傟埲忋偔偳偄偲巚偆偐偨偑偄傜偭偟傖傞偲偼巚偄傑偡偑丄偙傟傜偡傋偰偺採
埬偺婎挷偲側偭偰偄傞尨懃偼丄僔儞僾儖偱偁傞偙偲偱偡丅撉幰偼偡偱偵偁偨傜
偟偔搊応偡傞奣擮偲擔乆奿摤偟偰偄傞偺偱偡偐傜丄偁側偨偺尵梩偑棟夝偱偒偢
偵奿摤偡傞偲偄偭偨偙偲偵側傜側偄傛偆偵偟偰偔偩偝偄丅KISS 偺尨懃傪朰傟側
偄傛偆偍婅偄偟傑偡: Keep It Simple, Stupid!

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

5.4. 僥僉僗僩偺悇澣偲峑惓

HOWTO 偺暥復傪彂偒廔傢偭偨傜丄師偼丄偦傟傪悇澣偟偰杹偒傪偐偗傑偡丅悇澣
偺慞偟埆偟偱丄傑偢傑偢偺 HOWTO 偐丄偡偽傜偟偄 HOWTO 偐偑寛傑傝傑偡丅

悇澣偺栚揑偼丄暥彂偵擡傃崬傫偩梋寁側帠暱傪嶍彍偡傞偙偲偱偡丅HOWTO 傪拲
堄怺偔撉傒曉偟偰丄偦偺庡戣偵偮偄偰偺撉幰偺棟夝偵栶棫偨側偄傕偺偼丄僶僢
僒儕偲嶍偭偰偔偩偝偄丅暥復傪彂偄偰偄傞偆偪偵扙慄偡傞偺偼丄挊幰偲偟偰帺
慠側偙偲偱偡丅崱偼丄偦傟傪掶惓偡傞偲偒偱偡丅

悇澣偲峑惓偺嵺偼丄僗儁儖儈僗傗 typo 偲偄偭偨柧傜偐側儈僗傪僠僃僢僋偟側
偔偰偼側傝傑偣傫丅偟偐偟丄偦偺嵺丄傕偭偲怺偔偰丄尒偮偗偵偔偄丄昁梫側忣
曬偺 "寚棊" 傕摨帪偵僠僃僢僋偡傋偒偱偡丅僙僋僔儑儞偺撪梕偑偦偺僙僋僔儑
儞偺僞僀僩儖偲惓妋偵崌抳偟偰偄傞偐偳偆偐妋擣偟偰偔偩偝偄丅

暥彂偺幙偲惓妋偝偵偮偄偰姰慡偵枮懌偺偄偔傕偺偑偱偒偨傜丄師偵偦傟傪扤偐
偵搉偟偰丄戞嶰幰偲偟偰峑惓偟偰傕傜偭偰偔偩偝偄丅帺暘偱偼嶌昳偵嬤偡偓偰
丄崻杮揑側寚揰傪棟夝偱偒側偄偙偲偑偁傞偐傜偱偡丅

偙偆偟偨峑掶偼丄偁傞堄枴偱丄僜僼僩僂僃傾奐敪偺僐乕僪丒儗價儏乕偺傛偆側
傕偺偱偡丅僾儘僌儔儅偑帺暘偨偪偱嶌偭偨僐乕僪傪儗價儏乕偟偰傕偁傑傝堄枴
偑側偄偱偟傚偆丠嶌幰偑帺暘偨偪偱嶌偭偨暥彂傪峑掶偟偰傕丄偦傟埲忋堄枴偺
偁傞寢壥傪摼傜傟傞偱偟傚偆偐丠偦偆偟偨傢偗偱丄桭恖傪儕僋儖乕僩偡傞偐丄
ldp-discuss 儊乕儕儞僌儕僗僩偵搳峞偟偰儃儔儞僥傿傾傪憑偟丄婑峞偡傞慜偵
HOWTO 傪峑惓偡傞傛偆偵偟偰偔偩偝偄丅

    Note: 傕偟帺暘偱偼惛捠偟偰偄側偄尵岅偱暥彂傪彂偄偰偄傞応崌偼丄偦偺
    尵岅偵惛捠偟偨峑惓幰傪憑偡偙偲傪嫮偔偍慐傔偟傑偡丅媄弍暥彂偱偼丄懠
    偺偳傫側僞僀僾偺暥彂傛傝傕丄摿抜偵惓妋側暥朄偲岅渂傪巊傢側偗傟偽側
    傝傑偣傫丅尵梩偺岆梡偼丄偦傟偑偳傟傎偳抳偟曽偺側偄堄恾偣偞傞岆梡偱
    偁偭偨偲偟偰傕丄偁側偨偺 HOWTO 偺壙抣傪掅壓偝偣偰偟傑偄傑偡丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

5.5. 嶌惉偟偨 HOWTO 偺娗棟

嶌惉偟偨 HOWTO 暥彂偑岞奐偝傟偨偐傜偲偄偭偰丄巇帠偑偡傋偰廔傢偭偨傢偗偱
偼偁傝傑偣傫丅HOWTO 偺忣曬傪峏怴偟丄撉幰偺傾僀僨傾傗採埬偵墳偊偰 HOWTO
傪妋幚偵夵慞偟偰偄偔偨傔偵偼丄掕婜揑側儊儞僥僫儞僗偑昁梫偱偡丅 HOWTO 偵
偼丄妶敪偵惉挿偡傞惗偒偨抦幆偑媗傑偭偰偄傞偺偱丄岞奐偟偰偦傟偱廔傢傝偲
偄偆屌掕揑側傕偺偱偼偁傝傑偣傫丅

HOWTO 偵帺暘偺儊乕儖傾僪儗僗傪彂偄偰丄撉幰偐傜偺僼傿乕僪僶僢僋傪挌擩偵
偍婅偄偟偨偱偟傚偆偐丠堦扷惓幃偵岞奐偝傟傞偲丄採埬偺儊乕儖傪偄偔偮傕庴
偗庢傞傛偆偵側傝傑偡丅偦偺側偐偵偼偲偰傕婱廳側傕偺偑偁傝傑偡偑丄偦傟埲
奜偼屄恖揑側栤戣偺夝寛傪媮傔傞傕偺偩偭偨傝偟傑偡丅帪娫偑側偗傟偽丄屄恖
揑側栤戣偵墳偊傞昁梫偼慡偔偁傝傑偣傫丅LDP 偱 HOWTO 傪彂偄偨偐傜偲偄偭偰
丄僱僢僩忋偺偁傜備傞恖偵僼儕乕僒億乕僩傪惗奤懕偗傞媊柋傪晧偆傢偗偱偼側
偄偐傜偱偡丅偨偩丄傕偟偱偒傞側傜丄偦偆偟偨恖偵暿偺忣曬尮傪嫵偊偰偁偘傞
偲丄恊愗偱偼偁傝傑偡丅傑偨丄庴偗庢偭偨幙栤偺僷僞乕儞偑尒偊偰偔傟偽丄
HOWTO 偵捛壛偡傋偒僩僺僢僋偑暘偐傞偐傕偟傟傑偣傫丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

5.6. 儕僼傽儗儞僗

暥復偺彂偒曽偵娭偡傞暥專偑僆儞儔僀儞忋偵傕偨偔偝傫偁傝傑偡丅摿偵偡偖傟
偨傕偺偺偄偔偮偐傪娙扨偵徯夘偟傑偡丅

 丒 Politics and the English Language <http://www.resort.com/~prime8/
    Orwell/patee.html>.
   
 丒 Elements of Style <http://bartleby.com/141>
   
 丒 FIXME: 僥僋僯僇儖丒儔僀僥傿儞僌偵娭偡傞椙偄暥專偑偁傝傑偟偨傜丄 URL
    傪偍嫵偊偔偩偝偄丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 6. 僗僞僀儖娭楢帠崁偺曗懌

偙偺僙僋僔儑儞偱偼丄暥彂偺嶌惉偵偁偨傝丄僗僞僀儖偵娭楢偡傞僩僺僢僋偺偄
偔偮偐傪曗懌偟偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.1. 擔晅偺彂偒曽

<pubdate> 僞僌傪暥彂偱巊偆嵺偵偼丄師偺彂幃偱擔晅傪婰擖偟偰偔偩偝偄丅

v1.0, 21 April 2000                                                    

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.2. 夋憸僼僅乕儅僢僩

暥彂偵夋憸傪晅偗偰 LDP 偵憲傞嵺偼丄傑偢 .eps 偺僙僢僩偲丄師偵 .gif 傕偟
偔偼 .jpg 偺偳偪傜偐堦曽偺僙僢僩偲傪憲偭偰偔偩偝偄丅.gif 偺摿嫋偺栤戣偼
堄幆偟偰偍偔傋偒偱偡偑丄.gif 偺傎偆偑丄.jpg 傛傝偡偙偟偩偗椙偄夋憸偑嶌
傟傞傛偆偱偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.3. DocBook 偺僶乕僕儑儞

LDP 偱偼丄埲壓偺僼僅乕儅僢僩偱偺暥彂傪僒億乕僩偟丄庴偗擖傟偰偄傑偡丅

 丒 SGML DocBook versions 4.x 偲 3.1
   
 丒 SGML LinuxDoc
   
 丒 XML DocBook version 4.1.2
   
DocBook 偺僿僢僟傪彂偔偲偒偼丄師偺傛偆偵彂偄偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.4. 棙梡嬛巭偺僞僌

旕悇彠僞僌偲偟偰 DocBook: The Definitive Guide 偺儕僗僩偵嫇偑偭偰偄傞僞
僌偼丄LDP 暥彂撪偱傕巊梡偟側偄傛偆偵偟偰偔偩偝偄丅怴偟偄僞僌偺巊偄曽偵
偮偄偰偼丄僥僋僯僢僋偲僐僣偺僙僋僔儑儞偱徯夘偟偰偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.5. 僞僌偺嵟彫壔

僞僌偺嵟彫壔(tag minimization)偲偼丄(偨偲偊偽丄</para> 偺傛偆側)姰慡側
廔椆僞僌偺偐傢傝偵丄</> 傪巊偆偙偲偱偡丅偙傟傪巊偆偲丄偦偺暥彂偵彨棃娭
傢傞嶌幰傗 LDP 儊儞僶乕偵偲偭偰偼暥彂峔憿偑暘偐傝偵偔偔側傝傑偡偟丄XML
DocBook 偱偼擣傔傜傟偰偄側偄巊偄曽側偺偱丄偦偆偟偨廗姷偼巭傔傞傛偆偵偟
偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

6.6. 暥彂撪偱偺昞婰朄

條乆側暥彂娫偱庣傞傋偒昞婰朄偵丄師偺傛偆側傕偺偑偁傝傑偡丅

僐儅儞僪偺巊偄曽傪帵偦偆偲偡傞応崌丄儐乕僓僐儅儞僪儔僀儞偲偟偰偺昞帵偵
側傞傛偆丄僐儅儞僪峴傪彂偄偰偔偩偝偄丅僾儘儞僾僩偵偼丄傑偢丄僔僃儖偺庬
椶 (bash, tcsh, zsh, 側偳) 偑昞帵偝傟丄師偵丄(root 偱側偄)捠忢偺儐乕僓
偲偟偰幚峴偝傟傞応崌偵偼 $ 傪丄root 儐乕僓偲偟偰幚峴偝傟傞応崌偼 # 傪昞
帵偟偰偔偩偝偄丅

偦傟備偊丄僐儅儞僪偼丄師偺傛偆偵昞帵偝傟傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ command "run as a normal user"                                劆
劆bash# command "run as a root user"                                  劆
劆tcsh# setenv DISPLAY :0.0                                           劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 7. DocBook 偺僥僋僯僢僋偲僐僣

偙偺僙僋僔儑儞偱偼丄暥彂傪彂偔嵺偺 DocBook 偺偪傚偭偲傂偹偭偨巊偄曽傪偄
偔偮偐徯夘偟傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

7.1. 夋憸偺憓擖

HOWTO 偵夋憸傪擖傟傛偆偲巚偭偰偄傞応崌丄LinuxDoc 偱偼夋憸偺僒億乕僩偼偁
傝傑偣傫偱偟偨偑丄DocBook 側傜壜擻偱偡丅師偵丄HOWTO 偵夋憸傪擖傟傞曽朄
偺堦椺傪徯夘偟傑偡丅

                                                                          
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
         Screen shot of the LyX document processing program            
                                                                       
                                                                       

忋婰偼丄<graphic> 傪巊偆傛傝傕丄傆偨偮偺棟桼偱偡偖傟偰偄傑偡丅戞堦偵丄
DocBook 5.0 偱偼丄<mediaobject> 偵堏峴偡傞偨傔丄<graphic> 偼嶍彍偝傟傑
偡丅偦傟備偊丄崱偐傜惓偟偄曽朄偱巊偄巒傔傞傎偆偑傛偄偲巚傢傟傑偡丅戞擇
偵丄<mediaobject> 側傜丄弌椡宍幃偵廬偭偰堎側傞暋悢偺僼僅乕儅僢僩偺夋憸
傪埖偆偙偲偑偱偒傑偡丅忋婰偺椺偱尵偆偲丄嵟弶偺 <imageobject> 偼丄DVI,
PS, PDF 偲偄偭偨 TeX 偐傜惗惉偝傟傞僼僅乕儅僢僩偵棙梡偝傟傞 EPS
(Encapsulated PostScript) 夋憸偱丄傆偨偮栚偺 <imageobject> 偼丄僨傿僗僾
儗僀夋柺梡丄戝晹暘偼 HTML 梡偺弌椡偱棙梡偝傟傞 JPEG 夋憸偱偡丅
<textobject> 偺晹暘偼丄弌椡偑夋憸傪僒億乕僩偟偰偄側偄応崌偵昞帵偝傟傞傕
偺偱偡(TXT)丅<alt> 僞僌偺傛偆側傕偺偲偍峫偊偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

7.2. HTML 弌椡僼傽僀儖偺僼傽僀儖柤傪巜掕偡傞

屄暿偺 HTML 僼傽僀儖傪弌椡偡傞応崌丄SGML 張棟宯偼丄僨僼僅儖僩偱丄湏堄揑
側僼傽僀儖柤偟偐晅偗傑偣傫丅偙傟偱偼丄撉幰偑儁乕僕傪僽僢僋儅乕僋偟偰偍
偄偰傕偡偖偵曄峏偝傟偰偟傑偄傑偡偟丄偁側偨傕偳傟偑偳偺僼傽僀儖側偺偐暘
偐傜側偔側偭偰丄暣傜傢偟偄偱偟傚偆丅棟桼偼偳偆偱偁傟丄偙偙偱偼丄屄暿偺
弌椡僼傽僀儖偵岲偒側柤慜傪晅偗傞曽朄傪徯夘偟傑偡丅

<article> 僞僌傪嵟弶偵抲偔応崌( 偙傟偼傂偲偮偩偗偺偼偢偱偡丅)丄偦偙偵
id 僷儔儊乕僞傪彂偒崬傫偱丄偦偺抣傪 index 偲偟傑偡丅偦偆偡傞偲丄僞僌偼
師偺傛偆偵側傝傑偡丅

嵟弶偵 <chapter> 僞僌傪抲偔応崌丄偙偺僞僌撪偺撪梕偼捠忢僀儞僩儘僟僋僔儑
儞偲側傞偱偟傚偆偟丄偙傟偼暥彂撪偺嵟弶偵抲偒偨偄偲巚偆偱偟傚偆偐傜丄廋
惓偟側偄偱偔偩偝偄 [5]丅偦傟埲奜偺屄乆偺 <section> 僞僌偵偮偄偰偼丄 id
僷儔儊乕僞偲偦偺柤慜傪彂偒崬傫偱偔偩偝偄丅柤慜偵偼丄傾儖僼傽儀僢僩偲悢
帤偩偗傪巊偆傛偆偵偟丄撪梕偑棟夝偱偒傞掱搙偺抁偄柤慜偵偟偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

7.3. ldp.dsl 傪巊偆

LDP 偱偼丄撈帺偺 DSSSL 傪巊偭偰偄偰丄偦傟偵傛偭偰丄攚宨晹暘傗 HOWTO 偺
嵟弶偺儁乕僕偵偁傞栚師偺帺摦惗惉婡擻傪晅偗壛偊偰偄傑偡丅偦偺嵟怴僶乕僕
儑儞偼丄 http://www.linuxdoc.org/authors/tools/ldp.dsl 偵偁傝傑偡丅

僼傽僀儖偑庤偵擖偭偨傜丄DocBook DSSSL 僼傽僀儖偺抲偒応強偵婎偯偄偰愭摢
偺悢峴傪廋惓偡傞昁梫偑偁傞偐傕偟傟傑偣傫丅傢偨偟偺椺偱偼丄Cygnus 僣乕儖
僙僢僩傪巊偭偰偄傑偡丅

ldp.dsl 僼傽僀儖傪 /usr/lib/sgml/stylesheets 偵抲偄偰丄偦傟傪岲偒側僄僨
傿僞偱奐偄偰偔偩偝偄丅師偺傛偆偵側偭偰偄傞偺偑傢偐傞偲巚偄傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆                                                                    劆
劆(1) " CDATA dsssl>                                                  劆
劆]]>                                                                 劆
劆                                                                    劆
劆(2) " CDATA dsssl>                                                  劆
劆]]>                                                                 劆
劆]>                                                                  劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

(1) 嵟弶偺 "docbook.dsl" 偑丄/usr/lib/sgml/stylesheets/nwalsh-modular/
    html/docbook.dsl 傪撉傓傛偆偵偟偰偔偩偝偄丅
(2) 擇偮栚偺 "docbook.dsl" 偑 /usr/lib/sgml/stylesheets/nwalsh-modular/
    print/docbook.dsl 傪撉傓傛偆偵偟偰偔偩偝偄丅

傕偟堘偆 DSSSL 傪巊偭偰偄傞側傜丄忋婰傆偨偮偺僼傽僀儖偺偲偙傠偑 HTML 梡
偲僾儕儞僩梡偺 DSSSL 僼傽僀儖傪巜偡傛偆偵曄峏偟偰偔偩偝偄丅捠忢丄偦傟傜
偼 html 傗 print 偲屇偽傟傞僨傿儗僋僩儕偵擖偭偰偄傑偡丅

埲忋偑嵪傔偽丄HTML 僼傽僀儖偺弌椡偑偱偒傞傛偆偵側傝傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ mkdir HOWTO-HOWTO ; cd HOWTO-HOWTO                                                  劆
劆bash$  jade -t sgml -i html -d /usr/lib/sgml/stylesheets/ldp.dsl\#html ../HOWTO-HOWTO.sgml劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

嵟弶偺僐儅儞僪偱偼丄弌椡僼傽僀儖傪擖傟傞僨傿儗僋僩儕傪嶌惉偟偰偄傑偡丅
師偺僐儅儞僪(jade 傪巊偭偰偄傞曽偱偡)偱偼丄暥彂偺僙僋僔儑儞偛偲偺屄暿偺
HTML 僼傽僀儖傪惗惉偟偰偄傑偡丅RTF 側偳傪弌椡偟偨偄応崌偼丄師偺傛偆偵偟
偰偔偩偝偄丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ jade -t rtf -d /usr/lib/sgml/stylesheets/ldp.dsl ../HOWTO-HOWTO.sgml劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 8. 暥彂偺岞奐偵偮偄偰

8.1. 暥彂岞奐偺傑偊偵

彨棃偺柍悢偺撉幰偵暥彂傪岞奐偡傞傑偊偵丄傗傞傋偒偙偲偑偄偔偮偐偁傝傑偡
丅

戞堦偵丄昁偢僗儁儖僠僃僢僋傪偡傞偙偲偱偡丅SGML 傪彂偔偺偵巊傢傟傞儐乕僥
傿儕僥傿偵偼丄偨偄偰偄僗儁儖僠僃僢僋梡偺僾儔僌僀儞偑晅偄偰偄傑偡丅晅偄
偰偄側偄応崌偱傕丄aspell 偑偁傝傑偡丅

戞擇偵丄懠偺恖偵嵏撉偟偰傕傜偄丄僐儊儞僩傪傕傜偭偨傝丄帠幚偵娫堘偄偑側
偄偐妋擣偟偰傕傜偭偰偔偩偝偄丅LDP 偑弌偡暥彂偼丄柍悢偺 Linux 儐乕僓偑撉
傓偙偲偵側傞偺偱丄帠幚偺岆傝偼嬌椡尭傜偡昁梫偑偁傝傑偡丅幏昅懳徾偵娭偟
偰戝惃偺恖偑嶲壛偡傞儊乕儕儞僌儕僗僩偵搊榐偟偰偄傞側傜丄偦偙偱懠偺恖偵
恞偹偰丄彆偗偰傕傜偄傑偟傚偆丅

戞嶰偵丄嶌惉偟偨暥彂傪岞奐偡傞僂僃僽僒僀僩傪嶌偭偰偔偩偝偄丅偙傟偼昁恵
偱偼偁傝傑偣傫偑丄偦偺暥彂偑偳偙偱嶌惉偝傟偨偺偐傪抦傞庤偑偐傝偵側傝傑
偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

8.1.1. SGML 僐乕僪偺懨摉惈専嵏

jade 傗幚嵺偺 nsgmls 僐儅儞僪傪巊偭偰丄嶌惉偟偨 .sgml 僐乕僪偑 DTD 偵徠
傜偟偰懨摉偐偳偆偐専嵏偟丄僄儔乕偺側偄偙偲傪妋偐傔傞偙偲偑偱偒傑偡丅

劇劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劉
劆bash$ nsgmls -s HOWTO-HOWTO.sgml                                    劆
劋劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劅劊

偙傟偱栤戣偑側偗傟偽丄壗帠傕側偔僐儅儞僪僾儘儞僾僩偑曉偭偰偒傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

8.2. 挊嶌尃偲儔僀僙儞僗偺栤戣

LDP 偱 LDP 暥彂偲偟偰擣傔傜傟傞偵偼丄http://www.linuxdoc.org/
manifesto.html 偵偁傞 LDP 儅僯僼僃僗僩偺 " 儔僀僙儞僗忋偺昁梫帠崁 " 偵
廬偭偨儔僀僙儞僗偑晅偄偰偄側偗傟偽側傝傑偣傫丅暥彂偺嶌惉幰偲偟偰丄挊嶌
尃傪曐帩偡傞偙偲偑偱偒傑偡偟丄儔僀僙儞僗偵懠偺惂尷 (偨偲偊偽丄東栿傗擇
師暥彂傪嶌惉偟偨偲偒偼丄挊幰偺彸擣傪摼側偗傟偽側傜側偄丄偲偐) 傪晅偗壛
偊傞偙偲傕偱偒傑偡丅

傢傟傢傟偲偟偰偼丄GNU Free Documentation License (GFDL) <http://
www.gnu.org/copyleft/fdl.html> 偐丄僆僾僔儑儞 A 偲 B 側偟偺 Open
Publication License (OPL) <http://opencontent.org/openpub/> 傪巊偆偙偲
傪偍慐傔偟傑偡丅 DocBook 梡偵儅乕僋傾僢僾偝傟偨 GNU GPL 偲 GNU FDL 偑 
GNOME Documentation Project <http://developer.gnome.org/projects/gdp/
licenses.html> 偵偁傞偺偱丄偦傟傪巊偆偙偲傕偱偒傑偡丅偦偺応崌丄儔僀僙儞
僗慡暥傪暥彂撪偵擖傟傞偩偗偱偡丅偨偩丄慡暥偼挿偄偺偱丄儔僀僙儞僗傊偺儕
儞僋傪彂偒崬傫偱偍偔偩偗偱傕寢峔偱偡丅

挊嶌尃偺乽拻宆乿傪巊偍偆偲偡傞応崌偼丄" 挊嶌尃偲儔僀僙儞僗 "偲偄偭偨僙
僋僔儑儞傪棫偰偰丄偦偙偵暥柺傪偦偺傑傑僐僺乕偟偰偔偩偝偄丅屼帺暘偺柤慜
偱挊嶌尃偺昞帵傕擖傟偰偔偩偝偄丅(儔僀僙儞僗偺偨傔偵挊嶌尃偑扗傢傟傞傢偗
偱偼偁傝傑偣傫丅) 婛懚偺暥彂偺怴偟偄娗棟幰偵側偭偨応崌偼丄偦偺暥彂傪娗
棟偟偰偄偨埲慜偺挊幰柤偲擔晅偵偮偄偰偺挊嶌尃傕彂偐側偗傟偽側傝傑偣傫丅

偙偺 LDP Author Guide 偺儔僀僙儞僗偱偼丄擇師暥彂傗東栿傪嶌惉偡傞応崌偵
挊幰傊偺曬崘傪媮傔偰偄傞偙偲偵丄偍婥晅偒偐傕偟傟傑偣傫丅傑偨丄傢偨偟偼
丄(偙偺暥彂傪彂偄偨 SGML 偺僜乕僗僐乕僪傪彍偔) 偡傋偰偺僜乕僗僐乕僪傪柧
帵揑偵 GPL 偺婎偵抲偒傑偟偨丅嶌惉偟偨 HOWTO 偵僜乕僗僐乕僪偑娷傑傟偰偄
偰丄偦傟傪懠偺恖偵傕巊偭偰傕傜偍偆偲巚偆偲偒偼丄摨偠傛偆偵偡傞偲偄偄偲
巚偄傑偡丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

8.3. LDP 傊偺婑峞

LDP 暥彂偺偒傔嵶偐偄嵏撉偑嵪傓偲丄偦偺暥彂偼 LDP 偱儕儕乕僗偱偒傑偡丅
SGML 僜乕僗僐乕僪傪揧晅偟偰丄(<submit@linuxdoc.org> 偵儊乕儖傪憲偭偰偔
偩偝偄丅( gzip 偱埑弅偟偰傕寢峔偱偡丅)

儊乕儖偺 subject 棑偵偼 HOWTO 偺暥彂柤傪擖傟偰丄杮暥偵偼偦偺 HOWTO 偺曄
峏揰傗彂偒懌偟偨揰偺奣梫傪彂偄偰偍偔偺傪朰傟側偄偱偔偩偝偄丅偙傟偑偁傞
偲暥彂娗棟偺嶌嬈帪娫偑抁弅偱偒傑偡偟丄憲偭偨 HOWTO 偑 LDP 偺僂僃僽僒僀
僩忋偱峏怴偝傟傞偺傪懸偨側偔偰嵪傒傑偡丅5 擔娫壗偺抦傜偣傕側偄偲偒偼丄
傕偆堦搙儊乕儖傪憲偭偰丄傑偩嶌嬈拞側偺偐偳偆偐妋擣偟偰偔偩偝偄丅

HOWTO 偵僥僉僗僩埲奜偺夋憸傗摿暿側僇僞儘僌偑娷傑傟傞応崌丄.sgml 僜乕僗
僐乕僪傪娷傓慡僼傽僀儖傪 .tar.gz 僼傽僀儖偵屌傔偰丄儊乕儖偵揧晅偟偰
submit 儊乕儕儞僌儕僗僩傑偱憲偭偰偔偩偝偄丅

暥彂偺嶌惉拞偵 LDP CVS 僣儕乕傪巊偭偰偄傞応崌偼丄暥彂傪岞奐偡傞弨旛偑惍
偭偨偲偒偵嵞搙 LDP 傊曬崘偡傞昁梫偑偁傝傑偡丅偦偺嵺偼丄
<submit@linuxdoc.org> 偵儊乕儖傪偍憲傝偔偩偝偄丅僞僀僩儖偵暥彂柤傪擖傟
偰丄杮暥偵 LDP CVS 僣儕乕撪偱偺憡懳僷僗傪彂偄偰偍偄偰偔偩偝偄丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

8.4. 嶌惉偟偨暥彂偺娗棟

嶌惉偟偨 HOWTO 偑岞奐偝傟偨偐傜偲偄偭偰丄巇帠偑慡晹廔傢偭偨傢偗偱偼偁傝
傑偣傫丅HOWTO 偺忣曬傪峏怴偟丄撉幰偺傾僀僨傾傗採埬偵墳偊偰 HOWTO 傪妋幚
偵夵慞偟偰偄偔偨傔偵偼丄掕婜揑側儊僀儞僥僫儞僗偑晄壜寚偱偡丅HOWTO 偵偼
丄妶敪偵惉挿偡傞惗偒偨抦幆偑媗傑偭偰偄傞偺偱丄岞奐偟偨傜偦傟偱廔傢傝偲
偄偆屌掕揑側傕偺偱偼偁傝傑偣傫丅

HOWTO 偵帺暘偺儊乕儖傾僪儗僗傪彂偄偰丄撉幰偐傜偺僼傿乕僪僶僢僋傪挌擩偵
偍婅偄偟偨偱偟傚偆偐丠堦扷惓幃偵岞奐偝傟傞偲丄採埬偺儊乕儖傪偄偔偮傕庴
偗庢傞傛偆偵側傝傑偡丅偦偺側偐偵偼偲偰傕婱廳側傕偺偑偁傝傑偡偑丄偦傟埲
奜偼屄恖揑側栤戣偺夝寛傪媮傔傞傕偺偩偭偨傝偟傑偡丅帪娫偑側偗傟偽丄屄恖
揑側栤戣偵墳偊傞昁梫偼慡偔偁傝傑偣傫丅LDP 偱 HOWTO 傪彂偄偨偐傜偲偄偭偰
丄僱僢僩忋偺偁傜備傞恖偵僼儕乕僒億乕僩傪惗奤懕偗傞媊柋傪晧偆傢偗偱偼側
偄偐傜偱偡丅偨偩丄傕偟偱偒傞側傜丄偦偆偟偨恖偵暿偺忣曬尮傪嫵偊偰偁偘傞
偲丄恊愗偱偼偁傝傑偡丅傑偨丄庴偗庢偭偨幙栤偺僷僞乕儞偑尒偊偰偔傟偽丄
HOWTO 偵捛壛偡傋偒僩僺僢僋偑暘偐傞偐傕偟傟傑偣傫丅

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Chapter 9. LDP 偵偮偄偰偺 FAQ

Q: LDP 偺偍庤揱偄傪偟偨偄偺偱偡偑丄偳偆偟偨傜偄偄偱偟傚偆丠
Q: LDP 暥彂傪傑偲傔偰丄彂愋偲偟偰弌斉偟偨偄偺偱偡偑丄LDP 暥彂偺儔僀僙儞
    僗偼偳偆偄偭偨傕偺偵側傝傑偡偐丠
Q: LDP 暥彂偺拞偵岆傝傪尒偮偗偨偺偱偡偑丄廋惓偱偒傑偡偐丠
Q: SGML 偑暘偐傝傑偣傫丅/ 僣乕儖偑摦偒傑偣傫丅/ SGML 偑寵偄偱偡丅

Q: LDP 偺偍庤揱偄傪偟偨偄偺偱偡偑丄偳偆偟偨傜偄偄偱偟傚偆丠

A: 堦斣娙扨側曽朄偼丄壗偐庡戣傪憑偟偰丄偦傟傪暥彂壔偡傞偙偲偱偡丅傕偟偔
偼丄娗棟幰偑偄側偄 HOWTO 傪僠僃僢僋偟偰丄帺暘偑傛偔抦偭偰偄傞暘栰偱暥彂
壔偟懕偗傜傟傞傕偺偑側偄偐妋擣偡傞偙偲偱偡丅

Q: LDP 暥彂傪傑偲傔偰丄彂愋偲偟偰弌斉偟偨偄偺偱偡偑丄LDP 暥彂偺儔僀僙儞
僗偼偳偆偄偭偨傕偺偵側傝傑偡偐丠

A: http://www.linuxdoc.org/COPYRIGHT.html" <http://www.linuxdoc.org/
COPYRIGHT.html> 傪偛棗偔偩偝偄丅偨偩丄偙傟偼屄乆偺挊幰偵懳偡傞僈僀僪儔
僀儞偱偟偐側偄偙偲偵拲堄偟偰偔偩偝偄丅偲偼偄偊丄偙偺 URL 偵嫇偑偭偰偄傞
傕偺傛傝尩偟偄忦審傪晅偗傞偙偲偼偱偒傑偣傫丅

Q: LDP 暥彂偺拞偵岆傝傪尒偮偗偨偺偱偡偑丄廋惓偱偒傑偡偐丠

A: 暥彂偺挊幰偐丄LDP 僐乕僨傿僱乕僞 <discuss@linuxdoc.org> 埗偵楢棈偟偰
丄栤戣偺晹暘偲丄偳偆偄偆廋惓偑昁梫偑昁梫偐傪曬崘偟偰偔偩偝偄丅

Q: SGML 偑暘偐傝傑偣傫丅/ 僣乕儖偑摦偒傑偣傫丅/ SGML 偑寵偄偱偡丅

A: 栤戣偁傝傑偣傫丅嵟弶偺憪峞偼丄偍岲偒側僼僅乕儅僢僩偱彂偄偰偄偨偩偄偰
寢峔偱偡偺偱丄偦傟傪 LDP 傑偱偍憲傝偔偩偝偄丅LDP 儃儔儞僥傿傾偑嵏撉偟偰
丄偦偺屻偱 DocBook 偵曄姺偟傑偡丅偦傟偝偊嵪傔偽丄HOWTO 偺娗棟帺懱偼擄偟
偔側偄偱偟傚偆丅媈栤偑偁傟偽丄偄偮偱傕 LDP 儃儔儞僥傿傾偵楢棈偡傞偐丄
LDP DocBook 儊乕儕儞僌儕僗僩 <docbook@linuxdoc.org> 傑偱楢棈偟偰偔偩偝
偄丅

梡岅廤

懏惈 (attribute)
   
    懏惈偲偼丄偦傟偑抲偐傟偨僄儗儊儞僩偵捛壛忣曬傪帩偨偣傞偙偲傪壜擻偵
    偡傞傕偺偱偡丅懏惈偼丄昁偢乽懏惈柤偲抣乿偺儁傾偑弶婜壔億僀儞僞偱寢
    偽傟偨宍偱尰傟傑偡丅id="identification" 偼懏惈偺堦椺偱偡偑丄偙偙偱
    偼 id 偑懏惈偱丄identification 偑抣偱偡丅
   
暥彂宆掕媊 (DTD, Document Type Definition)
   
    慻傒崌傢偣偲弴彉偵偮偄偰偺儖乕儖傪巜掕偟偰丄僄儗儊儞僩柤偲偦偺懏惈
    偲傪掕媊偟偨暥尵偺廤崌丅僇乕僜儖埵抲偺僐儞僥僉僗僩忋偱丄偁傞僄儗儊
    儞僩傪憓擖偱偒傞偐斲偐傪掕媊偟偰偄傞偺偑丄DTD 偱偡丅
   
DSSSL
   
    DSSSL 偼丄Document Style Semantics and Specification Language 偺棯
    偱偡丅 ISO 昗弨 (ISO/IEC 10179:1996) 偲側偭偰偄傑偡丅DSSSL 婯奿偼丄
    SGML 偺暥彂僗僞僀儖僔乕僩儁乕僕偺偨傔偺尵岅偲偟偰崙嵺揑偵巊梡偝傟偰
    偄傑偡丅
   
僄儗儊儞僩 (element)
   
    僄儗儊儞僩偼丄暥彂偺奒憌峔憿傪掕媊偡傞傕偺偱偡丅傎偲傫偳偺僄儗儊儞
    僩偼丄奐巒僞僌偲廔椆僞僌偐傜惉傝傑偡丅偦偺僞僌偺娫偵丄暥復偺堦晹傗
    丄偁傞偄偼暥彂慡懱偑擖傝傑偡丅奐巒僞僌偩偗偟偐側偔丄僐儞僥儞僩傪帩
    偨側偄嬻僄儗儊儞僩 (empty element)偲偄偆偺傕偁傝傑偡丅
   
僄儞僥傿僥傿 (entity)
   
    僄儞僥傿僥傿偲偼丄偁傞柤慜偵傛偭偰(SGML 暥彂撪偱)嶲徠偱偒傞傛偆偵偝
    傟偨堦晹偺僨乕僞偵偮偄偰丄偦偺僨乕僞傪巜帵偡傞柤徧偱偡丅偙偺巜帵偼
    丄暥彂拞偵暥尵偲偟偰彂偒崬傓偙偲偱桳岠偵側傝傑偡丅巜帵懳徾偲側傞僨
    乕僞偼丄扨弮側暥帤楍傗暋悢偺曇偲側傞暥復孮偱傕傛偔丄DTD 偺堦楢偺暥
    尵偱傕峔偄傑偣傫丅 SGML 忋偱偺僄儞僥傿僥傿偵偼丄僷儔儊乕僞僄儞僥傿
    僥傿 (parameter entity)丄堦斒僄儞僥傿僥傿(generic entity)丄奜晹僄儞
    僥傿僥傿 (external entity)丄撪晹僄儞僥傿僥傿(internal entity)丄僨乕
    僞僄儞僥傿僥傿 (data entity)偑偁傝傑偡丅
   
奜晹僄儞僥傿僥傿 (external entity)
   
    奜晹僄儞僥傿僥傿偼丄奜晹暥彂傪億僀儞僩偡傞傕偺偱偡丅奜晹僄儞僥傿僥
    傿偼丄 SGML 暥彂偺擟堄偺埵抲偵僥僉僗僩傪庢傝崬傒偨偄応崌偵巊梡偟傑
    偡丅巊偄曽偲偟偰偼丄僒儞僾儖僾儘僌儔儉傗朄棩忋偺拲堄彂偒丄暥彂偺堦
    曇側偳傪庢傝崬傓偙偲偑峫偊傜傟傑偡丅
   
堦斒僄儞僥傿僥傿 (generic entity)
   
    "&" 偱巒傑傝僙儈僐儘儞偱廔傢傞柤慜偱嶲徠偝傟傞僄儞僥傿僥傿偼丄堦斒
    僄儞僥傿僥傿偱偡丅傎偲傫偳偺応崌丄偙偺僞僀僾偺僄儞僥傿僥傿偼丄暥彂
    忋偱巊梡偝傟丄DTD 忋偱偼巊梡偝傟傑偣傫丅堦斒僄儞僥傿僥傿偵偼丄奜晹
    僄儞僥傿僥傿偲撪晹僄儞僥傿僥傿偺擇庬椶偑偁傝傑偡丅偳偪傜傕丄摿庩暥
    帤傗丄傕偟偔偼丄孞傝曉偟棙梡偝傟傞僙儞僥儞僗丄柤慜丄暥彂偺堦曇側偳
    傪嶲徠偡傞傕偺偱偡丅
   
撪晹僄儞僥傿僥傿 (internal entity)
   
    撪晹僄儞僥傿僥傿偼丄僥僉僗僩偺堦晹傪嶲徠偡傞偨傔偺傕偺偱丄偟偽偟偽
    丄昿斏偵棙梡偝傟傞僥僉僗僩偺堦晹偺僔儑乕僩僇僢僩偲偟偰巊傢傟傑偡丅
   
僷儔儊乕僞僄儞僥傿僥傿 (parameter entity)
   
    DTD 忋偱傛偔巊梡偝傟傞僄儞僥傿僥傿丅偙偺僄儞僥傿僥傿柤偼丄僷乕僙儞
    僩婰崋 (%) 偱巒傑傝丄僙儈僐儘儞偱廔傢傝傑偡丅
   
僼儘乕僩 (float)
   
    僒僀僪僶乕傗夋憸丄昞慻丄僠儍乕僩側偳偺僆僽僕僃僋僩偱丄僥僉僗僩忋偵
    偍偄偰寛傑偭偨埵抲傪帩偨側偄応崌偵丄僼儘乕僩偲屇偽傟傑偡丅報嶞僥僉
    僗僩偺応崌丄僠儍乕僩偼丄儁乕僕偺堦斣忋偐堦斣壓偵抲偐傟傑偡丅戝偒偡
    偓傞嵺偼丄師偺儁乕僕偵搉偭偰抲偐傟傑偡丅
   
張棟柦椷 (processing instruction)
   
    張棟柦椷偲偼丄暥彂惉宍僣乕儖偵搉偝傟傞僐儅儞僪偺偙偲偱偡丅張棟柦椷
    偼丄 "<?" 偱巒傑傝傑偡丅偙偺暥彂忋偱丄HTML 僼傽僀儖傊偺曄姺偺嵺偵弌
    椡僼傽僀儖柤傪巜掕偡傞偨傔偵巊梡偝傟偰偄傞僐儅儞僪偺堦椺偲偟偰丄師
    偺傛偆側傕偺偑偁傝傑偡丅 <?dbhtml filename="file.html">
   
SGML
   
    斈梡儅乕僋傾僢僾尵岅婯栺(Standard Generalized Markup Language)丅偙
    傟偼丄巊梡偝傟傞僾儔僢僩僼僅乕儉偵埶懚偟側偄丄儅乕僋傾僢僾僔僗僥儉
    傪巊偭偨揹巕暥彂嶌惉偺偨傔偺儖乕儖傪婯掕偡傞崙嵺昗弨 (ISO8879) 偱傕
    偁傝傑偡丅
   
僞僌 (tag)
   
    "<" 偲 ">" 儅乕僋偵嫴傑傟偨 SGML 僄儗儊儞僩偺偙偲丅僞僌偼丄暥彂偺堄
    枴傗峔憿傪儅乕僋偡傞偨傔偵巊梡偝傟傑偡丅僞僌偺堦椺偲偟偰偼丄僞僀僩
    儖偺奐巒傪儅乕僋偡傞偨傔偺 <title> 偑偁傝傑偡丅
   
XML
   
    eXtensible Markup Language. 僀儞僞乕僱僢僩偱偺棙梡偺偨傔偵摿暿偵嶌
    惉偝傟偨 SGML 偺僒僽丒僾儘僟僋僩丅
   
XSL
   
    XML Style Language. XSL 偲 XML 暥彂偲偺娭學偼丄DSSSL 偲 SGML 暥彂偺
    娭學偲摨偠偱偡丅幚嵺丄偙偺僗僞僀儖偼丄暥彂偲偟偰偺 XML 偦偺傕偺偱偡
    丅
   
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

Index

C

catalogue
   
    creating
       
        example, Creating and modifying catalogues
            <making-catalogues.html>
        terminology, Explaining the terminology system
            <making-catalogues.html#CATALOGUE-EXPLAINING-TERMINOLOGY>
       
    modifying, Creating and modifying catalogues
        <making-catalogues.html>
       
        sample, Creating and modifying catalogues
            <making-catalogues.html>
        terminology, Explaining the terminology system
            <making-catalogues.html#CATALOGUE-EXPLAINING-TERMINOLOGY>
       
catalogues
   
    creating, Creating and modifying catalogues
        <making-catalogues.html>
       
configurations, Configuration needed <configurations.html>
   
    variables
       
        SGML_CATALOG_FILES, Configuration needed <configurations.html>
       
conventions, Documents <conventions.html>

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

D

documents
   
    re-use, Re-using parts of documents <tools-hints.html#TOOLS-REUSE>
       
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

E

edition
   
    examples, Document samples <examples-documents.html>
       
        article, Article example <examples-documents.html#
            EXAMPLES-DOCUMENTS-ARTICLE>
        book, Book Example <examples-documents.html#
            EXAMPLES-DOCUMENTS-BOOK>
       
    index, Encoding Indexes <encoding-index.html>
       
    using DocBook, Writing with DocBook elements <writing-docbook.html>
       
        commands, Useful commands <writing-docbook.html#
            WRITING-DOCBOOK-COMMANDS>
       
entities
   
    parameters
       
        exemple, Making notes on the text while it's being written
            <tools-hints.html#TOOLS-WRITING>
        usage, Making notes on the text while it's being written
            <tools-hints.html#TOOLS-WRITING>
       
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

F

figures
   
    inserting
       
        figure, Inserting Pictures <inserting-pictures.html>
        mediaobject, Alternative Methods <inserting-pictures.html#
            INSERTING-FIGURES-MEDIAOBJECT>
       
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

G

graphics
   
    inserting
       
        graphic, Inserting Pictures <inserting-pictures.html>
        mediaobject, Alternative Methods <inserting-pictures.html#
            INSERTING-FIGURES-MEDIAOBJECT>
       
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

L

listings
   
    inserting, Listings and program codes <listings.html>
       
        example, Listings and program codes <listings.html>
       
劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

N

nedit, nedit <editing.html#NEDIT>

劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒

T

tables
   
    inserting, Tables <tables.html>
       
        example, Tables <tables.html>
       
tools
   
    articles
       
        summary, Inserting a summary on the initial articles page
            <tools-hints.html#TOC-ARTICLES>
       
    compiling sources
       
        compile-sgml, Compiling the sources <tools-hints.html#
            TOOLS-COMPILE>
       
    compiling the sources, Compiling the sources <tools-hints.html#
        TOOLS-COMPILE>
       
    indexes
       
        automatic generation
           
            See also edition, index
           
Notes

[1] 偁側偨偺暥彂忋偱杮彂偲摨偠昞婰傪嶌傝偨偄応崌偼丄偙偺暥彂偺僜乕僗傪 
    偛棗偔偩偝偄丅偨偩丄尰嵼偛棗偄偨偩偄偰偄傞昞婰偼丄偁側偨偑偳偺僼僅 
    乕儅僢僩偱偙偺暥彂傪偍撉傒偵側偭偰偄傞偐偵埶懚偟傑偡丅僆儞儔僀儞暥 
    彂偺昞婰偼丄PostScript 傗 PDF 偱偺偦傟偲偼彮偟堎側傝傑偡丅         
                                                                       
[2] 桳岠僐儞僥儞僩偼丄DTD, DOCUMENT, ELEMENTS, ENTITIES, NONSGML 偱偡丅
                                                                       
[3] 嶕堷偺徻嵶偼丄Norman Walsh 偺僒僀僩偵偁傞嶕堷娭學偺儁乕僕傪偛棗偔偩
    偝偄丅                                                             
                                                                       
[4] 忋婰 2 偮偺 quotation 偼丄嶳宍峗惗偝傫偺東栿偐傜偍庁傝偟傑偟偨丅   
                                                                       
[5] (栿拲: 偙偺暥彂(尨暥)偺 SGML 僜乕僗偱偼丄嵟弶偵僞僌傪柍廋惓偱抲偒丄
    偦偺拞偱偺嵟弶偺傪偲偟偰偄傑偡丅僩僢僾儗儀儖丒僄儗儊儞僩( LDP 偱偼 
    丄斾妑揑抁偄暥彂偵偼偑丄挿傔偺暥彂偵偼偑巊傢傟傞偙偲偑懡偄傛偆偱偡 
    丅) 偵墳偠偰揔媂撉傒懼偊偰偔偩偝偄丅)                              

