








			   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

     ļ SGML-Tools ʹ˵һ SGML
     ΪͬʽĹߣ õһ SGML
     ԭʼļֵ (ASCII  ISO-8859-1), DVI, PostScript, HTML,
     GNU info, LyX,  RTF  ļ˵ SGML-Tools 0.99.0. Ϊ׼



1.  

һ SGML-Tools ļϵͳʹ˵SGML-Tools ṩһ SGML DTD
(ļ̬壬Document Type Definition) һ顸û(replacement
files)Խ SGML תΪ groff, LaTeX, HTML, GNU info, LyX,  RTF
ԭʼ

SGML-Tools Ҫ Tom Gordon1   QWERTZ DTD Ϊչģ

1.1  춴ļ

ļԸ SGML-Tools ϵ linuxdoc DTD ׫дģ ʹ
DTD д SGML ļ֪飮 ο example.sgml  SGML
Լļġ

1.2  Ϊ SGML?

ѡʹ SGML Ϊ SGML רתʽģ SGML  Standard Gen
eralized Markup Language
ļƣָļĽṹ---Ҳǣúʾļ ʹһ DTD
(ļ̬) ָļĽṹlinuxdoc һָ Linux HOWTOs ļ
DTD QWERTZ һ DTD; SGML ı׼ṩ飬£һļʹõ
DTD

DTD
ָļСԪءƣԪؾһֽṹ---£ڣ䣬ǸС
ǿ֣Ȼ LaTeX ͬǣЩԪز SGML ںģlinuxdoc DTD
Ͷ LaTeX еԪ---£ڣǡȵȣȻ SGML
ϲļκνṹĳ˵SGML ǵͽ׵ TeX lin
uxdoc DTD  LaTeX

____________________

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

SGML-Tools ʹ˵						      1





SGML-Tools ʹ˵						      2



ȸˣSGML һļʽϵͳûνġSGML ʽ SGML
ԭʼֻתʽԱ㴦ģУSGML ָļĽṹ
û SGML ָʽ߻ǡ޼֮ģеһж DTD У
û DTD 㲻ʹ SGMLһ DTD  SGML ʲᣮ

1.3  

ʹ SGML-Tools ļȣҪһ DTDõ QWERTZ
DTD һȺΪҪ LaTeX  DTD ģҽ QWERTZ DTD ޸ĳ
linuxdoc DTD ԷǵDTD
趨ļĽṹӵ:

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

ⲿ趨ˡļṹ LaTeX ġdocumentstyle
ļһҳ(titlepag)һп޵ı(header)һѡõб(toc)ѡõͼб(lof)б(lot)Ķ(p)½(sect)ѡõĸ¼(appendix)һѡõĲοĿ(bib
lio)Լע(footnote)

ɿDTD δ˵ļӦαʽ
ֻļɺֲɣļһط titlepag, header,
sect ŵԪأ

дļʱ㲢Ҫ֪κι DTD
ķֻ㿴һʲӻʲᣮ Ϥ
DTD ļṹڳдļʱܻΥṹ
ұѶϢˣǻ SGML ļṹϸڣ

 DTD Ľṹдļˣ˵һΣlinuxdoc DTD
ʹļ LaTeX---Ժӣ SGML
˵ʹĳһر DTD ׫дĵһļǷ DTD
ġ(instance)

Ϊ˽ SGML ԭʼתʽ( LaTex  groff)Ա㴦д SGML
ԭʼ뾭 SGML õ James Clark(jjc@jclark.com2 ) д
sgmls , Ҳ groff ߣܷ㣮sgmls
ļѭ DTD Ľṹ
ͬʱļеġ޼ԪչԷһ׶ε sgmlsasp 

sgmlsasp  sgmls תһָʽ( LaTeX) ʹûԭʼ
SGML ļеԪתɡĿ꡹ʽ( LaTeX  groff)Ӧԭʼ

磬һ LaTeX û

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


˵˵ SGML ԭʼʹ itemize ԪʱӦñû LaTeX ԭʼе

____________________

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







