^ Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 ^| | [[dokumentation:x1289|forrige]] | Kapitel 3. DocBook i XML : Ett konkret exempel | [[dokumentation:x1323|næste]] | ---- ==== 3.3. Transformera till DocBook ==== Itables.xmlhar vi nu ett 'well-formed' XML dokument. Detta skall nu mappas mot docbook. XSL-transformering är precis vad docbook i XML går ut på. En XML-parser validerar dokumentet som skall översättas, mot en DTD, docbooks DTD. Om det är OK kan processen med att skapa måldokumentet fortsätta. Skapandet av måldokumentet sker genom att köra det genom ett antal XSL-stylesheet, som byter docbook-taggarna mot t.ex. HTML-taggar. Problemet här, är atttables.xmlinte alls stämmer med docbooks DTD. Vi löser det med att skicka in det i ett eget XSL-stylesheet, som byter ut XML-taggarna frånmake_tables.tcltill docbook-XML-taggar. Detta stylesheet kallar vito_docbook_table.xsl. Om det verkar helt obegripligt, så gör det inte så mycket, XSL är inte helt enkelt. Database Table Description This chapter was autogenerated to document the structure of database tables used in project XXX. <xsl:value-of select="$Table_Name"/> Keys in <xsl:value-of select="../Name"/> Name Primary? Unique? Definition
There are no keys.
Relations for <xsl:value-of select="../Name"/> Description Constraints # of keys Index Foreign keys
There are no relations.
Fields in <xsl:value-of select="../Name"/> Fieldname Type Not null? Has defult? Field number
There are no fields.
Om du nu har orkat hänga med, så är resten ganska enkelt. Vi vill skapadocbook_tables.xmlsom är datat fråntables.xml, fast med docbook-syntax. Dags att utnyttja Saxon. Saxon behöver en del parametrar, så vi skapar enMakefile, som vi bygger på efter hand. Justera sökvägarna efter ditt system. Vi skapar en katalogstrukur enligt nedan [bnl@della docbook_xml]$tree|-- source | |-- Makefile | |-- datamodel.xml | |-- make_tables.tcl | |-- tables.xml | `-- to_docbook_table.xsl `-- target |-- html |-- html_one `-- pdf därMakefileser ut så här:#A list over source files SRC=datamodel.xml docbook_tables.xml tables.xml to_docbook_table.xsl DB=/usr/share/sgml/docbook/xsl-stylesheets SAXON=/home/bnl/distributions/java/saxon.jar TARGET=/home/bnl/public_html/sslug/docbook_xml/target OPTIONS=paper.type=A4 \ admon.graphics=1 \ admon.graphics.path=$(DB)/images/ \ use.extensions=1 \ fop.extensions=1 \ section.autolabel=1 \ callout.graphics.path=$(DB)/images/callouts/ \ tablecolumns.extension=0 #What to do when just 'make' is run all: docbook_tables.xml docbook_tables.xml: tables.xml java -jar $(SAXON) tables.xml to_docbook_table.xsl \ $(OPTIONS) > docbook_tables.xml Skapa docbook_tables.xml genom att skriva:[bnl@della source]$make docbook_tables.xml Vi har nu allt vi behöer för att komma i mål---- | [[dokumentation:x1289|forrige]] | [[dokumentation:index|hjem]] | [[dokumentation:x1323|næste]] | | Skaffa fram rådatat | [[dokumentation:c1211|op]] | Skapa ett HTML-dokument |