

LDP Author Guide

Mark F. Komarinski

VA Linux Systems

markk@linuxdoc.org

Jorge Godoy

Conectiva S.A.
Publishing Department

godoy@conectiva.com

godoy@metalab.unc.edu

David C. Merrill

dcmerrill@mindspring.com


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.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.2. DocBook DTD (version 4.1  3.1)
    3.3. Jade
    3.4. Jade wrappers
    3.5. ҏWc[
    3.6. CVS
    3.7. ̑̃c[ƃt@X
   
   
4. DocBook ^O̎g
    4.1. ͂߂
    4.2. KvȐݒ
    4.3. J^O̍쐬ƏC
    4.4. DocBook Gg̎g
    4.5. 
    4.6. 摜̑}
    4.7. \g
    4.8. vOR[hƃRg
    4.9. |҂R[hϊ҂̎\
    4.10. c[ƃqg
    4.11. ̃Tv
   
   
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.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
ɂ܂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 o
    RŁ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  sgmltools ́̕A̃ZNV
Ă܂BCVS ւ̃lbg[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̃vv bash$                                
g                                                                     
bash ł̃[g[UR}h̃v bash#                                
vg                                                               
tcsh ł̃[UR}h̃vv tcsh$                                
g                                                                     
ϐ                          VARIABLE                             
ꂽP                    word                                 
TvR[h                    <para>pOt̍ŏƍŌB</para>



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, ({) ܂A莝̃C[TlbgJ[h
Linux Ŏg邩m肽Ƃ́AEthernet HOWTO, ({) ΂
܂B͂߂̍ÁAeLXg HTML ŏ
܂ÂAƏɊǗKvĂ܂B
Ƃ΁AEFuy[Wŉ{ACD-ROM ォAɂ̓nhE
wh 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 - Stein Gojen ̃ev[g
    ALinuxDoc `ŏƂ̂̂łB
   
 E 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/

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

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 
A http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zipB

XML DTD gꍇ́A http://www.oasis-open.org/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

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[XfBNg
    ɂȂ悤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
   
    <xml_dtd_pth>/ent/iso-lat2.ent:119:18:E: "X0176" is not a function name 
    <xml_dtd_pth>/ent/iso-lat2.ent:120:17:E: "X0178" is not a function name 
                                                                            



 SGML DocBook  XML ɕϊꍇ́A(̖`̍s
)^錾(declaration)̂ƂŎ̂悤ɏĂB
<?xml version='1.0' encoding='ISO-8859-1'?>                            
<!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.1.2//EN'>       
                                                                       

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


3.3.2. OpenJade

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/

́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.

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^Ă܂B


3.5. ҏWc[

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


3.5.1. Emacs (PSGML)

IvVłB - 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
<!DOCTYPE test [                                                       
<!ELEMENT test - - (#PCDATA)>                                          
]>                                                                     

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


3.5.1.1.4. DocBook `ŐVK HOWTO @

HOWTO pɐVKt@CJāÂ悤ɓ͂܂B
<!DOCTYPE ARTICLE PUBLIC "-//OASIS//DTD DocBook V3.1//EN">             

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


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
   
 E 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


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&dollar; Ƃʂȃ^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
({)

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/

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

 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)
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

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


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 ŏ߂ĕ쐬ꍇ́AJO 
    A̃tH[}bgō쐬ǂ̍قɂȂ̂m 
    Fق悢ł傤B                                         

Note ϊʂ́Aϊ̍ۂɎgX^CV[gɈˑ̂ŁA}[NA
     bv͂ł邾gƂE߂܂BW̃X^CV[
     gł͏o͌ʂɂ܂ႢȂƂłA^Oڗ
     ̏o̓tH[}bg邩ȂłB            



Table 4-1. ֗ȃR}h

prR}h                                                      o͌        

[<email> address@domain</email>                                <address@domain>
A                                                                              
h                                                                              
X                                                                                

҄<author>...</author>                                          (L̗Q)
ɂ                                                                              
Ą                                                                              

҄<firstname>First_Name</firstname>                             First Name      
  <othername>Middle_Name</othername>                            Middle Name     
    <surname>Surname</surname>                                    Surname         
                                                                                  

L[<keycap>F1</keycap>                                           F1              
                                                                                
(L                                                                               
[{                                                                              
[h                                                                              
̄                                                                              
\                                                                                
L)                                                                               

L[<keysym>KEY_F1</keysym>                                       KEY_F1          
̃V                                                                              
{                                                                              
                                                                              

L[<keycode>0x3B</keycode>                                       0x3B            
̃R                                                                              
[h                                                                              

L[<keycombo>                                                    Ctrl-S          
̈́   <keycap>Ctrl</keycap>                                                      
       <keycap>S</keycap>                                                         
    </keycombo>                                                                   
                                                                                  

v<guimenu> t@C</guimenu>                                  t@C        
O                                                                              
                                                                              
j                                                                              
[                                                                                

j<guimenuitem>ۑ</guimenuitem>                               ۑ            
[                                                                              
AC                                                                              
e                                                                              

j<menuchoice>                                                  t@C->ۑ (
[   <shortcut>                                                 Ctrl-S)         
I      <keycombo>                                                              
             <keycap>Ctrl</keycap>                                                
             <keycap>S</keycap>                                                   
          </keycombo>                                                             
       </shortcut>                                                                
       <guimenu>t@C</guimenu>                                                
       <guimenuitem>ۑ</guimenuitem>                                            
    </menuchoice>                                                                 
                                                                                  

}E<mousebutton>left</mousebutton>                               left            
X{                                                                              
^                                                                              

R}<command>comando</command>                                    command         
h                                                                              
                                                                                

Av<application>application</application>                        application     
P                                                                              
[V                                                                              
                                                                              
                                                                                

Ql<citation>reference</citation>                                [reference]     
                                                                              
\                                                                              

p<blockquote>                                                                
       <attribution>Җ</attribution>                                p        
       <para>p</para>                                                      
    </blockquote>                                                  --Җ       
                                                                                  

ELQ                                                      Section 4.5Q 

t@<filename>file</filename>                                     file            
C                                                                              
                                                                                

fB<filename id="directory">directory</filename>                 directory/      
N                                                                              
g                                                                              

<emphasis>text</emphasis>                                     text            
[a]                                                                               

r<footnote>                                                    (̕\gɍŌ 
       <to>r</to>                                            Q)         
    </footnote>                                                                   

URL <ulink url="http://www.conectiva.com>Conectiva S.A.</>        Conectiva S.A.  

}[<itemizedlist>                                                                
Nt   <listitem>                                                  E ACe    
ӄ      <para>ACe</para>                                                   
   </listitem>                                                 E ACe    
     <listitem>                                                                 
          <para>ACe</para>                                                   
       </listitem>                                                                
    </itemizedlist>                                                               

ԍ<orderedlist>                                                                 
t   <listitem>                                                  1. ACe    
ӏ      <para>ACe</para>                                                   
   </listitem>                                                 2. ACe    
       <listitem>                                                                 
          <para>ACe</para>                                                   
       </listitem>                                                                
    </orderedlist>                                                                

<segmentedlist>                                               2 i 10 i
   <title>2 i 10 iւ̕ϊ\</title>                ւ̕ϊ\    
ӄ   <segtitle> 2 i</segtitle>                                               
   <segtitle>10 i</segtitle>                                2 i: 00     
     </seglistitem><seg>00</seg><seg>0</seg>                                    
       </seglistitem>                                             10 i: 0      
       <seglistitem><seg>01</seg><seg>1</seg>                                     
       </seglistitem>                                              2 i: 01     
       <seglistitem><seg>10</seg><seg>2</seg>                                     
    </segmentedlist>                                              10 i: 1      
                                                                                  
                                                                   2 i: 10     
                                                                                  
                                                                  10 i: 2      

o<variablelist>                                                                
t   <varlistentry>                                             o 1        
ӄ      <term>o 1</term>                                               
      <listitem>                                                              
           <para></para>                                    o 2        
          </listitem>                                                         
       </varlistentry>                                                            
       <varlistentry>                                                             
          <term>o 2</term>                                                   
          <listitem>                                                              
             <para></para>                                                    
          </listitem>                                                             
       </varlistentry>                                                            
    </variablelist>                                                               

V<simplelist type="horiz" columns="3">                         1 2 3           
v   <member>1</member>                                         4 5 6           
ȉӄ   <member>2</member>                                                         
   <member>3</member>                                         A, B, C, D, E, F
     <member>4</member>                                                         
       <member>5</member>                                                         
       <member>6</member>                                                         
    </simplelist>                                                                 
    <simplelist type="inline">                                                    
       <member>A</member>                                                         
       <member>B</member>                                                         
       <member>C</member>                                                         
       <member>D</member>                                                         
       <member>E</member>                                                         
       <member>F</member>                                                         
    </simplelist>                                                                 

摜ELQ                                                      Section 4.6Q 

\gELQ                                                      Section 4.7Q 
                                                                                

vELQ                                                      Section 4.8Q 
O                                                                              
ք                                                                              
̃R                                                                              
                                                                              
g}                                                                              
                                                                                

pꄠ<glossentry>                                                  ̊̕Ʉ
W     <glossterm>Term</glossterm>                                pWQ  
       <glossdef>                                                                 
          <para>Definition</para>                                                 
       </glossdef>                                                                
    </glossentry>                                                                 

݄<section id="secao">                                          (摜̏o͌ 
QƄ...                                                           ʗQ)       
    </section>                                                                    
    <section id="reference the other section">                                    
    ...                                                                           
    <para>Please, see<xref linkend="secao"> for more information.                 
    </para>                                                                       

Notes:                                                                                
a. \ɂ͂̕@܂BΑ̂̑łʓIłA DocBook ł͎΄
̂T|[gĂ܂Bgɂ́ApĂ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
<indexterm>                                                            
   <primary>Main level</primary>                                       
   <secondary>Second level</secondary>                                 
   <tertiary>Third level</tertiary>                                    
</indexterm>                                                           
                                                                       

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


Example 4-3.  zone ̎g
<section id="encoding-index">                                             
    <title>Encoding Indexes</title>                                       
                                                                          
    <indexterm zone="encoding-index">                                     
      <primary>edition</primary>                                          
      <secondary>index</secondary>                                        
    </indexterm>                                                          
                                                                          
    <para>́AɃ}[NAbv}邱ƂŐ܂B</para> 
                                                                          

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@
    <PARA>iA͂łłƁAƂǂ                              
   <INDEXTERM CLASS="startofrange" ID="example-band-index">                   
      <PRIMARY>examples</PRIMARY>                                             
      <SECONDARY>index</SECONDARY>                                            
   </INDEXTERM>                                                               
  }[NKv邱Ƃ܂B</PARA>                 
                                                                              
   <PARA>ꍇłAʂɏi߂܂傤B</PARA>              
                                                                              
   <PARA>āAt̍ŌɗÂ悤ɒ߂܂B 
                                                                              
   <INDEXTERM STARTREF="example-band-index" CLASS="endofrange">.              
   </PARA>                                                                    


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>                                                               
   <title>Picture's Title</title>                                      
   <graphic fileref="images/file"></graphic>                           
</figure>                                                              

<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
<figure>                                                                 
   <title>Title</title>                                                  
   <mediaobject>                                                         
      <imageobject>                                                      
         <imagedata fileref="images/file.eps" format="eps">              
      </imageobject>                                                     
      <imageobject>                                                      
         <imagedata fileref="images/file.jpg" format="jpg">              
      </imageobject>                                                     
      <textobject>                                                       
         <phrase>̕ɂ́A̗ł̉摜uĂ܂B</phrase> 
      </textobject>                                                      
      <caption><para>摜ɂ(IvV)</para></caption>         
   </mediaobject>                                                        
</figure>                                                                

̂悤ȃ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. \̑}
<table frame="all">                                                                         
  <title>Sample Table</title>                                                               
  <tgroup cols="5">                                                                         
    <colspec colname="column1">                                                             
    <colspec colname="column2">                                                             
    <colspec colname="column3">                                                             
    <colspec colnum="5" colname="column5">                                                  
    <spanspec namest="column1" nameend="column2" spanname="span-horiz" align="center">      
    <spanspec namest="column2" nameend="column3" spanname="span-horiz-vert" align="center"> 
    <thead>                                                                                 
      <row>                                                                                 
        <entry spanname="span-horiz">                                                       
           ̃Xp                                                                 
        </entry>                                                                            
        <entry>wb_ 2</entry>                                                             
        <entry>wb_ 3</entry>                                                             
        <entry>wb_ 4</entry>                                                             
      </row>                                                                                
    </thead>                                                                                
    <tfoot>                                                                                 
      <row>                                                                                 
        <entry>tb^ 1</entry>                                                             
        <entry>tb^ 2</entry>                                                             
        <entry>tb^ 3</entry>                                                             
        <entry>tb^ 4</entry>                                                             
        <entry>tb^ 5</entry>                                                             
      </row>                                                                                
    </tfoot>                                                                                
    <tbody>                                                                                 
      <row>                                                                                 
        <entry>f[^ 1-1</entry>                                                           
        <entry>f[^ 1-2</entry>                                                           
        <entry>f[^ 1-3</entry>                                                           
        <entry>f[^ 1-4</entry>                                                           
        <entry>f[^ 1-5</entry>                                                           
      </row>                                                                                
      <row>                                                                                 
        <entry>f[^ 2-1</entry>                                                           
        <entry>f[^ 2-2</entry>                                                           
        <entry>f[^ 2-3</entry>                                                           
        <entry>f[^ 2-4</entry>                                                           
        <entry morerows="1" valign="middle">                                                
           ̃Xp                                                                 
        </entry>                                                                            
      </row>                                                                                
      <row>                                                                                 
        <entry>f[^ 3-1</entry>                                                           
        <entry spanname="span-horiz-vert" morerows="1" valign="bottom">                     
           _uXp                                                                     
        </entry>                                                                            
        <entry>f[^ 3-4</entry>                                                           
      </row>                                                                                
      <row>                                                                                 
        <entry>f[^ 4-1</entry>                                                           
        <entry>f[^ 4-4</entry>                                                           
        <entry>f[^ 4-5</entry>                                                           
      </row>                                                                                
    </tbody>                                                                                
  </tgroup>                                                                                 
</table>                                                                                    
                                                                                            
                                                                                            


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[̃Xp
                                          ^              
                                          2-4               
              
f[^ 3-1             _uXp         f[              
                                            ^                
                                            3-4               
                              
f[^ 4-1                                  f[f[^ 4-5    
                                            ^                
                                            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)
<example id="sample-catalog">                                                           
  <title>Catalog Sample</title>                                                         
  <programlistingco>                                                                    
    <areaspec>                                                                          
      <area coords="1" id="ex.catalogue.comment">                                       
      <area coords="5" id="ex.catalogue.definition">                                    
      <area coords="11" id="ex.catalogue.eof">                                          
    </areaspec>                                                                         
        <programlisting>                                                                
-- 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 --                                                                               
        </programlisting>                                                               
    <calloutlist>                                                                       
      <callout arearefs="ex.catalogue.comment">                                         
        <para> Comment. Comments begin with <quote>--</quote>                           
        and follows to the end of the line. </para>                                     
      </callout>                                                                        
      <callout arearefs="ex.catalogue.definition">                                      
        <para> The public type association                                              
           <parameter class="option">"-//Conectiva SA//DTD books V1.0//EN"</parameter>  
           with the file <filename>books.dtd</filename> on the directory                
           <filename class="directory">/home/ldp/estilos</filename>. </para>            
      </callout>                                                                        
      <callout arearefs="ex.catalogue.eof">                                             
        <para> Comment informing the end of the file. </para>                           
      </callout>                                                                        
    </calloutlist>                                                                      
  </programlistingco>                                                                   
</example>                                                                              
                                                                                        

<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
<othercredit role='converter'>                                         
  <firstname>David</firstname>                                         
  <surname>Merrill</surname>                                           
  <contrib>Conversion from HTML to DocBook v3.1 (SGML).</contrib>      
</othercredit>                                                         


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
肷邱Ƃł܂B

ȉ̃XNvǵAɓ邱Ƃł܂B

L̏ꏊɂ́A 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 ̐ݒ
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [                          
<!entity html-docbook PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>   
<!entity print-docbook PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL> 
]>                                                                                                  
                                                                                                    
<style-sheet>                                                                                       
<style-specification use="html">                                                                    
<style-specification-body>                                                                          
                                                                                                    
; Includes a summary at the beginning of an item.                                                   
(define %generate-article-toc% #t)                                                                  
                                                                                                    
</style-specification-body>                                                                         
</style-specification>                                                                              
<style-specification use="print">                                                                   
<style-specification-body>                                                                          
                                                                                                    
; Includes a summary at the beginning of an item.                                                   
(define %generate-article-toc% #t)                                                                  
                                                                                                    
</style-specification-body>                                                                         
</style-specification>                                                                              
<external-specification id="html" document="html-docbook">                                          
<external-specification id="print" document="print-docbook">                                        
</style-sheet>                                                                                      
                                                                                                    
                                                                                                    


4.10.3. Iɑ}

DocBook ɂ͍t邽߂̃}[NAbv܂A͎
Iɂ͐܂BAcollateindex.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 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ݒ肷
<!doctype article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [            
                                                                       
<!-- Insertion of the index -->                                        
<!entity index SYSTEM "index.sgml">                                    
]>                                                                     
                                                                       

ɕ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
<!entity % review "INCLUDE">                                           
...                                                                    
<![%review;[                                                           
<para>̒íALGeBeB "review" ̒l "INCLUDE"         
`ꂽƂɁÄꕔƂȂ܂B</para>                      
]]>                                                                    
                                                                       

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 ̗

<article class="whitepaper" id="using -docbook" lang="pt-br"><?dbhtml filename="using-docbook.html"> 
                                                                                                     
  <artheader>                                                                                        
    <title>Como-Fazer DocBook</title>                                                                
    <author>                                                                                         
      <firstname>Jorge</firstname>                                                                   
      <othername>Luiz</othername>                                                                    
      <surname>Godoy</surname>                                                                       
      <othername>Filho</othername>                                                                   
      <affiliation>                                                                                  
        <orgname><ulink url="http://www.conectiva.com">Conectiva S.A.</ulink></orgname>              
        <orgdiv>Publishing Departmentt;/orgdiv>                                                      
        <address><email>godoy@conectiva.com</email></address>                                        
      </affiliation>                                                                                 
    </author>                                                                                        
    <revhistory>                                                                                     
      <revision>                                                                                     
        <revnumber>1.0</revnumber>                                                                   
        <date>27 de janeiro de 2000</date>                                                           
        <authorinitials>godoy</authorinitials>                                                       
        <revremark>Verso inicial.</revremark>                                                       
      </revision>                                                                                    
    </revhistory>                                                                                    
                                                                                                     
    <legalnotice>                                                                                    
      <para>This document can be freely translated and distributed. It's released                    
      under the LDP License.</para>                                                                  
    </legalnotice>                                                                                   
                                                                                                     
    <keywordset>                                                                                     
      <keyword>SGML</keyword>                                                                        
      <keyword>DocBook</keyword>                                                                     
      <keyword>DTD</keyword>                                                                         
      <keyword>XML</keyword>                                                                         
      <keyword>catalogs</keyword>                                                                    
      <keyword>documents</keyword>                                                                   
      <keyword>Publishingdlt;/keyword>                                                               
      <keyword>Conectiva</keyword>                                                                   
      <keyword>configuration</keyword>                                                               
      <keyword>use</keyword>                                                                         
      <keyword>tools</keyword>                                                                       
      <keyword>HOWTO</keyword>                                                                       
    </keywordset>                                                                                    
                                                                                                     
  </artheader>                                                                                       
                                                                                                     
                                                                                                     


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)" x 
     Xgł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 炢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.
   
 E Elements of Style
   
 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
<!doctype article public "-//OASIS//DTD DocBook V4.1//EN">             


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
<figure>                                                                     
   <title>LyX screen shot</title>                                            
   <mediaobject>                                                             
      <imageobject>                                                          
         <imagedata fileref="lyx_screenshot.eps" format="eps">               
      </imageobject>                                                         
      <imageobject>                                                          
         <imagedata fileref="lyx_screenshot.jpg" format="jpg">               
      </imageobject>                                                         
      <textobject>                                                           
         <phrase>Screen shot of the LyX document processing program</phrase> 
      </textobject>                                                          
   </mediaobject>                                                            
</figure>                                                                    

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
<article id="index">                                                   

ŏ <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
<chapter id="tips">                                                    


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

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ 
<!ENTITY % html "IGNORE">                                                  
<![%html;[                                                                 
<!ENTITY % print "IGNORE">                                                 
<!ENTITY docbook.dsl SYSTEM "docbook.dsl(1) " CDATA dsssl>                 
]]>                                                                        
<!ENTITY % print "INCLUDE">                                                
<![%print;[                                                                
<!ENTITY docbook.dsl SYSTEM "docbook.dsl(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) AIvV
A  B Ȃ Open Publication License (OPL) gƂE߂܂B
DocBook pɃ}[NAbvꂽ GNU GPL  GNU FDL  GNOME
Documentation Project ɂ̂ŁAgƂł܂B̏ꍇA
CZXS𕶏ɓ邾łBAS͒̂ŁACZ
Xւ̃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" BA
X̒҂ɑ΂KChCłȂƂɒӂĂ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
        terminology, Explaining the terminology system
       
       
    modifying, Creating and modifying catalogues
        sample, Creating and modifying catalogues
        terminology, Explaining the terminology system
       
       
   
   
catalogues
    creating, Creating and modifying catalogues
       
       
   
   
configurations, Configuration needed
    variables
        SGML_CATALOG_FILES, Configuration needed
       
       
   
   
conventions, Documents



D

documents
    re-use, Re-using parts of documents
       
       
   
   



E

edition
    examples, Document samples
        article, Article example
        book, Book Example
       
       
    index, Encoding Indexes
       
       
    using DocBook, Writing with DocBook elements
        commands, Useful commands
       
       
   
   
entities
    parameters
        exemple, Making notes on the text while it's being written
        usage, Making notes on the text while it's being written
       
       
   
   



F

figures
    inserting
        figure, Inserting Pictures
        mediaobject, Alternative Methods
       
       
   
   



G

graphics
    inserting
        graphic, Inserting Pictures
        mediaobject, Alternative Methods
       
       
   
   



L

listings
    inserting, Listings and program codes
        example, Listings and program codes
       
       
   
   



N

nedit, nedit



T

tables
    inserting, Tables
        example, Tables
       
       
   
   
tools
    articles
        summary, Inserting a summary on the initial articles page
       
       
    compiling sources
        compile-sgml, Compiling the sources
       
       
    compiling the sources, Compiling the sources
       
       
    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ŏ <book> ^O𖳏C
    ŒuA̒ł̍ŏ <chapter>  <chapter id="aboutthisguide">
    ƂĂ܂BgbvxEGg( LDP ł́ArIZ 
     <article> A߂̕ɂ <book> g邱Ƃ悤ł
    B) ɉēKXǂݑւĂB)                              
