Next / Previous / Contents / NM Tech homepage

14. Configuration of XEP

xep is the vital link in the toolchain that converts the XSL-FO that comes out of the stylesheets into a PDF file. For vendor information, see the RenderX homepage.

However, the current document is where we manage the customization of the xep.xml file.

The starting point for all customization is RenderX's stock xep.xml file. There is a local copy, xep.xml.orig, online as part of the current document.

14.1. xep.xml: Stock prologue

Here is the part of the stock xep.xml file that we don't change locally.

xep.xml
<?xml version="1.0" encoding="utf-8"?>

<!-- ======================================================= -->
<!-- RenderX XEP Configuration                               -->
<!-- ======================================================= -->

<config xmlns="http://www.renderx.com/XEP/config">

  <!-- ======================================================= -->
  <!-- Formatter options                                       -->
  <!-- ======================================================= -->
  <options>
    <option name="LICENSE" value="license.xml"/>
    <option name="TMPDIR" value="none"/>
    <option name="BROKENIMAGE" value="images/404.gif"/>
    
    <!-- Backend options -->
    <generator-options format="PDF">
      <!-- <option name="COMPRESS" value="false"/> -->
      <!-- <option name="PDF_VERSION" value="1.3"/> -->
    </generator-options>
      
    <generator-options format="PostScript">
      <!-- <option name="LANGUAGE_LEVEL" value="2"/> -->
      <!-- <option name="CLONE_EPS" value="true"/> -->
    </generator-options>
  </options>

  <!-- ======================================================= -->
  <!-- Fonts                                                   -->
  <!-- ======================================================= -->
  
  <fonts xmlns="http://www.renderx.com/XEP/config" 
         xml:base="fonts/" 
         default-family="Helvetica">
    <!-- Base Adobe fonts. -->
    <font-group label="Base 14" embed="false">
      <font-family name="Courier">
        <font><font-data afm="Courier.afm"/></font>
        <font style="oblique">
          <font-data afm="Courier-Oblique.afm"/></font>
        <font weight="bold">
          <font-data afm="Courier-Bold.afm"/></font>
        <font weight="bold" style="oblique">
          <font-data afm="Courier-BoldOblique.afm"/></font>
      </font-family>

      <font-family name="Helvetica">
        <font><font-data afm="Helvetica.afm"/></font>
        <font style="oblique">
          <font-data afm="Helvetica-Oblique.afm"/></font>
        <font weight="bold">
          <font-data afm="Helvetica-Bold.afm"/></font>
        <font weight="bold" style="oblique">
          <font-data afm="Helvetica-BoldOblique.afm"/></font>
      </font-family>

      <font-family name="Times" ligatures="&#xFB01; &#xFB02;">
        <font><font-data afm="Times-Roman.afm"/></font>
        <font style="italic">
          <font-data afm="Times-Italic.afm"/></font>
        <font weight="bold">
          <font-data afm="Times-Bold.afm"/></font>
        <font weight="bold" style="italic">
          <font-data afm="Times-BoldItalic.afm"/></font>
      </font-family>

      <font-family name="Symbol">
        <font><font-data afm="Symbol.afm"/></font>
      </font-family>
      <font-family name="ZapfDingbats"> 
        <font><font-data afm="ZapfDingbats.afm"/></font>
      </font-family>
    </font-group>

    <font-group label="Assorted Type 1" embed="true">
      <font-family name="OmegaSerifIPA">
        <font>
          <font-data afm="IPA.afm" pfa="IPA.pfa"
                     glyph-list="IPA.glyphs"/></font>
      </font-family>   
      <font-alias name="OmegaIPA" value="OmegaSerifIPA"/>
      <font-alias name="Phonetic" value="OmegaSerifIPA"/>
    </font-group>

The following section has been removed from the unmodified xep.xml file, because it sets up the Windows fonts, and this configuration is for Linux.

    <!-- Sample configuration for Windows TrueType fonts.  -->
    <font-group xml:base="file:/C:/Windows/Fonts/"
      label="Windows TrueType" embed="true" subset="true"> 
      <font-family name="Arial">
        <font><font-data ttf="arial.ttf"/></font>
        <font style="oblique"><font-data ttf="ariali.ttf"/></font>
        <font weight="bold"><font-data ttf="arialbd.ttf"/></font>
        <font weight="bold" style="oblique">
          <font-data ttf="arialbi.ttf"/></font>
      </font-family>

      <font-family name="Times New Roman" ligatures="&#xFB01; &#xFB02;">
        <font><font-data ttf="times.ttf"/></font>
        <font style="italic"><font-data ttf="timesi.ttf"/></font>
        <font weight="bold"><font-data ttf="timesbd.ttf"/></font>
        <font weight="bold" style="italic">
          <font-data ttf="timesbi.ttf"/></font>
      </font-family>

      <font-family name="Courier New">
        <font><font-data ttf="cour.ttf"/></font>
        <font style="oblique"><font-data ttf="couri.ttf"/></font>
        <font weight="bold"><font-data ttf="courbd.ttf"/></font>
        <font weight="bold" style="oblique">
          <font-data ttf="courbi.ttf"/></font>
      </font-family>

      <font-family name="Tahoma" embed="true">
        <font><font-data ttf="tahoma.ttf"/></font>
        <font weight="bold"><font-data ttf="tahomabd.ttf"/></font>
      </font-family>

      <font-family name="Verdana" embed="true">
        <font><font-data ttf="verdana.ttf"/></font>
        <font style="oblique"><font-data ttf="verdanai.ttf"/></font>
        <font weight="bold"><font-data ttf="verdanab.ttf"/></font>
        <font weight="bold" style="oblique">
          <font-data ttf="verdanaz.ttf"/></font>
      </font-family>

      <font-family name="Palatino" embed="true"
        ligatures="&#xFB00; &#xFB01; &#xFB02; &#xFB03; &#xFB04;">
        <font><font-data ttf="pala.ttf"/></font>
        <font style="italic"><font-data ttf="palai.ttf"/></font>
        <font weight="bold"><font-data ttf="palab.ttf"/></font>
        <font weight="bold" style="italic">
          <font-data ttf="palabi.ttf"/></font>
      </font-family>
    </font-group>