This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Index cross-references
- To: DocBook <docbook at lists dot oasis-open dot org>
- Subject: DOCBOOK: Index cross-references
- From: Fred Brown <fred dot brown at allegrotechindexing dot com>
- Date: Thu, 30 Aug 2001 10:55:36 -0400
- List-Id: <docbook.lists.oasis-open.org>
I'm having some difficulties with "See also" and "See" cross-references.
When I generate an index in HTML or RTF, I'm unable to get the "See also"
cross-reference in my test file to appear.
The "See" cross-reference is divided into two lines when it should appear
on a single line.
<indexterm id="greatidea"><primary>great idea.</primary><see>more
ideas</see></indexterm>
Appears as:
great idea.
See more ideas
When it should be:
great idea. See more ideas
I'm also having trouble getting the page numbers to show up in the RTF
file. The first two paragraphs disappear in the HTML output but are there
the RTF file.
I'm running under SuSE Linux 7.0. Here are the steps I use to generate the
index:
perl collateindex.pl -N -o genindex.sgm
openjade -t sgml -d /usr/share/sgml/docbook-dsssl-1.72/html/docbook.dsl -V
html-index test_index.sgm
perl collateindex.pl -o genindex.sgm HTML.index -p
openjade -t sgml -d /usr/share/sgml/docbook-dsssl-1.72/html/docbook.dsl
test_index.sgm
openjade -t rtf -d /usr/share/sgml/docbook-dsssl-1.72/print/docbook.dsl
test_index.sgm
Here is my test file (test_index.sgm):
<!doctype book public "-//OASIS//DTD DocBook V4.1//EN" [
<!ENTITY genindex.sgm SYSTEM "genindex.sgm">
]>
<book>
<chapter><title>Test Chapter</title>
<para>
<indexterm id="main"><primary>main heading</primary></indexterm>
<indexterm><primary>AZ</primary></indexterm>
<indexterm><primary>aa</primary></indexterm>
This is a test document.
</para>
<para>
<indexterm id="main1"><primary>main
heading</primary><secondary>subheading</secondary></indexterm>
And yet a second paragraph.
</para>
<para>
<indexterm id="range" class="startofrange"><primary>range</primary></indexterm>
<indexterm><primary>main heading</primary><seealso>other
topics</seealso></indexterm>
<indexterm id="greatidea"><primary>great idea.</primary><see>more
ideas</see></indexterm>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
<para>
<indexterm startref="range" class="endofrange">
text text text text text text text text text text text text text text text
text text text text text text text text text text
</para>
</chapter>
&genindex.sgm
</book>
Any thoughts? Thanks,
Fred Brown
~ ~ ~ ~ ~
Allegro Technical Indexing
"Professional indexes for technical publications."
~ ~ ~ ~ ~
"Allegro Time!" the FREE ezine about
indexing for technical communicators.
http://www.allegrotechindexing.com/allegrotime.htm
~ ~ ~ ~ ~
fred.brown@allegrotechindexing.com
http://www.allegrotechindexing.com
voice: (613) 728-9373 fax: (613) 728-0644
~ ~ ~ ~ ~
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>