








			   SGML-Tools ϥλĶ

		  @: Matt Welsh. Updated by Greg Hankins.

		    Ķ: C.W.Huang cwhuang@phys.ntu.edu.tw

	    v0.99.0, 29 November 1996.	½Ķ: 4-15 August 1997



				   Abstract

     oO SGML-Tools ϥλA@إH SGML
     ¦AAͤPX榡uD AiHγ@ SGML
     l󲣥ͯ¤r (ASCII P ISO-8859-1), DVI, PostScript, HTML,
     GNU info, LyX, P RTF ɡD o󻡩H SGML-Tools 0.99.0. ǡD



1.  ²

oO@ SGML-Tools BztΪϥλDSGML-Tools Ѥ@ SGML DTD
(κAwqADocument Type Definition) Τ@աum(replacement
files)vAiHN SGML ഫ groff, LaTeX, HTML, GNU info, LyX, P RTF
lɡD

SGML-Tools DnH Tom Gordon1   QWERTZ DTD ¦oiD

1.1  󦹤

oHb SGML-Tools W linuxdoc DTD ҼgD XG]tҦϥγo
DTD Ӽg SGML һݪDƱD аѦ example.sgml o SGML
dҡAAiH@Aۤv󪺽dD

1.2   SGML?

ڿܨϥ SGML O] SGML OMΨഫ䥦榡D SGML O Standard Gen
eralized Markup Language
²١A\Aw󪺵c---]NOAΦبƪӼХܤD AϥΤ@ DTD
(κAwq) ӫw󪺵cDlinuxdoc O@ثw Linux HOWTOs P䥦
DTDD QWERTZ Ot@ DTD; SGML зǴѮѡA峹AΨl@ҨϥΪ
DTDD

DTD
w󤤡uզvW١DզNO@صc---ҦpA`AqAάOpOo˪
jդrDMӸ LaTeX POAoǲզëD SGML tDlinuxdoc DTD
NwqF LaTeX զ---AA`AάOuҡvDMӡAQ SGML
AiHӧAwwq󪺥󵲺cDNY譱ӻASGML NOC TeXA lin
uxdoc DTD hO LaTeXD

____________________

1. <URL:mailto:thomas.gordon@gmd.de>

SGML-Tools ϥλĶ						      1





SGML-Tools ϥλĶ						      2



OQodVFDSGML äO@ؤ榡ƨtΡDSҿתuSGML 榡vD SGML
lɥuOΨഫ䥦榡HKBzD٦ASGML OΨӫw󪺵cD
S SGML r榡ƤuάOuvDҦ@wq DTD D
S DTD Aϥ SGMLA@ DTD wqF SGML ӰD

1.3  pB@

o̸pϥ SGML-Tools BzDAAݭn@ DTDDڥΪO QWERTZ
DTDA ӬO@sH]ݭn LaTeX  DTD ӰDڱN QWERTZ DTD ק令
linuxdoc DTD HŦXڭ̪ݨDDDTD
L]wF󪺵cDݰ_ӹOoӼˤl:

     <!element article - -
	 (titlepag, header?,
	  toc?, lof?, lot?, p*, sect*,
	  (appendix, sect+)?, biblio?) +(footnote)>

o]wFuvӵcANO LaTeX udocumentstylevD
o]tF@ӮѭW(titlepag)A@ӥiiLD(header)A@ӥiΪeC(toc)AiΪϧΦC(lof)PC(lot)ANƶqq(p)ANƶq`(sect)AiΪ(appendix)A@ӥiΪѦҮѥ(bib
lio)Hε(footnote)D

AiݥXADTD åpQ榡ơAΥݰ_ӪoˡD
uLwqFѦسҲզDb󪺥t@ӦawqF titlepag, header,
sect ΨlզD

gɧAäݭnD DTD
kWhDڥuLAݤ@Uoˤl٦FD Aݼxo
DTD ҩwq󵲺cD_hAbռgɧAi|HϵcA
ӥBQ~TdFDUڭ̷|yz SGML 󵲺cӸ`D

UӴNOγo DTD ҩwqcӼgFDA@Alinuxdoc DTD
ϱoݰ_Ӫo LaTeX---ҥHܮeqD SGML
NyӻAϥάY@ӯSO DTD Ӽg@s DTD
uר(instance)vD

