  SGML Tips for JF
  JF Project, (http://www.linux.or.jp/JF/)
  $Date: 2002/11/12 11:04:15 $

  ̕ JF ML  SGML 𗘗pĕ̍쐬E|ۂ oĂ
  ƕ֗ȂƁAӂׂƂȂǂ܂Ƃ߂̂łB SGML g
  쐬ۂ̊{IȖ񑩂ɂẮA JF ɂ SGML Memo
  <http://www.linux.or.jp/JF/JFdocs/sgmlmemo.html> QƂB
  ______________________________________________________________________

  ڎ

  1. SGML  DTD
     1.1 SGML ɂ
     1.2 DTD ɂ

  2. SGML ϊc[ɂ
     2.1 LinuxDoc  LinuxDocTR DTD
        2.1.1 LinuxDoc-Tools
           2.1.1.1 {R[h EUC-JP
           2.1.1.2 LinuxDoc-Tools ̃R}h
        2.1.2 ̑ LinuxDoc DTD ϊc[
     2.2 DocBook DTD
        2.2.1 DocBook ̃c[
           2.2.1.1 DSSSL
           2.2.1.2 DocBook DTD
           2.2.1.3 ISO8879 ENTITY SGML
           2.2.1.4 openjade
           2.2.1.5 w3m
           2.2.1.6 RPM ɂCXg[
           2.2.1.7 ϊ̃R}h
           2.2.1.8 docbook-utils (Jade Wrapper) ̎gp
           2.2.1.9 PSGML
           2.2.1.10 |ɂ
           2.2.1.11 {ł̒ҕ\L
     2.3 DocBook XML
        2.3.1 DocBook XML ̃c[
           2.3.1.1 ϊ̃R}h

  3. g镶AgȂ
     3.1 Rg "--"
     3.2 LinuxDoc DTD ŎgȂ
     3.3 LinuxDoc DTD Ŏg镶
     3.4 DocBook DTD ŎgȂ
     3.5 LinuxDoc  DocBook ւ̕ϊ̒

  4. LinuxDoc DTD ̏C (^O)
     4.1 <url ... > or <htmlurl ... >
     4.2 <itemize>  </itemize>
     4.3 <verb>  </verb>
     4.4 <sect1>
     4.5 <newline>
     4.6 <label id=...>

  5. LinuxDoc DTD ł̉摜̑}ƕ\g
     5.1 摜̑}
     5.2 \g

  6. QlȂ
     6.1 FAQ уKCh
     6.2 SGML ʂɂ
     6.3 HTML ɂ
     6.4 ֗ȃc[
     6.5 DocBook DTD, jade

  7. 
     7.1 ̔̕zzɂ
     7.2 CREDITS

  ______________________________________________________________________

  1.  SGML  DTD

  1.1.  SGML ɂ

  Standard Generalized Markup Language (Wėp}[NAbv) Ƃ́A
  ̍\A܂́A߁AiȂǈӖ̏ł̂܂Ƃ܂ (
  elementA\vf邢͒PɗvfƌĂт܂B{ł̓Gg
  \L܂B) w肵ȂLq邽߂̕@̂ЂƂłB (SGML 
  ́Af[^Ȃǂ̗pr܂B)

  Ɍ΁ASGML ̂́u̍\`v̂ł͂ȂAu
  ̍\`v߂ DTD (^`) `邽߂̘gg߂
  ̂łB܂uSGML ŕvۂɂ͂܂ǂ DTD ĝA
  炩ߌ߂ĂȂ΂Ȃ܂B

  DTD ɂ͂낢Ȏނ܂BႦ WWW ([hChEFu) 
  pĂ HTML (̒ɂ낢Ȏނ܂)  DTD 
  B

  1.2.  DTD ɂ

  DTD (^`: Document Type Definition) Ƃ̂́ASGML ŕL
  q邽߂ɗpłu\vK肵̂łB

  Ⴆ WWW ŗp HTML  SGML ̈łADTD Ƃ HTML
  3.2, HTML 4.0 Strict, HTML 4.01 Transitional Ȃǂ܂B

  Linux ֘A̕ł LinuxDoc DTD ȑO悭pĂ܂A
  ͂Ƃ qwartz DTD (LaTeX ւ̕ϊɕ֗ DTD ł) 
  ɁALinuxDoc-sgml c[̊Jƍ킹č쐬ꂽ̂łB

  Aŋ߂ł DocBook DTD 𗘗pႪĂĂ܂B֘A
  EłyĂĂA܂ Gnome, KDE Ȃǂ̃t[\tgEFAJv
  WFNgł֘A̍쐬ɗpĂ܂B XFree86  document
  ł] LinuxDoc DTD ɕύXƎ DTD 𗘗pĂ̂ł
  A DocBook DTD ւ̈ڍs悳Ă܂B LinuxDoc DTD
  ̖{Ɩ{ Linux Documentation Project (LDP) ł DocBook DTD ւ̈
  s{iIɐi߂Ă܂B

  DocBook DTD ́AZp SGML ō쐬ۂ̕W DTD Ƃđ̐l
  XɂĕyiĂA܂ LinuxDoc DTD ł͈ȑO̓T|[g
  ĂȂ}\̑}\Ȃǋ@\IɂDĂ̂ŁAڍs͂
  ȂɗR̂̂ƌ܂B

  DTD ł́AeGg̎ނƁÃGg̒ɂǂȃG
  g܂ނƂł邩ƂƁA܂AGg̋EuJn
  ^OvuI^Ov̂ꂼɂďȗ\ł邩ǂƂƂ
  ǂK肵Ă܂B

  Ⴆ LinuxDoc DTD ł́A"linuxdoc" ƂGg (Jn^OAI
  ^OƂɏȗ\) Ŝ\GgłA̒
  sectAchaptAarticleAreportAbook Ȃǂ̃Gg邱Ƃł
  ܂B܂ article ƂGg̒ɂ titlepageAheaderA
  tocApAsect Ȃǂ̃Gg邱Ƃł܂B

  Gg̎ނɂ̓ubNGgƃCCGg
  BubNGg͏L articleAsectAchapt Ȃǂ́uӖ̂܂
  ܂vGgACCGg̓eLXĝ̂悤ɕ
  ̓eGgƎvĂ΂悳łB

  2.  SGML ϊc[ɂ

  2.1.  LinuxDoc  LinuxDocTR DTD

   JF Project ł́A{ LinuxDoc DTD SGML ϊ邽
  ߂̃c[ƂāALinuxDoc-Tools gpĂ܂B̃c[́ACees
  de Groot ɂ SGML-Tools ̍Ō LinuxDoc DTD Ήłł ver
  1.0.9 x[Xɂ̂łA{Ή̂߂̕ύXȂǂ
  ܂B
  2.1.1.  LinuxDoc-Tools

  SGML-Tools ̌pł SGMLtools-Lite ł́ALinuxDoc DTD ̃T|[g
  p~Ă܂̂ŁADocBook ւ̈ڍs܂ł̎b[uƂ
  āAV LinuxDoc-Tools [X邱ƂɂȂ܂B
  āAꂩ LinuxDoc DTD gĕ쐬ꍇ́ALinuxDoc-Tools
  g悤ɂĂB

  LinuxDoc-Tools ɂẮÃTCgB

  <http://people.debian.org/~sano/linuxdoc-tools/>

  JF ł͓ jLinuxDoc-SGML Ƃc[gpĂ܂B
  ASGML-Tools 1.0.9 ɓ{pb`𓖂Ă SGML-Tools 1.09j Ƃ
  c[ւƈڍsA݂ł LinuxDoc-Tools gĂ܂BjLinuxDoc-
  SGML  SGML-Tools ւ̈ڍs DTD ̎dlύXꂽ̂ŁA
  <hrule>  <faq> Ƃvf͎gƂł܂B

  ̏L LinuxDoc-Tools  SRPM  linuxdoc-tools-0.9.20-3.src.rpm
  <ftp://ftp.redhat.com/pub/redhat/linux/8.0/en/os/i386/SRPMS/linuxdoc-
  tools-0.9.20-3.src.rpm> œł܂B

  RPM pbP[Wgꍇ́AĂ݂Ƃ悢ł傤B

  2.1.1.1.  {R[h EUC-JP

  ӓ_ƂāAȑO jLinuxdoc-SGML ł̓IvVw肵Ȃł{
  ꕶ܂ASGML-Tools 1.0.9 x[X̃c[ LinuxDoc-Tools
  ł́AIvV "-l ja -c nippon "KvɂȂĂ܂Bw肵
  ȂƂƕϊł܂B

  ܂{̕R[h EUC-JP łBJIS R[h Shift-JIS
  ł͂܂ł܂B "kcc -c" Ń`FbNAEmacs/Mule ł
  \mFĂ܂傤B EUC-JP R[hȊOō쐬ꂽ̕
  Ƃ SGML ۂȂǂɁAYĂ܂Ƃ̂ŁA
  ӂ܂傤B

  2.1.1.2.  LinuxDoc-Tools ̃R}h

  o  @`FbN linuxdoc -B check -l ja -c nippon

  o  eLXgւ̕ϊ linuxdoc -B txt -l ja -c nippon -f

  o  HTML ւ̕ϊ linuxdoc -B html -l ja -c nippon

  łBȂAlinuxdoc -B html ł͊e <sect> Ƃɕʂ html t@C
  Ȃ܂ATCY̏ȕł͑ŜЂƂ html t@Cɂ܂Ƃ
  Ƃꍇ܂B̂悤ȏꍇɂ -s 0 -T 2 IvV
  Asgml21html ֗ł傤Bsgml21html  JF  Web site
  <http://www.linux.or.jp/JF/workshop/archives/sgml21html> ł
  ܂B

  ̃R}hgۂ́AႦ ``linuxdoc -B check anatano.sgml''
  ̂悤ɃR}ĥƂɃXy[X SGML ̃t@Cw肵
  B

  2.1.2.  ̑ LinuxDoc DTD ϊc[

  LinuxDoc DTD g SGML ̕ϊc[ɂ́ALinuxDoc-Tools ̑
   doctools Ƃ\tgEFA܂BႦ XFree86 ł́AFreeBSD
  ֘ÃvWFNgŗpĂ doctools 𗘗p SGML 
  ϊsȂĂ܂B doctools/XFree86 o[W 1.1.3 ȍ~ł
  {ւ̑ΉƂƂɁAman y[WtH[}bgւ̑ΉȂĂ
  B

  2.2.  DocBook DTD

  JF ł́ADocBook SGML  HTML ɕϊ邽߂̃c[ƂāAopenjade
  gpĂ܂Btext ւ html oR w3m ŕϊĂ܂B
  _ł̖ TeXAPSAPDF ւ̏o͂ŗpĂ jadetex {Ή
  ĂȂ߂ɂ̃tH[}bgւ̏o͂ƂłȂƁA
  сALDP  PS, PDF ւ̕ϊɗpĂ HTMLDOC }`oCg
  ΉĂȂƁAȂǂ܂B

  2.2.1.  DocBook ̃c[

  html o͂ɂ openjade Atext o͂ɂ openjade + w3m p܂B

  efBXgr[VŗpӂĂpbP[WŃCXg[
  ƁAϐȂǂ̖ʓ|ȐݒKvȂ̂ŁAƂĂyłB

  ȂȀ͓ html o͂܂łsc[Ɋւ́A LDP Authors
  Guide <http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/index.html> (
   <http://www.tldp.org/LDP/LDP-Author-Guide/index.html>) ̔
  łBX̃CXg[Ɋւڍׂ́A LDP Authors Guide 
  B

  2.2.1.1.  DSSSL

  DSSSL (Document Style Semantics and Specification Language) ́Aǂ
  @ SGML ICp̕ɂ邩 openjade Ɏw
  ̂łBƂ΁ADSSSL ɏ]āAtitle ^OAHTML ł <H1>
  ^OɕϊARTF ł 14 |Cg Times Roman {[ĥɕϊ
  ܂B DSSSL Ɋւ镶͉L Norman Walsh DSSSL ̃y[Wɂ
  ܂B DSSSL C邱Ƃ́ADocBook ̂C邱Ƃɂ͂ȂȂ
  _ɒӂĂBPɃ_OꂽeLXǧhςĂ
  ɂ܂B

  ʏ Walsh o[W DSSSL ł Norman Walsh DSSSL
  <http://docbook.sourceforge.net/projects/dsssl/> A܂CXg[
  ĂB

  Red Hat ł̃pbP[W docbook-style-dssslADebian ł̃pbP[W
   docbook-dsssl łB

  ɁAjf-custom.dsl 
  <http://www.linux.or.jp/JF/workshop/archives/jf-custom.dsl> 肵
  ĂB

  jf-custom.dsl ADȃfBNgɒuĂBq̐̂
  /usr/local/share/sgml/stylesheets/ ɒuƂɂ܂B

  c[ꎮ\[XCXg[ꍇ́A jf-custom.dsl 
  ɁAWalsh o[W DSSSL ǂɂ邩LqKv邩
  ܂B

  t@C̐擪̂悤ɏ܂B (: openjade, DocBook,
  DSSSL X^CV[g, iso-entities AfBXgr[Ṽpb
  P[WŃCXg[ꍇA͕Kv܂)

    <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
  + <!--
    <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl>
  + -->
  + <!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl" CDATA dsssl>
    ]>
    <style-sheet>

  Lł́AWalsh o[W DSSSL A
  /usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl ɂ邱Ƃ
  w肵Ă܂B

  2.2.1.2.  DocBook DTD

   DTD ̃o[W ɍ̂A <http://www.oasis-
  open.org/docbook/sgml/> 肵܂B

  Red Hat ł́ASGML/XML  DocBook DTD ꎮ docbook-dtds pbP[W
  ܂Ƃ߂Ă܂B

  Debian ł́ASGML  docbook pbP[WAXML  docbook-xml pbP[W
  łB

  2.2.1.3.  ISO8879 ENTITY SGML

  ISO8879 ENTITY ɂ́AȋL╶̋Lq@`Ă܂B

  Red Hat ł́Asgml-common pbP[WɊ܂܂Ă܂B

  \[XCXg[ꍇA sgml-common 𗘗p̂y
  B <ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/>
  ɁA܂B

  Debian ł̃pbP[ẂAsgml-data łB

  2.2.1.4.  openjade

  html ւ̕ϊɎgp܂BẴfBXgr[Vł́AoC
  ipbP[WpӂĂ܂B\[XCXg[ꍇ́A
  openjade-1.3
  <http://download.sourceforge.net/openjade/openjade-1.3.tar.gz> 
  ܂B

  2.2.1.5.  w3m

  eLXgւ̕ϊɎgp܂BẴfBXgr[Vł́Ao
  CipbP[WpӂĂ܂B\[XCXg[ꍇ́A
  w3m <http://w3m.sourceforge.net/> 肵ÃR}hɂCX
  g[܂B

  ./configure
  make
  make install

  ./configure ŏdvȂ̂́A

  Which language do you prefer?
    1 - Japanese (charset ISO-2022-JP, EUC-JP, Shift_JIS)
    2 - English (charset US_ASCII, ISO-8859-1, etc.)
  [1]?

  ƁA

  Input your display kanji code.
          S - Shift JIS
          E - EUC-JP
          j - JIS: ESC $@ - ESC (J
          N - JIS: ESC $B - ESC (J
          n - JIS: ESC $B - ESC (B
          m - JIS: ESC $@ - ESC (B

  Which? E

  łBuEUprɂȂ̂ł΁A

  Let's do some configurations. Choose config option among the list.

  1 - Baby model    (no color, no menu, no mouse, no cookie, no SSL)
  2 - Little model  (color, menu, no mouse, no cookie, no SSL)
  3 - Mouse model   (color, menu, mouse, no cookie, no SSL)
  4 - Cookie model  (color, menu, mouse, cookie, no SSL)
  5 - Monster model (with everything; you need openSSL library)
  6 - Customize

  Which? 1

   baby model IсA̎ɂ́Aenter ō\܂B

  2.2.1.6.  RPM ɂCXg[

  openjade ́A
  <ftp://rpmfind.net/linux/redhat/8.0/en/os/i386/RedHat/RPMS/openjade-1.3.1-9.i386.rpm>
  ɂ܂B

  ܂ÃpbP[WCXg[Ă邩mFĂB

  o  sgml-common

  o  docbook-dtds

  o  docbook-style-dsssl

  Jade Wrapper  docbook-utils pbP[WɊ܂܂Ă܂B

  2.2.1.7.  ϊ̃R}h

  openjade, DocBook, DSSSL X^CV[g, iso-entities \[XC
  Xg[ꍇ̂݁Aϐ SGML_CATALOG_FILES K؂ɐݒ肷Kv
  ܂B

  ȉɈ܂:

  export SGML_CATALOG_FILES=\
  /usr/local/share/sgml/iso-entities-8879.1986/iso-entities.cat:\
  /usr/local/share/sgml/docbk41/docbook.cat:\
  /usr/local/share/sgml/openjade-1.3/catalog:\
  /usr/local/share/sgml/docbook-dsssl-1.74b/catalog

  ݒɊւڍׂ́A LDP Authors Guide
  <http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/jade.html> (
  <http://www.tldp.org/LDP/LDP-Author-Guide/jade.html>)B

  fBXgr[ṼpbP[WłׂăCXg[ꍇA
  SGML_CATALOG_FILES ̐ݒ͕svłB

  ꂽ html o

  openjade -t sgml -i html \
     -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
       filename.sgml

  P html o

  openjade -t sgml -i html -V nochunks \
    -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
      filename.sgml > filename.html

  eLXgo

  OɒP html t@C܂Bq̕@ł́Aulink ̃N
  Ƃďo͂Ȃ̂ŁAp邱Ƃ͂ł܂B

  u<ulink url="http://tldp.org/">LDP</ulink> A\łBv

   SGML \[XɏꍇAeLXgo͂́A

  uLDP A\łBv

  ɂȂĂ܂܂Bjf-custom.dsl ͂ɑΉ邽߂̃IvV
  Ă܂B̃R}hŁAeLXgo͗p̒P html t@C쐬
  ł܂B

  openjade -t sgml -i html -V nochunks -V %show-ulinks% \
    -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
      filename.sgml > filename.html

  ɍ쐬΂̒P html t@CpAeLXgɕϊ܂B

  w3m -dump -T text/html -cols 72 -S filename.html > filename.txt

  OL̗ŁAeLXgo͂́A

  uLDP <http://tldp.org/> A\łBv

  ƂȂ܂B

  2.2.1.8.  docbook-utils (Jade Wrapper) ̎gp

  docbook-utils (Jade Wrapper) gƁAƂĂȒP HTML  text ɕ
  ł܂B

  @

  RedHat, Debian, Slackware ł́ApbP[WpӂĂ܂B\[X
  <ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/> 
  Ał܂B

  gp@

  ꂽ html o

  docbook2html -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
  filename.sgml

  P html o

  docbook2html -u -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
  filename.sgml

  eLXgo

  docbook2txt -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
  filename.sgml

  2.2.1.9.  PSGML

  LinuxDoc p YaSGML Ăꍇ́A[h؂ւĎgKv
  ܂B

  <http://www.lysator.liu.se/~lenst/about_psgml/> Ał܂B

  ǵALDP Authors Guide ̕ҏWc[
  <http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/editing.html>
  B

  2.2.1.10.  |ɂ

  |҂̒ǋL@́Aȉ̂悤ɂ܂B

  ̍ŏ̕

    <author>
     <firstname>Kevin</firstname>
     <surname>Taylor</surname>
     <affiliation>
       <address>
        <email>kevin@northants.lug.org.uk</email>
       </address>
     </affiliation>
    </author>

  Ƃ܂̂ŁÂ悤ɕύX܂B

    <authorgroup>
     <author>
      <firstname>Kevin</firstname>
      <surname>Taylor</surname>
      <affiliation>
        <address>
         <email>kevin@northants.lug.org.uk</email>
        </address>
      </affiliation>
     </author>

     <othercredit role="translator" lang="ja">
      <surname>{</surname>
      <firstname>_</firstname>
      <contrib>{</contrib>
      <affiliation>
        <address>
         <email>hng@ps.ksky.ne.jp</email>
        </address>
      </affiliation>
     </othercredit>
    </authorgroup>

  2.2.1.11.  {ł̒ҕ\L

  ҂{ŏ@́Aȉ̂悤ɂ܂B

    <author lang="ja">
     <surname>{</surname>
     <firstname>_</firstname>
     <affiliation>
       <address>
        <email>hng@ps.ksky.ne.jp</email>
       </address>
     </affiliation>
    </author>

  2.3.  DocBook XML

  LDP ɂ́ADocBook XML ̕o^Ă܂B`̕ȉ̂悤
  Ȃ̂łB

    <?xml version="1.0"?>

    <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">

  2.3.1.  DocBook XML ̃c[

  DocBook XML  HTML  text ɕϊc[ɂ́A openjade, xmlproc,
  cocoon Ȃǂ܂A JF ł DocBook SGML l openjade 
  gĂ܂B

  g Linux fBXgr[VɁAdocbook2html R}hȂǂ
   docbook-utils pӂĂꍇ́AĝԊȒPłB

  ꂽ html o

  docbook2html -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
  filename.xml

  ȉ́Aopenjade 𒼐ڎgꍇ܂B

  XML p DocBook KvłB <http://www.oasis-open.org/docbook/xml/>
  AKvȃo[Ŵ̂肵܂B

  Debian ̏ꍇApbP[W docbook-xml łB

  2.3.1.1.  ϊ̃R}h

  openjade, DocBook, DSSSL X^CV[g, iso-entities \[XC
  Xg[ꍇ̂݁Aϐ SGML_CATALOG_FILES  XML ɍĐݒ
  Kv܂B

  ꂽ html o

  t@C̒OɁAK xml.dcl w肷Kv܂B

  openjade -t sgml -i html \
       -d /usr/local/share/sgml/stylesheets/jf-custom.dsl \
       /usr/share/sgml/xml.dcl \
       filename.sgml

  3.  g镶AgȂ

  ƂɂȂ́u{ LinuxDoc-SGML KChvɏĂe
  Aقڂ̂܂܎ʂ̂łAJF ML ňӌ𒸂ł
  Ă܂B

  3.1.  Rg "--"

  JF ł͑ LDP {ɖ|󂵂Ă܂A̍ہAZȂǂɕ
  Ȃ悤ARgƂĖ󕶒ɎcƂsȂĂ܂BƂ
  낪ASGML ̎dlRg "--" 邱Ƃ͂ł܂B
  RgAEgہA "--"  "&#045;&#045;" ɕϊKv
  ܂BႦ

  cat original.sgml | \
  perl -e 'while(<>) { s/--/&#045;&#045;/g; print; }' | \
  sed -e 's/^/<!-- 0 /' -e 's/$/ -->/' > commentout.sgml

  邢

  cat original.sgml | \
  perl -e 'while(<>){s/--/&#045;&#045;/g;s/^\s+$/ -->\n\n<!-- O \n/;print;}' \
   > commentout.sgml

  Ȃǂ̃R}hgāA炩ߌŜRgAEgĂ|
  ƂɂƗǂ܂B

  3.2.  LinuxDoc DTD ŎgȂ

  LinuxDoc ł́Aȉ͂̕ꂼEɎ悤ɏĉBeLX
  g HTML ֕ϊ鎞ɈӐ}ɒu܂B

  ȂALinuxDoc  LinuxDocTR ł́A{ yasgml.el 
  Emacs/Mule Ƒgݍ킹ĎgƁÁuvIɍsȂĂ
  ܂B

     `_ "~" (~)
         &tilde;

     p ([)
         &lsqb;

     Ep (])
         &rsqb;

     ApTh (&)
         &amp;

     s (<)
         &lt;

     Es (>)
         &gt;

     s{XbV (</)
         &etago;

     h}[N ($)
         &dollar;

     V[v (#)
         &num;

     p[Zg (%)
         &percnt;

     obNXbV (\)
         &bsol;

     dp (")
         &dquot;

  u킩vƎvĂAŏ͈ӊOƌՂ̂łB`FbNR
  }h (linuxdoc -B check) ŃG[ɂȂAȌo͂茩
  ܂傤B

  3.3.  LinuxDoc DTD Ŏg镶

  āAug镶vɂ́Aʂ̂ȁAApɉĎ̋L
  ܂܂B

       : ; . , ? ! ` ' ( ) - / * @ ^ _ + = { } |

  ɂẮA{łȂ畁ʂɎgĂ܂č\܂BA
  <author> ̂ƂŃ[AhX߂ @ ̂܂܎gƃG[
  ɂȂꍇ݂łB (͂Ȃ܂B)

  ̏ꍇ̓[AhX <tt/user@domain/ ̂悤 <tt/  / ň͂
  Ɨǂ悤łBB

  ȂAuRg "--"v ̌QƂĂĂB

  3.4.  DocBook DTD ŎgȂ

  DocBook ̏ꍇAgȂ "<"  "&" łB

     s (<)
         &lt;

     ApTh (&)
         &amp;

  3.5.  LinuxDoc  DocBook ւ̕ϊ̒

  LinuxDoc DTD ɂ́AƎɊgĂ SGML GeBeB܂B
   DocBook ł͎g܂BɎύXsƂɂAقځA
  ̕ϊo͂s SGML \[XɂȂ܂B

  o  &congr;   =

  o  &dArr;   &dArr;

  o  &dquot;  &quot;

  o  &ero;    &amp;

  o  &etago;  &lt;&sol;

  o  &hArr;   &hArr;

  o  &harr;   &harr;

  o  &mid;    &mid;

  o  &mu;     &micro;

  o  &oplus;  &oplus;

  o  &otimes; &otimes;

  o  &setmn;  &setmn;

  o  &tm      &trade;

  o  &uArr;   &uArr;

  o  &vDash;  &vDash;

  o  &vdash;  &vdash;

  LŁA&setmn; &vDash; &vdash; ̓ƎGeBeB𓯂O ISO G
  eBeBɒuĂ܂A

    "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN"
    "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN"

  Ȃǂ ISO GeBeBɒ`Ă̂ŁAɉߋƂ̌݊̂
  ߂Ɋ܂܂Ă̂ƍlAۂɂ̃GeBeB𗘗p
  LinuxDoc ͂قƂǂȂł傤B

  ǂĂKvȏꍇ Unicode gĂꂼ &#x2216;, &#x22A2;,
  &#x22A8; Ƃ邩A邢͓̃tHgɈˑ邱ƁA܂`
  ႤƂm̂ŁA"\" (backslash)A"|-" (c_ƃnCt)A
  "|=" (c_Ɠ) ȂǂőpĂB

  ܂AƎGeBeBƂāA&urlnam; &refnam; `Ă܂A
  ͎̓sɂ钆ԏ̂߂̃GeBeB`Ȃ̂ŁA
  SGML \[Xɂ̃GeBeB܂߂邱Ƃ͋֎~Ă܂B

  4.  LinuxDoc DTD ̏C (^O)

  ̏͂̋Lq́ALinuxDoc DTD gꍇ̏C^OłB DocBook DTD
  gꍇ́Ap DocBook 
  <http://www.linux.or.jp/JF/JFdocs/docbook-intro/> LDP-Author-Guide
  <http://www.linux.or.jp/JF/JFdocs/LDP-Author-Guide/index.html>(
  <http://tldp.org/LDP/LDP-Author-Guide/index.html>)  DocBook
  Definitive Guide <http://www.docbook.org/tdg/html/docbook.html> 
  B

  ȉ̂悤ȃ^OoĂƕ֗ł傤B

  4.1.  <url ... > or <htmlurl ... >

  HTML ɕϊɁANbNƑ̏ꏊ URL փWvł悤
  ɂ邽߂̃^OłB

  Web uEU "JF (Japanese FAQ Project)" ƕ\Ă镔N
  bN邱ƂŁA <http://www.linux.or.jp/JF/> փWvł悤
  ɂ

       <url url="http://www.linux.or.jp/JF/"
            name="JF (Japanese FAQ Project)">

  Ƃɏ܂B

  url ̈ɂ́Aۂ URL ܂B܂ name ̈ɂURL ̖O
  e܂B̓IvVȂ̂ŁA <url ... > ^Og
  ɂ͏ȂĂ薳łB

  <url ... > Ǝ悤ȃ^OƂ <htmlurl ... > ܂B<url ...
  >  <htmlurl ... > ̈Ⴂ́A sgml2txt găeLXgɕϊۂ
  URL o͂邩ǂłB

  Ⴆ

  o  <url url="http://case1.org" name=" 1">

  o  <url url="http://case2.com">

  o  <htmlurl url="http://case3.edu" name=" 3">

  o  <htmlurl url="http://case4.gov">

  Ƃ SGML \[X linuxdoc -B html ɂ HTML ̃\[Xx

  o  <a href="http://case1.org">1</a>

  o  <a href="http://case2.com">http://case2.com</a>

  o  <a href="http://case3.edu"> 3</a>

  o  <a href="http://case4.gov"></a>

  ɕϊ܂B linuxdoc -B txt ɂ

  o   1 <http://case1.org>

  o  <http://case2.com>

  o   3

  o  (o͂Ȃ)

  ̂悤ɂȂ܂B4 Ԗڂ̗̂悤ȏo͂́Aʏ͒N҂Ȃł
  A <htmlurl ... > ^Ogꍇ name= ŕ\镶w
  ĂKv܂B

  ǁAWeb oRŃANZXł镶Ȃǂ̂悤ɁAeLXg URI 
  Kvꍇɂ́A<url ...> gقK؂ł傤B <htmlurl
  ...> ̂قKĂ̂́A[AhX <mailto:> NA
  j[XL or j[XO[v <news:> N肷悤ȏ
  Aƌ܂B

  4.2.  <itemize>  </itemize>

  ӏŎg܂B

  Ⴆ

       SGML (LinuxDoc) ł̉ӏ

       o   1

       o   2

       o   3

          ȕɂȂ܂B

  Əo͂ꍇ

       <tt/SGML (LinuxDoc)/ ł̉ӏ
       <itemize>
       <item> 1
       <item> 2
       <item> 3
       </itemize>
       ȕɂȂ܂B

  ̂悤ɁAXg̐擪 <itemize> uAꂼ̍ڂ̐擪
  <item> tāAŌ </itemize> Œ߂܂B
  ӏpɂ́Aɂuotӏv̂߂

       <descrip>
       <tag>o</tag>e
       </descrip>

  Auڂɔԍtӏv̂߂

       <enum>
       <item>ɍڂƁAꂼ̍ڂɔԍ
       </enum>

  Ȃǂ܂B

  ɂẮAu{ Linuxdoc-SGML KChv SGML et@C
  ł jguide.sgml  JF  Web site 擾Ă蒲ׂĂ݂
  ƁA낢QlɂȂł傤B

  4.3.  <verb>  </verb>

  ͂͂𐮌`ɂ̂܂܏o͂邽߂̃^OłB 2 
  ^Oň͂܂ꂽ͂̂܂܏o͂܂BA &  </ ͂ł
  g܂̂ŁAꂼ

  o  ApTh (&)  &ero;

  o  s{XbV (</)  &etago;

  gĉB

  4.4.  <sect1>

  <sect> ̉ɕۂɎg܂Bu (ZNV)v̉́u
   (TuZNV)vɑ̂łB

  Ȃ݂ɁA <sect>  <sect4> ܂ 5 iK̕xpӂĂ
  B{̑O <p> KvȂ̂͂ǂ̕xłłB

  4.5.  <newline>

  IɉsꍇɎg܂Bg߂ɒӂ܂傤B

  4.6.  <label id=...>

   <sect>,<sect1> Ȃǂ̒ǐoɒǉAuݎQƁv
  ̂߂̃^OłB <ref id=...> Ƒgݍ킹邱ƂŁAQƐ̃Z
  NVԍIɌvZĒuAƂƂł܂BHTML
  ւ̕ϊł́AɂĊYւ̃Nݒ肳悤łB(
  mF)

  ȂAHTML ւ̕ϊł <htmlurl> ̃^OgđݎQƂ邱
  \łBɂĂڍׂ́u{ LinuxDoc-SGML KCh
  <http://www.linux.or.jp/JF/workshop/sgml-jguide/jguide.html> v
  B

  5.  LinuxDoc DTD ł̉摜̑}ƕ\g

  LinuxDoc ɂĂ摜\𕶏ɑgݍނƂł܂BǂĂ
  KvȏꍇɂgB

  5.1.  摜̑}

  摜}ꍇ́A<figure> g܂B

       <figure>
       <ph vspace="0">
       <img src="t@C">
       </figure>

  LݒgƁAHTML ϊ̏ꍇ͉摜}AeLXgϊ̏ꍇ
  ͂Ȃɂ\܂BeLXgϊ̍ۂɑփeLXg\
  ́Â悤ɂĂB

       <#if output="html">
       <figure>
       <ph vspace="0">
       <img src="t@C">
       </figure>
       </#if>
       <#unless output="html">
       փeLXg
       </#if>

  ́AThe-Linux-Kernel <http://www.linux.or.jp/JF/JFdocs/The-Linux-
  Kernel-2.html> B

  5.2.  \g

  \g݂ɂ́A<table> ^Opł܂Bȉ͂̈łB

  <#if output="html">
  <table loc="tbp">
  <tabular ca="ccc">
  1 | 2 | 3 @
  e1 | e2 | e3 @
  </tabular>
  </table>
  </#if>

  <#unless output="html">
  <descrip>
  <tag>1</tag>e1
  <tag>2</tag>e2
  <tag>3</tag>e3
  </descrip>
  </#if>

  \̓eLXgϊɃG[ƂȂ̂ŁAKo͂𕪂ėpĂ
  B

  ́AISAPnP-HOWTO <http://www.linux.or.jp/JF/JFdocs/ISAPnP-
  HOWTO-3.html> B

  6.  QlȂ

  6.1.  FAQ уKCh

   LinuxDoc SGML ɂĂƏڂm肽΁A܂ jLinuxDoc-
  SGML ̃\[XɊ܂܂Ă FAQj  jguide ǂނƂ߂܂B
   2 ̓̕eLXg^ (.txt) ̂̂ SGML ^ (.sgml) ̂
  pӂĂ̂ŁAeLXgȂ SGML QƂƂ낢
  Ə̎QlɂȂ܂BA̒ŐĂ^O̒
  ́ALinuxDoc-Tools ł͎gȂ̂邱ƂɒӂĂB

  ݁Ãt@C JF  Web y[W

     { LinuxDoc-SGML Ɋւp`

        o  (HTML ) <http://www.linux.or.jp/JF/workshop/linuxdoc-
           sgml/FAQj.html>

        o  (eLXg) <http://www.linux.or.jp/JF/workshop/linuxdoc-
           sgml/FAQj.txt>

        o  (SGML ) <http://www.linux.or.jp/JF/workshop/linuxdoc-
           sgml/FAQj.sgml>

     { LinuxDoc-SGML KCh

        o  (HTML ) <http://www.linux.or.jp/JF/workshop/sgml-
           jguide/jguide.html>

        o  (eLXg) <http://www.linux.or.jp/JF/workshop/sgml-
           jguide/jguide.txt>

        o  (SGML ) <http://www.linux.or.jp/JF/workshop/sgml-
           jguide/jguide.sgml>
  ƂēǂނƂł܂B

  6.2.  SGML ʂɂ

  LinuxDoc-SGML ł͂ȂASGML ʂɂẮAL JF ̃y[W JF
  Workshop Guidance: SGML 쐬
  <http://www.linux.or.jp/JF/workshop/guidance-sgml.html> ̒ SGML Q
  lNW <http://www.linux.or.jp/JF/workshop/guidance-
  sgml.html#sgml-links> ƎQlɂȂł傤B

  6.3.  HTML ɂ

  SGML ̂̂ɂĂł͂܂񂪁Alinuxdoc -B html ł̏o͂ɂ
  ČۂȂ HTML ɂĂ̒mKvɂȂꍇ邩܂
  ̂ŁAJF ml ŋĒQlLڂĂ܂B

     [ D܂߂̕@ƍl
        <http://www.asahi-net.or.jp/~wq6k-yn/konomac.html>

     [ HTMLDTDǂł݂悤
        <http://www.asahi-net.or.jp/~wq6k-yn/readdtd.html>

     _ p  ȒPHTML̐
        <http://kanzaki.com/docs/htminfo.html>

     ICEnCp[eLXĝ߂̃X^CKCh
        <http://kanzaki.com/docs/Style/index.html>

  6.4.  ֗ȃc[

  ܂AL JF ̃y[Wɂ́uLinuxDoc SGML 쐬xc[v
  Ƃ

  yasgml.el
  <http://www.linux.or.jp/JF/workshop/archives/yasgml_1.5-5.tar.gz>

  ЉĂ܂BAŋߑpĂ܂Aɕ֗łB
  gƂ΁AxĂ݂邱Ƃ߂܂B

  ɂ܂ LinuxDoc SGML ł̕쐬ɊĂȂlɂƂẮA
  j[ <sect> Ȃǂ̑}Ił@\ƂĂ肪łB~
  Ȃǂ́ugȂLv͎Iɕϊē͂Ă܂B

  ȂADebian ̈łł woody ɂ yasgml ̃pbP[W܂܂Ă
  ܂BDebian [U[́̕ACXg[ƕ֗ł傤B

  6.5.  DocBook DTD, jade

  Debian ̃o[ł Stephane Bortzmeyer <bortzmeyer@pasteur.fr> 

     The Debian SGML/XML HOWTO
        <http://www.debian.org/~bortz/SGML-HOWTO/>

  ƂČJĂ܂BDebian/Debian JP o[̕
  |󂵂Ă{ł܂B

     { The Debian SGML/XML HOWTO
        <http://www.topstudio.co.jp/~kmuto/debian/Debian-HOWTO/potato/>

  

     Ȃۂ SGML ɂĒmKv邱
        <http://www.topstudio.co.jp/~kmuto/debian/Debian-
        HOWTO/potato/x67.html>

     DocBook ŃhLg쐬
        <http://www.topstudio.co.jp/~kmuto/debian/Debian-
        HOWTO/potato/x174.html>

     LinuxDoc ɂhLg̍쐬
        <http://www.topstudio.co.jp/~kmuto/debian/Debian-
        HOWTO/potato/x268.html>

     Q
        <http://www.topstudio.co.jp/~kmuto/debian/Debian-
        HOWTO/potato/x406.html>

  Ƃ͌\QlɂȂ肻Ȃ̂ŁAǂłƂ߂ɂȂ邩
  ܂BȂŌ References ɂ

     SGML CD, Bob DuCHARME, Edited by Prentice-Hall, 0-13-475740-8
        <http://www.snee.com/bob/sgmlfree/>

     DocBook: The Definitive Guide, Norman Walsh, Leonard Muellner,
        Edited by O'Reilly, 1-56592-580-7
        <http://www.docbook.org/>

  ЉĂ܂BO҂ "A very good and practical book about the
  tools needed to write and process SGML on Unix and Windows NT.  Does
  not cover XML. A very good chapter about Emacs' SGML mode, psgml and a
  nice page of PSGML tricks." ܂҂ "I didn't read it yet. The
  entire book is also online." ƃRgĂ܂B

  ܂AȑO debian-sgml@lists.debian.org ML ŋĂ̂łA
  ȉ̏ꏊ DocBook DTD ̉Ȃǂ悤łB

     The DocBook DTD
        <http://www.oasis-open.org/docbook/>

     DocBook intro
        <http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html>

     Nik Clayton, FreeBSD Documentation Project Primer for New Contribu-
        tors
        <http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/>

     John Shipman, How to write documentation with DocBook 4.1
        <http://www.nmt.edu/tcc/help/pubs/docbook/>

  ƁA SGMLtools v2 

  ______________________________________________________________________
   sgmltools -b ld2db
  ______________________________________________________________________

  sƁALinuxDoc DTD  SGML  DocBook DTD ɕϊĂ
  炵łB܂Sł͂Ȃ̂ŁAϊ̏C͕KvƂ̂ƁB
  SGMLtools v2  SGML-Tools v1 𗼕g̐ĺAĂ݂Ɨǂ
  ł傤B

  (ȂƂ Debian potato ł SGML-Tools pbP[W SGMLtools-2
  pbP[WA jade ł悤ɍ쐬Ă܂B)

  7.  

  ̕ JF Ŝ̋LYƂĈĂĂ̂ŁA JF vWFNg
  ɎQ committer ɓo^ꂽ JF  CVS |WgɂIW
  i̕RɉςĂČ\łB̍ۂ͍Ō "CREDITS"
  ̂ƂɖOƕύXǋLĂĂB

  ̕ LTGP pɏ SGML Memo ɑ΂āAJF ML ł낢Ɠe
  ǉv]Ă݂̌ӌɃqg𓾂āAuJF 쐬
  pṽt@XƂĎgĂ炢Ƃ]̂ƂŁA쐬
  ̂łB

  ̓éu{ LinuxDoc-SGML KChv璸Ă̂𒆐S
  ɁAJF ML Œ̗Lvȃqg܂Ƃ߂̂łB낢ƗLv
  ȏ JF Q҂݂̂ȂɊӂ܂B

  7.1.  ̔̕zzɂ

   Copyright (c) 1999 Taketoshi Sano
   Copyright (c) 2002 JF Project

  ̕ GNU General Public License (GPL) o[W 2 ȍ~
  A邢͕WI Linux hLgvWFNg (LDP) ̏Ɋ
  ÂzzȂΎRɂĂĂ܂܂B̃CZX
  ̃hLgł悤ȃTCgł܂BLDP ̏
  (|̂) ȂCĂ܂BCꂽo[W
  GPL ̊ł̂ݔzẑƂ邱Ƃ\łB

  7.2.  CREDITS

  o  앐r (kgh12351@nifty.ne.jp) : ŏ̐^쐬

  o  UTi (ysenda@pop01.odn.ne.jp) : 摜ƕ\gǉ

  o  {_ (hng@ps.ksky.ne.jp) : DocBook ̃c[ǉ

  o  щT (zap03216@nifty.ne.jp) : ɂ킹čXV

