<?xml version="1.0" standalone="yes"?>
<?xml-stylesheet type="text/xsl" href="index.xsl"?>

<!DOCTYPE index [
<!ATTLIST	anchor
       ID   ID  #REQUIRED >
]>

<index xmlns:xlink="http://www.w3.org/1999/xlink" >

<kop>
<naam>Madelief XML</naam>
<omschrijving>Een XML DTD en XSLT stylesheets voor
waarnemingslijsten</omschrijving>
<logo src="bellisp.gif" alt="Bellis Perennis"/>
</kop>

<beschrijving xmlns="http://salix.spepping.descriptions">

<titel>Van database naar XML file</titel>

<p>Mijn waarnemingsarchief is opgeslagen in een Postgres database.
Dat archief beheer ik via mijn programma <link
xlink:href="../madelief/index.html">Madelief</link>. Met Madelief kunnen de
waarnemingen in een XML file met de juiste struktuur geschreven
worden.</p>

<titel>De DTD</titel>

<p>XML files hoeven geen DTD te hebben. Maar het is beter om er wel
een te hebben. Deze DTD heb ik zelf geschreven. Daar is een
hoeveelheid XML kennis voor nodig, dus de meeste Web auteurs zullen
dat niet kunnen en willen doen. Meestal zul je proberen een bestaande
DTD te vinden die voor je toepassing geschikt is. Deze DTD is geschikt
voor het presenteren van waarnemingslijsten die passen binnen mijn
<link xlink:href="struktuur.html">struktuur</link>.</p>

<titel>De XML file lezen</titel>

<p>Om de XML file leesbaar te maken heb ik een XSL stylesheet
geschreven waarmee de XML files naar HTML files kunnen worden
omgezet. Die HTML files kun je dan in je WWW browser bekijken. Voor
die omzetting is een XSLT processor nodig, b.v. <link
xlink:href="http://xml.apache.org/xalan-j/index.html">Xalan</link>.
Zie <link xlink:href="http://www.oasis-open.org/cover/xsl.html">Robin
Covers pagina</link> voor meer informatie over XSLT software.</p>

<p>Dat is een hele omweg. In de modernste browsers IE6 en Mozilla
kunnen XML files met XSL style sheets rechtstreeks gelezen worden.</p>

<p>Er zijn vier XSLT stylesheets:
<opsomming>
<punt><bestand xmlns="" type="xsl">waarnemingen.xsl</bestand>: zet een
waarnemingenlijst om van xml naar html; parameters:
<opsomming>
<punt><parameter xmlns="">lijst</parameter>: de naam van de lijst.</punt>
<punt><parameter xmlns="">lijstgroep</parameter>: de naam van de lijstgroep
waar deze lijst deel van uit maakt.</punt>
<punt><parameter xmlns="">tocfile</parameter>: de naam van de file met de
lijstgroepen en lijstrefs; verstekwaarde: <bestand xmlns=""
type="xml">toc.xml</bestand>.</punt>
</opsomming></punt>
<punt><bestand xmlns="" type="xsl">toc.xsl</bestand>: maak <bestand
xmlns="" type="html">index.html</bestand> uit de file met de
lijstgroepen en lijstrefs, <bestand xmlns=""
type="xml">toc.xml</bestand>; parameters:
<opsomming>
<punt><parameter xmlns="">lijstgroep</parameter>: de naam van de lijstgroep
waarvoor de index gemaakt moet worden; als er geen waarde opgegeven
wordt, worden alle lijstgroepen in de index gezet.</punt>
<punt><parameter xmlns="">lijstcols</parameter>: aantal kolommen in de tabel;
verstekwaarde: 5</punt>
</opsomming></punt>
<punt><bestand xmlns="" type="xsl">navigation.xsl</bestand>: bevat
templates om een lijstref om te zetten in een hyperlink, en om de
navigatiebalk in de waarnemingslijsten te maken.</punt>
<punt><bestand xmlns="" type="xsl">descriptions.xsl</bestand>: bevat
templates om de beschrijvende teksten om te zetten.</punt>
</opsomming>
</p>

<titel>Deze pagina</titel>

<p>Vanzelfsprekend bestaat er ook van deze pagina een oorspronkelijke
XML vorm <link xlink:href="index.xml"><bestand xmlns=""
type="xml">index.xml</bestand></link> en een daarvan afgeleide
HTML vorm <link xlink:href="index.html"><bestand xmlns=""
type="html">index.html</bestand></link>. Het stylesheet is <link
xlink:href="index.xsl"><bestand xmlns=""
type="xsl">index.xsl</bestand></link>.</p>

<p>Bovendien bestaat deze pagina in een alternatieve vorm, met een
template achtig stylesheet. Hier staat de tekst in het stylesheet
<link xlink:href="index-xsl.xsl"><bestand xmlns=""
type="xsl">index-xsl.xsl</bestand></link>, en is de XML file <link
xlink:href="index-xsl.xml"><bestand xmlns=""
type="xml">index-xsl.xml</bestand></link> een lege huls. De
resulterende HTML file is <link xlink:href="index-xsl.html"><bestand
xmlns="" type="html">index-xsl.html</bestand></link>.</p>

</beschrijving>

<dist>
<naam>madelief-xml</naam>
<ext>tar.gz</ext>
<versie>1.02</versie>
<size>76kB</size>
</dist>

</index>