FN SGML lഫ䥦榡(Ҧp LaTex  groff)HKBzAAҼg SGML
lɥg SGML ѪRBzLDڥΪO James Clark(jjc@jclark.com2 ) Ҽg
sgmls ѪR, L]O groff @̡Dΰ_ӫܤKDsgmls
ŪJAAˬd` DTD ҩwqcD
PɱNA󤤪uvMi}AHKU@q sgmlsasp ӳBzD

sgmlsasp ΨӱN sgmls XGഫt@خ榡(p LaTeX)D ϥθmɱNl
SGML 󤤪զഫuؼСv榡(p LaTeX  groff)lɡD

ҦpA@ LaTeX mɪooˡG

     <itemize>	  +    "\\begin}itemize}   +
     </itemize>   +    "\\end}itemize}	  +


FAb SGML lɤϥ itemize ɡAӳQm LaTeX lɤ

____________________

2. <URL:mailto:jjc@jclark.com>







SGML-Tools ϥλĶ						      3



     \begin}itemize}


(ڻLFADTD F̦b LaTeX D)

]AnN SGML ഫ䥦榡AAҭnNO榡g@ӷsmɡA
bs榡C@ SGML զwADƹWASo²---ҦpA
pGAഫMA DTD PcAAN·СDLA
_nC@خ榡gWѪRPഫ{٬On²檺hD SGML
Ѥ@ؤ@몺tαN@حlഫ\h榡D

@ sgmlsasp ഫAANP SGML l۹ LaTeX lɡA
AiH@몺 LaTeX ɤ@˨ӨϥΥDUڷ|ܽdp󰵳o˪ഫP榡ơD
AunΤ@ONFD

LAڭnpwˤγ]w SGML-ToolsD


2.  w

qoӦa

    ftp://sunsite.unc.edu/pub/Linux/utils/text/sgml-tools-0.99.0.tar.gz

o sgml-tools-0.99.9.tar.gzD

AiHq SGML-Tools WWW Page3  o̷sTD

sgml-tools-0.99.0.tar.gz ]tFҦAݭnΨӼg SGML ഫ groff, LaTeX,
HTML, GNU info, LyX, P RTF FD~AAiٻݭnUCu---SGML
tΨäݭnoǡAګĳAooǤuHKAഫAbA}GAeNTw̬ݰ_ӨSDD

  1.  groff.  Aϥ 1.08 ΧsDAiHq
      ftp://prep.ai.mit.edu/pub/gnu oDb ftp://sun
      site.unc.edu/pub/Linux/utils/text i Linux ɡDAݨϥ groff
      A SGML 󲣥ͯ¤rɡD nroff !

  2.  TeX P LaTeX. oXGbCӦa賣AAӥiH@Lxaæw (b
      sunsite.unc.edu iH Linux ) MApGAn LaTeX
      Ӯ榡ƧA SGML A~ݭn TeX/LaTeXD

  3.  flex.  lex iणDAiHq ftp://prep.ai.mit.edu/pub/gnu oD

  4.  gawk P GNU info tools, ΨӮ榡ƻPw info ɮסD b
      ftp://prep.ai.mit.edu/pub/gnu,  ftp://sun
      site.unc.edu/pub/Linux/utils/text iH gawkA ٦ ftp://sun
      site.unc.edu/pub/Linux/system/Manual-pagers i GNU info tools.  awk
      D

  5.  LyX (@ӥbҨYұo(quasi-WYSIWYG)  LaTeX ɭ)Aib
      ftp://ftp.via.ecp.fr D

____________________

3. <URL:http://www.xs4all.nl/~cg/sgmltools/>







SGML-Tools ϥλĶ						      4



2.1  w˳n

w˻P]w SGML-Tools һݪBJOG

  1.  AbYBѶ} sgml-tools-0.99.0.tar.gz YɡD N sgml-
      tools-0.99.0 ؿDb̸Ѷ}SYAuOṋFh sgml-
      tools-0.99.0 ؿND

  2.  \Ū INSTALL ɡA]tFw˹L{Ӹ`D

pG@QAANiHϥΥFD

Ķ: NO install o shell scriptA^DNF!

2.2  s SGML 

ҦpAQnsƤ@ SGML s
foo.sgmlAo̦@²upXP榡D㪺ﶵCаѦ man
pagesD

