Rozdział zawiera informacje dotyczące przetwarzania dokumentacji zapisanej w formacie DocBook XML na inne formaty, takie jak: HTML, RTF.
Musisz zainstalować pakiety openjade i dockbook-*. Umożliwiają one translację plików SGML na inne formaty. Niestety (dotyczy wersji 3.6 i wcześniejszych) nie ma pakiety zawierającego szablony DocBook XML. Musisz samodzielnie je ściągnąć.
Na dzień dzisiejszy dokumentacja tłumaczona jest za pomocą plików z Fedora Core 2 (pakiety: docbook-style-dsssl-1.78-2.noarch.rpm i docbook-dtds-1.0-22.1.noarch.rpm). Pakiety rozpakowane zostały za pomocą rpm2cpio, pliki z usr/share/ skopiowane zostały do /usr/local/share/sgml/redhat. Następnie poniższe linie:
Przykład 8-1. Zawartość pliku catalog
CATALOG "redhat/sgml/docbook/xml-dtd-4.1.2-1.0-22.1/catalog" CATALOG "redhat/sgml/docbook/xml-dtd-4.2-1.0-22.1/catalog" CATALOG "redhat/sgml/docbook/dsssl-stylesheets/catalog"
Po tych czynnościach możliwe stało się generowanie wersji RTF dokumentacji:
env SGML_CATALOG_FILES=/usr/local/share/sgml/catalog openjade -t rtf -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl /usr/local/share/sgml/docbook/dsssl/modular/dtds/decls/xml.dcl ../index.xml
Aby wygenerować dokumentację w formacie HTML należy zmienić rtf na sgml.
Notatka: openjade może wypisać ostrzeżenia dotyczące DTDDECL, który nie jest obsługiwany, należy je ignorować.
Poprzedni | Spis treści | Następny |
Instalacja | Korzystanie z pliku makefile |