SGML-Tools ʹ˵						      3



     \begin}itemize}


(˵ˣDTD еԪ LaTeX еĶӦ)

ˣҪ SGML תʽҪľΪ˸ʽдһµû
¸ʽΪÿһ SGML ԪָʵĶӦʵϣû---磬
㳢תɺ DTD ȫͬĽṹ鷳
ҪΪÿһָʽдĽתʽҪ򵥵Ķ࣮ SGML
ṩһһϵͳһԭʼתʽ

һ sgmlsasp תɣԭ SGML ԭʼļӦ LaTeX ԭʼ
һ LaTeX һʹһʾתʽ
ֻҪһָ͹ˣ

ȣҪ˵ΰװ趨 SGML-Tools


2.  װ

ȴط

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

ȡ sgml-tools-0.99.9.tar.gz

Դ SGML-Tools WWW Page3  ȡµѶ

sgml-tools-0.99.0.tar.gz Ҫд SGML ļתΪ groff, LaTeX,
HTML, GNU info, LyX,  RTF Ķ֮⣬ܻҪеĹ---SGML
ϵͳҪЩҽȡЩԷתļ㹫ɢļǰȷǿû⣮

  1.  groff.  ʹ 1.08 µİ汾Դ
      ftp://prep.ai.mit.edu/pub/gnu ȡã ftp://sun
      site.unc.edu/pub/Linux/utils/text ҵ Linux ִеʹ groff
       SGML ļֵ nroff !

  2.  TeX  LaTeX. ⼸ÿطУӦÿԺѵҵװ (
      sunsite.unc.edu ҵ Linux ִе) ȻҪ LaTeX
      ʽ SGML ļҪ TeX/LaTeX

  3.  flex.  lex ܲУԴ ftp://prep.ai.mit.edu/pub/gnu ȡã

  4.  gawk  GNU info tools, ʽԤ info  
      ftp://prep.ai.mit.edu/pub/gnu,  ftp://sun
      site.unc.edu/pub/Linux/utils/text ҵ gawk  ftp://sun
      site.unc.edu/pub/Linux/system/Manual-pagers ҵ GNU info tools.  awk
      У

  5.  LyX (һ(quasi-WYSIWYG)  LaTeX )
      ftp://ftp.via.ecp.fr ҵ

____________________

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







SGML-Tools ʹ˵						      4



2.1  װ

װ趨 SGML-Tools Ĳǣ

  1.  ȣĳ⿪ sgml-tools-0.99.0.tar.gz ѹ  sgml-
      tools-0.99.0 Ŀ¼⿪ûйϵֻǲҪĶ sgml-
      tools-0.99.0 Ŀ¼У

  2.  Ķ INSTALL ˰װ̵ϸڣ

һ˳Ϳʹˣ

ע: ʵִ install ֧ shell scriptش!

2.2   SGML ļ

˵Ҫһ SGML ļ
foo.sgmlһݼ̵˵ɲͬĸʽѡбο man
pages

2.2.1  

ֵʹָ

     % sgml2txt foo.sgml

עѵ groff תΪҲ˵ҽҳףҳ룬߿ȥ
һЩ޸Դ groff  PostScript  DVI ʽҽ
LaTeX ȽϺã

Ϊ man pages  groff ԭʼ groff -man ţ
ִָ

     % sgml2txt -man foo.sgml

2.2.2   LaTeX, DVI  PostScript 

Ҫ SGML ԭʼ LaTeX ļã

     % sgml2latex foo.sgml

ϣ PostScript ( dvips) -p ѡ

     % sgml2latex -p foo.sgml

Լ -d ѡ DVI 

     % sgml2latex -d foo.sgml

2.2.3   HTML 

ϣ HTML ָ

     % sgml2html -img foo.sgml








SGML-Tools ʹ˵						      5



⽫ foo.html, foo-1.html, foo-2.html, ȵ --- ÿһһfoo.html
ҳ WWW 䯡ۿ ȷе HTML
ͬһĿ¼£ΪԵ URL ˴˲οģ HTML ͼʾĿ¼ָ
$SGMLTOOLSLIB/icons Ŀ¼ ЩӦλϣ$SGMLTOOL
SLIB/  SGML תͷ