2.2.1  ͯ¤rX

pGAQͯ¤rɡAϥγoӫOG

     % sgml2txt foo.sgml

Ъ`Nڤwվ groff ഫ¤rXD]NOAڱNAXAصhD
gL@ǭקAiHq groff X PostScript P DVI 榡AګĳA
LaTeX nD

AiH man pages  groff lɡAӥ groff -man NsơD
oӫOG

     % sgml2txt -man foo.sgml

2.2.2   LaTeX, DVI  PostScript X

nq SGML lɲ LaTeX ANΡG

     % sgml2latex foo.sgml

pGAƱ沣 PostScript X(g dvips)Ai -p ﶵG

     % sgml2latex -p foo.sgml

Ϊ̧AiH[W -d ﶵ DVI ɡG

     % sgml2latex -d foo.sgml

2.2.3   HTML X

pGAƱX HTML ɡAγoOG

     % sgml2html -img foo.sgml








SGML-Tools ϥλĶ						      5



oN foo.html, foo-1.html, foo-2.html,  --- C@@ɮסDfoo.html
OAiHΧA WWW s[ݡD TwAҦ HTML
ɦbP@ؿUA]̬Oά۹諸 URL ѦҪD HTML ɪϥܥؿV
$SGMLTOOLSLIB/icons ҩwqؿD oɳQ̫᪺mWD$SGMLTOOL
SLIB/ wqb SGML ഫ{Ǫ̶}YD

pGAϥ sgml2html ӨS[W -img ﶵܡAͪ HTML |[WŪΪ
"Previous", "Next", H "Table of Contents" ҡD AiHǥѦb $SGMLTOOL
SLIB/rep/html/<filename> إߤ@ɮץH\Loǹw]A
åBHAۤvܨӨN̡Dɮת榡pUҥܡG he following format:

	  PrevPage:  newvalue
	 NextPage:  newvalue
	  TOC:	   newvalue


dҽаѾ\ deutschD

2.2.4   GNU Info 榡X

pGAQnNAɮ׽sƦ GNU Info s{榡AunϥΤUCOG

     % sgml2info foo.sgml

2.2.5   LyX 榡X

 LyX 榡XAϥγoӫOG

     % sgml2lyx foo.sgml

2.2.6   RTF 榡X

pGAQ RTF 榡XAoӫOG

     % sgml2rtf foo.sgml

oN| foo.rtf, H foo-1.rtf, foo-2.rtf,
ɮ---󪺨C@`ۦ@ɮסD

2.2.7  ˬd SGML yk

pGAuOQq SGML ഫXA~AiHϥ sgmlcheck oӫOZD ҦpG

     % sgmlcheck foo.sgml

2.3  ISO 8859-1 r

ISO 8859-1 (latin1) riHΦb¤r LaTeX, HTML, LyX, H RTF
Xڦr(GNU Info ӥi䴩 ISO 8859-1)D nϥγo\઺ܡAiH[W
-l ﶵsƫOZAҦpG

     % sgml2txt -l foo.sgml










SGML-Tools ϥλĶ						      6



A]iHb SGML l󤤨ϥ ISO 8859-1
rA̷|۰ʳQഫ榡AhXr(escape codes)D


3.  ϥ SGML-Tools g

