Revision History | ||
---|---|---|
Revision v1.8 | 04-02-2002 | Revised by: rbe |
De DocBook-Install-mini-HOWTO is een gedetailleerde praktische handleiding voor nieuwelingen om snel DocBook geïnstalleerd te krijgen om SGML bestanden in HTML, PS en PDF bestanden om te kunnen zetten op een GNU/Linux systeem - andere systemen kunnen vergelijkbaar zijn. Aangezien er voor de setup van DocBook bestanden nodig zijn vanuit verscheidene apart gedistribueerde packages, kan het voor beginners verwarrend zijn.
De laatste versie van deze mini-HOWTO is te vinden op:
http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/
Zie de "Legal" sectie in de appendix voor het copyright, de licentie en disclaimer informatie betrekking hebbend op dit document.
DocBook is een Standard Generalized Markup Language (SGML) Document Type Definition (DTD) waarin een set tekstuele document markup tags wordt gedefinieerd die veel lijkt op de bekende HTML taal die op het web wordt toegepast.
DocBook is bedoeld voor het bewerken van boeken en artikelen. Als zodanig voorziet het in tags die specifiek zijn ontworpen voor het schrijven van boeken en artikelen. De <book> en en <article> DocBook tags bijvoorbeeld worden gebruikt om boeken en artikelen aan te maken. Binnen deze documenten worden de <chapter>, <sect1>, en <para> tags gebruikt. DocBook SGML bestanden worden opgeslagen in tekstbestanden met een sgml of gml toevoegsel.
Wanneer het wordt verwerkt, kan een enkel DocBook SGML bestand als uitvoer html, pdf, ps, txt en andere formaten voor zowel online als gedrukte publicatie opleveren. De verwerking wordt bepaald door stylesheets die automatisch inhoudsopgaves, paginanummeringen, hoofdstuk- & en sectienummeringen en andere features kunnen genereren.
DocBook is ook ontworpen voor het bewerken van unix man pages door het schrijven van <refentry> documenten. Probeer de opdracht man man vanachter je terminal als je niet weet wat een man page is.
Hier zijn beknopte beschrijvingen van de packages waarmee we in de volgende secties zullen gaan werken:
OpenJade. OpenJade is een implementatie van de ISO/IEC 10179:1996 internationale standaard Document Style Semantics and Specification Language (DSSSL). OpenJade voert de DSSSL taal uit om SGML en XML invoerbestanden te verwerken. In het bijzonder maakt het gebruik van de Modulaire DocBook Stylesheets dsl code om DocBook SGML/XML bestanden om te zetten naar andere formaten zoals html, tex, rtf, txt en anderen. OpenJade is de essentiële engine voor het omzetten van een DocBook bestand naar andere formaten. Het TeX uitvoerformaat wordt meestal gebruikt als een tussenliggend formaat om dvi, pdf, en ps via TeX macros en dvi converters te kunnen verkrijgen.
DocBook SGML DTD. De DocBook Document Type Definition (DTD) bestanden zijn SGML bestanden die de DocBook taal definiëren. Het definieert de geldige set met tags en regels voor gebruik. OpenJade vereist toegang tot de DTD bestanden voor elk type document dat het verwerkt.
ISO8879 ENTITY SGML. Entiteiten definiëren hoe speciale tekens worden voorgesteld die of niet op het toetsenbord voorkomen of een speciale betekenis hebben in SGML. Voorbeelden bekend vanuit HTML zijn o.a. "&"='&', ">"='>', en "<"='<'.
DocBook DSSSL (Modular DocBook Stylesheets). De DSSSL bestanden (met de extensie dsl) voor een bepaalde DTD, in dit geval DocBook, specificeren hoe DocBook naar html, rtf, tex, enz te converteren. Een dsl bestand is invoer voor openjade in combinatie met je DocBook sgml bestand en het vertelt openjade hoe je document in een ander bestandsformaat te transformeren/stijleren. De dsl voor online (html) formaten is vaak anders dan voor af te drukken (dvi, pdf, ps) formaten.
SGMLtools-Lite. SGMLtools-Lite is een frontend wrapper voor het uitvoeren van openjade en de TeX macro's jadetex en pdfjadetex, macro's die in OpenJade zijn opgenomen. Het converteren van een DocBook bestand naar ps of pdf is een proces bestaande uit twee of drie stappen. OpenJade geeft als uitvoer een tex bestand wat weer de invoer is voor jadetex om een dvi bestand te kunnen produceren en pdfjadetex om een pdf bestand te kunnen produceren. Een ps bestand wordt verkregen door het dvi bestand door te geven aan dvips. Het sgmltools script voorziet in een enkele opdracht om deze taken uit te voeren.
HTMLdoc. HTMLdoc is een vrij programma voor het omzetten van html bestanden naar een pdf of ps bestand.
SGMLSpm en docbook2X. Samen worden deze gebruikt om man pages te genereren. SGMLSpm is een perl5 module library voor het verder verwerken van verwerkte uitvoer van onsgmls, een programma dat met OpenJade wordt meegeleverd. In SGMLSpm is een applicatie genaamd sgmlspl opgenomen voor gebruik van de SGMLSpm library. Voor Sgmlspl zijn "spec files" nodig, die van diverse bronnen op Internet beschikbaar zijn, voor elk type uit te voeren documentomzetting. DocBook2X is een package dat voorziet in de spec files voor het omzetten van de DocBook bestanden in man pages.
Next | ||
Download de Packages |