G.2. ���߼�

����Ĺ������ڴ�����ĵ�����Щ�����ǿ�ѡ�ģ������б�ע�ˡ�

DocBook DTD

���� DocBook ����Ķ��塣����Ŀǰʹ�ð汾 4.2�� �㲻��ʹ�ø��»�����Щ�İ汾����ע�⻹��һ�� XML �汾�� DocBook — �ɱ�������

ISO 8879 �ַ���¼

���� DocBook ��Ҫ�ģ����Ƕ�����������Ϊ�������� ISO ά���ġ�

OpenJade

���Ǵ��� SGML �Ļ������� ������һ�� SGML ��������һ�� DSSSL ��������Ҳ����һ�� �� DSSSL ����� SGML ת����������ʽ�ij��򣩣�����һϵ����ع��ߡ� ���� Jade �� OpenJade ��ά������������ James Clark �ˡ�

DocBook DSSSL Stylesheets

��Щ���������� DocBook Դ����ת����������ʽ������ HTML���Ĵ���ָ�

DocBook2X ����

�����ѡ�İ������ڴ����ֲ�ҳ�ġ����Լ���һϵ�а�Ҫ���Ȱ�װ�� ��鿴��վ��

JadeTeX

�������Ҫ���㻹���԰�װ JadeTeX���� TeX ���� Jade ��һ�ָ�ʽ����ˡ� JadeTeX �������� Postscript ���� PDF �ļ�(���ߴ���ǩ)��

������JadeTeX ������� RTF ����Բ�һ��� ��ӡ�������Ҫ�DZ�ĸ�ʽ�͸�����ֱ��ˮƽ�Ŀհ�Ч���� ���ң��㻹û�л����ֹ���ɫ�������� �����������еúܺã���������Щ���ñ��ļ�Щ���ĵ���

�����Ѿ����ĵ��м�¼�˼��ְ�װ������ĵ�����ĸ��ֹ��ߵķ����� ����������������Ҳ������������������Щ���ߡ����� doc �ʼ��б� ������Щ����״̬�����Ǿͻ������������Щ��Ϣ��

G.2.1. Linux RPM ��װ

��๩Ӧ�������ǵİ汾���ṩ��һ���״��� DocBook �� RPM ���� ͨ���ǻ��� Red Hat Software �� docbook-tools �ġ���װ��ʱ������һ�� "SGML" ѡ��������а�֮һ�� sgml-common��docbook, stylesheets��openjade ���� jade�������ܻ���Ҫ sgml-tools�� �����İ汾û���ṩ��Щ��������ô��Ӧ�ÿ���ʹ������һЩ���� ������ݵķ����̵İ���

G.2.2. FreeBSD ��װ

FreeBSD �ĵ��ƻ�����ͷdz�Ƶ����ʹ�� DocBook�� ������ FreeBSD ����һ���׿����õ��ĵ����ߵ�"ports" ��һ��Ҳ������ˡ�Ҫ�� FreeBSD �������ĵ�������밲װ����� port��

�����ԣ����ڻ�û�� DocBook V4.2 SGML DTD �� port������Ҫ�ֹ���װ����

�ܶණ������ /usr/ports/print ��tex��jadetex�� ��Ҳ���ܻᰲװ��

��Щ port �ܿ��ܲ������λ�� /usr/local/share/sgml/catalog ����Ŀ¼�ļ���ȷ�������������У�

CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"

����㲻��༭�ļ����㻹���԰ѻ������� SGML_CATALOG_FILES ����Ϊһ��ð�ŷָ� ��Ŀ¼�ļ��б��������������ģ���

������� FreeBSD �ĵ��ƻ�ָ�����ҵ�����ָ��.

G.2.3. Debian ��

Debian GNU/Linux ����Ҳ��һ���� �����õ��ĵ����ߵİ��� ��װʱ��ֻ��Ҫ����������

apt-get install jade
apt-get install docbook
apt-get install docbook-stylesheets

G.2.4. ��Դ�������ֹ���װ

DocBook ���ߵ��ֹ���װ������Щ���ӣ�����������Ԥ�����õİ��� ��û��������ǡ�����������ֻ����һ����׼�İ�װ�����Ұ�װ����׼��·�������û��"����"�����ԡ� ��صĸ����ϸ�ڣ���Ӧ��ѧϰ��ذ����ĵ��������Ķ� SGML �����Բ��ϡ�

G.2.4.1. ��װ OpenJade

  1. OpenJade �ṩ��һ�� GNU ���� ./configure; make; make install �������̡�������� OpenJade Դ��������ҵ���ϸ���ݡ� �� shell �

    ./configure --enable-default-catalog=/usr/local/share/sgml/catalog
    make
    make install

    ȷ�����ס����� "default catalog" ��λ�ã� �����㻹����Ҫ������Ҳ���Բ���ע����仰�������Ժ���ʹ�� jade ��ʱ�� ��ͻ᲻�ò��ѻ������� SGML_CATALOG_FILES ����Ϊָ����ļ���λ�á� ����� OpenJade �Ѿ���װ�����������ڱ��ذ�װ�������ߵ�ʱ����Ҳ�Ǹ���ѡ�ķ�������

  2. ���⣬��Ӧ�ô� dssslĿ¼����ļ� dsssl.dtd��fot.dtd�� style-sheet.dtd���� catalog ��װ�ϣ������ǰ�װ�� /usr/local/share/sgml/dsssl�ɡ���򵥵Ŀ��� ���ǿ�������Ŀ¼��

    cp -R dsssl /usr/local/share/sgml

  3. ��󣬴����ļ� /usr/local/share/sgml/catalog ���Ұ������� �������С�

    CATALOG "dsssl/catalog"

    (����һ�����·����ָ���� step 2 �ﰲװ���ļ�����������Լ��İ�װ���ֽ��е�����)

