  SGML Tips for JF
  JF Project, (http://www.linux.or.jp/JF/)
  $Date: 2002/01/09 16:25:06 $

  ̕ 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.2 ̑ LinuxDoc DTD ϊc[
           2.1.2.1 {R[h EUC-JP
     2.2 DocBook DTD
        2.2.1 DocBook ̃c[
           2.2.1.1 DSSSL
           2.2.1.2 DocBook DTD
           2.2.1.3 Jade
           2.2.1.4 w3m
           2.2.1.5 rpm ɂCXg[
           2.2.1.6 ϊ̃R}h
           2.2.1.7 cygnus tools ̎gp
           2.2.1.8 PSGML
           2.2.1.9 |ɂ
           2.2.1.10 ł̒ҕ\L
     2.3 DocBook XML

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

  4. 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. 摜̑}ƕ\g
     5.1 摜̑}
     5.2 \g

  6. R}h
  7. QlȂ
     7.1 FAQ уKCh
     7.2 SGML ʂɂ
     7.3 HTML ɂ
     7.4 ֗ȃc[
     7.5 DocBook DTD, jade

  8. 
     8.1 ̔̕zzɂ
     8.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
  ɂ̓f[^Ȃǂ̗pr܂B)

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

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

  Linux ֘A̕ł́A܂ LinuxDoc DTD gĂႪ
  łAŋ߂ł͈֘AƊEɂ DocBook DTD yĂāA܂
  Gnome/KDE Ȃǂ̃t[\tgEFAJvWFNgł֘A̍쐬
  DocBook DTD 𗘗pĂ܂BXFree86  document ł] LinuxDoc
  DTD ɕύXƎ DTD 𗘗pĂ̂łA DocBook DTD
  ւ̈ڍs悳Ă܂B LinuxDoc DTD ̖{Ɩ{ Linux
  Documentation Project (LDP) ł DocBook DTD ւ̈ڍsŋ߂ɂȂ
  Ă悤₭{iIɐi߂悤ƂĂ܂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ႪĂĂ܂A͋Z
  p SGML ō쐬ۂ̕W DTD Ƃđ̐lXɂĕy
  iĂA܂ LinuxDoc DTD ł͈ȑO̓T|[gĂȂ}\
  }\Ȃǋ@\IɗDĂ邱ƂA DocBook DTD ւ̈ڍ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 ł́A1.0.9 ȍ~̌po[Wł́ALinuxDoc DTD T|[
  gȂƂmɂȂ̂ŁADocBook ւ̈ڍs܂ł̎b[
  uƂ LinuxDoc-Tools ւƖ̂ύXAbug fix ł݂̂[X
  邱ƂɂȂ܂BāAꂩ LinuxDoc DTD gĕ
  ꍇ́ALinuxDoc-Tools g悤ɂĂB

  {Ή LinuxDoc-Tools ɂẮÃTCgB

  <http://www.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 pĂ܂BjLinuxDoc-
  SGML  SGML-Tools ւ̈ڍsɂ DTD ̎dlύXꂽ
  ŁA<hrule>  <faq> Ƃvf͌ݗpłȂȂĂ܂B܂
  {ꉻpb` sgml-tools-1.0.9.jf7.diff.gz ɂ̓oO邱ƂmF
  Ă܂BāAȂׂL LinuxDoc-Tools gB

  ̏L LinuxDoc-Tools  SRPM  linuxdoc-tools-0.9.1-0v13.src.rpm
  <ftp://ftp.jaist.ac.jp/pub/os/linux/Vine/VineSeed/SRPMS/linuxdoc-
  tools-0.9.1-0vl3.src.rpm> œł܂B

  ܂AȑÕo[Wł͂܂Adiff.sgml-tools-1.0.9.jf6.gz
  g SRPM sgml-tools-1.0.9_jp-6.2.src.rpm
  <ftp://ftp.jaist.ac.jp/pub/os/linux/Vine/Vine-2.0/SRPMS/SRPMS/sgml-
  tools-1.0.9_jp-6.2.src.rpm> ܂B͍ŐVłɔrƂ
  ̋@\܂܂Ă܂񂪁A{Iȓɖ͖͂łB
  RPM pbP[Wgꍇɂ͂Ă݂Ɨǂł傤B

  2.1.2.  ̑ LinuxDoc DTD ϊc[

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

   LDP ł͍ŋ DocBook DTD SGML ւ̈ڍsXɐi߂ĂĂ
  Aϊ̂߂ jade 𗘗p Makefile pĂ܂B
  A݂ł DocBook XML ̐߂ĂAXML ŋLq
  JĂ܂B

  ɁASGMLtools т̌pł SGMLtools-Lite  LinuxDoc DTD
  ̃T|[gp~Ă܂̂ŁA LinuxDoc DTD T|[gĂ
  c[ XFree86  doctools AɂĂ DocBook DTD 
  ̈ڍsi߂ LinuxDoc DTD ̃T|[g͔p~Ă܂\
  ƂŁAߋ̕𗘗pł悤ɂ邽߂ SGML-Tools v1 x[
  X̐VR[hƂ LinuxDoc-Tools JĂƂv撆łB
  (ꂪ[Xł LDP c[Ƃėp悤ɂȂ
  ͂łBȂALinuxdocTR Ƃċʂ <trans>A<tdate> Ȃǂ̗vf
   LinuxDoc-Tools ł LinuxDoc DTD ̒ɓĂ܂ƍlĂ
  B̂ւ XFree86  doctools ւ̃pb`̕Ƃł̂
  ڂ͏ȗ܂B)

  2.1.2.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 ۂȂǂYĂ܂Ƃ
  ŁAӂ܂傤B

  2.2.  DocBook DTD

  DocBook DTD ̏c[ł jade Ȃǂł͓ EUC-JP ȓ{ꕶ
  Ă html ւ̕ϊɌΖ͖悤łBtext ւ̕ϊ html
  oR w3m Ŏs邽ߖ肠܂B_ł̖
  TeXAPSAPDF ւ̏o͂ŗpĂ jadetex {ΉĂȂ
  ɂ̃tH[}bgւ̏o͂ƂłȂƁAсALDP 
  PS, PDF ւ̕ϊɗpĂ HTMLDOC }`oCgɑΉĂ
  ƁAȂǂ܂B

  JF ł̍̓WJƂẮADocBook DTD ȕ̕ϊɂ LDP 
  ̋c_QlɂȂ猈߂ĂƂȂǂKvɂȂƎv܂B

  2.2.1.  DocBook ̃c[

  APꂨѕ html o͂ text o͂sĂ܂B html o
  ɂ́Ajade Atext o͂ɂ́Ajade + w3m p܂B

  ̕ html o͂܂łs߂̃c[Ɋւ́A LDP
  Authors Guide () ̔łBڍׂ́ALDP Authors Guide 
  B

  2.2.1.1.  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̂ɕϊ
  BDSSSL Ɋւ镶͉L Norman Walsh DSSSL ̃y[Wɂ܂B
  DSSSL C邱Ƃ́ADocBook ̂C邱Ƃɂ͂ȂȂ_ɒ
  ĂB_OꂽeLXǧhςĂɂ܂
  B JF ł́A܂AHTML o͂ƂɂeLXgo͂sĂ
  Ȃ̂ŁAL HTML pDSSSL gĂ܂B

  ʏ Walsh o[W DSSSL ł Norman Walsh DSSSL A܂A
  肵ĂB

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

  jf-custom.dsl ɁAWalsh o[W DSSSL ǂɂ邩Lq
  Bt@C̐擪̂悤ɏ܂B </
    <!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

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

  2.2.1.2.  DocBook DTD

  DocBook ́Av4.1 [XĂ܂A (2001/03/25)AJF 
  ́AΉłB

  ́AJF ̃rh Debian potato 𗘗pĂāApotato 
  DocBook 4.1 ̃pbP[WłB

  o[W 3.1 肵܂B

  2.2.1.3.  Jade

  html ւ̕ϊɎgp܂B Jade 肵ACXg[܂B

  2.2.1.4.  w3m

  eLXgւ̕ϊɎgp܂B w3m ̃o[W 0.2.1 肵ÃR
  }hɂACXg[܂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.5.  rpm ɂCXg[

  jade ́Ajade-1.2.1-9j1.i386ɂ܂B

  Jade wrapper ́Acygnus-tools ƂāARed Hat 6.2 ɕtĂ܂B
  ÃpbP[WCXg[Ă邩mFĂB

  o  sgml-common-0.1-8.noarch

  o  docbook-3.1-4.noarch

  o  stylesheets-1.54.13rh-1.noarch

  ŐVo[ẂARed Hat ̃EFuTCgɂ܂B

  2.2.1.6.  ϊ̃R}h

  ꂽ html o

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

  P html o

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

  eLXgo

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

  u<ulink url="http://www.linuxdoc.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쐬
  ܂ (filename.html Ƃ܂)B

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

  OL̗ŁAeLXgo͂́A

  uLDP ("http://www.linuxdoc.org/") A\łBv

  ƂȂ܂B

  ɍ쐬΂̒P html o͂pAeLXgɕϊ܂B

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

  2.2.1.7.  cygnus tools ̎gp

  db2html gƁATufBNg쐬A̒ɁAꂽ html
  ɕϊĂ܂B

  @

  jf-custom.dsl gp悤ɁAdb2html ̐擪̂悤ҏW
  B

    #! /bin/sh

  + <!--
    DB_STYLESHEET=/usr/lib/sgml/stylesheets/cygnus-both.dsl
  + -->
  + DB_STYLESHEET=/usr/local/lib/sgml/stylesheets/jf-custom.dsl
    HTML_STYLESHEET=/usr/lib/sgml/stylesheets/nwalsh-modular/test/docbook.css

  TufBNgւ̕ html o͂́A

  db2html filename.sgml

  Ƃ܂Bfilename ƂfBNg̉ɏo͂܂B

  db2html ŕ html, eLXgxɍ쐬ꍇ́AL̕ҏWɎ
  ŁAt@C̐^񒆂ȉ̂悤ɕҏW܂B
    # we used to generate a single file, but with the modular DB_STYLESHEETs
    # it's best to make a new directory with several html files in it
    #cat $* | jade -d $DB_STYLESHEET -t sgml -V nochunks > $TMPFN
  + cat $* | jade -d $DB_STYLESHEET\#html -t sgml -i html \
  +   -V nochunks -V "%show-ulinks%" | \
  +     w3m -T text/html -S -dump -cols 72 > $output.txt

  gp@́A

  db2html filename.sgml

  ŁAfBNg filename.txt A filename ƂfBNg
  ɕhtmlo͂܂B

   db2html  /usr/bin/db2jf ƂĎgƂ܂B

  2.2.1.8.  PSGML

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

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

  ǵALDP Authors Guide ̕ҏWc[B

  2.2.1.9.  |ɂ

  |҂̒ǋ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">
      <firstname>_</firstname>
      <surname>{</surname>
      <contrib>{|</contrib>
      <affiliation>
        <address>
         <email>hng@ps.ksky.ne.jp</email>
        </address>
      </affiliation>
     </othercredit>
    </authorgroup>

  2.2.1.10.  ł̒ҕ\L

  ҂ŏ@́Aȉ̂悤ɂ܂B

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

  2.3.  DocBook XML

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

    <?xml version="1.0"?>

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

  XML `́AGg (<xref id="xxx"/> Ȃ <hoge></hoge> ̌`
  ȂĂȂ)̈āA SGML DocBook Ɠ͂Ȃ̂ŁA`
  ̕

    <!doctype article public "-//OASIS//DTD DocBook V3.1//EN" [

  ɏ܂Bۂɂ́AXML ̕^錾̓RgAEg
  āADocBook SGML V3.1 ɏCĂB

  ܂A<articleinfo>  </articleinfo> ꍇ́Aꂼ
  A<artheader>, </artheader> ɏ܂B

  łAjade G[ꍇɂ́AJF-ML Ɏ₵܂傤B

  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.  gȂ

  ȉ͂̕ꂼEɎ悤ɏĉBeLXg HTML ֕ϊ
  鎞ɈӐ}ɒu܂B

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

  DocBook ̏ꍇA݂̕ϊn (jade + w3m) ŁAgȂ "<"
   "&" łA㏈n[ĂƂӂ݁Ã[
  ]ĂƂ߂܂B

     `_ "~" (~)

        o  LinuxDoc  LinuxDocTR  &tilde;

        o  DocBook  &#126;

     p ([)
         &lsqb;

     Ep (])
         &rsqb;

     ApTh (&)
         &amp;

     s (<)
         &lt;

     Es (>)
         &gt;

     s{XbV (</)

        o  LinuxDoc  LinuxDocTR  &etago;

        o  DocBook  &lt;&sol;

     h}[N ($)
         &dollar;

     V[v (#)
         &num;

     p[Zg (%)
         &percnt;

     obNXbV (\)
         &bsol;

     dp (")

        o  LinuxDoc  LinuxDocTR  &dquot;

        o  DocBook  &quot;

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

  3.3.  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.  LinuxDoc  DocBook ւ̕ϊ̒

  LinuxDoc DTD ɂ́AƎɊgĂ SGML GeBeBADocBook
  DTD ŁÂ܂܂ł͎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.  C (^O)

  ̏͂̋Lq́ALinuxDoc DTD gꍇ̏C^OłB DocBook DTD
  gꍇ́Adocbook-intro  LDP-Author-Guide( name="">) 
   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 sgml2html ɂ 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 sgml2txt ɂ

  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 (jLinuxDoc-SGML) ł̉ӏ

       o   1

       o   2

       o   3

          ȕɂȂ܂B

  Əo͂ꍇ

       <tt/SGML (jLinuxDoc-SGML)/ ł̉ӏ
       <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.  摜̑}ƕ\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 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 B

  6.  R}h

  o  @`FbN sgmlcheck

  o  eLXgւ̕ϊ sgml2txt -l ja -c nippon (v1.09j ̏ꍇ)

  o  HTML ւ̕ϊ sgml2html -l ja -c nippon (v1.09j ̏ꍇBI
     vVłϊ͉\炵)

  łBȂAsgml2html ł͊e <sect> Ƃɕʂ html t@CɂȂ܂
  ATCY̏ȕł͑ŜЂƂ html t@Cɂ܂Ƃ߂Ƃ
  ꍇ܂B̂悤ȏꍇɂ sgml21html ֗ł
  Bsgml21html  JF  Web site ł܂B

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

  7.  QlȂ

  7.1.  FAQ уKCh

   SGML ɂĂƏڂm肽΁A܂ jLinuxDoc-SGML ̃\
  [XɊ܂܂Ă FAQj  jguide ǂނƂ߂܂B 2 
  ̓̕eLXg^ (.txt) ̂̂ SGML ^ (.sgml) ̂̂p
  ӂĂ̂ŁAeLXgȂ SGML QƂƂ낢Ə
  ̎QlɂȂ܂BA̒ŐĂ^O̒
  ́ASGML-Tools 1.0.9j ł͎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

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

  7.3.  HTML ɂ

  SGML ̂̂ɂĂł͂܂񂪁Asgml2html ł̏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>

  7.4.  ֗ȃc[

  ܂AL JF ̃y[Wɂ́uSGML 쐬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

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

  ȂADebian ̊Jłł potato ɂ yasgml ̃pbP[W܂܂
  ܂BDebian [U[́̕ACXg[ƕ֗ł
  B

  7.5.  DocBook DTD, jade

  ŋ߁ADebian ̃o[ł Stephane Bortzmeyer
  <bortzmeyer@pasteur.fr> 

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

  ƂČJĂ܂B Debian/Debian JP o[̕
  񂪖|󂵂ĂāA Stephane ̂ƂɂĂ̂ł̂
  {łJł傤B

  

     What you really need to know about SGML
        <http://www.debian.org/~bortz/SGML-HOWTO/potato/x59.html>

     Creating documentation with DocBook
        <http://www.debian.org/~bortz/SGML-HOWTO/potato/x165.html>

     Creating documentation with LinuxDoc
        <http://www.debian.org/~bortz/SGML-HOWTO/potato/x255.html>

     References
        <http://www.debian.org/~bortz/SGML-HOWTO/potato/x384.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/tutorials/docproj-primer/book.html>

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

     John Fieber, DocBook Resources
        <http://fallout.campusview.indiana.edu/~jfieber/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)

  ܂Ajade ̎gɂẴTvȉ̏ꏊɂ悤łB

     an (English) example of jade usage
        <http://www.wi.LeidenUniv.nl/~jdassen/onderwijs/stuva/debug/>

  8.  

  ̕ 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

  8.1.  ̔̕zzɂ

   copyrighted (c) 1999 Taketoshi Sano

  ̕ 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

  8.2.  CREDITS

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

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

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

