3. Настройка стиля выходного документа

С помощью Borges очень легко управлять форматированием конечных документов, благодаря функциям оформления DocBook. Более того, можно легко создать новые уровни оформления, чтобы каждое руководство имело своё собственное оформление.

3.1. Настройка существующих форматов

Как мы уже видели в Раздел 1.1.3, «conf/manual-default.xml», уровни оформления для всех выходных форматов находятся в каталоге drivers/. Вам просто нужно открыть в текстовом редакторе таблицу стилей, соответствующую формату, который вы хотите изменить:

drivers/docbook-jadetex.dsssl

для выходных форматов PDF и PS

drivers/docbook-xhtml.xsl

для выходного формата HTML в виде одной страницы;

drivers/docbook-xhtml-chunk.xsl

для выходного формата HTML в виде нескольких страниц.

Обратитесь к документации, если вам необходимо узнать о том, как настраиваются таблицы стилей XSL и DSSSL.

3.2. Создание нового уровня оформления

Наличие одного уровня оформления для каждого из выходных форматов может быть недостаточным для каких-либо особых целей. Давайте представим, что у вас есть руководство, которое вы хотите издать в Европе и в США. Тогда вам потребуются два разных формата бумаги: A4 и Letter. Это делается в два простых этапа:

  1. Создайте новый уровень оформления

    Этот уровень оформления будет помещён над уровнем настройки печати Borges, в результате чего будут получены следующие уровни:

    Наш новый уровень оформления (drivers/docbook-jadetex-Letter.dssssl) будет выглядеть так:

    <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [<!ENTITY docbook-jadetex.dsssl SYSTEM "docbook-jadetex.dsssl" CDATA DSSSL > ]>
         
         <style-sheet> 
          <style-specification id="print" use="docbook-jadetex">
           <style-specification-body>
         
           ;;Какой размер бумаги вам нужен? A4, A5, USletter или USlandscape?
           (define %paper-type% "USletter")
         
           </style-specification-body>
          </style-specification>
          <external-specification id="docbook-jadetex" document="docbook-jadetex.dsssl"> 
         </style-sheet>
      

    Теперь, когда уровень оформления готов, мы просто указываем системе использовать его на втором этапе.

  2. По умолчанию таблица стиля печати Borges использует формат бумаги A4. Затем нам нужно создать новое руководство, которое будет использовать только что созданный уровень оформления «Letter». Это делается в конфигурационном файле супердокумента, например в manuals/Install-guide/conf.xml:

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <configuration>
      <stylesheet>
        <dssslprint>../../drivers/docbook-jadetex.dsssl</dssslprint>
        <xslxhtmlflat>../../drivers/docbook-xhtml.xsl</xslxhtmlflat>
        <xslxhtmlchunk>../../drivers/docbook-xhtml-chunk.xsl</xslxhtmlchunk>
      </stylesheet>
    
     <manuals>
      <manual id="Install-guide-A4">
        <lang>en</lang>
        <format>pdf</format>
      </manual>
      <manual id="Install-guide-Letter">
        <lang>en</lang>
        <format>pdf</format>
        <stylesheet>
          <dssslprint>../../drivers/docbook-jadetex-Letter.dsssl</dssslprint>
        </stylesheet>
      </manual>
     </manuals>
    </configuration>
      

    В этом файле первый элемент stylesheet сообщает системе, что по умолчанию мы хотим использовать таблицы стилей Borges. Следовательно, руководство Install-guide-A4 будет использовать docbook-jadetex.dsssl с форматом бумаги A4. Однако для руководства Install-guide-Letter мы указали, что мы хотим использовать свой уровень оформления docbook-jadetex-Letter.dsssl. Другие форматы (HTML) будут продолжать использовать таблицы стилей по умолчанию, т.к. мы их не переопределяли.

Как только это выполнено, вы можете воспользоваться функцией Раздел 2.2, «Создание нескольких документов за один раз» для одновременного создания двух различных книг: Install-guide-A4.pdf и Install-guide-Letter.pdf с форматами бумаги A4 и Letter соответственно.