ϥ SGML-Tools DTD g󪺹L{jOD`eAӥBI LaTeXD
MӡAMǭn`NDo@`ڱN SGML 󪺼gD SGML
d(μg@)аѾ\ example.sgml ɮסAAiHӷ@ۤv󪺽dD
bڱNQ SGML U\AOHl@dҤOܦiŪʡD ]ALX
example.sgml lX(sƫ᪺X)ApANuꪺѦҽdҡC

3.1  򥻷

JӬݽdҤ󪺭lAA|`Ṋ\hHA(< 
>)Хܪu(tags)vD
ҳ¦aXYզ_lAo̩ҿתզO@`A@qA@y骺yAC@ӶءAHνѦpcD
ϥμҴNϥ LaTeX Op \item άO \section{...} @D

|²檺ҤlAnͳo@q rAڦblXJ

     |²檺ҤlAnͳo@q <bf>r</bf>, ...


<bf> Ooqr}YA </bf> OD A]iHϥγo²ΦG

     |²檺ҤlAnͳo@q <bf/r/, ...


NOα׽uNr]D(MApGQ]trtuAANϥΪΦA
Ҧp Unix ɮצW١D)

Sr٦䥦on`ND
(oNOpGAJ[lN|`NoǬݰ_ӫܩǲ "&"
ܦFڱN²uaoǲŸ)D

bYǱpUASwզҬOiΪD ҦpAAbY@`}lϥ
<sect> oӼҡAMӡAӸ`
(iHX{bӸ`D饻aAӤuOӸ`W٫᭱!)
OiΪӷAbP@Ӽh}lt~@`ɭԤ]Ntܵ۸Ӹ`D
@ӻAݭn߳oǲӸ`FunۨϥΦb example.sgml
޸̪dҴNiHFC

3.2  Sr

ܩ㪺AḀNO SGML
l̪SrDt~٦䥦Ӫ`NrD
ҦpA]AQJѨAҲ[\ܦAo: <foo>D
Fܥ䪺AAAϥ &lt; oӲզA
oO@ӷ|i}AruvD]AڦblJ

     angle brackets around it, as so: <tt>&lt;foo></tt>.










SGML-Tools ϥλĶ						      7



@ӻAHXr(&)@}lܳoO@ӯSD ҦpA % Ÿ
&percnt;  |  &verbar; D
ҦuSrvXiHܥ̡D

q`AAݭnϥεXܬYSrAMӡAbYǱpUoOC̱`ΪOG

    Use &amp; for the ampersand (&),

    Use &lt; for a left bracket (<),

    Use &gt; for a right bracket (>),

    Use &lt;/ for a left bracket with a slash (</)

    Use &dollar; for a dollar sign ($),

    Use &num; for a hash (#),

    Use &percnt; for a percent (%),

    Use &tilde; for a tilde (~),

    Use `` and '' for quotes, or use &ldquo; for ", &rdquo; for ".

㪺SrCiHdݨ䤤@ӴɡD q` LaTeX
̷|SrAҥHd\ $SGMLTOOLSLIB/rep/latex/general |OӦn}lD
$SGMLTOOLSLIB wqb SGML ഫ{Ǫ̫eD

3.3  Verbatim P Code 

ڭ̥QׯSroӥDDɡAڤ]uverbatim ҡvA
ΨӦbXtJ[ܰʪr(ťզrHYơAMѦp)D verb
oӲզNOγ~Dݰ_ӴNoˡG

     <verb>
      Some literal text to include as example output.
     </verb>


verb Ҥ\Ab䤺eϥΥFD SOaAb verb ҤAG

    ϥ &amp; N &

    ϥ &lt;/ N </

    nb verb Ҥϥ \end{verbatim}A ]oO LaTeX Ψӵ verbatim
     ҪD (ӥi৹éhrsơAثeѪR٤䴩D)

code ҫD` verb ҡAFbrP[Jju

     oO code ҪҤlD

AӦb verb ҪPϥ tscreen ҡAoˡG









SGML-Tools ϥλĶ						      8



     <tscreen><verb>
     oO@qҥyD
     </verb></tscreen>


tscreen O@ҳ¦aYƨó]ww]r ttD oϱodҭnצb LaTeX
Hί¤rݰ_ӦnhFD AiHϥ tscreen Ӥ[
verbALApGAbdҤϥΥ󪺯SrANݭn̨ӡD tscreen
PSrLDdҽаѾ\ example.sgmlD

quote  tscreenAFNw]r] ttDҥHAAiHϥ quote
PqLޥΡApG

     <quote>
     Here is some text to be indented, as in a quote.
     </quote>


o|͡G

     Here is some text to be indented, as in a quote.

3.4  󤺮e[

bڭ̲`JsӸ`eAڭn}l linuxdoc DTD
wq[Dp]ߪdҽХJ[ example.sgmlD

3.4.1  Ǥ

b󪺡uǤvA]߹ODHΤ󫬺A(style)FDLinux HOWTO
ݰ_ӹG

     <!doctype linuxdoc system>

     <article>

     <title>Linux Foo HOWTO
     <author>, <tt/cwhuang@phys.ntu.edu.tw/
     <date>v1.0, 14 August 1997
     <abstract>
     o󻡩Fpϥ <tt/foo/ oӤuD
     </abstract>

     <toc>

oǲզإiHuWǡDĤ@iD SGML ѪR{ϥ linuxdoc
DTDD <article> oӼҳWwϥΡuarticlevؤ󫬺AD ( QWERTZ
DTD ٩wq ureportvHΡubookvAFڨèSק復̥Hb SGML-Tools
ϥ)D

title, author, H date oǼҪNqӬOܩ㪺A b date
Ҥ]t󪺪sHγ̫קɶD

abstract ҳ]w󳻺ݦbeeLXrD pGAQtJeC(toc








SGML-Tools ϥλĶ						      9



)AAiणݭn abstractD

3.4.2  `Pq