ʹ sgml2html ûм -img ѡĻ HTML ļϵõ
"Previous", "Next", Լ "Table of Contents" ǩ Խ $SGMLTOOL
SLIB/rep/html/<filename> һԸǹЩԤ裬
ԼĻȡǣõĸʽʾ he following format:

	  PrevPage:  newvalue
	 NextPage:  newvalue
	  TOC:	   newvalue


 deutsch

2.2.4   GNU Info ʽ

Ҫĵų GNU Info ʽܵĸʽֻҪʹָ

     % sgml2info foo.sgml

2.2.5   LyX ʽ

 LyX ʽĳʹָ

     % sgml2lyx foo.sgml

2.2.6   RTF ʽ

 RTF ʽִָ

     % sgml2rtf foo.sgml

⽫ foo.rtf, Լ foo-1.rtf, foo-2.rtf,
ȵȵ---ļÿһԳһ

2.2.7   SGML ﷨

ֻ SGML תץĴ󣬿ʹ sgmlcheck ָ壮 磺

     % sgmlcheck foo.sgml

2.3  ISO 8859-1 Ԫ

ISO 8859-1 (latin1) Ԫڴ LaTeX, HTML, LyX, Լ RTF
ĹԪ(GNU Info δ֧Ԯ ISO 8859-1) ҪʹܵĻԼ
-l ѡָ壬磺

     % sgml2txt -l foo.sgml










SGML-Tools ʹ˵						      6



Ҳ SGML ԭʼļʹ ISO 8859-1
ԪǻԶתɶӦļʽʵݳԪ(escape codes)


3.  ʹ SGML-Tools ׫дļ

ʹ SGML-Tools DTD ׫дļĹ̴󲿷Ƿǳ׵ģе LaTeX
ȻȻЩҪע⣮һҽ SGML ļ׫д SGML
ļ(дָ) example.sgml Լļġ
ڴҽ SGML ĸܣԭʼļΪǺпɶԣ ˣӡ
example.sgml ԭʼ()ʵĲο

3.1  

ϸļԭʼļע⵽Խ(< 
>)ʾġǩ(tags)
ǩָĳԪصʼνԪһڣһΣһбľ䣬беһĿԼĽṹ
ʹñǩʹ LaTeX ָ \item  \section{...} һ㣮

ٸ򵥵ӣҪһ ֣ԭʼм

     ٸ򵥵ӣҪһ <bf></bf>, ...


<bf> δֵĿͷ </bf> ǽβ Ҳʹʽ

     ٸ򵥵ӣҪһ <bf//, ...


бְ߽ס(Ȼֺߣͱʹóʽ
 Unix ĵƣ)

ԪҪע
(Ϊʲϸ۲ԭʼļͻע⵽Щܹ "&"
ʾʽҽ̵˵Щ)

ĳЩ£ضԪ֮βǩǿѡõģ 磬ĳһڵĿʼʹ
<sect> ǩȻýڵĽβǩ
(Գڸý屾ĵطֻǸýڵ!)
ǿѡõĶͬһοʼһڵʱҲͰʾýڵĽ
һ˵㲻ҪЩϸڣֻҪʹ example.sgml
ָġͿˡ

3.2  Ԫ

ԵģǱ SGML
ԭʼļԪ⻹עԪ
磬ɽǵıʾʽ: <foo>
Ϊ˱ʾߵĽţʹ &lt; Ԫأ
һչԪġ޼ˣԭʼļм

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










SGML-Tools ʹ˵						      7



һ˵ԽԪ(&)Ϊʼʾһľ޼ 磬 % ŵ
&percnt;  |  &verbar; ȵȣ
еġԪнϾ޼Աʾǣ

ͨ㲻ҪʹýϾ޼ʾĳԪȻĳЩǱġõǣ

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

