XSL-FO asiakirja

XSL-FO-dokumentit ovat XML-tiedostoja, joissa on tulostustietoja.

XSL-FO asiakirja

XSL-FO-dokumentit ovat XML-tiedostoja, joissa on tulostustietoja. Ne sisältävät tietoja ulostulon asettelusta ja sisällöstä.

XSL-FO-dokumentit tallennetaan .fo- tai .fob-päätteisiksi tiedostoiksi. .xml-päätteiset XSL-FO-dokumentit ovat myös yleisiä, ja tällä tavalla XSL-FO-dokumentit ovat helpommin saatavilla XML-editorin avulla.

XSL-FO-dokumentin rakenne

XSL-FO:n dokumenttirakenne on samankaltainen:

<?xml version="1.0" encoding="ISO-8859-1"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
  <fo:simple-page-master master-name="A4">
    Tämä on sivupohjan sisältö.
  </fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4">
  Tämä on sivun sisältö.
</fo:page-sequence>
</fo:root>

Rakenteellinen selitys

XSL-FO-dokumentti kuuluu XML-dokumentteihin, koska sen on myös aloitettava XML-deklaratiolla:

<?xml version="1.0" encoding="ISO-8859-1"?>

<fo:root>-elementti on XSL-FO-dokumentin juurelementti. Tämä juurelementti on myös ilmoitettava XSL-FO:n nimenkuoriavaimella:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
  Tämä on XSL-FO-dokumentin sisältö.
</fo:root>

<fo:layout-master-set> -elementti sisältää yhden tai useamman sivumallin:

<fo:layout-master-set>
  <!-- Tämä on kaikki sivumallit -->
</fo:layout-master-set>

<fo:simple-page-master> -elementti sisältää yhden yksittäisen sivumallin. Jokaisella malleilla on oltava ainutlaatuinen nimi (master-name):

<fo:simple-page-master master-name="A4">
  <!-- Tämä on tietyn sivumallin -->
</fo:simple-page-master>

Yksi tai useampi <fo:page-sequence> -elementti voi kuvata sivun sisältöä. master-reference -ominaisuus käyttää samaa nimeä viittaamaan simple-page-master -malleihin:

<fo:page-sequence master-reference="A4">
  <!-- Tämä on sivun sisältö -->
</fo:page-sequence>

Huomautus:master-reference:n arvo "A4" ei oikeastaan kuvaa minkään ennakkosuunnitellun sivuformatin. Se on vain nimi. Voit käyttää mitä tahansa nimeä, kuten "MyPage", "MyTemplate" ja niin edelleen.