G.2.4.2. ��װ DocBook DTD ������

  1. ��ȡ DocBook V4.2 ������

  2. ����Ŀ¼ /usr/local/share/sgml/docbook-4.2 ���ҽ����Ŀ¼�� ��ʵ�ʵ�λ�ò��ǹؼ����������ֻ������������IJ��ֵıȽϺ����λ�á���

    $ mkdir /usr/local/share/sgml/docbook-4.2
    $ cd /usr/local/share/sgml/docbook-4.2

  3. ����鵵��

    $ unzip -a ...../docbook-4.2.zip

    ������鵵���������ļ��⿪����ǰĿ¼����

  4. �༭ /usr/local/share/sgml/catalog�ļ��������κ� ��װ��ʱ������� jade �Ķ��������Ұ�����������зŵ����ļ����棺

    CATALOG "docbook-4.2/docbook.cat"

  5. ���� ISO 8879 �ַ���¼ �鵵���⿪����Ȼ����ļ��ŵ���� DocBook �ļ���ͬһ��Ŀ¼�

    $ cd /usr/local/share/sgml/docbook-4.2
    $ unzip ...../ISOEnts.zip

  6. ��װ�� DocBook �� ISO �ļ���Ŀ¼����������������

    perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat

    ����������޲���һ��Сë�������ë���� DocBook Ŀ¼�ļ���ʹ�õ����ֺ� ISO �ַ�ʵ���ļ������ֻ����ˡ���

G.2.4.3. ��װ DocBook ��DSSSL ����

Ҫ��װ�����⿪�����Ĺ��߰���Ȼ�����Ų��һ�����ʵĵط��� ���� /usr/local/share/sgml�� ���鵵���Զ�����һ����Ŀ¼����

$ gunzip docbook-dsssl-1.xx.tar.gz
$ tar -C /usr/local/share/sgml -xf docbook-dsssl-1.xx.tar

��Ҳ������ /usr/local/share/sgml/catalog �� �������õ�Ŀ¼��Ŀ��

CATALOG "docbook-dsssl-1.xx/catalog

��Ϊ����仯Ƶ���������ʱ���ʵ�鼸���汾Ҳͦ�ã� PostgreSQL ����ʹ�������� ���� Section G.3 ��ȡ�й����ѡ��������Ϣ��

G.2.4.4. ��װ JadeTeX

Ҫ��װ��ʹ�� JadeTeX�������Ҫ һ�����õ� TeX �� LaTeX2e������֧�ֵ� ������ͼ������ Babel�� AMS ���� �� AMS-LaTeX�� PSNFSS ��չ�Ͱ��¹����� "the 35 fonts"�� �������� PostScript �� dvips ���򣬺�� fancyhdr�� hyperref�� minitoc�� url �� ot2enc ������Щ�㶼������������� CTAN ����վ���ҵ��� ���� TeX ϵͳ�İ�װԶԶ��������ݽ��� �ķ�Χ����Ӧ�ÿ������κο������� TeX ��ϵͳ���ҵ������ư���

���㿪ʼʹ�� JadeTeX ���� PostgreSQL �ĵ�֮ǰ������Ҫ ���� TeX ���ڲ����ݽṹ�ijߴ硣 ������Щ�����ϸ�ڿ����� JadeTeX �İ�װָ�����ҵ���

������ jadetex.fmt ��ʽ�ļ�֮ǰ�� �������༭ jadetex.ltx �ļ��� �� Babel �����øı�Ϊ�ʺ����·���� Ҫ�޸ĵ��п�������

\RequirePackage[german,french,english]{babel}[1997/01/23]

���Һ���Ȼ��Ӧ��ֻ�г�����Ҫ��Ψһ�����ԣ� ���Ұ� Babel ����Ϊ���ڸ����ԡ�

һ���������Щ��Ϳ��԰�װ JadeTeX �ˡ�

$ gunzip jadetex-xxx.tar.gz
$ tar xf jadetex-xxx.tar
$ cd jadetex
$ make install
$ mktexlsr

���������Ҫ�� root ��ݴ���

G.2.5. Detection by configure

���������ĵ�֮ǰ������Ҫ���������������� ���� configure �ű��� ������н�β���������Ӧ�ÿ�������������

checking for onsgmls... onsgmls
checking for openjade... openjade
checking for DocBook V4.2... yes
checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular
checking for sgmlspl... sgmlspl

��� onsgmls �� nsgmls ��û���ҵ�����ô��Ϳ�����������С� ���û���ҵ� "DocBook V4.2"����ô������û�а� DocBook DTD ������װ�� jade �����ҵ��ĵط���������û����ȷ����Ŀ¼�ļ��� ��������İ�װ��ʾ�����ýű�����һЩ�Ƚϱ�׼��λ��Ѱ�� DocBook ���� �����������Ƿ�������λ�ã���ô���Ӧ�����û������� DOCBOOKSTYLE Ϊ��λ�ò������������������� configure��