tagging.txt

   1 Tips regarding DocBook XML tagging
   2 ==================================
   3
   4 To get entries in the Index at the back, add entries like this in the
   5 docbook source:
   6
   7   <indexterm><primary>ABC</primary></indexterm>
   8
   9 This will result in the entry ABC showing up in the Index, with a
  10 reference to the page where it is mentioned.
  11
  12 To get two levels in the index at the back, add entries like this to
  13 the docbook source:
  14
  15   <indexterm>
  16   <primary>artists</primary>
  17   <secondary>publicity rights on images of</secondary>
  18   </indexterm>
  19
  20 To index a range of paragrams/pages:
  21
  22   <indexterm id="idxexchap" class='startofrange'>
  23     <primary>Example Chapter</primary></indexterm>
  24   ...
  25   <indexterm startref="idxexchap" class="endofrange"/>
  26
  27 Docbook howtos
  28 --------------
  29
  30 http://developer.gnome.org/gdp-handbook/stable/docbook.html.en
  31 http://www.docbook.org/tdg/en/html/docbook.html
  32 http://www.docbook.org/tdg/en/html/indexterm.html
  33
  34 Docbook processing
  35 ------------------
  36
  37 xmlto with fop backend
  38
  39  - Overlap footnote and text body in some cases (BTS #683197)
  40
  41  - incorrect index (missing page numbers for some, create wrong page
  42    number for some).
  43
  44  - missing images (possibly BTS #567122)
  45
  46 xmlto with default backend
  47
  48  - fail to process the docbook source (possibly BTW #683163)
  49
  50 dblatex
  51
  52  - do not end a <part> when it should, gluing following chapters as if
  53    they belonged to the last <part> (BTS #683166).
  54
  55  - Incorrect hyphens for multipage index references (BTS #682901)