bǤ大AANiHǳƶiJ󥻨DUC`OiHϥΡG

    sect: ̳h` (]NO 1, 2, )

    sect1: ĤGh` (]NO  1.1, 1.2, )

    sect2: ĤThp`

    sect3: ĥ|hpp`

    sect4: Ĥhppp`

̬۷ LaTeX  section, subsection D

b sect  ( sect, sect ) Ҥ۬OӸ`W١D
ҦpAb󪺳ݡAǤ大᪺OҡG

     <sect>²


Ӧb`}la(q)AӼҬOG

     <sect2>q


b@`ҤAA}l󪺥DDMӡAAH@ <p> Ҷ}lAoˡG

     <sect>²
     <p>
     oO@ SGML-Tools BzϥΪ̫....


oOiDѪR{Aw@`DåBǳƦn}lDD
AsqOHťզ}l(NpP TeX)DҦpA

     oOĤ@qD

     ӧڭ̱qo̶}ls@qD


SzѭnbCӬqeϥ <p>
ҡFunb`O᭱Ĥ@Ӭq}lB[ND

3.4.3  󵲧

b󵲧aAAϥγoӼҡG

     </article>

HiDѪR{Awg article oӲզ([\)D








SGML-Tools ϥλĶ						     10



3.5  椬Ѧ

{bڭ̭niJtΪ䥦\D椬ѦҫܮeDҦpApGAQns@Y@`椬ѦҡAAoo˼ХܸӸ`:

     <sect1>²<label id="sec-intro">


ۧANiHb󤤪YӦa覡γoӪܦѷӸӸ`G

     аѦ<ref id="sec-intro" name="²">@`СD


oN|H sec-intro аO`o ref ҡD  groff H HTML ഫ
name oӰѼƬOD SGML-Tools ϥΪ groff
]wثeå䴩椬ѦҡAӥB``HW٨NƦrѷӬY@`D

ҦpA`O椬Ѧ (section 3.5, page 10)D

byTWϥΪqθ귽w쾹AY URL ]զ urlD
oӤӥΨӰѷӨ䥦AFTP Wɮ׵DҦpG

     Aiqo Linux HOWTO 
     <url url="http://sunsite.unc.edu/mdw/HOWTO/"
	name="The Linux HOWTO INDEX">D


