X-Git-Url: https://pere.pagekite.me/gitweb/text-free-culture-lessig.git/blobdiff_plain/6b9906264b4e43b99a6af805c3e01e7dc733df7a..ac89337fe4987b2ad9ecce3c4f407247c1c47787:/tagging.txt

diff --git a/tagging.txt b/tagging.txt
index 1c93dd3..38a2d05 100644
--- a/tagging.txt
+++ b/tagging.txt
@@ -8,3 +8,58 @@ docbook source:
 
 This will result in the entry ABC showing up in the Index, with a
 reference to the page where it is mentioned.
+
+To get two levels in the index at the back, add entries like this to
+the docbook source:
+
+  <indexterm>
+  <primary>artists</primary>
+  <secondary>publicity rights on images of</secondary>
+  </indexterm>
+
+To index a range of paragrams/pages:
+
+  <indexterm id="idxexchap" class='startofrange'>
+    <primary>Example Chapter</primary></indexterm>
+  ...
+  <indexterm startref="idxexchap" class="endofrange"/>
+
+Docbook howtos
+--------------
+
+http://developer.gnome.org/gdp-handbook/stable/docbook.html.en
+http://www.docbook.org/tdg/en/html/docbook.html
+http://www.docbook.org/tdg/en/html/indexterm.html
+
+Docbook processing
+------------------
+
+xmlto with fop backend
+
+ - showing norwegian language for system templates.
+
+ - Overlap footnote and text body in some cases (BTS #683197)
+
+ - incorrect index (missing page numbers for some, create wrong page
+   number for some).
+
+ - missing images (possibly BTS #567122)
+
+xmlto with default backend
+
+ - fail to process the docbook source (possibly BTW #683163)
+
+dblatex
+
+ - do not end a <part> when it should, gluing following chapters as if
+   they belonged to the last <part> (BTS #683166).
+
+ - Incorrect hyphens for multipage index references when using xetex
+   (BTS #682901).
+
+ - not showing norwegian language for system templates (BTS #682936).
+
+xsltproc / fop
+
+ - both version 1.75.2+dfsg-5 (squeeze) and version 1.76.1+dfsg-1
+   (wheezy) give broken footnotes and index.