diff options
author | Pierre Labastie <pieere@linuxfromscratch.org> | 2020-03-13 09:20:45 +0000 |
---|---|---|
committer | Pierre Labastie <pieere@linuxfromscratch.org> | 2020-03-13 09:20:45 +0000 |
commit | 2e524f93fc03353e6fb05333d8041505948959eb (patch) | |
tree | 0e2f8a60e47c994d49152b300f0d698a7eb29c4f /stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml | |
parent | cc98817b6165e5307c1fc38328cdc2a1cc2de257 (diff) |
Since LFS started using docbook-1.78.1, there is a lot of unused data
in the stylesheet directory. Basically, a whole docbook-stylesheet is
there, while we need only fo and xhtml (+ some common dirs). Each time
we checkout the repo, we have to download this whole thing, which is by
far the biggest part of the repo (~33 M). By removing unused cruft,
this could be down to ~12 M.
Of course, it would be even better to remove completely the stylesheets
and use host ones (repo size down to 2M). but let's do this first, it is
easier :)
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11778 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml')
-rw-r--r-- | stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml | 73 |
1 files changed, 0 insertions, 73 deletions
diff --git a/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml b/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml deleted file mode 100644 index 7942b5a50..000000000 --- a/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/make.index.markup.xml +++ /dev/null @@ -1,73 +0,0 @@ -<refentry xmlns="http://docbook.org/ns/docbook" - xmlns:xlink="http://www.w3.org/1999/xlink" - xmlns:xi="http://www.w3.org/2001/XInclude" - xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - version="5.0" xml:id="make.index.markup"> -<refmeta> -<refentrytitle>make.index.markup</refentrytitle> -<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> -</refmeta> -<refnamediv> -<refname>make.index.markup</refname> -<refpurpose>Generate XML index markup in the index?</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<src:fragment xml:id="make.index.markup.frag"> -<xsl:param name="make.index.markup" select="0"/> -</src:fragment> -</refsynopsisdiv> - -<refsection><info><title>Description</title></info> - -<para>This parameter enables a very neat trick for getting properly -merged, collated back-of-the-book indexes. G. Ken Holman suggested -this trick at Extreme Markup Languages 2002 and I'm indebted to him -for it.</para> - -<para>Jeni Tennison's excellent code in -<filename>autoidx.xsl</filename> does a great job of merging and -sorting <tag>indexterm</tag>s in the document and building a -back-of-the-book index. However, there's one thing that it cannot -reasonably be expected to do: merge page numbers into ranges. (I would -not have thought that it could collate and suppress duplicate page -numbers, but in fact it appears to manage that task somehow.)</para> - -<para>Ken's trick is to produce a document in which the index at the -back of the book is <quote>displayed</quote> in XML. Because the index -is generated by the FO processor, all of the page numbers have been resolved. -It's a bit hard to explain, but what it boils down to is that instead of having -an index at the back of the book that looks like this:</para> - -<blockquote> -<formalpara><info><title>A</title></info> -<para>ap1, 1, 2, 3</para> -</formalpara> -</blockquote> - -<para>you get one that looks like this:</para> - -<blockquote> -<programlisting><indexdiv>A</indexdiv> -<indexentry> -<primaryie>ap1</primaryie>, -<phrase role="pageno">1</phrase>, -<phrase role="pageno">2</phrase>, -<phrase role="pageno">3</phrase> -</indexentry></programlisting> -</blockquote> - -<para>After building a PDF file with this sort of odd-looking index, you can -extract the text from the PDF file and the result is a proper index expressed in -XML.</para> - -<para>Now you have data that's amenable to processing and a simple Perl script -(such as <filename>fo/pdf2index</filename>) can -merge page ranges and generate a proper index.</para> - -<para>Finally, reformat your original document using this literal index instead of -an automatically generated one and <quote>bingo</quote>!</para> - -</refsection> -</refentry> |