url oӰѼƫwo URL Ds|۰ʥ[J HTML 󤤡D iΪ name
Ѽƫwӥ[Wsr(HTML ഫ)άO URL yzRW(LaTeX 
groff)DpGS name ѼơA|ϥγo URL D

ҦpAAiHqǫo SGML-Tools M

ftp://sunsite.unc.edu/pub/Linux/utils/text/sgml-tools-0.99.0.tar.gz.

@ӦΪܧάO htmlurlAF HTML b䥦Cؤ󤤳o URL
N|X{D ΦbOӤHqll}FAiHg

     <htmlurl url="mailto:esr@snark.thyrsus.com"
	   name="esr@snark.thyrsus.com">


Ӧb¤rXouesr@snark.thyrsus.comv ӤOƪuesr@snark.thyr
sus.com <mailto:esr@snark.thyrsus.com>v Ob HTML 󤤤MOA URL
D

3.6  r

򥻤WASGML-Tools 䴩P LaTeX ۦPrD `NALצpA¤rഫ(g
groff)z|rTD ҥHAAiHɥi઺ϥΦhئrAo LaTeX
ഫ|nBD Ob¤rnΦrIXID

SOOAeyzL tt oӼҥiHΨPeשTwurvrA
oӥΦbҦqll}AW١AɮצWٵD ҦpG









SGML-Tools ϥλĶ						     11



     Here is some <tt>typewriter text</tt> to be included in the document.


۷G

     Here is some <tt/typewriter text/ to be included in the document.


OopGQ]trt׽uAiHϥ²ΦD

䥦r r Ϊ bf H r Ϊ emD
t~٤䴩ƺئrAOڤĳAϥΥ̡A]̷|Qഫ HTML
䴩rD ArAHαӯມAݭnD

3.7  C

tΤ䴩ƺؤPCD̬OG

    itemize o˪iܦC

    enum ƦrC

    descrip yzC

b itemize άO enum ̪إH item ҥ[HХܡD b descrip
̪إH tag ХܡD ҦpA

     <itemize>
     <item>oO@ӶءD
     <item>oOĤGӶءD
     </itemize>


ݰ_ӹOoˡG

    oO@ӶءD

    oOĤGӶءD

b enum 

     <enum>
     <item>oOĤ@ӶءD
     <item>oOĤGӶءD
     </enum>


AݱoXӡACiHO_DӸ`аѾ\dҤD

descrip CyPAӥBIݡAObYǱpUAi|QϥΥG

     <descrip>
     <tag/Gnats./ Annoying little bugs that fly into your cooling fan.
     <tag/Gnus./ Annoying little bugs that run on your CPU.








SGML-Tools ϥλĶ						     12



     </descrip>


̫ݰ_ӹG

      Gnats.
	    Annoying little bugs that fly into your cooling fan.

      Gnus.
	    Annoying little bugs that run on your CPU.

3.8  i@BT

  1.  QWERTZ ϥΪ̫ޥiHqǫo ftp://ftp.cs.cornell.edu/pub/mdw/SGML.
      QWERTZ (H SGML-Tools) ٤䴩OƾǤAAϧε\hSʡD
      pGAQ SGML g@몺AګĳAέӪ QWERTZ DTD
      ӤnέקL linuxdoc DTDA ]oOگSOΨӼg Linux HOWTOs
      Ψ䥦ΪD

  2.  Tom Gordon  QWERTZ tools ibG ftp://ftp.gmd.de/GMD/sgml.

  3.  h SGML TiHbUoǺG

	  SGML and the Web4

	  SGML Web Page5

	  Yahoo's SGML Page6


  4.  James Clark  sgmls ѪRAΫӪ nsgmls ٦䥦uiboG
      ftp://ftp.jclark.com H James Clark's WWW Page7 .

  5.  emacs psgml ibG
      ftp://ftp.lysator.liu.se/pub/sgmlDoӤu㴣ѳ\h SGML \D

  6.  AiHHqll majordomo@via.ecp.fr HѻP SGML-Tools mailing
      listAeg subscribe sgml-toolsD Mailing list a}O sgml-
      tools@via.ecp.frD

  7.   LyX hTiHbG LyX WWW Page8 .  LyX O@ӵ LaTeX
      ΪrBzeݡD bҨYұoɭA|۰ʲͳ\h LaTeX
      ˦ή槽D iHW LaTeX ǲߦӥBϽ槽²BD

____________________

4. <URL:http://www.w3.org/hypertext/WWW/MarkUp/SGML/>

5. <URL:http://www.sil.org/sgml/sgml.html>

6. <URL:http://www.yahoo.com/Computers_and_Internet/Information_and_Documentation/Data_Formats/SGML/>

7. <URL:http://www.jclark.com>

8. <URL:http://wsiserv.informatik.uni-tuebingen.de/~ettrich/>







SGML-Tools ϥλĶ						     13





































































				   CONTENTS



1. ² ..................................................................... 1
   1.1 󦹤 ........................................................... 1
   1.2  SGML? ......................................................... 1
   1.3 pB@ ........................................................... 2

2. w ..................................................................... 3
   2.1 w˳n ............................................................. 4
   2.2 s SGML  ....................................................... 4
   2.3 ISO 8859-1 r .................................................... 5

3. ϥ SGML-Tools g ................................................. 6
   3.1 򥻷 ............................................................. 6
   3.2 Sr ............................................................. 6
   3.3 Verbatim P Code  ................................................ 7
   3.4 󤺮e[ ......................................................... 8
   3.5 椬Ѧ ............................................................ 10
   3.6 r ................................................................ 10
   3.7 C ................................................................ 11
   3.8 i@BT ...................................................... 12

































				       i


