From: Susan Korgen (skorgen@intersystems.com)
Date: Fri Apr 30 2004 - 13:09:41 PDT
Hello Alexander (and folks at RenderX):
I have fixed the problem I reported!
The index.xsl file that I downloaded with a trial RenderX version in April 2003
was designed to restrict page number "hits" to one per chapter, apparently
as a way of eliminating the chance of duplicate "hits" on the same page.
Coincidentally, in my test file, all of my index terms that I expected to have
multiple page references were WITHIN THE SAME CHAPTER. This created
the illusion of being unable to generate multiple page references. Only the
first hit in each chapter was displayed. Since I indexed only one chapter, only
one "hit" was listed per term in the index.
As soon as I put more of the same index term in other chapters, the
first "hit" in each chapter displayed correctly in the index, and I was able
to see multiple "hits". Subsequent hits within each chapter were suppressed,
as the file was designed to do.
Alexander, I would be happy to send you this "grandchild" of an old
index.xsl from RenderX. It might be of academic interest, FWIW.
In the short term, now that I know what it is doing, I will adapt it to
permit more "hits" within chapters.
In the long term, I expect to use the plan you suggested, creating a
customization layer on top of Norman Walsh's standard stylesheets
and abandoning this unsupported trial code.
Many thanks, again, for your support on this issue.
And to everyone on this list, for your patience.
Susan
At 03:18 PM 4/30/2004 -0400, you wrote:
>Hi Alexander,
>
>I downloaded a bunch of stylesheets from Norman Walsh's web site, but
>there are
>so many of them. Would you tell me exactly which of the standard
>stylesheet files
>from Normal Walsh you used, when you successfully built my index?
>
>Thanks, Susan
>
>
>At 10:07 AM 4/30/2004 -0400, you wrote:
>>Many thanks.
>>
>>How do I obtain the standard Docbook stylesheets created by Norman Walsh?
>>
>>
>>At 03:20 PM 4/30/2004 +0400, you wrote:
>>>Hello Susan,
>>>
>>>Your previous message to this list bounced because of attached file.
>>>The policy of this list is to reject messages more then 40000
>>>characters long (this includes Base64-encoded attachments).
>>>
>>>The stylesheets you refer to were proprietary stylesheets used by
>>>RenderX to format XEP documentation written in a subset of Docbook.
>>>The aim of 'index.xsl' module was to support Docbook indexes, however it
>>>was rather experimental and we have never actually used it much. We
>>>shipped it only with several XEP versions up to XEP 3.4.
>>>Note that those stylesheets were not intended to be used as example
>>>and we do not provide any guarantee that they there bugs-free nor we
>>>support them in any form.
>>>
>>>Starting from XEP 3.5 we completely give up use of the proprietary
>>>stylesheets and decided to use standard Docbook stylesheets created by
>>>Norman Walsh. This allowed us to use the full set of Docbook elements
>>>and to avoid problems with maintaining our own set of stylesheets.
>>> >From that time on, XEP distribution contains only customization
>>>stylesheets which are supposed to work with standard Docbook XSL
>>>stylesheets.
>>>
>>>I have added an empty index element (<index/>)to the end of your
>>>document (before </book>) in order to trigger Index generation and
>>>processed this document with standard Docbook stylesheets - the index
>>>was successfully generated. I'd rather suggest to switch to the
>>>standard Docbook stylesheets. You can use your own customization layer
>>>(as we did now) in order to achieve desired appearance. Customization
>>>techniques are thoroughly described in Bob Stayton's excellent book
>>>"DocBook XSL: The Complete Guide" (http://www.sagehill.net/docbookxsl/)
>>>
>>>
>>>Best regards,
>>>Alexander Peshkov mailto:peshkov@renderx.com
>>>RenderX
>>>
>>>
>>>SK> I've had a response to my email (not from RenderX) that says there
>>>SK> is both too much and not enough information for anyone to work
>>>SK> on the problem.
>>>
>>>SK> I would be delighted to correspond with anyone who can tell me a
>>>SK> better way to describe my problem, so that a solution can be found.
>>>
>>>SK> Indexing is difficult, so I assume any solutions would be of general
>>>interest.
>>>
>>>SK> My assumption has been that there is a simple syntax error in
>>>SK> my index_xep.xsl file that a knowledgeable person would spot quickly.
>>>
>>>SK> My hope is that since my file is based on one I downloaded from RenderX,
>>>SK> there is someone at RenderX who understands it better than I do.
>>>
>>>SK> We have been RenderX customers for nearly a year now and this is our
>>>SK> first serious problem in using the product. I hope I can get some help.
>>>
>>>SK> If anyone would like to call me rather than send email,
>>>SK> my number is 617-577-3642.
>>>
>>>SK> Susan
>>>
>>>SK> -------------------
>>>SK> (*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>>>SK> in the body of the message to majordomo@renderx.com from the address
>>>SK> you are subscribed from.
>>>SK> (*) By using the Service, you expressly agree to these Terms of
>>>Service http://www.renderx.com/tos.html
>>>
>>>
>>>-------------------
>>>(*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>>>in the body of the message to majordomo@renderx.com from the address
>>>you are subscribed from.
>>>(*) By using the Service, you expressly agree to these Terms of Service
>>>http://www.renderx.com/tos.html
>>
>>-------------------
>>(*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>>in the body of the message to majordomo@renderx.com from the address
>>you are subscribed from.
>>(*) By using the Service, you expressly agree to these Terms of Service
>>http://www.renderx.com/tos.html
>
>-------------------
>(*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>in the body of the message to majordomo@renderx.com from the address
>you are subscribed from.
>(*) By using the Service, you expressly agree to these Terms of Service
>http://www.renderx.com/tos.html
-------------------
(*) To unsubscribe, send a message with words 'unsubscribe xep-support'
in the body of the message to majordomo@renderx.com from the address
you are subscribed from.
(*) By using the Service, you expressly agree to these Terms of Service http://www.renderx.com/tos.html
This archive was generated by hypermail 2.1.5 : Fri Apr 30 2004 - 13:19:26 PDT