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 ̍쐬҂Kɕ쐬邽߂̃c[菇Aуqg
AXgAbv܂B



Table of Contents
1. ̕ɂ
   
    1.1. ̖̕ړIƎ˒
    1.2. LDP ɂ
    1.3. tB[hobN
    1.4. 쌠ƏW
       
        1.4.1. {ɂ
       
    1.5. ӎ
    1.6. ̕̕\L@
   
2. LDP  SGML ̏Љ
   
    2.1. LDP
    2.2. SGML
    2.3. Ȃ HTML łȂASGML Ȃ̂H
    2.4. SGML  XML Ȃ
    2.5. ߂Ċe
    2.6. [OXg
   
3. 쐬c[
   
    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 g
            3.3.1.2. XML [h 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 ̎g
           
    3.5. ҏWc[
       
        3.5.1. Emacs (PSGML)
           
            3.5.1.1. PSGML g SGML @
           
        3.5.2. VIM
           
            3.5.2.1. ͂߂
            3.5.2.2. VK̃[h͍쐬
           
        3.5.3. WordPerfect 9 (Corel Office 2000)
        3.5.4. sgedit
        3.5.5. nedit
           
            3.5.5.1. nedit ̎g
            3.5.5.2. nedit  Tips ƃRc
           
    3.6. CVS
       
        3.6.1. CVS AJEg̓
        3.6.2. ȊO CVS |Wgւ̃ANZX@
           
            3.6.2.1.  CVS ANZX
            3.6.2.2. Web oRł CVS t@C
            3.6.2.3. OtBJC^[tFCXg
           
        3.6.3. t@C̍XV CVS
       
    3.7. ̑̃c[ƃt@X
       
        3.7.1. DocBook: The Definitive Guide
        3.7.2. SGML ev[g
        3.7.3. Aspell
        3.7.4. ispell
       
4. DocBook ^O̎g
   
    4.1. ͂߂
    4.2. KvȐݒ
    4.3. J^O̍쐬ƏC
       
        4.3.1. p̐
        4.3.2. J^Oł֗̕ȃR}h
       
    4.4. DocBook Gg̎g
       
        4.4.1. ֗ȃR}h
       
    4.5. 
    4.6. 摜̑}
       
        4.6.1. LȊO̕@
       
    4.7. \g
    4.8. vOR[hƃRg
    4.9. |҂R[hϊ҂̎\
       
        4.9.1. <othercredit> ^O
        4.9.2. "ӎ" (Acknowledgements) ̏͂ɂ
        4.9.3. <revremark> ^O
       
    4.10. c[ƃqg
       
        4.10.1. \[X̃RpC
        4.10.2. article ̍ŏ̃y[Wɗv|}
        4.10.3. Iɑ}
        4.10.4. ̒̉B
        4.10.5. pɂɗp镶O荞
       
    4.11. ̃Tv
       
        4.11.1. article ̗
        4.11.2. book ̗
       
5. LDP X^CEKCh
   
    5.1. ߂
    5.2. AEgC쐬
    5.3. ͂
    5.4. eLXg̐ȂƍZ
    5.5. 쐬 HOWTO ̊Ǘ
    5.6. t@X
   
6. X^C֘A̕⑫
   
    6.1. t̏
    6.2. 摜tH[}bg
    6.3. DocBook ̃o[W
    6.4. p֎~̃^O
    6.5. ^O̍ŏ
    6.6. ł̕\L@
   
7. DocBook ̃eNjbNƃRc
   
    7.1. 摜̑}
    7.2. HTML o̓t@C̃t@Cw肷
    7.3. ldp.dsl g
   
8. ̌Jɂ
   
    8.1. Ĵ܂
       
        8.1.1. SGML R[h̑Ó
       
    8.2. 쌠ƃCZX̖
    8.3. LDP ւ̊e
    8.4. 쐬̊Ǘ
   
9. LDP ɂĂ FAQ
pW
Index

List of Tables
4-1. ֗ȃR}h
4-2. \̗

List of Figures
3-1. sgedit ̃XN[Vbg
3-2. nedit ̃XN[Vbg
3-3. nedit ւ̃VFR}h̒ǉ
3-4. G[Ȃꍇ nsgml ̏o

List of Examples
4-1. J^O̗
4-2. ̂߂̃R[h
4-3.  zone ̎g
4-4.  class ŁAl startofrange  endofrange g@
4-5. 摜̑}
4-6. <imageobject>̎g
4-7. \̑}
4-8. compiles-sgml XNvg
4-9. article ŁAIɗv|}邽߂ stylesheet ̐ݒ
4-10. t邽߂ɊOGeBeBݒ肷
4-11. p[^EGeBeBg



Chapter 1. ̕ɂ

1.1. ̖̕ړIƎ˒

̍̕쐬́A1999N826AMark F. Komarinski 쐬c[
̂ 2 ƂɃC̂łB̕
Ƃlł LDP ҂̖ɗƂA킽̖߂͉ʂ܂
B

̍̕ŐVo[ẂALDP ̃z[y[W http://www.linuxdoc.org
<http://www.linuxdoc.org/> ɂ܂BIWi DocBook SGML tH[
}bgȂ HTML ̃tH[}bgɂ܂B

ۂɃR[hƂALinux [ugɍv@͂
܂BdvȂ̂̂ЂƂAƂłBɂČXl
E̖̐lXƒmL邱Ƃł܂B́̕Aǎ҂
LDP ̊e𗝉Ă炢A HOWTO ۂɕKvȃc[ɂ
ĒmĂ炤߂ɍ쐬Ă܂B



1.2. LDP ɂ

        Linux Documentation Project ́AGNU / Linux Iy[e         
        BOVXeɂĂ̗ǎŃt[ȕJ邽         
        ߂ɊĂ܂BLDP ̍ő̖ړÍALinux Ɋւ         
        ׂĂ̎̕Aŉi߂邱ƂłB             
        HOWTO  Guide ̍쐬͂ɂ܂Bɂ        
        ́AȒPɗpƌł镶VXe\z         
        lĂ܂Bman y[W info AHOWTO ̑̓         
        ͂ɂ܂B                                         
                                                                       
     --LDP }jtFXg: http://www.linuxdoc.org/manifesto.html        

̌ɂ͂̂悤ȂƂĂ܂BuLDP ł̓{eB
A吨W܂ Linux OS p̕ĂBԖڗ̂ HOWTO 
AHOWTO  http://www.linuxdoc.org/ ɂBv̕ (LDP Author
Guide) ̎ȖړÍA HOWTO  LDP Ɋe@
ƂłB



1.3. tB[hobN

̕ւ̃RǵA (<markk@linuxdoc.org>) ܂ł肢܂B



1.4. 쌠ƏW

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

́̕Aȉ̏AS邢͈ꕔ𖳗ŕł܂
B

 E Ŝ͕𕡐ꍇAL쌠\Ƃ̗pƂA
    ̕ɊSȌ^ŕێ邱ƁB
   
 E |͓񎟓I앨쐬ꍇAzzɐ旧A҂ɘA
    ďF𓾂邱ƁB
   
 E ̈̕ꕔ݂̂zzꍇA̔zzɂ́AŜ̓肪
    \ł邱Ƃ𖾋LAŜ̓@\邱ƁB
   
 E ̋͂̕ȕA]̍ޗƂđ̒앨ɓ]ڂ
    ۂ́ÄpȂ̂łꍇɌA̗p̋Lڂ
    łBwpړIł̗pɂẮA̗p̓KpOƂȂ
    ꍇ̂ŁA҂܂ŘAĐq˂邱ƁB̐́A҂
    Ă̂̌邽߂̂̂łāA҂wK҂ɐ
    ۂƂӐ}ĂȂB (̍̕쐬tH[}bgł SGML
    R[h) ׂ̂̕Ẵ\[XR[hɂ́AGNU General
    Public License KpBLCZX́A FTP oRŁAGNU
    A[JCu\łB
   


1.4.1. {ɂ

JF Project <JF@linux.or.jp>

|UTi <ysenda@pop01.odn.ne.jp >

Z^Y <s_sakai@mxn.mesh.ne.jp >

̓{ALɏ]ĔzzĂB



1.5. ӎ

̍̕쐬ɂARgׂĂ̐lXA David
Lawyer, Deb Richardson, Daniel Barlow, Greg Ferguson, Mark Craig, 
 <ldp-discuss@lists.linuxdoc.org> [OXg̃o[Ɋ
܂BHOWTO Index <http://www.linuxdoc.org/HOWTO/>  sgmltools ̕
́A̃ZNV𔲐Ă܂BCVS ւ̃lb
g[NANZXɊւZNV̈ꕔ́ASerek
(<ser@serek.arch.pwr.wror.pl>)Ă܂B DocBook ɊւZNV
́AJorge Godoy (<godoy@conectiva.com>) ܂Bl̋͂ɑ
ϊӂĂ܂B



1.6. ̕̕\L@

́̕Aȉ̕\L@gpĂ܂B [1]

                                      \L                    
x                                      
                                                Caution       
                                          
                                          xB            
                                          
qg                                        Tip: qgB       
                                                                  
                                          Note: ӕB      
                                                                  
ɒӂׂ                        
                                                Warning       
                                          
                                          ɏdvȌxB  
                                          
t@C                                file.extension          
fBNg                            directory               
̓R}h                              command                 
AvP[V                        application             
bash ł̃[UR}h̃vvg       bash$                   
bash ł̃[g[UR}h̃vvg bash#                   
tcsh ł̃[UR}h̃vvg       tcsh$                   
ϐ                                  VARIABLE                
ꂽP                            word                    
TvR[h                            pOt̍ŏƍŌB



Chapter 2. LDP  SGML ̏Љ

2.1. LDP

Linux Documentation Project (LDP) X^[ĝ́AS҂A
ΏۂɂĂ̏΂₭邱Ƃł悤ɂ邽߂łB
LDP ɂ́AVXeǗlbg[NAvO~OɂĂ̈A̕
łȂAʂ̕ΏۂƂāAgƂl
ƍׂɊւ镶ɂ܂BɂĒm肽Ȃ
APrinting-HOWTO <http://www.linuxdoc.org/HOWTO/Printing-HOWTO.html>, (
{ <http://www.linux.or.jp/JF/JFdocs/Printing-HOWTO.html>) 
܂A莝̃C[TlbgJ[h Linux Ŏg邩m肽Ƃ́A
Ethernet HOWTO <http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html>, (
{ <http://www.linux.or.jp/JF/JFdocs/Ethernet-HOWTO.html>) 
܂B͂߂̍ÁAeLXg HTML ŏ
Ă܂ÂAƏɊǗKvĂ܂
BƂ΁AEFuy[Wŉ{ACD-ROM ォAɂ̓n
hEwh PDA ŃeLXgt@CƂēǂ߂悤ɂƂ
ƂłBŏIIɁÂ̖ASGML łB



2.2. SGML

SGML (Standard General Markup Language) ́AɃR[h𖄂ߍނ
ƂŐ藧Ă錾łB̈Ӗł́AHTML ƗގĂ܂Aގ
_͂ꂾłBSGML ̃p[́AWYSIWYG (What You See Is What You
Get) ƈāAFtHgTCY₠̌`Ȃǂ`킯ł͂
ƂƂɂ܂B̑A(pOtZNVAԍt
XgȂǂ) Gg(element)`ĂāASGML n㏈
pvOɔőgFAtHgȂǂCĂ܂܂BHTML ł
ƂĂ܂A HTML ͎ۂ̂Ƃ SGML ̃TuZbgłB

SGML ́A̐̂߂ɁA{I 3 ̕琬藧Ă܂B1
ڂ́A\ (Structure) ŁÁAʏADTD Ƃ^` (Document
Type Definition) Ƃ΂Ă܂B DTD ł́AX̃Gg
(element) (̓^O(tag)) ̊֌W`Ă܂B̕
̂ɎgĂ DocBook ͂̂ЂƂłBDTD ́A̓ełRe
g (content) ]ׂ[̉ӏłB2 ڂ́ADSSSL 
ADocument Style Semantics and Specification Language łBDSSSL ́A
_OvOɑ΂āASGML lԂǂ߂`ɂ
ۂ̂w܂BƂ΁ARTF tH[}bgɂꍇ́A
<title> ^O 14 |Cg̃{[ĥɂ悤_OvO
ɎwA HTML ɂꍇɂ́A <h1> ɕϊ悤Ɏw܂
BŌɁA̓ełReg (Content) A SGML 
nɂă_OΏەłAŏIIɃ[Uڂɂ镔
łBƂ΁ÃpOt́ARegłA摜\A
ԍtXgȂ񂩂RegłBReǵA^O (tag) ň͂܂
āAʂ̃GgƂċʂ܂B



2.3. Ȃ HTML łȂASGML Ȃ̂H

SGML ́ÃtH[}bgϊ邾ł͂܂BڎA
̓Oւ̃NIɐł܂BJade  OpenJade pbP[W
(Ȍ́A_[ƌĂт܂) g΁ASGML  LaTeX  infoAeLX
gA HTMLARTF ɂϊł܂B{tH[}bgAMS Word
 PostScript, PDF Ȃǂ̃tH[}bg̕邱Ƃł܂ALyX
̂悤ȃvOg΁ATeX tH[}bgŕāǍ
SGML ɕϊASGML DȃtH[}bgɃ_Oł܂B
ASGML ́Ǎڂɂ͊֐SȂAςGg̋@\ɒ
Ă܂B̓_琶傫ȈႢ́ApOẗʒutHgT
CYAtHg^CvȂǂŔY܂ȂĂ̂ŁAXs[h
ƂƂłB



2.4. SGML  XML Ȃ

ŋ߂ XML gƂv]̂ŁADocBook ł XML T|[g
Ă܂BDocBook ́ÅKw\}[NAbv^ȌW
łB XML DocBook v4.1.2 ́A LDP ŐɃT|[gĂ܂B
SGML ɂĂ͊ɒmĂāAXML gꍇ́ÂƂɒӂ
B (ȉ́AuDocBook: The Definitive Guidevq؂܂
B)

 E ׂĂ XML }[NAbv́A啶ʂBG
    gAAgr[gAGeBeB́AłȂ΂Ȃ
    B̓_ŁASGML Ƃ͈قȂB
   
 E ׂẴAgr[ǵAVONI[g (') A_uNI[g
    (") ň͂܂Ȃ΂ȂȂB
   
 E Gg (Ƃ΁Axref) ́A/: <xref/> ŏIȂ΂Ȃ
    B
   
 E ^O̒Zk (</>) ̓T|[gȂB LDP ɂĂA SGML 
    Ŏgp邱Ƃ͐ĂȂB
   


2.5. ߂Ċe

ALDP ͏߂ĂŁAXVĂȂ HOWTO ̊ǗAVK
HOWTO 肵悤Ǝvꍇ́A<discuss@linuxdoc.org>  HOWTO
R[fBl[^ɘAĂB́ANǂ̕SĂ
 HOWTO R[fBl[^ɕ悤ɂ邽߂łB

ꂪIƁADȃtH[}bgŕāÃhtg
<submit@linuxdoc.org> ɑĂ܂B LDP ̃{eBA
ZāAɃ{eBA瑐eƃRgԂĂ܂̂ŁA
̃Rg𕶏ɔfāAx LDP ւ̍ŏIeƂčēx
ldp-submit [OXgɐVo[W𓊍e܂B

̎_ŁAʂ̃{eBAeꂽ DocBook `ɕϊāA
ꂽ DocBook ƂĎ茳ɑĂ܂BALDP ւ
eׂ͂ DocBook `ɂȂ܂B}[NAbvɂċ^₪΁A
ϊS{eBAɕALDP DocBook [OXgŎ
ĂB

͂߂ DocBook `ŏn߂ꍇ́AQlɂȂev[g
񂠂܂B

 E 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 
    ev[ǵALinuxDoc `ŏƂ̂̂łB
   
 E http://www.linuxdoc.org/authors/template/big-howto-template.sgml
    <http://www.linuxdoc.org/authors/template/big-howto-template.sgml>
    - ̃ev[g Stein ̂łALƑ傫
    ĕGɂȂĂ܂B́ADocBook ̖Lxȋ@\p
    łB
   


2.6. [OXg

[OXg̂ŁAo^ LDP ̊ɎQł܂
B܂A<discuss@linuxdoc.org> ́ALDP ̒SIȃ[OXgŁAo
^ɂ́Asubject  "subscribe" Ə[
<discuss-subscribe@linuxdoc.org> ɂ肭Bo^ꍇ
Asubject  "unsubscribe" Ə[
<discuss-unsubscribe@linuxdoc.org> ܂őĂB

ɂA<docbook@linuxdoc.org> [OXǵA}[NAbvA
DocBook ̂Ɋւ鎿ƂłB̃}[NAbv^Oō
Ƃ́AɎ𑗂ĕԎ҂ĂB DocBook [O
Xgɓo^ɂ́A"subscribe" Ə[
<docbook-subscribe@linuxdoc.org> ɂ肭B



Chapter 3. 쐬c[

̃ZNVł́ALDP 쐬̂ɕKvȃc[֗ȃc[
Љ܂Bł́ACXg[@ƃc[̊Tv
Aڂg͌ŉ邱Ƃɂ܂BȂɂ̈
Õc[g LDP ̏ꍇÃZNVŐ`܂
ŁA񂻂̃c[m点B



3.1. DSSSL

ʏ Walsh o[W DSSSL KvŁÃIvVƂ LDP 
DSSSL ܂B



3.1.1. Norman Walsh DSSSL

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

DSSSL (Document Style Semantics and Specification Language) ́Aǂ
@ SGML ICp̕ɂ邩 jade Ɏw
̂łBƂ΁ADSSSL ɏ]āAtitle ^OAHTML ł <H1> ^O
ϊARTF ł 14 |Cg Times Roman {[ĥɕϊ܂B
DSSSL Ɋւ镶Lɂ܂BDSSSL C邱Ƃ́A DocBook 
̂C邱Ƃɂ͂ȂȂ_ɒӂĂB_Oꂽe
LXǧhςĂɂ܂BLDP ł́ȀCꂽ DSSSL
gĂ܂B



3.1.2. LDP DSSSL

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

LDP DSSSL ́A(L) Norman Walsh o[W DSSSL 邱ƂO
ɂāAڎȂǂ𐶐邽߂Ɏ኱̕ύX̂łB



3.2. DocBook DTD (version 4.1  3.1)

KvȂ̂́A http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip
<http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip> A http://
www.oasis-open.org/docbook/sgml/3.1/docbk31.zip <http://
www.oasis-open.org/docbook/sgml/3.1/docbk31.zip>B

XML DTD gꍇ́A http://www.oasis-open.org/xml/4.1.2/ <http://
www.oasis-open.org/docbook/xml/4.1.2> łB

DocBook DTD ́ADocBook SGML ̃^Oƕ\Ƃ`Ă܂B
䂦AVK^O肵 DTD CƁADocBook ł͂ȂȂ
܂܂B



3.3. Jade

Jade  OpenJade ́AӂƂADTD  DSSSL ɊÂăR[h̃_
OÓ̑唼vOłBǂ炩KvȂ̂
A DTD  DSSSL ̃CXg[IĂACXg[Ă
B



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 ́ASGML ̃tgEGhvZbTłBDocBook  DSSSL g
āAÓAړĨtH[}bgւ SGML \[X̃_Os
܂B



3.3.1.1. Jade g

ł́AgĂfBXgr[V킸Aǂ̃fBXgr
[VłAƂɂɎg悤ɂ@Љ܂B

 1. ȃt@C邽߂ɁA/usr/local/sgml/ Ƃx[XEf
    BNg쐬܂Bȉł́ÃfBNg $_toolroot 
    Ăт܂B
   
 2. Jade, DocBook DTD, DSSSL A$_toolroot ꂼ̃x[XfBN
    gɂȂ悤Â悤ȃfBNg쐬āACXg[
    B
   
      $_toolroot/jade-1.2.1
       
      $_toolroot/dtd
       
      $_toolroot/dsssl
       
 3. ϐ SGML_CATALOG_FILES  $_toolroot ɂJ^Ot@C
    ݒ肷Kv܂Bɂ͎̃R}hgĂB
    
    bash$ export SGML_CATALOG_FILES=$_toolroot/dtd/docbook.cat:\          
    $_toolroot/dsssl/docbook/catalog:$_toolroot/jade-1.2.1/dsssl/catalog  
                                                                          
    
   
 4.  Jade gł܂BZNVʂ HTML t@C
    쐬ɂ́ÃR}hg܂B
   
    
    $_toolroot/jade-1.2.1/jade/jade -t sgml -i html \       
    -d $_toolroot/dsssl/docbook/html/docbook.dsl howto.sgml 
                                                            
    
 5. ꖇ HTML t@Cɂ܂Ƃ߂ɂ́AL Jade R}h -V
    nochunks tĂB
   


3.3.1.2. XML [h Jade

 XML p̐ݒ肪ς߂΁AJade  OpenJade  SGML DocBook Ɠ
Ŏg܂B

XML DTD 𓀂Ajade/openjade ̃J^Ot@C̃ftHgt@
CƂāAdocbook.cat t@C "catalog" ɃV{bNN
邱Ƃł܂B $_xml_root ́̕ACXg[ XML_DTD
̏ꏊɒuĂB


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 ꂼ̃J^Ot@CKvłB
    $_toolroot ́Aقǂ̗ƓłB
(2) X^Ct@ĆAD݂̃X^Ct@CɒuĂB
    jade ɂ́Axml.dcl ւ̃|C^KvŁÁAXML 
    OɎw肳Kv܂B
   
    XML Ɏ̂悤Ȍx\邩܂B
    o͂ɂ͉e܂񂪁A͒łB
   
    
    /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 ɕϊꍇ́A(̖`̍s
)^錾(declaration)̂ƂŎ̂悤ɏĂB


                                                                    
                                                                    


LDP ̕Kɏ]ĂꍇAȊOɕɕύXKv͂
܂B



3.3.2. OpenJade

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

DSSSL R~jeB[쐬AJade ̃GNXeVłBAvP[
V̂Ȃɂ jade KvƂ̂܂AǂT|[g
悤ɃAbvf[g܂B



3.4. Jade wrappers

IvVňȉ̃c[̂ŁAJade, DSSSL, DTD ̃CXg[
ACXg[ł܂B



3.4.1. sgmltools-lite

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

́ANȏOɐɉU sgmltools vWFNgp
̂ŁAȗACees de Groot ኱قȂvWFNg𗧂グāA
jade SGML nւ̃bpƂăc[Ă܂B\̉͂
܂B҂́AÂ sgmltools pbP[WCXg[āA
̂Ƃ sgml-tools-lite 邱ƂŁA̕ɊȒPɃtH[
}bgłłB\\ sgmltools p man y[W
B



3.4.2. Cygnus DocBook Tools

Red Hat pł - http://www.redhat.com/

Red Hat ł́A6.2 [XADocBook T|[gc[̑
߂ 3 ̃pbP[WzzĂ܂B̃c[́AȒPɃCXg
[ł̂ŁAc[ƊiȂĂMɐOł܂BTeTeX, Jade,
JadeTeX 炩߃CXg[ĂƂKvłBpbP[W 3
ƂACXg[ CD ɓĂ܂B



3.4.2.1. Cygnus Tools ̎g

̃c[́ARed Hat 6.2 ɕtĂ܂B܂ÃpbP[W
CXg[Ă邩mFĂB

 E sgml-common-0.1-8.noarch
   
 E docbook-3.1-4.noarch
   
 E stylesheets-1.54.13rh-1.noarch
   
ŐVo[ẂARed Hat ̃EFuTCgɂ܂: http://
www.redhat.com/support/errata/RHBA-2000022-01.html <http://
www.redhat.com/support/errata/RHBA-2000022-01.html>.

RPM t@C}VɃ_E[h邩AǂĂ邩āA
ʂCXg[ĂB(root ɂȂāArpm -Uhv t@C
B) RPM CXg[ꂽÃR}hg DocBook _
Oł܂B


bash$ db2html filename                                              


DocBook  HTML Ƀ_O܂B( .sgml gq)t@C
ƓOŃTufBNg쐬A HTML t@Cu
B


bash$ db2pdf filename                                               


DocBook  PDF t@CɃ_O܂BJadeTeX g db2pdf 
pd2ps ŁAݖ肪Ă̂ɒӂĂB́ARed Hat 
oOƂēo^ <http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=
9670>Ă܂B



3.5. ҏWc[

ȉł́AHOWTO ̍쐬ҏWAÓɎgc[Љ܂B



3.5.1. Emacs (PSGML)

IvVłB - http://www.lysator.liu.se/~lenst/about_psgml/ <http:
//www.lysator.liu.se/~lenst/about_psgml/>

Emacs ɂ́ASGML  XML ̕ҏŴ߂ɍꂽW[[hƂ
A SGML 쐬p psgml ƌĂ΂郂[h܂Bɂ "\
 (syntax highlighting)"  "ꂢȕ\ (pretty printing)" @\
gƁASGML ^OꂽAŃ^CvȂĂ^O邱Ƃ
łAȂÓł肵܂B

Emacs [Uɂ͂ꂵ@\łÂǂ SGML ҏWc[[
@\ĂƁÃ[U͎vĂ܂BDocBook 
LinuxDocȂ DTD łg܂B



3.5.1.1. PSGML g SGML @

3.5.1.1.1. ͂߂

ŋ߂̃fBXgr[VCXg[ĂȂAEmacs Ŏg
悤Ɋ PSGML CXg[ĂƎv܂BmF̂߂ɁA
Emacs NāAPSGML {Ă݂܂傤B(C-himpsgml)

́ArIVo[W Emacs  PSGML CXg[
Ďg悤ɂȂĂ̂Oɂ܂Bbi݂Ǝv
ABob Ducharme  SGML CD book ̃t[ŌJĂ鎟̏͂
B http://www.snee.com/bob/sgmlfree/



3.5.1.1.2. .emacs Abvf[g PSGML g@

.sgml t@CJƂ GNU Emacs  PSGML [hɓāASGML 
ҏWł鏀悤ɂꍇ́APSGML  DocBook DTD 
悤ɂȂ΂Ȃ܂B GNU Emacs  PSGML g悤ɃfB
Xgr[VŊɐݒς݂ȂAȂĂ܂s͂
łAłȂꍇ́Aϐݒ肵āASGML J^O (܂ DTD
̃Xg) {ׂꏊ PSGML ɋKv܂B

Ƃ΁A܂


bash$ export SGML_CATALOG_FILES=/usr/lib/sgml/catalog               


ƑłāAɁA.emacs t@CɎ̂悤ȓe̍sǉ܂B

;; ******************************************************************* 
;; 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.                                      
;; ******************************************************************* 

Ƃ́AEmacs ċNĂB



3.5.1.1.3. SGML ̂ƂeXg

ƂeXgĂ݂܂傤BƂāAVKt@C /tmp/
test.sgml JāÂ悤ɏ݂܂B

]>                                                                     

āAC-cC-p Ɠ͂܂B Emacs  DTD ǂݍƂĂȂA
~jobt@ Parsing prolog....done ƕ\܂BAC-c C-e
RETURN ƑłāA<test> Ɠ͂Ă݂܂傤BĂꍇ́A
Emacs Ɏ̂悤ɕ\܂B

]>                                                                     



3.5.1.1.4. DocBook `ŐVK HOWTO @

HOWTO pɐVKt@CJāÂ悤ɓ͂܂B

C-cC-p ƑłāAʂɒځBׂė\ʂȂAb Emacs ǂݍ
ݏāA~jobt@ Parsing prolog....done ƕ\̂
܂B

ŁAC-cC-eRETURN ƑłA<article> GgŁAHOWTO 
MɎ肩܂傤B



3.5.1.1.5. PSGML g Emacs ̃NCbNt@X

FreeBSD ɂ Nik Clayton ̓发B 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 ɂĂ̘b܂̂ŁARA vi ̂błBVIM (Vi
IMproved) GfB^́Avi ̕W@\ȂA^ÖʒuXN[
ŐFċĂ܂ SGML [hĂ܂B



3.5.2.1. ͂߂

vim vO͎ۂɕ̕oĂ܂B܂Af vim vO
āÁAvi vO₻̃R}hƌ݊Ă܂
BRed Hat [UȂAvim-common  vim-minimal pbP[WKvłB
ɁAg@\ vim ŁA͕W vi ɑ΂āA\Ȃǂ
@\܂BRed Hat [UȂAvim-enhanced KvłBŌ̌
Ȃ@\ƂāA X C^[tFCXÁAOtBJC^
[tFCX⃁j[A}EXȂǂ񋟂Ă܂Bvim  vi 炱
ʂꍇAOtBJł̃R}h́Agvim ƌĂ΂Ă܂
B



3.5.2.2. VK̃[h͍쐬

vim  gvim [hł́A .sgml t@C͎IɔFāA"sgml [
h" ɓ܂B炩ߕĂA DocBook ^O vim ɓǂ
܂ƁAFꂽ^O͒Fŋ܂BFȂꍇAC
gu[ŕ\܂BFꂽ^Ȏ(attribute)Cgu[
ȂA̒l(value)́AsNɂȂ܂B́Aʏ vi R}
hgāAJ[\ړƕҏWł܂B



3.5.3. WordPerfect 9 (Corel Office 2000)

http://www.corel.com/

MS Windows vbgtH[ WordPerfect 9 ́ASGML  DocBook 3.0 
T|[gĂ܂BLinux p WordPerfect 9  SGML @\͂܂B

́ASGML T|[gĂ鏤pAvP[VƂĂ͈ԈȂ
̂łB



3.5.4. sgedit

http://www.tksgml.de/

sgedit ́ASGML t@CrWAɕҏWłvOłB̃v
O̒́A炩 Emacs  VI ̎gmȂĂ悢_
ANXvbgtH[Ȃ̂ŁAWindows ł Linux łƂ_ł
BpAvP[VłAli͐ݒ肳Ă܂Bl⋳@
ł̗pɂẮAt[CZXło悤łB

rWAҏW̑ɂAsgedit ́A[hKvȎɁA Document->
Validate R}hgāȂÓł܂B

Figure 3-1. sgedit ̃XN[Vbg

sgedit vÕXN[VbgBɂ́AKw SGML 
̃c[\\AEɂ́Â\ĂB^ÓAO
[̔wiŕ\B



3.5.5. nedit

http://nedit.org

ɌāAnedit ́AvO}ŁAVK[UɃvO}
Ȃ[UɂƂĂ͂Ƃ܂B΁A^O
FÂRɂł肵āAȂptłBsgedit ƈقȂAnedit
ł́A^OœꂽȂÓIɍs͂܂
B̂AEBhE̓eɑ΂ăVFR}hg悤ɂ
Ă܂B(t@CۑŁA`FbN܂B) 킽́ASGML
̑Ó̂߂ nsgmls ݒ肵AXy`FbN̂߂ aspell 
ݒ肵܂AŏI܂B

Figure 3-2. nedit ̃XN[Vbg

nedit ł́Aʂ̍[ɍsԍ\̂ŁAnsgmls ŃG[o
ɕ֗łB



3.5.5.1. nedit ̎g

VKƂ́ALDP DocBook ev[g_E[hĎg
ƂĂ܂B̃t@C΁Anedit NĂҏW
肩܂Bt@C .sgml gqtĕۑĂ΁Anedit 
A SGML/HTML ^O@\Lɂăt@C[h܂B̋@\́A
Preferences->Language Mode->SGML HTML R}hgĖIɗLɂ
邱Ƃł܂B



3.5.5.2. nedit  Tips ƃRc

nedit ł́AEBhE̓eOvOɏo͂邱Ƃł̂
A̋@\gāAigĂ֐sł܂BŎグ
ł́A nsgmls gASGML ̑Ós@Љ܂B

܂A Preferences->Default Settings->Customize Menus->Shell Menu... 
I܂BƁAShell j[ɓo^ĂSVFR}h\
_CAO{bNXoĂ̂ŁA Menu Entry ̗ "SGML
validate" Ə݂܂B̃Gg[́AXN[Ō邱Ƃ
܂BɁAAccelerator ̗ŁA Alt-S āA SGML ̑Ó
ōs悤ɂ܂BCommand Input ̕ł́A window I
āACommand Output ̕ł́Adialog I܂B Command to Execute
ł́Ansgmls -sv Ɠ͂܂傤Bꂪ܂߂ɂ́A PATH  
nsgmls ւ̃pXݒ肳ĂȂƂȂ̂ŒӂĂB

Figure 3-3. nedit ւ̃VFR}h̒ǉ

VFR}hǉ鎞̃_CAO{bNXB

OK NbNāAŌ̃CXN[ɖ߂܂BSGML t@C
[hāAShell+SGML Validate I邩AAlt-S ƁAnsgmls
NāAEBhE̓e`FbN܂B-sv gŔA-v 
w肷ƁAnsgmls ̓vÕo[Wo͂̂ŁȀo͂
 nsgmls sꂽƂK悤ɂȂ邩łBo[W
ԍo͂Ȃꍇ́AɃG[ȂƂɂȂ܂BG
[΁ÃG[悤ɁAʂ̃EBhEJĕ\
Bsԍ@\LɂĂȂ (ɂ́A Preferences->Show Line
Numbers g܂B)Ansgmls ̓G[sԍŕ\̂ŁAG[
̂ƊyɂȂ܂B

Figure 3-4. G[Ȃꍇ nsgml ̏o

nsgmls G[oȂꍇ́Ao[Wԍ񍐂܂B



3.6. CVS

LDP ł́A̒҂ CVS AJEg𔭍s悤ƂĂ܂Bɂ
Â悤ȗR܂B

 1. CVS ȂA쐬̃ItTCgEobNAbvĂB̒
    ֕̈pƂłACVS 炻̕ĂāA
    ɍƂɓBȑÕo[W̕KvɂȂƂłA
    ȂoƂłB
   
 2. lŁAЂƂ̕ۂɔɕ֗BCVS g΁A
    W̎ɁAlύX̓em邱Ƃł邵A
    X̂܂܎荞ނƂłB
   
 3. ύXӏ̃OۑłBSGML nۂ̏Ɏ肩
    ɁAOď悤ȓʂȃ^Og΁AO(
    tX^v)IɕɖߍނƂłB
   
 4. VK쐬ĒoƁALDP EFuTCgIɍXV
    悤ȃvO邱ƂłB͂܂Ă͂Ȃ
    ǐĂ݂ƂłB̂ƂACVS ̍XVɂāAHOWTO
    R[fBl[^ LDP EFuy[WXV悤ʒms悤ɂȂ
    Ă܂A̎dg݂g SGML R[h[őKvȂ
    Ȃ܂B
   
CVS S߂ĂȂAEFuy[ŴŁAĂƖɗ
܂B

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


3.6.1. CVS AJEg̓

܂ALDP ɂ CVS |Wg̃AJEg肷Kv܂B
́ACVS g[gfBNĝ̂ŁÃTufBNgƂ
 (HOWTO  mini HOWTO Ȃǂ)̃vWFNgp̃fBNg
쐬Ă܂B

AJEgɂ́AnbVꂽpX[hƃ[U ID 쐬
΂Ȃ܂BnbVꂽpX[hgƁACVS O[v
M҂̃pX[hm炸ƂAÍꂽpX[h CVS O[vɑ
邱Ƃł܂Bɂ́Â悤ȃR}h bash ( sh) 
łĂB


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


LR}h̏o͂A]郆[U ID ƈꏏ
<cvsadmin@cvslist.linuxdoc.org> ܂ł肭Be CVSROOT fB
Ng쐬ꂽƂŁA̎|̕ԓ[͂̂ŁAꂪ͂
_ŁACVSROOT ɃOCāAׂĂK؂ɐݒ肳Ă邱ƂmF
ĂB


bash$ export CVSROOT=:pserver:your_userid@cvs.linuxdoc.org:/cvsroot 
bash$ cvs -d $CVSROOT login                                         


(your_userid ́̕A󂯎ԓ[ɂ郆[U ID ɒu
B)

pX[hq˂āÂƂŁACVS |Wgɓǂݏ[hł
ANZX^܂Bcvs login R}h͈xgŃVXe
̃ANZXA.cvspass ɃpX[hۑ̂ŁA 
cvs login łKv͂܂B CVSROOT ݒ肵āAƂ𑱂܂
B̃R}hŁALinuxDoc |WgŜRs[邱Ƃł܂B


bash$ cvs get LDP                                                   


قɂAō쐬 SGML \[X~Ƃ́ÃR}h
łĂB


bash$ cvs get LDP/howto/docbook/YOUR-HOWTO.sgml                     
bash$ cvs get guide/docbook/YOURGUIDE                               



3.6.2. ȊO CVS |Wgւ̃ANZX@

3.6.2.1.  CVS ANZX

(LDP ̏oł]ȂǁA)AJEg̕svȕłA CVS A
NZXpł܂B̏ꍇA|Wg͓ǂݏopɂȂ܂B


bash$ cvs -d :pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login       


pX[hɂ́A"cvs" g܂B΁ALƓ悤 LinuxDoc
W[ł܂B CVS TCg̍XV́ACTCg 30
قǒx̂ŒӂĂB



3.6.2.2. Web oRł CVS t@C

CVS |Wgɂ́AWeb oRłANZXł܂B http://
cvsweb.linuxdoc.org/index.cgi/LDP <http://cvsweb.linuxdoc.org/index.cgi
/LDP>



3.6.2.3. OtBJC^[tFCXg

CVS ɂ̓OtBJC^[tFCX܂B http://freshmeat.net/
appindex  CVS L[[hɌ΁Aꗗ\܂B



3.6.3. t@C̍XV CVS

CVS ɂ́A$Id$ Ƃʂȃ^OAgĕɒړtƃo[
WIɓ邱Ƃł܂B commit ŁACVS ̃^O
 $Id: cvs.sgml,v 1.3 2000/08/24 20:31:01 markk Exp $ ̂悤ɕύX
B̃^O𕶏ɏĂƁAt@CύX邽тɎIɂ
̃^OAύX邲ƂɃrWԍグ邱Ƃł
B

XV CVS T[oɃAbv[h鏀A cvs ci -m
"comment" .sgml ƃR}hłĂB-m "comment" ͕Kv
͂܂񂪁AȂƁA(ʂ vi Aϐ EDITOR ɐݒ
ꂽ炩)GfB^オāAύX_ɂẴRgǉ
悤߂܂B

ldp-discuss [OXgł̋c_ڂ񂪓܂B

̍쐬 LDP CVS c[gĂꍇ́AJ_
LDP ɒm点Kv܂B<ldb-submit@lists.linuxdoc.org> Ƀ[
𑗂ĂB̍ہÃ^CgƁAt@C LDP CVS c
[ł̑΃pX{ɏĂĂB



3.7. ̑̃c[ƃt@X

̃ZNVł́ÂƂ땪ނĂȂt@X{⃆[e
BeBЉ܂B



3.7.1. DocBook: The Definitive Guide

http://www.docbook.org/

́A1999N10 O'Reilly ołꂽADocBook ɂĂ̂΂
t@X{łBقǎpIł͂Ȃ悤Ɏv邵A XML 
d_uĂ͂܂Ao[W 3.1  DocBook ^Oׂ͂ĕ
₷ꗗ\Ă܂BXŔƂł邵A{ׂ̂Ă̓e
L URL IC (HTML  SGML tH[}bgɂ) ǂނ
Ƃł܂B



3.7.2. SGML ev[g

IvVłB- http://www.linuxdoc.org/authors/index.html#resources
<http://www.linuxdoc.org/authors/index.html#resources> ({ <../..
/authors/index.html#resources>)

SGML ev[gƁAϊ HTML o͂ɂẴN̂ŁA
̑̍ق𗝉菕ɂȂ܂B^Ȏ́A쐬镶̓e
ɍ킹Ēu邱ƂKvłB



3.7.3. Aspell

IvVłB - http://aspell.sourceforge.net/ <http://
aspell.sourceforge.net/>

Xy`FbNp̂̃AvP[V́ASGML ^OāA^Oɋ
ꂽe`FbN邱Ƃł܂Bispell ̂悤ȃftHg̃X
y`FbJ[ƁA^Ô`FbN悤Ƃ̂ŁAVK^O
ƁAG[ɂȂĂ܂܂B



3.7.4. ispell

IvVłB - http://www.cs.hmc.edu/~geoff/ispell.html <http://
www.cs.hmc.edu/~geoff/ispell.html>

 ispell vÓARed Hat (A炭̃fBXgr[V
 )ɓĂ̂ŁA}[NAbv^O𖳎邱Ƃł܂B



Chapter 4. DocBook ^O̎g

4.1. ͂߂

DocBook ł́AeLXg}[NAbv(markup)A֗̕ȃ}[NAb
vGg(element)`āAeLXg낢ȈقȂtH[}bg
ɕϊł悤ɂĂ܂B

DocBook gƁAHTML  XML, RTF, TeX ̑̈قȂtH[}bg̕
𐶐ł܂B

́A܂ADocBook ŕ쐬Ă΁A\Ȍő命̂
Ƃɏ`邱ƂłƂƂłB

K؂ɕۊǂĂȂfW^́AƂɌȂ
̂łB(oCitH[}bĝ悤)ʏƂ͈قȂ镶͊܂܂
ĂȂ̂ŁASGML Ȃ DocBook ŏꂽȂAڍt⌟
邱Ƃł܂B

SGML VXeł́A}[NAbv(markup)gāALqĂ܂B
DocBook ɂ 300 ȏ̃}[NAbvEGg(element)AX
Ggɂ̑A̒l܂B
ǂp邩́A҂g̃X^CɂČ܂܂B

DocBook ̒`t@Cł DTD ɏłύXƁA͂
DocBook ł͂ȂȂ邱ƂYȂłB



4.2. KvȐݒ

SGML ₠̃c[Ȃǂ̂悤Ɏʎq(identifier)gVXeł́A
J^O(catalogue)x[XɂȂĂāÃJ^OAʎq
ǂݎāAKvȒ`ꂽt@C܂B

J^Ot@C̓eɂẮAJ^O̐ݒɂďꂽZNV
 (Section 4.3 Q)ŁAڂ܂B

c[KvȃJ^O悤ɁAϐ
SGML_CATALOG_FILES ̒lÂ悤ɐݒ肵Ȃ΂Ȃ܂B


$ export SGML_CATALOG_FILES="/usr/lib/sgml/catalog"                 


DocBook ₻̑̃c[ނRs[^Ő̂ɕKvȒǉ
ݒ́AꂾłB



4.3. J^O̍쐬ƏC

J^O(catalogue)́AJʎq(public identifier)߂ăVXe
t@Cۂ̃[LqꂽeLXgt@CłB

J^Ot@ĆADocBook ͎g₷邽߂̂̂łBX̃[
ÚAJ^Ot@C(Ƃ΁Az[fBNgA/usr/local/sgml
Ȃ)ǂɃCXg[ĂłACXg[΁A
ȏ㏈RpC肷Kv܂B

Example 4-1. J^O̗

-- 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) RgBRǵA"--" Ŏn܂AsŏI܂B
(2) J^錾(public type declaration) "-//Connectiva SA//DTD books
    V1.0//EN"  /home/ldp/styles ɂ books.dtd t@CB
(3) t@C̏IRgB

L̗ł́Aʎqt@CɑΉ邽߂ɁÂ悤ȏɏ]
Ă܂B

 1. ʎq PUBLIC Rs[B
   
 2. ʂeLXgށB
   
 3. Ήt@Cւ̃pXB
   


4.3.1. p̐

̎ʎqɒڂĂB

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

̕ѕ́A_ł͂ȂA炩ߌ߂ꂽKɏ]Ă܂
B

" - " Ƃ́Agp鎯ʎqAo^ς݂̃^Cvł͂ȂƂ
Ă܂Bo^ςݎʎq͂킸ȂA͒ʏA ISO 
IEEE ƂGeBeB (entity)ɑĂ܂B

ʎq̎̕ł́A쐬gD`܂BL̗ł
AConectiva S.A. łB

ŌォЂƂOɕł́AReg(content) ({̏ꍇ́ADTD 
[2] łB) ƁAʂĂeLXg`܂B

Ō̃GǵALqĂ܂BDocBook ́Ap
ŏꂽ DTD Ȃ̂ŁA EN ƂȂ܂B 2 ̃R[h
Ă̂́AISO ̌ꎯʊɏ]Ă邩łB

ڂ́AOASIS Technical Resolution 9401:1997 (Amendment 2 to TR 9401)
<http://www.oasis-open.org/html/a401.htm> B



4.3.2. J^Oł֗̕ȃR}h

J^OŎgR}ĥA\IȂ̂ȉŐ܂B

PUBLIC
   
    L[[h PUBLIC ́AJʎq(public identifier) VXe
    ʎqɃ}bv܂B
   
SYSTEM
   
    L[[h SYSTEM ́AVXeʎq(system identifier)VXe
    ̃t@CɃ}bv܂B
   
    SYSTEM "http://nexus.conectiva/utilidades/publicacoes/livros.dtd"
    "publicacoes/livros.dtd"
   
SGMLDECL
   
    L[[h SGMLDECL ́Agpׂ SGML  (SGML statement)
    VXeʎqw܂B
   
    SGMLDECL "publishings/books.dcl"
   
DTDDECL
   
    SGMLDECL ƓlAL[[h DTDDECL ́Agpׂ SGML 
    w܂BDTDDECL ɂāASGML ́ADTD ɑ΂Jʎq
    Ήt܂BcOȂȂΉt́Aœł
    ̃c[ł̓T|[gĂ܂B́̕ÃJ^Ot@
    CgƂɌʂ܂B
   
    DTDDECL "-//Conectiva SA//DTD livros V1.0//EN" "publicacoes/
    livros.dcl"
   
CATALOG
   
    L[[h CATALOG gƁAJ^Ot@Cʂ̃J^Ot@
    CɊ܂߂邱Ƃł܂BɂāAJ^Ot@Ĉ
    ̂ύXɁAقȂ镡̃J^O𗘗pł悤ɂȂ܂B
   
OVERRIDE
   
    L[[h OVERRIDE ́AJʎqVXeʎqɗD悷邩ǂ
    wł܂B啔̃VXeł̕ẂAVXeʎqJ
    ʎqɗD悵Ă܂B
   
DELEGATE
   
    L[[h DELEGATE gƁAJ^O^Cv̌Jʎq
    ɑΉt邱Ƃł܂BDELEGATE R}h́ACATALOG ƔɎ
    Ă܂Ãp^[w肳Ȃ艽Ȃ_ňقȂ
    ܂B
   
DOCTYPE
   
    ^ŏɏĂĂAJʎqVXeʎq
    ȂꍇADOCTYPE R}hA̕ DTD ɑΉt܂
    B
   


4.4. DocBook Gg̎g

DTD ͂āAɊÂăGg}@\̕tGfB^
𗘗pƁAJ[\ʒuœ̃Ggg邩ǂ
łȂ֗łBȂÂǂɂȃGg邱
ȂȂ܂B

ύXĂȂׂȒPɈڍsł悤ɁA̍쐬҂́A
DocBook DTD  XML o[WƂ̌݊ł邾ۂ悤ɐS
ł傤B܂AGgɂ͑啶gAł̓_u
NI[głA"Zk^O"(LQ)͎gȂ悤ɂāAI^O
ȗȂ悤ɂ܂傤B(psgml + emacs ̂悤)Ń^O}
c[̑啔́A[ɎIɏ]Ă邩AƐ
肷邾ŏ]܂B

^O̍ŏ(minimization)ɂ͂̂܂B^O(empty
tag)ɂ܂B^O̍ŏ̗ƂẮAI^O邩
ɁA</> ƂłƂłBȑOɂqׂ܂AɂA^Ȍȗ
(tag omission)Ƃ̂܂Bɂ̗̗܂B

 ^OɂƂƁA܂Ał͏I^OȗA              
ɁA<>ł͋^OgĂ܂B                             

X̕^ɂ͓̍\̂ŁA̗͂̂قǏЉ
܂B(Section 4.11Q)

L̐lŁA DocBook gĕ@
܂B



4.4.1. ֗ȃR}h

Table 4-1ł́AʓIȕ쐬ۂɕ֗ȃR}hꗗ\Ă
܂BA̃GǵA̕ł̂ݗLł邱ƂY
ȂłB

(: L Table 4-1 ł́A<to> </to> Əꂽ܂A
̂܂܎gƃG[ɂȂ蕴킵̂ŁA<para></para> ɏCĂ܂
B)

    Tip: ϊtH[}bgςƁÃ^Oł̕\ʂς
    ƂƂǂ܂BDocBook ŏ߂ĕ쐬ꍇ́AJ
    OɁA̃tH[}bgō쐬ǂ̍قɂȂ̂
    mFق悢ł傤B
   
    Note: ϊʂ́Aϊ̍ۂɎgX^CV[gɈˑ̂ŁA}
    [NAbv͂ł邾gƂE߂܂BW̃X^C
    V[gł͏o͌ʂɂ܂ႢȂƂłA^O
    ڗ̏o̓tH[}bg邩ȂłB
   


Table 4-1. ֗ȃR}h


pr      R}h                          o͌          

[Ahaddress@domain                                      
X                                                          

҂ɂ...                               (L̗Q)  
                                                            

Җ    First_Name                        First Name Middle 
          Middle_Name                       Name Surname      
          Surname                                             
                                                              

L[(L F1                                F1                
[{[hㄠ                                                    
̕\L)                                                       

L[̃VKEY_F1                            KEY_F1            
{                                                        

L[̃R[0x3B                              0x3B              
h                                                            

L[     Ctrl                           Ctrl-S            
             S                                                
                                                              
                                                              

vOt@C                          t@C          
j[                                                      

j[Aۑ                              ۑ              
Ce                                                        

j[I                                  t@C->ۑ (  
                                          Ctrl-S)           
                   Ctrl                                       
                   S                                          
                                                              
                                                              
             t@C                                         
             ۑ                                             
                                                              
                                                              

}EX{^left                              left              
                                                            

R}hcomando                           command           

AvP[application                       application       
V                                                      

Ql\reference                         [reference]       
                                                            

p             Җ                       p          
                 p                                       
                                                   --Җ   
                                                              

      ELQ                          Section 4.5Q   

t@Cfile                              file              

fBNgdirectory                         directory/        
                                                            

[a]   text                              text              

r         r                         (̕\gɍŌ 
                                            Q)             

URL                                         Conectiva S.A.    

}[Nt                                   E ACe      
ӏ        ACe                                      
                                             E ACe      
                                                              
                ACe                                      
                                                              

ԍtӄ                                   1. ACe      
          ACe                                      
                                             2. ACe      
                                                              
                ACe                                      
                                                              

                                     2 i 10 i
ӏ      2 i                        ւ̕ϊ\        
             10 i                                          
             000                            2 i: 00        
                                                              
             011                            10 i: 0        
                                                              
             102                            2 i: 01        
                                                              
                                            10 i: 1        
                                                              
                                            2 i: 10        
                                                              
                                            10 i: 2        

ot                                  o 1          
ӏ        o 1                                      
                                                          
                                                          
                                            o 2          
                                                              
                                                          
                o 2                                      
                                                              
                                                          
                                                              
                                                              

VvȄ   1                              1 2 3             
ӏ     2                              4 5 6             
             3                                                
             4                              A, B, C, D, E, F  
             5                                                
             6                                                
                                                              
                                                              
             A                                                
             B                                                
             C                                                
             D                                                
             E                                                
             F                                                

摜      ELQ                          Section 4.6Q   

\g    ELQ                          Section 4.7Q   

vOELQ                          Section 4.8Q   
ւ̃R                                                    
g}                                                        

pW       Term                           ̊̕ɂ
                                            pWQ      
                Definition                                    
                                                              

ݎQ  ...                               (摜̏o͌ 
                                            Q)           
                                                              
          ...                                                 
          Please, see for more information.                   

Notes:                                                            
a. \ɂ͂̕@܂BΑ̂̑łʓI 
A DocBook ł͎Α̂T|[gĂ܂Bgɂ́A 
pĂX^CV[gɐݒǉKv܂B        




4.5. 

Ƀ}[NAbv}邱ƂŁA𐶐邱Ƃł܂B

}[NAbv́AƂŊOc[ɂďāA𐶐
܂Bc[̈ɁAcollateindex.pl XNvg܂B
𐶐邽߂̏́ASection 4.10.3ŏڂqׂ܂B

ɂ́Aqx(nesting level)܂B̃}[NAbvɂ
ÃR[hg܂BExample 4-2

Example 4-2. ̂߂̃R[h

   Main level                                                          
   Second level                                                        
   Third level                                                         
                                                                       
                                                                       

 zone gƂŁÃ`v^[ZNVт̑̕
QƂ邱Ƃł܂B

Example 4-3.  zone ̎g

                                                                           
                                                                       
                                                                       
      edition                                                          
      index                                                            
                                                                       
                                                                       
    ́AɃ}[NAbv}邱ƂŐ܂B           
                                                                       

Example 4-3 ̃R[h́Aɂ edition ƂGg[𐶐
̂ɎgĂ̂łBہA zone g΁AłAO
̕ʃt@Cɂłǂɂły[WuƂł܂B

AȒPɃeiXł悤ɁÃGg[́At
̍Ō̃y[WɂuĂ܂B

Example 4-4.  class ŁAl startofrange  endofrange g@

    iA͂łłƁAƂǂ                              
                                                                        
      examples                                                          
      index                                                             
                                                                        
  }[NKv邱Ƃ܂B                  
                                                                        
   ꍇłAʂɏi߂܂傤B                     
                                                                        
   āAt̍ŌɗÂ悤ɒ߂܂B 
                                                                        
   .                                                                    
                                                                        



4.6. 摜̑}

摜̑}́AǂfBAŕJꍇłKvȂ̂łB

TeX tH[}bggȂAPostScript t@C̃C[WKvłBI
CŌJȂAJPG  GIFA PNG ƂʓIȃC[Wt@C
g܂B

摜}ԊȒPȕ@́A fileref gƂłBʏA摜
́AJPG  PostScript (PS  EPS) Ő܂B

Example 4-5. 摜̑}

                                                                          
                                                                       

<figure>  <informalfigure> ɒuƁA摜̃^CgKv
ȂȂ܂B

ɁA float A̒lƂ 0 w肷ƁA摜́A̗
ɉmȈʒuɒu܂BlƂ 1 w肷ƁAK؂ƍl
Ƃɉ摜āÄʒuɒu܂B (̈ʒúA
X^CV[gɋLqĂꍇ邵A͎gpAvP[
VɂĊǗĂꍇ܂B)



4.6.1. LȊO̕@

Example 4-5 ȊO̕@ƂāA<figure>  <informalfigure> gȂ
@܂B

ɂA摜gȂfBAŌJ悤ƂꍇA[֑[u
ƂāA<imageobject> bp[g@܂B

Example 4-6. <imageobject>̎g

                                                                          
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
         ̕ɂ́A̗ł̉摜uĂ܂B                
                                                                       
      摜ɂ(IvV)                                       
                                                                       

̂悤ȃtH[}bg̃t@Cg܂B 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.

̕@ɂ́AK؂ɃAvP[VǗłƂ_
B<imageobject> GǵAp\ȃtH[}bg܂ŏ
ԂɃeXgAo̓tH[}bgƂĉ摜T|[gĂȂꍇ́A
<textobject> Gggp܂BAExample 4-6 `g
̗_́ADocBook ̃[X 5.0 ł́A <graphic> Gg݂͑
ȂȂƂ_łB

_ƂẮAЂƂ̏\邽߂ɂ̃R[hKv
Ƃ_łBɃCXgʐ^̂ɂǂg͕
҂łÃo[WƂ̌݊炷ƁAlƂĂ
A摜̑}@ƂĂ𐄏܂B



4.7. \g

\ɂƏ̈ӖĂɂȂP[X͐܂B

\쐬ȒPȕ@́A<simplelist> g Table 4-1 łɏЉ
܂ADocBook ɂ́A̎̏Ɛꂽ@
܂B

Example 4-7. \̑}

̃Xpwb_ 2 wb_ 3 wb_ 4 tb^ 1 tb^ 2 tb^ 3  
tb^ 4 tb^ 5 f[^ 1-1 f[^ 1-2 f[^ 1-3 f[^ 1-4 f[^   
1-5 f[^ 2-1 f[^ 2-2 f[^ 2-3 f[^ 2-4 ̃Xpf[^ 
3-1 _uXpf[^ 3-4 f[^ 4-1 f[^ 4-4 f[^ 4-5            



Table 4-2. \̗


       ̃Xp       wb_ 2      wbwb_ 4      
                                            _ 3              

f[^ 1-1    f[^ 1-2    f[^ 1-3    f[f[^ 1-5    
                                          ^                
                                          1-4               

f[^ 2-1    f[^ 2-2    f[^ 2-3    f[              
                                          ^                
                                          2-4 ̃Xp
            
f[^ 3-1                                  f[              
                                            ^                
                                            3-4               
                              
f[^ 4-1                                  f[f[^ 4-5    
                                            ^                
                       _uXp         4-4               

tb^ 1      tb^ 2      tb^ 3      tbtb^ 5      
                                          ^ 4              




4.8. vOR[hƃRg

ʔ@\ƂāAR[ḧꕔw肵āAɃRgtƂ
̂܂BDocBook g΁AvOR[h𕶏ɑ}āA
R[h̓̍sɁu邵(callout)vt邱Ƃł܂B

̋@\́AႦ΁AJ^Ot@C̐ݒ@ۂɁAgp
܂B(Section 4.3 Q)

̍ۂɎgR[hȉɎ܂Bu邵(callout)v@\̎gp]
܂ȂP[Xł́A<areaspec>  <calloutlist> ɋ܂ꂽԂ
邱Ƃł܂B

(: Table 4-1lA<to> </to>  <para> </para> ɏC܂B)

                                                                               
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
-- 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> GggȂƂARg(listing)́A
{ɏƂł܂B

u邵v̈ʒúARgꂽR[hʒuɍ悤ɏ
B



4.9. |҂R[hϊ҂̎\

N LDP 쐬̎菕ĂꂽƂ́A𕶏Ŗ炩ɂ
ׂłADocBook ɂ̂߂̃^O܂B̃ZNVł́A
炩̌`ōv҂̎ (credit) \ׂꍇɎg^O
ďЉ܂B܂AҏW҂ɂĂȂȒPłBDocBook ɂ͂炩
 <editor> Ƃ̂܂BA\ׂł DocBook
ɊY^ÔȂʂȃP[X 2 ܂B|҂ƃR[hϊ҂
B

R[hϊ҂Ƃ́AႦ HTML  DocBook SGML ɕϊȂǁA\[XR
[h̕ϊsl̂ƂłB\[XR[h̕ϊs邱ƂŁALDP
A[JCúA^f[^̍쐬Ƃꂩ̖ڕW̒BɂK
̂ɂȂ܂A𑽗lȏo̓tH[}bgŒ񋟂邱Ƃł悤
ɂȂ܂B

|҂́AIWiAႦΉpꂩ{AhCcꂩpƂ
ʂ̒ňւƈڂ܂BX̖|󕶏ɂāAÊ
葽̐lXȂ̕𗘗pł悤ɂȂ܂ALinux A[JC
űɂ̖]łAuSEe "Total World Dominion (tm)" vɂ܂
߂ÂƂł܂B

ȉ̃ZNVɎ悤ȕ@ŁAlAȂ̕쐬
ɍvȊO̐lɑ΂āA̎xe𖾂炩ɂ邱Ƃ
܂B



4.9.1. <othercredit> ^O

|҂R[hϊ҂̎\ꍇɂ́A<othercredit> Ƃ^O
EGg[gĂB|R[hϊƂꂼ̖
ɂ́A<othercredit> ^O <role> ɁA"converter" (R[h
)  "translator" (|) Ƃlݒ肵܂B́AႦ΁A
̂悤ɂȂ܂B

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



4.9.2. "ӎ" (Acknowledgements) ̏͂ɂ

ɂ́A"ӎ" (Acknowledgements) Ƒ肵ZNVāA
ŁA̕ɈӖ̂vׂĂ̐l̂Ƃ悤ɂ܂
B|҂R[hϊ҂łȂA̗LӋ`ȃtB[hobN𑗂
ĂꂽlAȂm낤ƂĂmĂꂽlA邢́A
݂̕oオ܂łɎ葫ƂȂĎ`ĂꂽlȂǂ
Ɋ܂܂܂B啔̒҂A̍Ōɂ̃ZNVuĂ܂
B



4.9.3. <revremark> ^O

<revision> ^Oɂ͊KwA̒ɁA<revremark> Ƃ^O
B̃^Oň͂񂾗̈ɂ́Aۂ̊ȒPȊo
łƂł܂BVtH[}bgŃ[Xŏ̃o[W
̃RgƂăR[hϊ҂ɑ΂ӎĂA|҂̎
|󂵂o[WƂɏĂ肷邱ƂE߂Ǝv
܂B



4.10. c[ƃqg

o͌ʂ肷鏈́A쐬ɉxJԂ
܂AG[o邱Ƃ͂łByɍs߂ɁA
̃XNvgpӂ܂B낵΃JX^}CYĎg
B



4.10.1. \[X̃RpC

compiles-sgml XNvǵAÃR}hO[v̂łBp
[^ƂāASGML ̕Əo͂tH[}bgnKv
܂B

L̃o[W̃XNvgł́A XML, HTML, TeX, RTF, PS, DVI 
ʑ PS (mirrored PS) tH[}bgT|[gĂ̂ŁAtHggO
t𐶐ꍇɂ͗zIłB

̐́Acollateindex.pl[3] XNvgIɍŝŁALXN
vg炩߃VXeɃCXg[ĂĂB

lXȃtH[}bgŏo͂𐶐鉺L̃R}hƂ͕ʂɁAɂڕ
sc[ Cygnus&trade; 񋟂Ă܂B̃c[́A
<http://sourceware.cygnus.com/docbook-tools/>肷邱Ƃł܂
B

ȉ̃XNvǵA <http://www.linuxdoc.org/LDP/LDP-Author-Guide/
compile-sgml> ɓ邱Ƃł܂B

L̏ꏊɂ́A collateindex.pl <http://www.linuxdoc.org/LDP/
LDP-Author-Guide/collateindex.pl> ܂B

Example 4-8. compiles-sgml XNvg

#!/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                                                                                                                                                 
                                                                                                                                                       
                                                                                                                                                       

XNvǵAMakefile āA֐̂œK邱
ŁACł̂ɂȂƎv܂B



4.10.2. article ̍ŏ̃y[Wɗv|}

article ̍ŏ̃y[Wɗv|\ł@\~Ǝvꍇ邩
܂BADocBook  article ́AWł́A̋@\Ă
܂B (: DocBook  book gꍇ́A肠܂B)

Lɂɂ́ApĂX^CV[gɏCKv
܂B

ȉ̗́Ȁꍇ̏ɂďqׂĂ܂BǵA Example 4-8
B

Example 4-9. article ŁAIɗv|}邽߂ 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. Iɑ}

DocBook ɂ͍t邽߂̃}[NAbv܂A͎
Iɂ͐܂BAcollateindex.pl <http://www.linuxdoc.org/
LDP/LDP-Author-Guide/collateindex.pl> c[g΁A͎
ł܂B

ɂ̃XNvg̎g܂Bۂ̗́A̕Őقǂ
ɂȂƎv܂B(Example 4-8Q)

 1. HTML X^CV[gƁAIvV -V html-index gāAjade ŕ
    ܂B
   
    
    $ 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> gāAindex.sgml 𐶐܂B
   
    
    $ perl collateindex.pl -o index.sgml HTML.index         
    
   
L̗Ⴊ@\ɂ́AOGeBeB(external entity) `
index.sgml t@C荞ޕKv܂B

Example 4-10. t邽߂ɊOGeBeBݒ肷

                                                                       
]>                                                                     
                                                                       

ɕKvȏ荞ޕ@ɂẮASection 4.5 B

    Note: PS  PDF ł̏o͂̍ۂɖڎ荞ƂĂꍇ
    ́A jadetex  pdfjadetex Œ 3 ͎sKv邱Ƃɒ
    ӂĂB́ATeX KvƂ鏈łADocBook 
    ͂Ɋ֘AAvP[V̖ł͂܂B
   


4.10.4. ̒̉B

ʔ@\ƂāA̍쐬ɁA̍쐬ŏIeƂČJ邩
ǂȒPȃ`FbNŌ߂邱Ƃł@\܂B̕
XV悤ƂĂꍇȂǂɂ͓ɁAɑeƂĈʒuÂ
Ă镔݂ꍇ悭܂B

DocBook ł́Ap[^EGeBeB(parameter entity)gāA
ɎU΂蕔͂̕A󋵂ɉĉB\肷邱
ł܂BXVĂꍇɂ́Aǂ̂mF
AV͂҂̂܂ȏomF肷Kv܂A
̑eŏIeɂ͕\ȂƂƂ悭܂B

p[^EGeBeBgƁA̖`̈sύX邾ŁA
e𕶏Ɋ܂߂A폜肷邱Ƃł܂
B

Example 4-11. p[^EGeBeBg

...                                                                    
̒íALGeBeB "review" ̒l "INCLUDE"               
`ꂽƂɁÄꕔƂȂ܂B                             
]]>                                                                    
                                                                       

LGeBeB review ́Â낢ȉӏɏނƂł
܂B̕ւ̕ύXIAL̗Ȃ΁A 3 sڂ 6 sڂ
폜邾łB

ê܂܂ŕێāAŏIeɂ͊܂߂Ȃ悤ɂɂ́AGeBeB
l INCLUDE  IGNORE ɏ邾ōς݂܂B



4.10.5. pɂɗp镶O荞

OGeBeB(external entity)̏dvȓ́A悭g郁╶
舵ۂɔ܂B

̓āA(Ⴆ΁ACZXБȂǂ)pɂɗp镶
͂t@CɂāAt@C𕶏̓K؂ȈʒuɎ荞ނƂ
ł܂B

̓pɁAقǂ Example 4-10 ܂B܂A
HOWTO ̂ SGML R[ḧłB



4.11. ̃Tv

JԂɂȂ܂AX̕^ɂ́A̕^L̃wb_ƗL
R}h̊Kw܂Bȉ̃TuZNVł́Aarticle  book 
Ẵwb_ƗLȃR}hKwЉ܂B

ł̗́A闘p@Jo[Ă킯ł͂Ȃ̂ŁAȉ
́Ag̈ʗ񋟂ӖŏЉ܂B



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 X^CEKCh

5.1. ߂

HOWTO n߂OɁAJo[悤Ƃ͈̔͂𖾊mɂ邱Ƃ
挈łB͈̔͂́Aȉ̏ɍv邱ƂxXgłB

 1. LA. L͂ȏJo[悤ƂƁA[]
    Ȃ܂BLnɃJo[A[ɃJo[
    قx^[łB Linux ̃c[ނ́AЂƂ̎d܂
    AImɂȂƂŗLłBlɁAHOWTO łЂƂ̎
    ImɃJo[悤ɂĂB
   
    ƂȂ鎖ɋꍇ́A HOWTO ̈ꕔƂč쐬
    ܂B΁Aǎ҂͕KvƂ HOWTO 
    ₷Ȃ܂B֘AgsbN HOWTO  LDP |WgŌ
    āA HOWTO ̂Ȃɂꂩ珑Ƃǉłꏊ
    ȂmFĂB
   
    ǂ̒xƏAǂ̒xƏȂ́AI񂾎
    ܂A̎ɂǂꂾKnĂ邩Ȃǂɂ܂B
    ̂ƂOɒuāAK؂ȔfĂB
   
 2. ͖m. n߂OɁAƂȂ̈̋Eǂɐ邩
    𐳊mɈӎ悤ɂĂB HOWTO Ɠ̈Jo[
    ׂł͂܂񂵁A쐬 HOWTO Ɗ֘A HOWTO Ƃ
    ԂɂȂׂMbvȂ悤ɂĂB
   
 3. Vł邱. ̎ɂďOɁALDP ő HOWTO
    `FbNāAȂgsbNɕĂȂmFĂ
    BɂȂAӂA̕
    p悤ɂĂB
   
     HOWTO ł͕s\ȏꍇAXVKvȏꍇ́A̒҂
    AāA͂\o悤ɂĂBLDP ̒҂́AĂ
    cłBǁAނ́AmȂЂƂ邽߂ɋMdȎ
    Ԃ킯łBł̂ŁA\o͉󂯓Ăł傤
    BAǂƌʂ͈{ĂBłȂƁAF
    B
   
 4. LDP ŎOɏF邱. HOWTO 쐬ɓOɁAldp-discuss [
    OXgɂ̎|AāA LDP {eBÃtB[hobN
    悤ɂĂBOɃ[OXg`FbNĂ
    ƁAŔY܂ɂ݂܂Bo҂̒kłB
   
    |XgȂƂAldp-discuss [OXgɎQāAI
    tH[Ă̂́AƂĂƂłBLDP ̊j[YA|
    V[̌m̂ɖ𗧂܂BLDP {eBA͂ނ񉇏͐ɂ
    ݂܂񂪁A LDP ̃|V[wсAɏ]ǂ́AŏIIɂ
    Ȃ߂ɂȂ邱ƂłB
   


5.2. AEgC쐬

ۂɏn߂ɂAOɃAEgC쐬ĂBAEg
CĂƁAɂĂ̖mȃC[WƂł
悤ɂȂ܂A̎XŁAHOWTO ׂ̍ȕɏWł܂B

ɒ[ɒZ HOWTO łȂAAEgC͂炭iK̃xɂ
͂łBKwAEgC쐬ꍇ́AɊւ
ʓIȎŏʂɊ܂܂ATuZNVɓ̏ڂ
ɂĂBX̃AEgC̃xʂɒ߂āAɂ
Ă̎v̈悪ׂăJo[Ă邩ǂmFĂBTuZ
NVŜŁAZNVɊ܂܂ׂׂĂ̎v̈悪Jo[
悤ɂĂB

AEgČX̍ڂ́AO̍ڂ󂯁A̍ڂ𓱂悤Ș_
WɂȂ悤ɂĂBƂ΁ÃvOɊւ HOWTO 
ꍇA炩߃CXg[̃ZNVɁAȂݒ̃ZN
VȂ悤ɂĂB

AEgCłAx́AᔻIȖڂłx߂Ă
BׂĂ̊֘AgsbNKȏڂŃJo[Ăł傤H
HOWTO ̎˒ÔƂĂ܂񂩁HNɌāAӌ
߂Ƃ܂Bn߂AAEgC̒iK̕
 HOWTO ̑S݂̑͂₷̂łB̃tB[hobN~
Ƃ́AAEgC ldp-discuss [OXgɓe邱Ƃl
ĂB

    Note: ŏqׂ悤ƂĂe[}ɂCt
    ł傤Bt[\tgEFAƓlɁAt[hLgA"͂
    ̃[XAイ[X (release early, release often)
    <http://cruel.org/freeware/cathedral.html#4>" xXgłB
    ldp-discuss [OXgɂ́ALDP 쐬̌o҂吨܂
    A HOWTO 쐬ɖƂAAhoCX߂Ƃ
    ܂B
   
Linus ̖@vo܂傤B

        "ڋʂ̐[΁Aǂ typo [ł͂ȂB          
        [4] "                                                          
                                                                       
                                              --Eric S. Raymond        

(Mr. Raymond ߂ȂB)

FIXME: NWbg⃉CZXARs[CgȂǂȂǂ̃gsbNɊւ "
WI" ȃCAEg񎦂邱ƁB



5.3. ͂

̎_ŁAHOWTO ̘gg܂AH̒fГIȏ񂪏W߂A
AAEgCɑgݍ܂ĂƎv܂B悢j[XłB
ŒԒn_߂܂BƂ͉łB

Ƀ`Ŵ́A܂ŏW߂̂܂܂̃f[^SɃ}bT[W
{ȂAǂŁAyŁAł悤ȊiɎdグ邱Ƃ
B

ۂɕ͂n߂邱Ƃłn_܂łǂ蒅ɂ́AςȍƂ
KvƎv܂BÃn[h[N鎞܂B
̒iKł́AȂƎ̕@Ŗȑʂ̏ᖡāAC}W
l[VƓƑn𔭊ł܂B

悭͂@Sʂ邱Ƃ́A̔̕eẑ
A{IȂƂ悤Ǝv܂B"t@X" ̃ZNV
A̕ȂǂImɂЉĂ܂B̕
āAAhoCXɏ]ĂB

܂́APolitics and the English Language <http://www.resort.com/
~prime8/Orwell/patee.html> 炢AhoCXЉ܂B

        Ӑ[C^[́A͂sтɁAȂƂ         
         4 ̂Ƃ₷B                                      
                                                                       
         1. ͉ƂĂ񂾂낤H                       
                                                                       
         2. ǂȌtł\ł邾낤H                       
                                                                       
         3. ǂC[W⌾񂵂gƂƂ͂肷         
            邾낤H                                               
                                                                       
         4. ̃C[ẂAVNȌʂ𔭊邾낤H             
                                                                       
        炭́Âӂ₷邾낤B                       
                                                                       
         1. ƒ[Iɕ\łȂ낤H                         
                                                                       
         2. ŗ]vȂƂĂȂ낤H                   
                                                                       
        ...ťʂv肩˂̂͂悭邱ƂłB䂦        
        AςĂɂłȂƂɁA郋[KvɂȂ         
        BẴP[X͎̃[ŃJo[łƁA킽         
        ͎vB                                                       
                                                                       
         1. iڂɂ邱ƂBgⒼgȂ̔gI\         
            ͎gȂƁB                                         
                                                                       
         2. ȒPȒPgƂ́APgȂ         
            B                                                         
                                                                       
         3. gȂĂṔAĎgȂƁB               
                                                                       
         4. \ԂgꍇɁA󓮑ԂgȂƁB               
                                                                       
         5. Õt[YAȊwpAp̗ނ́Ap         
            ̂ȂŊY傪vԏꍇ͎gȂ         
            ƁB                                                       
                                                                       
         6. ȏ̃[ЂƂłjƁÂƂɁAt         
            ͖Ȃ̂ɂȂB                                       
                                                                       
                                                --George Orwell        

ꂩAɃX^C̊ϓ_猾ƁA HOWTO gĂl
̂ł̏́A킽ɂ͖͂悤Ɏv܂B̖͂́A
Ȃ啔͓̕̂łBgƂĘbƂꂸ
A " I " gǍk⎩̈ӌĂB

ȏキǂƎvƂ͎v܂A炷ׂĂ̒
Ă̊ƂȂĂ錴́AVvł邱ƂłBǎ҂͂łɂ
oꂷTOƓXiĂ̂łAȂ̌tł
ɊiƂƂɂȂȂ悤ɂĂBKISS ̌Y
悤肢܂: Keep It Simple, Stupid!



5.4. eLXg̐ȂƍZ

HOWTO ͂̕IÁA𐄝ȂĖ܂B
̑PŁA܂܂ HOWTO A΂炵 HOWTO ܂܂B

Ȃ̖ړÍAɔEэ񂾗]vȎ폜邱ƂłBHOWTO 
Ӑ[ǂݕԂāA̎ɂĂ̓ǎ҂̗ɖ𗧂Ȃ̂́Aob
TƍĂB͂Ă邤ɒẾA҂ƂĎ
RȂƂłB́AƂłB

ȂƍZ̍ۂ́AXy~X typo Ƃ炩ȃ~X`FbN
Ă͂Ȃ܂BA̍ہAƐ[āAɂAKvȏ
 "" Ƀ`FbNׂłBZNV̓ẽZNV
̃^CgƐmɍvĂ邩ǂmFĂB

̎ƐmɂĊSɖ̂̂łAɂN
ɓnāAO҂ƂčZĂĂBł͍iɋ߂
A{IȌ_𗝉łȂƂ邩łB

ŹAӖŁA\tgEFAJ̃R[hEr[̂悤
̂łBvO}ōR[hr[Ă܂Ӗ
Ȃł傤H҂ōZĂAȏӖ
錋ʂ𓾂ł傤H킯ŁAFlN[g邩A
ldp-discuss [OXgɓeă{eBA{AeO
HOWTO Z悤ɂĂB

    Note: ł͐ʂĂȂŕĂꍇ́A
    ɐʂZ҂{ƂE߂܂BZpł́A
    ̂ǂȃ^Cv̕Aiɐmȕ@ƌbgȂ΂
    ܂BťṕAꂪǂقǒv̂ȂӐ}p
    ƂĂAȂ HOWTO ̉lቺĂ܂܂B
   


5.5. 쐬 HOWTO ̊Ǘ

쐬 HOWTO JꂽƂāAdׂďI킯
͂܂BHOWTO ̏XVAǎ҂̃ACfAĂɉ HOWTO
mɉPĂ߂ɂ́AIȃeiXKvłB HOWTO 
́Aɐ鐶ml܂Ă̂ŁAJĂŏI
ŒIȂ̂ł͂܂B

HOWTO Ɏ̃[AhXāAǎ҂̃tB[hobN𒚔J
肢ł傤HUɌJƁAẴ[
悤ɂȂ܂B̂Ȃɂ͂ƂĂMdȂ̂܂A
O͌lIȖ̉߂̂肵܂BԂȂ΁Al
IȖɉKv͑S܂BLDP  HOWTO Ƃ
AlbĝlɃt[T|[g𐶊U`𕉂킯ł͂
łBAłȂAlɕʂ̏񌹂Ă
ƁAe؂ł͂܂B܂A󂯎̃p^[Ă΁A
HOWTO ɒǉׂgsbN邩܂B



5.6. t@X

͂̏Ɋւ镶ICɂ񂠂܂Bɂ
̂̂ȒPɏЉ܂B

 E Politics and the English Language <http://www.resort.com/~prime8/
    Orwell/patee.html>.
   
 E Elements of Style <http://bartleby.com/141>
   
 E FIXME: eNjJECeBOɊւǂ܂A URL
    B
   


Chapter 6. X^C֘A̕⑫

̃ZNVł́A̍쐬ɂAX^CɊ֘AgsbN̂
⑫Ă܂B



6.1. t̏

<pubdate> ^O𕶏Ŏgۂɂ́ȀœtLĂB

v1.0, 21 April 2000                                                    



6.2. 摜tH[}bg

ɉ摜t LDP ɑۂ́A܂ .eps ̃ZbgƁA .gif 
 .jpg ̂ǂ炩̃ZbgƂ𑗂ĂB.gif ̖̓
ӎĂׂłA.gif ̂قA.jpg 肷ǂ摜
悤łB



6.3. DocBook ̃o[W

LDP ł́Aȉ̃tH[}bgł̕T|[gA󂯓Ă܂B

 E SGML DocBook versions 4.x  3.1
   
 E SGML LinuxDoc
   
 E XML DocBook version 4.1.2
   
DocBook ̃wb_Ƃ́Â悤ɏĂB



6.4. p֎~̃^O

񐄏^OƂ DocBook: The Definitive Guide ̃XgɋĂ^
ÓALDP łgpȂ悤ɂĂBV^O̎g
ẮAeNjbNƃRc̃ZNVŏЉĂ܂B



6.5. ^O̍ŏ

^O̍ŏ(tag minimization)Ƃ́A(Ƃ΁A</para> ̂悤)S
I^ÔɁA</> gƂłBgƁA̕ɏ
҂ LDP o[ɂƂĂ͕\ɂȂ܂AXML
DocBook ł͔F߂ĂȂgȂ̂ŁAK͎~߂悤ɂ
ĂB



6.6. ł̕\L@

lXȕԂŎׂ\L@ɁÂ悤Ȃ̂܂B

R}h̎gƂꍇA[UR}hCƂĂ̕\
Ȃ悤AR}hsĂBvvgɂ́A܂AVF̎
 (bash, tcsh, zsh, Ȃ) \AɁA(root łȂ)ʏ̃[U
ƂĎsꍇɂ $ Aroot [UƂĎsꍇ # \
ĂB

䂦AR}h́Â悤ɕ\܂B


bash$ command "run as a normal user"                                
bash# command "run as a root user"                                  
tcsh# setenv DISPLAY :0.0                                           



Chapter 7. DocBook ̃eNjbNƃRc

̃ZNVł́Aۂ DocBook ̂ƂЂ˂g
Љ܂B



7.1. 摜̑}

HOWTO ɉ摜悤ƎvĂꍇALinuxDoc ł͉摜̃T|[g͂
܂łADocBook Ȃ\łBɁAHOWTO ɉ摜@
̈Љ܂B

                                                                          
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
         Screen shot of the LyX document processing program            
                                                                       
                                                                       

ĹA<graphic> gAӂ̗RłĂ܂BɁA
DocBook 5.0 ł́A<mediaobject> Ɉڍs邽߁A<graphic> ͍폜
B䂦A琳@Ŏgn߂ق悢Ǝv܂B
ɁA<mediaobject> ȂAo͌`ɏ]ĈقȂ镡̃tH[}bg̉摜
Ƃł܂BL̗ŌƁAŏ <imageobject> ́ADVI,
PS, PDF Ƃ TeX 琶tH[}bgɗp EPS
(Encapsulated PostScript) 摜ŁAӂڂ <imageobject> ́AfBXv
CʗpA啔 HTML p̏o͂ŗp JPEG 摜łB
<textobject> ́̕Ao͂摜T|[gĂȂꍇɕ\
̂ł(TXT)B<alt> ^Ô悤Ȃ̂ƂlB



7.2. HTML o̓t@C̃t@Cw肷

ʂ HTML t@Co͂ꍇASGML ńAftHgŁAӓI
ȃt@Ct܂Bł́Aǎ҂y[WubN}[NĂ
ĂɕύXĂ܂܂AȂǂꂪǂ̃t@CȂ̂
ȂȂāA킵ł傤BR͂ǂłAł́Aʂ
o̓t@CɍDȖOt@Љ܂B

<article> ^Oŏɒuꍇ( ͂ЂƂ̂͂łB)A
id p[^ŁA̒l index Ƃ܂BƁA^O
̂悤ɂȂ܂B

ŏ <chapter> ^OuꍇÃ^O̓e͒ʏCg_NV
ƂȂł傤A͕̍ŏɒuƎvł傤AC
Ȃł [5]BȊǑX <section> ^OɂẮA id
p[^Ƃ̖OłBOɂ́AAt@xbgƐ
g悤ɂAełx̒ZOɂĂB



7.3. ldp.dsl g

LDP ł́AƎ DSSSL gĂāAɂāAwi HOWTO 
ŏ̃y[Wɂڎ̎@\tĂ܂B̍ŐVo[W
́A http://www.linuxdoc.org/authors/tools/ldp.dsl ɂ܂B

t@CɓADocBook DSSSL t@C̒uꏊɊÂĐ擪
̐sCKv邩܂B킽̗ł́ACygnus c[
ZbggĂ܂B

ldp.dsl t@C /usr/lib/sgml/stylesheets ɒuāADȃGf
B^ŊJĂB̂悤ɂȂĂ̂킩Ǝv܂B


                                                                    
(1) " CDATA dsssl>                                                  
]]>                                                                 
                                                                    
(2) " CDATA dsssl>                                                  
]]>                                                                 
]>                                                                  


(1) ŏ "docbook.dsl" A/usr/lib/sgml/stylesheets/nwalsh-modular/
    html/docbook.dsl ǂނ悤ɂĂB
(2) ڂ "docbook.dsl"  /usr/lib/sgml/stylesheets/nwalsh-modular/
    print/docbook.dsl ǂނ悤ɂĂB

Ⴄ DSSSL gĂȂALӂ̃t@ĈƂ낪 HTML p
ƃvgp DSSSL t@Cw悤ɕύXĂBʏA
 html  print ƌĂ΂fBNgɓĂ܂B

ȏオς߂΁AHTML t@C̏o͂ł悤ɂȂ܂B


bash$ mkdir HOWTO-HOWTO ; cd HOWTO-HOWTO                                                  
bash$  jade -t sgml -i html -d /usr/lib/sgml/stylesheets/ldp.dsl\#html ../HOWTO-HOWTO.sgml


ŏ̃R}hł́Ao̓t@CfBNg쐬Ă܂B
̃R}h(jade gĂł)ł́ÃZNVƂ̌ʂ
HTML t@C𐶐Ă܂BRTF Ȃǂo͂ꍇ́Â悤ɂ
ĂB


bash$ jade -t rtf -d /usr/lib/sgml/stylesheets/ldp.dsl ../HOWTO-HOWTO.sgml



Chapter 8. ̌Jɂ

8.1. Ĵ܂

̖̓ǎ҂ɕJ܂ɁAׂƂ܂
B

ɁAKXy`FbN邱ƂłBSGML ̂Ɏg郆[e
BeBɂ́AĂXy`FbNp̃vOCtĂ܂Bt
ĂȂꍇłAaspell ܂B

ɁA̐lɍǂĂ炢ARgAɊԈႢ
mFĂĂBLDP óA Linux [U
ނƂɂȂ̂ŁǍ͋ɗ͌炷Kv܂BMΏۂɊւ
đ吨̐lQ郁[OXgɓo^ĂȂAő̐l
q˂āAĂ炢܂傤B

OɁA쐬JEFuTCgĂB͕K{
ł͂܂񂪁A̕ǂō쐬ꂽ̂m肪ɂȂ
B



8.1.1. SGML R[h̑Ó

jade ۂ nsgmls R}hgāA쐬 .sgml R[h DTD ɏ
炵đÓǂAG[̂ȂƂm߂邱Ƃł܂B


bash$ nsgmls -s HOWTO-HOWTO.sgml                                    


Ŗ肪Ȃ΁AȂR}hvvgԂĂ܂B



8.2. 쌠ƃCZX̖

LDP  LDP ƂĔF߂ɂ́Ahttp://www.linuxdoc.org/
manifesto.html ɂ LDP }jtFXg " CZX̕Kv " 
]CZXtĂȂ΂Ȃ܂B̍쐬҂ƂāA
ێ邱Ƃł܂ACZXɑ̐ (Ƃ΁A|
쐬Ƃ́A҂̏F𓾂Ȃ΂ȂȂAƂ) t
邱Ƃł܂B

ƂẮAGNU Free Documentation License (GFDL) <http://
www.gnu.org/copyleft/fdl.html> AIvV A  B Ȃ Open
Publication License (OPL) <http://opencontent.org/openpub/> g
E߂܂B DocBook pɃ}[NAbvꂽ GNU GPL  GNU FDL  
GNOME Documentation Project <http://developer.gnome.org/projects/gdp/
licenses.html> ɂ̂ŁAgƂł܂B̏ꍇACZ
XS𕶏ɓ邾łBAS͒̂ŁACZXւ̃
Nłł\łB

쌠́u^vgƂꍇ́A" 쌠ƃCZX "ƂZ
NV𗧂ĂāAɕʂ̂܂܃Rs[ĂB䎩̖O
Œ쌠̕\ĂB(CZX̂߂ɒ쌠D킯
ł͂܂B) ̐̕VǗ҂ɂȂꍇ́A̕
ĂȑO̒ҖƓtɂĂ̒쌠Ȃ΂Ȃ܂B

 LDP Author Guide ̃CZXł́A񎟕|쐬ꍇ
҂ւ̕񍐂߂Ă邱ƂɁACt܂B܂A킽
A(̕ SGML ̃\[XR[h) ׂẴ\[XR[h
I GPL ̊ɒu܂B쐬 HOWTO Ƀ\[XR[h܂܂Ă
āA𑼂̐lɂgĂ炨ƎvƂ́A悤ɂƂ
v܂B



8.3. LDP ւ̊e

LDP ̂ߍׂǂςނƁA̕ LDP Ń[Xł܂B
SGML \[XR[hYtāA(<submit@linuxdoc.org> Ƀ[𑗂Ă
B( gzip ňkĂ\łB)

[ subject ɂ HOWTO ̕āA{ɂ͂ HOWTO ̕
X_⏑_̊TvĂ̂YȂłBꂪ
ƕǗ̍ƎԂZkł܂A HOWTO  LDP ̃EFuTC
gōXV̂҂Ȃčς݂܂B5 ԉ̒m点ȂƂ́A
x[𑗂āA܂ƒȂ̂ǂmFĂB

HOWTO ɃeLXgȊỎ摜ʂȃJ^O܂܂ꍇA.sgml \[X
R[h܂ޑSt@C .tar.gz t@CɌł߂āA[ɓYt
submit [OXg܂őĂB

̍쐬 LDP CVS c[gĂꍇ́AJ鏀
Ƃɍēx LDP ֕񍐂Kv܂B̍ۂ́A
<submit@linuxdoc.org> Ƀ[肭B^Cgɕ
āA{ LDP CVS c[ł̑΃pXĂĂB



8.4. 쐬̊Ǘ

쐬 HOWTO JꂽƂāAdSI킯ł͂
܂BHOWTO ̏XVAǎ҂̃ACfAĂɉ HOWTO m
ɉPĂ߂ɂ́AIȃCeiXsłBHOWTO ɂ
Aɐ鐶ml܂Ă̂ŁAJ炻ŏI
ŒIȂ̂ł͂܂B

HOWTO Ɏ̃[AhXāAǎ҂̃tB[hobN𒚔J
肢ł傤HUɌJƁAẴ[
悤ɂȂ܂B̂Ȃɂ͂ƂĂMdȂ̂܂A
O͌lIȖ̉߂̂肵܂BԂȂ΁Al
IȖɉKv͑S܂BLDP  HOWTO Ƃ
AlbĝlɃt[T|[g𐶊U`𕉂킯ł͂
łBAłȂAlɕʂ̏񌹂Ă
ƁAe؂ł͂܂B܂A󂯎̃p^[Ă΁A
HOWTO ɒǉׂgsbN邩܂B



Chapter 9. LDP ɂĂ FAQ

Q: LDP ̂`̂łAǂ炢ł傤H
Q: LDP ܂Ƃ߂āAЂƂďoł̂łALDP ̃CZ
    X͂ǂ̂ɂȂ܂H
Q: LDP ̒Ɍ̂łACł܂H
Q: SGML ܂B/ c[܂B/ SGML łB

Q: LDP ̂`̂łAǂ炢ł傤H

A: ԊȒPȕ@́A{āA𕶏邱ƂłB
́AǗ҂Ȃ HOWTO `FbNāA悭mĂ镪ŕ
̂ȂmF邱ƂłB

Q: LDP ܂Ƃ߂āAЂƂďoł̂łALDP ̃CZ
X͂ǂ̂ɂȂ܂H

A: http://www.linuxdoc.org/COPYRIGHT.html" <http://www.linuxdoc.org/
COPYRIGHT.html> BA͌X̒҂ɑ΂KCh
CłȂƂɒӂĂBƂ͂A URL ɋĂ
̂茵t邱Ƃ͂ł܂B

Q: LDP ̒Ɍ̂łACł܂H

A: ̒҂ALDP R[fBl[^ <discuss@linuxdoc.org> ɘA
A̕ƁAǂCKvKv񍐂ĂB

Q: SGML ܂B/ c[܂B/ SGML łB

A: 肠܂Bŏ̑éADȃtH[}bgŏĂ
\ł̂ŁA LDP ܂ł肭BLDP {eBAǂ
Ǎ DocBook ɕϊ܂Bꂳς߂΁AHOWTO ̊Ǘ͓̂
Ȃł傤B^₪΁Ał LDP {eBAɘA邩A
LDP DocBook [OXg <docbook@linuxdoc.org> ܂ŘAĂ
B

pW

 (attribute)
   
    Ƃ́AꂪuꂽGgɒǉ邱Ƃ\
    ̂łB́AKuƒlṽyA|C^Ō
    ΂ꂽ`Ō܂Bid="identification" ͑̈łA
     id ŁAidentification lłB
   
^` (DTD, Document Type Definition)
   
    gݍ킹ƏɂẴ[w肵āAGgƂ̑
    Ƃ`̏WBJ[\ʒũReLXgŁAG
    g}ł邩ۂ`Ă̂ADTD łB
   
DSSSL
   
    DSSSL ́ADocument Style Semantics and Specification Language ̗
    łB ISO W (ISO/IEC 10179:1996) ƂȂĂ܂BDSSSL KíA
    SGML ̕X^CV[gy[Ŵ߂̌ƂčۓIɎgp
    ܂B
   
Gg (element)
   
    GǵÅKw\`̂łBقƂǂ̃G
    ǵAJn^OƏI^O琬܂B̃^O̊ԂɁA͂̈ꕔ
    A邢͕Ŝ܂BJn^OȂAReg
    ȂGg (empty element)Ƃ̂܂B
   
GeBeB (entity)
   
    GeBeBƂ́A閼Oɂ(SGML )QƂł悤ɂ
    ꂽꕔ̃f[^ɂāÃf[^w閼̂łB̎w
    AɕƂďނƂŗLɂȂ܂BwΏۂƂȂf
    [^́APȕ╡̕҂ƂȂ镶͌Qł悭ADTD ̈A̕
    ł\܂B SGML ł̃GeBeBɂ́Ap[^GeB
    eB (parameter entity)AʃGeBeB(generic entity)AOG
    eBeB (external entity)AGeBeB(internal entity)Af[
    ^GeBeB (data entity)܂B
   
OGeBeB (external entity)
   
    OGeBeB́AO|CĝłBOGeBe
    B́A SGML ̔Cӂ̈ʒuɃeLXg荞݂ꍇɎgp
    BgƂẮATvvO@̒ӏÄ
    ҂Ȃǂ荞ނƂl܂B
   
ʃGeBeB (generic entity)
   
    "&" Ŏn܂Z~RŏI閼OŎQƂGeBeB́A
    GeBeBłBقƂǂ̏ꍇÃ^CṽGeBeB́A
    ŎgpADTD ł͎gp܂BʃGeBeBɂ́AO
    GeBeBƓGeBeB̓ނ܂BǂAꕶ
    ÁAJԂpZeXAOÄ҂Ȃ
    QƂ̂łB
   
GeBeB (internal entity)
   
    GeBeB́AeLXg̈ꕔQƂ邽߂̂̂ŁA΂
    ApɂɗpeLXg̈ꕔ̃V[gJbgƂĎg܂B
   
p[^GeBeB (parameter entity)
   
    DTD ł悭gpGeBeBB̃GeBeB́Ap[Z
    gL (%) Ŏn܂AZ~RŏI܂B
   
t[g (float)
   
    TCho[摜A\gA`[gȂǂ̃IuWFNgŁAeLXg
    Č܂ʒuȂꍇɁAt[gƌĂ΂܂BeL
    Xg̏ꍇA`[ǵAy[Ẅԏォԉɒu܂B傫
    ۂ́Ãy[WɓnĒu܂B
   
 (processing instruction)
   
    ߂Ƃ́A`c[ɓnR}ĥƂłB
    ́A "<?" Ŏn܂܂B̕ŁAHTML t@Cւ̕ϊ̍ۂɏo
    ̓t@Cw肷邽߂ɎgpĂR}ḧƂāA
    ̂悤Ȃ̂܂B <?dbhtml filename="file.html">
   
SGML
   
    ėp}[NAbvK(Standard Generalized Markup Language)B
    ́AgpvbgtH[ɈˑȂA}[NAbvVXe
    gdq쐬̂߂̃[K肷鍑ەW (ISO8879) ł
    ܂B
   
^O (tag)
   
    "<"  ">" }[Nɋ܂ꂽ SGML GĝƁB^ÓÄ
    \}[N邽߂Ɏgp܂B^ÖƂẮA^Cg
    ̊Jn}[N邽߂ <title> ܂B
   
XML
   
    eXtensible Markup Language. C^[lbgł̗p̂߂ɓʂɍ
    ꂽ SGML ̃TuEv_NgB
   
XSL
   
    XML Style Language. XSL  XML Ƃ̊֌ẂADSSSL  SGML 
    ֌WƓłBہÃX^ĆAƂĂ XML ̂̂ł
    B
   


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] Ȃ̕Ŗ{Ɠ\L肽ꍇ́Ã̕\[X 
    BA݂Ă\ĹAȂǂ̃tH 
    [}bgł̕ǂ݂ɂȂĂ邩Ɉˑ܂BIC 
    ̕\ĹAPostScript  PDF ł̂Ƃ͏قȂ܂B         
                                                                       
[2] LReǵADTD, DOCUMENT, ELEMENTS, ENTITIES, NONSGML łB
                                                                       
[3] ̏ڍׂ́ANorman Walsh ̃TCgɂ֌W̃y[W
    B                                                             
                                                                       
[4] L 2  quotation ́AR`_̖|󂩂炨؂肵܂B   
                                                                       
[5] (: ̕() SGML \[Xł́AŏɃ^O𖳏CŒuA
    ̒ł̍ŏ̂ƂĂ܂BgbvxEGg( LDP ł 
    ArIZɂ͂A߂̕ɂ͂g邱Ƃ悤ł 
    B) ɉēKXǂݑւĂB)                              