ԪбԲ鿴һ滻 ͨ LaTeX
ᱧԹԪԲ $SGMLTOOLSLIB/rep/latex/general ǸõĿʼ
$SGMLTOOLSLIB  SGML תǰ森

3.3  Verbatim  Code 

ԪʱҲᵽverbatim 
к벻ӱ䶯(հԪԼţ) verb
Ԫؾ;ģ

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


verb ʹκζ رأ verb 룺

    ʹ &amp;  &

    ʹ &lt;/  </

    Ҫ verb ʹ \end{verbatim} Ϊ LaTeX  verbatim
     ģ (δӦÿȫصײֱţĿǰĽ֧Ԯ)

code ǳ verb Χָ

      code ӣ

Ӧκ verb Χʹ tscreen 









SGML-Tools ʹ˵						      8



     <tscreen><verb>
     һ䣮
     </verb></tscreen>


tscreen һŲ趨ԤΪ tt ʹáҪ LaTeX
Լֵİ汾пöˣ ʹ tscreen 
verbڡʹκεԪҪ tscreen
Ԫ޹أ example.sgml

quote  tscreen˲ԤΪ ttԣʹ quote
޹صã磺

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




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

3.4  ļݸŹ

оϸ֮ǰҪʼ linuxdoc DTD
ļŹۣļġϸۿ example.sgml

3.4.1  

ļġġǱԼļ̬(style)ĶLinux HOWTO
ļӦ

     <!doctype linuxdoc system>

     <article>

     <title>Linux Foo HOWTO
     <author>ΰ, <tt/cwhuang@phys.ntu.edu.tw/
     <date>v1.0, 14 August 1997
     <abstract>
     ļ˵ʹ <tt/foo/ ߣ
     </abstract>

     <toc>

ЩĿ밴˳򣮵һи SGML ʽʹ linuxdoc
DTD <article> ǩ涨ļʹáarticleļ̬ (ԭȵ QWERTZ
DTD  reportԼbook̬Ҳû޸ SGML-Tools
ʹ)

title, author, Լ date ЩǩӦǺԵģ  date
ǩаļİ汾Լ޸ʱ䣮

abstract ǩ趨ļ֮ǰӡ֣ 㲻뺬б(toc








SGML-Tools ʹ˵						      9



ǩ)ܲҪ abstract

3.4.2  ½

֮ᣬͿ׼ļеķָֽʹã

    sect: ½ (Ҳ 1, 2, ȵ)

    sect1: ڶĴ½ (Ҳ  1.1, 1.2, ȵ)

    sect2: С½

    sect3: ĲСС

    sect4: ССС

൱ LaTeX жӦ section, subsection ȵȣ

 sect  ( sect, sect ȵ) ǩ֮Ǹýڵƣ
磬ļĶˣ֮Ǵ˱ǩ

     <sect>


ڴ˽ڿʼĵط()иǩǣ

     <sect2>


һڵıǩ֮ᣬ㿪ʼļ壮Ȼһ <p> ǩʼ

     <sect>
     <p>
     һ SGML-Tools ļʹָ....


Ǹ߽ʽһڵıⲢ׼ÿʼ壮
ᣬµĶԿհпʼ(ͬ TeX)磬

     ǵһεĽβ

     Ǵ￪ʼµһΣ


ûʲҪÿǰʹ <p>
ǩֻҪڷָֽĵһ俪ʼӾУ

3.4.3  ļβ

ļĵطʹǩ

     </article>

Ը߽ʽѾ article Ԫ(ļ)








SGML-Tools ʹ˵						     10



3.5  ο

Ҫϵͳܣοף磬ҪĳһڵĽοʾý:

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


Ϳļеĳطʽʾʽոýڣ

     ο<ref id="sec-intro" name="">һڵĽܣ


⽫ sec-intro ǵĽں滻 ref ǩ  groff Լ HTML ת
name Ǳģ SGML-Tools ʹõ groff
޼趨Ŀǰδ֧Ԯοȡֲĳһڣ

磬ǽο (section 3.5, page 10)

