Detta dokument beskriver inte hur layout-programmet Passepartout fungerar, utan hur man formaterar artiklar i emissionens eget XML-format. För en manual till programmet, se http://www.stacken.kth.se/project/pptout/doc.shtml.
XML är ett filformat för att beskriva filformat. En XML-fil är skriven i klartext och har speciella kontrollsekvenser för att beskriva innebörden av innehållet. Om du har skrivit i HTML förut kommer XML att te sig ganska bekant. I HTML kan man till exempel skriva I am Arthur, <em>king</em> of the Britons! så visas ordet "king" kursivt. Skillnaden mellan XML och HTML är att i XML kan man definiera egna markeringar. Ponera att jag vill göra en lista med träd. Jag väljer att markera listan med tree-list och ett träd med tree. Då kan det se ut så här:
<tree-list> <tree>The Larch</tree> <tree>The Larch</tree> <tree>The Larch</tree> <tree>The Horse Chestnut</tree> </tree-list>
Varje gruppering av typen <foo>pnyxtr</foo> kallas en nod. Om man öppnar med <foo> så måste man stänga med </foo>. Bara <foo> kan inte stå ensamt. Däremot kan en tom nod <foo></foo> förkortas till <foo/>. Noder kan innehålla andra noder, men noder kan inte överlappa varandra. Detta är inte tillåtet: <foo><bar></foo></bar>.
Kommentarer i XML-kod kan skrivas som <!-- det här är en kommentar -->.
Som sagt så kan man definiera sina egna markeringar i XML. En sådan definition kallas för en DTD och beskriver ett filformat. Emissionen har en egen DTD som Passepartout kan tolka med hjälp av en speciell stilmall.
Vi går direkt på ett exempel:
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE artikel SYSTEM "/misc/projects/esekt/emission/nyweb/share/emission.dtd">
<artikel>
<!-- Detta är en kommentar -->
<rubrik>Rubrik</rubrik>
<ingress>Detta är en ingress</ingress>
<para><start>Detta är en</start> paragraf med
ett <em>kursivt</em> ord.</para>
</artikel>
De två första raderna i exemplet talar om vad dokumentet är för något. Hela artikeln ska inneslutas i rot-noden artikel. All brödtext ska finnas inuti para-noder.
Layoutmallen ligger (tills vidare) i
emission/emission2/layoutmall/mall.ppt
Stilmallen (som ska kopplas till XML-filen i Streams-dialogen
i Passepartout) ligger i
emission/sys/share/xml/passepartout/emission.xslt
<artikel> - rot-noden som allt ska finnas inom
<bp/> - avstavningspunkt. Passepartout har ingen avstavningsordlista. Om man vill man tycker att ordet "elektrosektionen" ska avstavas så skriver man elektro<bp/>sektionen så kan Passepartout avstava där om den tycker det är lämpligt
<br/> - explicit radbrytning
<em> - kursiv text. Endast inuti para-noder
<h> - styckesrubrik. Läggs mellan para-noder
<ingress> - ingress. En speciellt typ av stycke.
<para> - stycke. All brödtext ska finnas inuti para-noder
<rubrik> - rubrik
<signatur> - artikelförfattarens + fotografens + tecknarens namn.
<start> - fixar anfang och kapitäler i början på första stycket.
Börja med att skriva artikeln i vanligt textformat. När den är klar kan du lägga in para-noder för att dela in den i stycken. När texten är inklistrad i Passepartout så updateras bilden automatiskt när du sparar, så det är möjligt att fortsätta redigera texten.