Changeset 50d3491


Ignore:
Timestamp:
06/14/2004 04:35:14 AM (17 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, krejzi/svn, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
44b376e
Parents:
5d1668d
Message:

XML update for Chapter 43

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2320 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
9 edited

Legend:

Unmodified
Added
Removed
  • general.ent

    r5d1668d r50d3491  
    333333
    334334<!-- Chapter 43 -->
    335 
     335<!ENTITY sgml-common-version          "0.6.3">
     336<!ENTITY sgml-dtd-3-version           "3.1">   
     337<!ENTITY sgml-dtd-version             "4.3">   
     338<!ENTITY opensp-version               "1.5.1">
     339<!ENTITY openjade-version             "1.3.2">   
    336340<!ENTITY docbook-dsssl-version        "1.78">
     341
    337342<!-- Chapter 44 -->
     343<!ENTITY DocBook-version              "4.3">
     344
     345
    338346<!-- Chapter 45 -->
    339347<!-- Chapter 46 -->
  • pst/pst.xml

    r5d1668d r50d3491  
    55<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pst/printing/printing.xml"/>
    66<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pst/scanning/scanning.xml"/>
     7<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pst/sgml/sgml.xml"/>
    78
    8 <!-- &pst-scanning; -->
    9 &pst-sgml;
     9
     10<!-- &pst-sgml; -->
    1011&pst-xml;
    1112&pst-ps;
  • pst/sgml/docbook-dsssl.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY docbook-dsssl-download-http "http://prdownloads.sourceforge.net/docbook/docbook-dsssl-&docbook-dsssl-version;.tar.gz">
     7  <!ENTITY docbook-dsssl-download-ftp  " ">
     8  <!ENTITY docbook-dsssl-size          "384 KB">
     9  <!ENTITY docbook-dsssl-buildsize     "4 MB">
     10  <!ENTITY docbook-dsssl-time          "0.01 SBU">
     11]>
     12
    113<sect1 id="docbook-dsssl" xreflabel="DocBook DSSSL Stylesheets-&docbook-dsssl-version;">
    214<?dbhtml filename="docbook-dsssl.html"?>
    315<title>DocBook DSSSL Stylesheets-&docbook-dsssl-version;</title>
    416
    5 &docbook-dsssl-intro;
    6 &docbook-dsssl-inst;
    7 &docbook-dsssl-exp;
    8 &docbook-dsssl-config;
    9 &docbook-dsssl-desc;
     17<sect2>
     18<title>Introduction to <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application></title>
     19
     20<para>The <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application> package
     21contains <acronym>DSSSL</acronym> stylesheets. These are
     22used by <application>OpenJade</application> or other tools to transform
     23<acronym>SGML</acronym> and <acronym>XML</acronym> DocBook files.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&docbook-dsssl-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&docbook-dsssl-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &docbook-dsssl-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &docbook-dsssl-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &docbook-dsssl-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title><application>DocBook <acronym>DSSSL</acronym> Stylesheets</application> dependencies</title>
     35<sect4><title>Required</title>
     36<para><xref linkend="sgml-common"/></para></sect4>
     37</sect3>
     38
     39
     40
     41</sect2>
     42
     43<sect2>
     44<title>Installation of <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application></title>
     45
     46<para>Install <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application> by running the following commands:</para>
     47
     48<screen><userinput><command>mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
     49mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
     50mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
     51mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
     52mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
     53mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/test &amp;&amp;
     54mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
     55install bin/collateindex.pl /usr/bin &amp;&amp;
     56cp catalog VERSION /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
     57cp dtds/decls/*.dcl \
     58    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
     59cp lib/dblib.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
     60cp common/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
     61cp common/*.ent /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
     62cp html/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
     63cp lib/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
     64cp print/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
     65cp images/*.gif /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
     66install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
     67    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/catalog &amp;&amp;
     68install-catalog --add /etc/sgml/sgml-docbook.cat \
     69    /etc/sgml/dsssl-docbook-stylesheets.cat</command></userinput></screen>
     70
     71</sect2>
     72
     73<sect2>
     74<title>Command explanations</title>
     75
     76<para>Above commands create a <command>make install</command> script
     77for this package.</para>
     78
     79</sect2>
     80
     81<sect2>
     82<title>Configuring <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application></title>
     83
     84<sect3><title>Configuration Information</title>
     85
     86<para>The following configuration is necessary in order to utilize
     87<application>OpenJade</application> to convert the <acronym>BLFS</acronym>
     88Book from <acronym>XML</acronym> to <acronym>HTML</acronym>:</para>
     89<screen><userinput><command>ln -sf <replaceable>[your home directory]</replaceable>/BLFS/BOOK/blfs.dsl \
     90    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html/</command></userinput></screen>
     91
     92</sect3>
     93
     94</sect2>
     95
     96<sect2>
     97<title>Contents</title>
     98
     99<para>The <application>DocBook <acronym>DSSSL</acronym> Stylesheets</application> package
     100contains <acronym>DSSSL</acronym> stylesheets and <command>collateindex.pl</command>.</para>
     101
     102</sect2>
     103
     104<sect2><title>Description</title>
     105
     106<sect3><title>collateindex.pl</title>
     107<para><command>collateindex.pl</command> is a
     108<application>Perl</application> script that creates a DocBook index
     109from raw index data. </para></sect3>
     110
     111</sect2>
    10112
    11113</sect1>
  • pst/sgml/openjade.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY openjade-download-http "http://prdownloads.sourceforge.net/openjade/openjade-&openjade-version;.tar.gz">
     7  <!ENTITY openjade-download-ftp  "ftp://ftp.freestandards.org/pub/lsb/app-battery/packages/openjade-&openjade-version;.tar.gz">
     8  <!ENTITY openjade-size          "880 KB">
     9  <!ENTITY openjade-buildsize     "14.5 MB">
     10  <!ENTITY openjade-time          "1.51 SBU">
     11]>
     12
    113<sect1 id="openjade" xreflabel="OpenJade-&openjade-version;">
    214<?dbhtml filename="openjade.html"?>
    315<title>OpenJade-&openjade-version;</title>
    416
    5 &openjade-intro;
    6 &openjade-inst;
    7 &openjade-exp;
    8 &openjade-config;
    9 &openjade-desc;
     17<sect2>
     18<title>Introduction to <application>OpenJade</application></title>
     19
     20<para>The <application>OpenJade</application> package contains a
     21<acronym>DSSSL</acronym> engine. This is useful for
     22<acronym>SGML</acronym> and <acronym>XML</acronym> transformations into
     23<acronym>RTF</acronym>, TeX, <acronym>SGML</acronym>
     24and <acronym>XML</acronym>.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&openjade-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&openjade-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &openjade-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&openjade-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&openjade-time;</para></listitem></itemizedlist>
     37</sect3>
     38
     39<sect3><title><application>OpenJade</application> dependencies</title>
     40<sect4><title>Required</title>
     41<para><xref linkend="opensp"/></para></sect4>
     42</sect3>
     43
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>OpenJade</application></title>
     48
     49<para>Install <application>OpenJade</application> by running the following commands:</para>
     50
     51<screen><userinput><command>./configure --prefix=/usr --enable-http --disable-static \
     52    --enable-default-catalog=/etc/sgml/catalog \
     53    --enable-default-search-path=/usr/share/sgml \
     54    --datadir=/usr/share/sgml/openjade-&openjade-version; &amp;&amp;
     55make &amp;&amp;
     56make install &amp;&amp;
     57ln -sf openjade /usr/bin/jade &amp;&amp;
     58ln -sf libogrove.so /usr/lib/libgrove.so &amp;&amp;
     59ln -sf libospgrove.so /usr/lib/libspgrove.so &amp;&amp;
     60ln -sf libostyle.so /usr/lib/libstyle.so &amp;&amp;
     61install -m644 dsssl/catalog /usr/share/sgml/openjade-&openjade-version;/ &amp;&amp;
     62install -m644 dsssl/*.dtd dsssl/*.dsl dsssl/*.sgm \
     63    /usr/share/sgml/openjade-&openjade-version; &amp;&amp;
     64install-catalog --add /etc/sgml/openjade-&openjade-version;.cat \
     65    /usr/share/sgml/openjade-&openjade-version;/catalog &amp;&amp;
     66install-catalog --add /etc/sgml/sgml-docbook.cat \
     67    /etc/sgml/openjade-&openjade-version;.cat</command></userinput></screen>
     68
     69</sect2>
     70
     71<sect2>
     72<title>Command explanations</title>
     73
     74<para><option>--disable-static</option>: This switch prevents
     75the building of the static library.</para>
     76
     77<para><option>--enable-http</option>: This switch adds support
     78for <acronym>HTTP</acronym>.</para>
     79
     80<para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This
     81switch sets the path to the centralized catalog.</para>
     82
     83<para><option>--enable-default-search-path</option>: This switch
     84sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
     85
     86<para><parameter>--datadir=/usr/share/sgml/openjade-&openjade-version;</parameter>: This switch puts data files in
     87<filename>/usr/share/sgml/openjade-&openjade-version;</filename> instead of
     88<filename class="directory">/usr/share</filename>.</para>
     89
     90<para><screen><command>ln -sf openjade /usr/bin/jade
     91ln -sf libogrove.so /usr/lib/libgrove.so
     92ln -sf libospgrove.so /usr/lib/libspgrove.so
     93ln -sf libostyle.so /usr/lib/libstyle.so</command></screen>
     94These commands create the Jade equivalents of OpenJade executables and
     95libraries.</para>
     96
     97</sect2>
     98
     99<sect2>
     100<title>Configuring OpenJade</title>
     101
     102<sect3><title>Configuration Information</title>
     103
     104<screen><userinput><command>echo "SYSTEM \"http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd\" \
     105    \"/usr/share/xml/docbook/xml-dtd-&DocBook-version;/docbookx.dtd\"" &gt;&gt; \
     106    /usr/share/sgml/openjade-&openjade-version;/catalog</command></userinput></screen>
     107<para>This configuration is only necessary if you intend to use
     108<application>OpenJade</application> to process the
     109<acronym>BLFS</acronym> <acronym>XML</acronym> files through
     110<acronym>DSSSL</acronym> Stylesheets.
     111</para>
     112</sect3>
     113
     114</sect2>
     115
     116<sect2>
     117<title>Contents</title>
     118
     119<para>The <application>OpenJade</application> package contains
     120<command>openjade</command>.</para>
     121
     122</sect2>
     123
     124<sect2><title>Description</title>
     125
     126<sect3><title>openjade</title>
     127<para><command>openjade</command> is a <acronym>DSSSL</acronym> engine used for transformations.</para></sect3>
     128
     129
     130</sect2>
    10131
    11132</sect1>
  • pst/sgml/opensp.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY opensp-download-http "http://download.sourceforge.net/openjade/OpenSP-&opensp-version;.tar.gz">
     7  <!ENTITY opensp-download-ftp  " ">
     8  <!ENTITY opensp-size          "1.4 MB">
     9  <!ENTITY opensp-buildsize     "37 MB">
     10  <!ENTITY opensp-time          "1.50 SBU">
     11]>
     12
    113<sect1 id="opensp" xreflabel="OpenSP-&opensp-version;">
    214<?dbhtml filename="opensp.html"?>
    315<title>OpenSP-&opensp-version;</title>
    416
    5 &opensp-intro;
    6 &opensp-inst;
    7 &opensp-exp;
    8 &opensp-desc;
     17<sect2>
     18<title>Introduction to <application>OpenSP</application></title>
     19
     20<para>The <application>OpenSP</application> package contains a
     21<application>C++</application> library for using
     22<acronym>SGML</acronym>/<acronym>XML</acronym> files.
     23This is useful for validating, parsing and manipulating
     24<acronym>SGML</acronym> and <acronym>XML</acronym>
     25documents.</para>
     26
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&opensp-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&opensp-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &opensp-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&opensp-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&opensp-time;</para></listitem></itemizedlist>
     38</sect3>
     39<sect3><title>Additional downloads</title>
     40<itemizedlist spacing='compact'>
     41<listitem><para>Required Patch: <ulink url="&patch-root;/OpenSP-&opensp-version;-LITLEN.patch"/></para></listitem>
     42</itemizedlist></sect3>
     43
     44<sect3><title><application>OpenSP</application> dependencies</title>
     45<sect4><title>Required</title>
     46<para><xref linkend="sgml-common"/></para></sect4>
     47</sect3>
     48
     49</sect2>
     50
     51<sect2>
     52<title>Installation of <application>OpenSP</application></title>
     53
     54<para>This patch removes some annoying messages that can appear while
     55running <command>openjade</command>:</para>
     56
     57<screen><userinput><command>patch -Np1 -i ../OpenSP-&opensp-version;-LITLEN.patch</command></userinput></screen>
     58
     59<para>Install <application>OpenSP</application> by running the following commands:</para>
     60
     61<screen><userinput><command>./configure --prefix=/usr --disable-static --enable-http \
     62    --enable-default-catalog=/etc/sgml/catalog \
     63    --enable-default-search-path=/usr/share/sgml &amp;&amp;
     64make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; &amp;&amp;
     65make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install &amp;&amp;
     66ln -sf onsgmls /usr/bin/nsgmls &amp;&amp;
     67ln -sf osgmlnorm /usr/bin/sgmlnorm &amp;&amp;
     68ln -sf ospam /usr/bin/spam &amp;&amp;
     69ln -sf ospcat /usr/bin/spcat &amp;&amp;
     70ln -sf ospent /usr/bin/spent &amp;&amp;
     71ln -sf osx /usr/bin/sx &amp;&amp;
     72ln -sf osx /usr/bin/sgml2xml &amp;&amp;
     73ln -sf libosp.so /usr/lib/libsp.so &amp;&amp;
     74install-catalog --add /etc/sgml/OpenSP-&opensp-version;.cat \
     75    /usr/share/sgml/OpenSP-&opensp-version;/catalog &amp;&amp;
     76install-catalog --add /etc/sgml/sgml-docbook.cat \
     77    /etc/sgml/OpenSP-&opensp-version;.cat</command></userinput></screen>
     78
     79<tip><title>Update hint</title>
     80<para>Remove the above catalog items prior to upgrading with:
     81<screen><command>install-catalog --remove /etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat \
     82    /usr/share/sgml/OpenSP-<replaceable>[version]</replaceable>/catalog &amp;&amp;
     83install-catalog --remove /etc/sgml/sgml-docbook.cat \
     84    /etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat</command></screen></para></tip>
     85
     86</sect2>
     87
     88<sect2>
     89<title>Command explanations</title>
     90
     91<para><option>--disable-static</option>: This switch prevents
     92the building of the static library.</para>
     93
     94<para><option>--enable-http</option>: This switch adds support
     95for <acronym>HTTP</acronym>.</para>
     96
     97<para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This
     98switch sets the path to the centralized catalog.</para>
     99
     100<para><option>--enable-default-search-path</option>: This switch
     101sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
     102
     103<para><option>--enable-xml-messages</option>: This switch adds
     104support for <acronym>XML</acronym> Formatted Messages.</para>
     105
     106<para><command>make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</command>: This
     107sets the pkgdatadir variable in the <filename>Makefile</filename> from
     108<filename class="directory">/usr/share/OpenSP</filename> to
     109<filename class="directory">/usr/share/sgml/OpenSP-1.5</filename>.</para>
     110
     111<para><screen><command>ln -sf onsgmls /usr/bin/nsgmls
     112ln -sf osgmlnorm /usr/bin/sgmlnorm
     113ln -sf ospam /usr/bin/spam
     114ln -sf ospcat /usr/bin/spcat
     115ln -sf ospent /usr/bin/spent
     116ln -sf osx /usr/bin/sx
     117ln -sf osx /usr/bin/sgml2xml
     118ln -sf libosp.so /usr/lib/libsp.so</command></screen>
     119These commands create the <application>SP</application> equivalents of
     120<application>OpenSP</application> executables and
     121libraries.</para>
     122
     123</sect2>
     124
     125<sect2>
     126<title>Contents</title>
     127
     128<para>The <application>OpenSP</application> package contains <command>onsgmls</command>,
     129<command>ospam</command>, <command>osx</command>,
     130<command>ospcat</command> and
     131<command>ospent</command>.</para>
     132
     133
     134</sect2>
     135
     136<sect2><title>Description</title>
     137
     138<sect3><title>onsgmls</title>
     139<para><command>onsgmls</command> processes <acronym>SGML</acronym> files.</para></sect3>
     140
     141<sect3><title>ospam</title>
     142<para><command>ospam</command> is a markup stream editor.</para></sect3>
     143
     144<sect3><title>osx</title>
     145<para><command>osx</command> is a <acronym>SGML</acronym> normalizer or a
     146converter of <acronym>SGML</acronym> to <acronym>XML</acronym>.</para></sect3>
     147
     148<sect3><title>ospcat</title>
     149<para><command>ospcat</command> prints effective system identifiers found in the
     150catalogs.</para></sect3>
     151
     152<sect3><title>ospent</title>
     153<para><command>ospent</command> provides access to
     154<application>OpenSP</application>'s entity manager.</para></sect3>
     155
     156</sect2>
    9157
    10158</sect1>
  • pst/sgml/sgml-common.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY sgml-common-download-http "http://gd.tuwien.ac.at/hci/kde/devel/docbook/SOURCES/sgml-common-&sgml-common-version;.tgz">
     7  <!ENTITY sgml-common-download-ftp  "ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/sgml-common-&sgml-common-version;.tgz">
     8  <!ENTITY sgml-common-size          "75 KB">
     9  <!ENTITY sgml-common-buildsize     "648 KB">
     10  <!ENTITY sgml-common-time          "0.00 SBU">
     11]>
     12
    113<sect1 id="sgml-common" xreflabel="SGML Common-&sgml-common-version;">
    214<?dbhtml filename="sgml-common.html"?>
    315<title>SGML Common-&sgml-common-version;</title>
    416
    5 &sgml-common-intro;
    6 &sgml-common-inst;
    7 &sgml-common-config;
    8 &sgml-common-desc;
     17<sect2>
     18<title>Introduction to <application><acronym>SGML</acronym> Common</application></title>
     19
     20<para>The <application><acronym>SGML</acronym> Common package</application>
     21contains <command>install-catalog</command>. This is useful
     22for creating and maintaining centralized <acronym>SGML</acronym> catalogs.</para>
     23
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink
     27url="&sgml-common-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink
     29url="&sgml-common-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &sgml-common-size;</para></listitem>
     31<listitem><para>Estimated Disk space required:
     32&sgml-common-buildsize;</para></listitem>
     33<listitem><para>Estimated build time:
     34&sgml-common-time;</para></listitem></itemizedlist>
     35</sect3>
     36
     37<sect3><title>Additional downloads</title>
     38<itemizedlist spacing='compact'>
     39<listitem><para>Required Patch: <ulink url="&patch-root;/sgml-common-&sgml-common-version;-manpage-1.patch"/></para></listitem>
     40</itemizedlist></sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application><acronym>SGML</acronym> Common</application></title>
     46
     47<para>First apply the patch</para>
     48
     49<screen><userinput><command>patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch</command></userinput></screen>
     50
     51<para>The autotools files included with sgml-common are old. Use the following
     52commands to regenerate the files.</para>
     53
     54<screen><userinput><command>aclocal &amp;&amp;
     55automake -acf &amp;&amp;
     56autoconf</command></userinput></screen>
     57
     58<para>Install <application><acronym>SGML</acronym> Common</application> by
     59running the following commands:</para>
     60
     61<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     62make &amp;&amp;
     63make install &amp;&amp;
     64install-catalog --add /etc/sgml/sgml-ent.cat \
     65    /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
     66install-catalog --add /etc/sgml/sgml-docbook.cat \
     67    /etc/sgml/sgml-ent.cat</command></userinput></screen>
     68
     69<tip><title>Update hint</title>
     70<para>Remove the above catalog items prior to upgrading with:
     71<screen><command>install-catalog --remove /etc/sgml/sgml-ent.cat \
     72    /usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
     73install-catalog --remove /etc/sgml/sgml-docbook.cat \
     74    /etc/sgml/sgml-ent.cat</command></screen></para></tip>
     75</sect2>
     76
     77<sect2>
     78<title>Configuring <application><acronym>SGML</acronym>-common</application></title>
     79
     80<sect3><title>Config files</title>
     81<para><filename>/etc/sgml/sgml.conf</filename></para>
     82</sect3>
     83
     84<sect3><title>Configuration Information</title>
     85
     86<para>No change in this file is necessary.</para>
     87</sect3>
     88
     89</sect2>
     90
     91<sect2>
     92<title>Contents</title>
     93
     94<para>The <application><acronym>SGML</acronym> Common</application> package contains
     95<command>install-catalog</command>,
     96<command>sgmlwhich</command>, <acronym>SGML</acronym> entities
     97files and <acronym>XML</acronym> entities files.</para>
     98
     99</sect2>
     100
     101<sect2><title>Description</title>
     102
     103<sect3><title>install-catalog</title>
     104<para><command>install-catalog</command> creates a centralized catalog that
     105maintains references to catalogs scattered throughout the
     106<filename class="directory">/usr/share/sgml</filename> directory tree.</para></sect3>
     107
     108<sect3><title>sgmlwhich</title>
     109<para><command>sgmlwhich</command> will print to standard output the name of
     110the main configuration file.</para></sect3>
     111
     112<sect3><title>SGML entities files</title>
     113<para><acronym>SGML</acronym> entities files contain the basic character
     114entities defined with <acronym>SDATA</acronym> entries.</para></sect3>
     115
     116<sect3><title>XML entities files</title>
     117<para><acronym>XML</acronym> entities files contain the basic character
     118entities defined by a hexadecimal representation of the Unicode character
     119number.</para></sect3>
     120
     121</sect2>
    9122
    10123</sect1>
  • pst/sgml/sgml-dtd-3.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY sgml-dtd-3-download-http "http://www.docbook.org/sgml/3.1/docbk31.zip">
     7  <!ENTITY sgml-dtd-3-download-ftp  "ftp://ftp.rutgers.edu/pub/kde/devel/docbook/SOURCES/docbk31.zip">
     8  <!ENTITY sgml-dtd-3-size          "60 KB">
     9  <!ENTITY sgml-dtd-3-buildsize     "336 KB">
     10  <!ENTITY sgml-dtd-3-time          "0.01 SBU">
     11]>
     12
    113<sect1 id="sgml-dtd-3" xreflabel="DocBook SGML DTD-&sgml-dtd-3-version;">
    214<?dbhtml filename="sgml-dtd-3.html"?>
    315<title>DocBook SGML DTD-&sgml-dtd-3-version;</title>
    416
    5 &sgml-dtd-3-intro;
    6 &sgml-dtd-3-inst;
    7 &sgml-dtd-3-exp;
    8 &sgml-dtd-3-config;
    9 &sgml-dtd-3-desc;
     17<sect2>
     18<title>Introduction to <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     19
     20<para>The <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> package contains document type definitions for verification of
     21<acronym>SGML</acronym> data files against the DocBook rule set. These are
     22useful for structuring books and software documentation to a standard
     23allowing you to utilize transformations already written for that
     24standard.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&sgml-dtd-3-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&sgml-dtd-3-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &sgml-dtd-3-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&sgml-dtd-3-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&sgml-dtd-3-time;</para></listitem></itemizedlist>
     37</sect3>
     38
     39<sect3><title><application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> dependencies</title>
     40<sect4><title>Required</title>
     41<para><xref linkend="sgml-common"/></para></sect4>
     42</sect3>
     43
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     48
     49<para>Install <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> by running the following commands:</para>
     50
     51<screen><userinput><command>cp docbook.cat docbook.cat.orig &amp;&amp;
     52sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat &amp;&amp;
     53cp docbook.cat docbook.cat.orig &amp;&amp;
     54sed -e '/gml/d' docbook.cat.orig > docbook.cat &amp;&amp;
     55cp docbook.cat docbook.cat.orig &amp;&amp;
     56sed -e 's|DTDDECL "-//OASIS//DTD DocBook V&sgml-dtd-3-version;//EN"|SGMLDECL|g' \
     57    docbook.cat.orig > docbook.cat &amp;&amp;
     58install -d /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version; &amp;&amp;
     59chown -R root:root . &amp;&amp;
     60chmod -R 755 . &amp;&amp;
     61install docbook.cat /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &amp;&amp;
     62cp -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version; &amp;&amp;
     63install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-3-version;.cat \
     64    /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &amp;&amp;
     65install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-3-version;.cat \
     66    /etc/sgml/sgml-docbook.cat</command></userinput></screen>
     67
     68</sect2>
     69
     70<sect2>
     71<title>Command explanations</title>
     72
     73<para><screen><command>cp docbook.cat docbook.cat.orig
     74sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat
     75cp docbook.cat docbook.cat.orig
     76sed -e '/gml/d' docbook.cat.orig > docbook.cat</command></screen>
     77These commands remove the ENT definitions from the catalog file.</para>
     78
     79<para><screen><command>cp docbook.cat docbook.cat.orig
     80sed -e 's|DTDDECL "-//OASIS//DTD Docbook V&sgml-dtd-3-version;//EN"|SGMLDECL|g' \
     81    docbook.cat.orig > docbook.cat</command></screen>
     82This command replaces the DTDDECL catalog entry, which is not supported
     83by Linux <acronym>SGML</acronym> tools, with the SGMLDECL catalog entry.</para>
     84
     85</sect2>
     86
     87<sect2>
     88<title>Configuring <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     89
     90<sect3><title>Config files</title>
     91<para><filename>/etc/sgml/catalog</filename></para>
     92</sect3>
     93
     94<sect3><title>Configuration Information</title>
     95
     96<para>The above installation script updates the catalog.</para>
     97
     98<para>Using only the most current 3.x version of
     99<application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> requires the following:</para>
     100<screen><userinput><command>cat &gt;&gt; /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &lt;&lt; "EOF"</command>
     101  -- Begin Single Major Version catalog changes --
     102
     103PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"
     104
     105  -- End Single Major Version catalog changes --
     106<command>EOF</command></userinput></screen>
     107
     108</sect3>
     109
     110</sect2>
     111
     112<sect2>
     113<title>Contents</title>
     114
     115<para>The <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> package contains <filename>DTD</filename> files and
     116<filename>MOD</filename> files.</para>
     117
     118</sect2>
     119
     120<sect2><title>Description</title>
     121
     122<sect3><title>DTD files</title>
     123<para><filename>DTD</filename> files contain a document type definition which
     124defines the element types and the attribute lists that can be used in the
     125corresponding <acronym>SGML</acronym> files.</para></sect3>
     126
     127<sect3><title>MOD files</title>
     128<para><filename>MOD</filename> files contain components of the document type
     129definition that are sourced into the <filename>DTD</filename> files.</para></sect3>
     130
     131</sect2>
    10132
    11133</sect1>
  • pst/sgml/sgml-dtd.xml

    r5d1668d r50d3491  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY sgml-dtd-download-http "http://www.docbook.org/sgml/4.3/docbook-&sgml-dtd-version;.zip">
     7  <!ENTITY sgml-dtd-download-ftp  " ">
     8  <!ENTITY sgml-dtd-size          "76 KB">
     9  <!ENTITY sgml-dtd-buildsize     "389 KB">
     10  <!ENTITY sgml-dtd-time          "0.01 SBU">
     11]>
     12
    113<sect1 id="sgml-dtd" xreflabel="DocBook SGML DTD-&sgml-dtd-version;">
    214<?dbhtml filename="sgml-dtd.html"?>
    315<title>DocBook SGML DTD-&sgml-dtd-version;</title>
    416
    5 &sgml-dtd-intro;
    6 &sgml-dtd-inst;
    7 &sgml-dtd-exp;
    8 &sgml-dtd-config;
    9 &sgml-dtd-desc;
     17<sect2>
     18<title>Introduction to <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     19
     20<para>The <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> package contains document type definitions for verification of
     21<acronym>SGML</acronym> data files against the DocBook rule set. These are
     22useful for structuring books and software documentation to a standard
     23allowing you to utilize transformations already written for that
     24standard.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&sgml-dtd-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&sgml-dtd-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &sgml-dtd-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&sgml-dtd-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&sgml-dtd-time;</para></listitem></itemizedlist>
     37</sect3>
     38
     39<sect3><title><application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> dependencies</title>
     40<sect4><title>Required</title>
     41<para><xref linkend="sgml-common"/></para></sect4>
     42</sect3>
     43
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     48
     49<para>Install <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> by running the following commands:</para>
     50
     51<screen><userinput><command>cp docbook.cat docbook.cat.orig &amp;&amp;
     52sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat &amp;&amp;
     53cp docbook.cat docbook.cat.orig &amp;&amp;
     54sed -e '/gml/d' docbook.cat.orig > docbook.cat &amp;&amp;
     55install -d /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version; &amp;&amp;
     56chown -R root:root . &amp;&amp;
     57chmod -R 755 . &amp;&amp;
     58install docbook.cat /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &amp;&amp;
     59cp -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version; &amp;&amp;
     60install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-version;.cat \
     61    /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &amp;&amp;
     62install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-version;.cat \
     63    /etc/sgml/sgml-docbook.cat</command></userinput></screen>
     64
     65</sect2>
     66
     67<sect2>
     68<title>Command explanations</title>
     69
     70<para><screen><command>cp docbook.cat docbook.cat.orig
     71sed -e '/ISO 8879/d' docbook.cat.orig > docbook.cat
     72cp docbook.cat docbook.cat.orig
     73sed -e '/gml/d' docbook.cat.orig > docbook.cat</command></screen>
     74These commands remove the ENT definitions from the catalog file.</para>
     75
     76</sect2>
     77
     78<sect2>
     79<title>Configuring <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application></title>
     80
     81<sect3><title>Config files</title>
     82<para><filename>/etc/sgml/catalog</filename></para>
     83</sect3>
     84
     85<sect3><title>Configuration Information</title>
     86
     87<para>The above installation script updates the catalog.
     88</para>
     89
     90<para>Using only the most current 4.x version of <application>DocBook
     91<acronym>SGML</acronym> <acronym>DTD</acronym></application> requires the
     92following:</para>
     93<screen><userinput><command>cat &gt;&gt; /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &lt;&lt; "EOF"</command>
     94  -- Begin Single Major Version catalog changes --
     95
     96PUBLIC "-//OASIS//DTD DocBook V4.2//EN" "docbook.dtd"
     97PUBLIC "-//OASIS//DTD DocBook V4.1//EN" "docbook.dtd"
     98PUBLIC "-//OASIS//DTD DocBook V4.0//EN" "docbook.dtd"
     99
     100  -- End Single Major Version catalog changes --
     101<command>EOF</command></userinput></screen>
     102
     103</sect3>
     104
     105</sect2>
     106
     107<sect2>
     108<title>Contents</title>
     109
     110<para>The <application>DocBook <acronym>SGML</acronym> <acronym>DTD</acronym></application> package contains <filename>DTD</filename> files and
     111<filename>MOD</filename> files.</para>
     112
     113</sect2>
     114
     115<sect2><title>Description</title>
     116
     117<sect3><title>DTD files</title>
     118<para><filename>DTD</filename> files contain a document type definition which defines the
     119element types and the attribute lists that can be used in the
     120corresponding <acronym>SGML</acronym> files.</para></sect3>
     121
     122<sect3><title>MOD files</title>
     123<para><filename>MOD</filename> files contain components of the document type definition that
     124are sourced into the <filename>DTD</filename> files.</para></sect3>
     125
     126</sect2>
    10127
    11128</sect1>
  • pst/sgml/sgml.xml

    r5d1668d r50d3491  
     1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5]>
     6
    17<chapter id="pst-sgml">
    28<?dbhtml filename="sgml.html"?>
     
    814transform, format and publish DocBook documents.</para>
    915
    10 &sgml-common;
    11 &sgml-dtd-3;
    12 &sgml-dtd;
    13 &opensp;
    14 &openjade;
    15 &docbook-dsssl;
     16<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-common.xml"/>   
     17<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-dtd-3.xml"/>   
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-dtd.xml"/>   
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="opensp.xml"/>   
     20<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openjade.xml"/>   
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="docbook-dsssl.xml"/>   
    1622
    1723</chapter>
Note: See TracChangeset for help on using the changeset viewer.