ȫѶʹõͨԴλ URL ҲԪ url
ԪӦļFTP ϵĵȵȣ磺

     ɴӴȡ Linux HOWTO ļ
     <url url="http://sunsite.unc.edu/mdw/HOWTO/"
	name="The Linux HOWTO INDEX">


url ָ URL Զ뵽 HTML ļУ ѡõ name
ָӦü(HTML ת)Ϊ URL (LaTeX 
groff)ûи name ʹ URL 

磬Դȡ SGML-Tools ׼

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

һõı htmlurl HTML ļÿļ URL
ݽ֣ Ǹ˵ĵʼλַд

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


ڴлáesr@snark.thyrsus.com ظġesr@snark.thyr
sus.com <mailto:esr@snark.thyrsus.com>  HTML ļȻʵ URL
ݣ

3.6  

ϣSGML-Tools ֧Ԯ LaTeX ͬͣ ע⣬Σֵת(
groff)й͵Ѷ ԣԾܵʹöͣ LaTeX
תкô ڴֵİ汾вҪָ͵ص㣮

رǣǰ tt ǩ¿ȹ̶ġֻͣ
ӦеĵʵλַƣƵȵȣ 磺









SGML-Tools ʹ˵						     11



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


൱춣

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


ǵֲбʹüʽ

  õ bf Լ б õ em
⻹֧ԮͣҲʹǣΪǻᱻת HTML
֧Ԯͣ 壬ֻ壬ԼбӦҪ

3.7  б

ϵͳ֧Ԯֲͬбǣ

    itemize ĸʾб

    enum б

    descrip б

 itemize  enum Ŀ item ǩԱʾ  descrip
Ŀ tag ʾ 磬

     <itemize>
     <item>һĿ
     <item>ǵڶĿ
     </itemize>




    һĿ

    ǵڶĿ

 enum 

     <enum>
     <item>ǵһĿ
     <item>ǵڶĿ
     </enum>


Ӧóбǳ״ģϸġļ

descrip бвͬеѿĳЩܻʹ

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


ῴ

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

      Gnus.
	    Annoying little bugs that run on your CPU.

3.8  һѶ

  1.  QWERTZ ʹָԴȡ ftp://ftp.cs.cornell.edu/pub/mdw/SGML.
      QWERTZ (Լ SGML-Tools) ֧Ԯѧʽͼεԣ
       SGML дһļҽԭ QWERTZ DTD
      Ҫ޸Ĺ linuxdoc DTD Ϊرд Linux HOWTOs
      ļõģ

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

  3.   SGML ѶЩҳҵ

	  SGML and the Web4

	  SGML Web Page5

	  Yahoo's SGML Page6


  4.  James Clark  sgmls  nsgmls ߿ҵ
      ftp://ftp.jclark.com Լ James Clark's WWW Page7 .

  5.  emacs psgml ڴҵ
      ftp://ftp.lysator.liu.se/pub/sgmlṩ SGML Ĺܣ

  6.  Լĵʼ majordomo@via.ecp.fr Բ SGML-Tools mailing
      listд subscribe sgml-tools Mailing list ĵַ sgml-
      tools@via.ecp.fr

  7.   LyX ĸѶڴҵ LyX WWW Page8 .  LyX һ LaTeX
      õĸִ߽ǰˣ ߰ý棬Զ LaTeX
      ʽ֣  LaTeX ѧϰʹӵĸֱֱӣ

____________________

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

2. װ ..................................................................... 3
   2.1 װ ............................................................. 4
   2.2  SGML ļ ....................................................... 4
   2.3 ISO 8859-1 Ԫ .................................................... 5

3. ʹ SGML-Tools ׫дļ ................................................. 6
   3.1  ............................................................. 6
   3.2 Ԫ ............................................................. 6
   3.3 Verbatim  Code  ................................................ 7
   3.4 ļݸŹ ......................................................... 8
   3.5 ο ............................................................ 10
   3.6  ................................................................ 10
   3.7 б ................................................................ 11
   3.8 һѶ ...................................................... 12

































				       i


