Re: [docbook-apps] Re: Indexing.
On 05/05/12 17:15, Norman Walsh wrote: The sources for The Definitive Guide have quite a bit of index markup from the O'Reilly copyedit. That might be a good place to look for examples. Indexing is an art. Yes. Exactly how it's described in this book I'm reading. Tks for the reference, I'll take a look at tdg Norm regards -- Dave Pawson XSLT XSL-FO FAQ. http://www.dpawson.co.uk - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Re: Indexing.
On 05/05/12 17:17, Norman Walsh wrote: davepda...@dpawson.co.uk writes: I did made a note to for myself some time back that anindexterm inside a footnote caused an error. I was using oXygenXML v12 at the time. Not sure if this is still the case. Footnotes aren't normally indexed is one piece of advice. So perhaps docbook is right. I have a vague recollection that we may have loosened that restriction. Be seeing you, norm To be precise the 'guideline' is Don't, unless they contain substantive content relevant to the text. I.e. bit gray? regards -- Dave Pawson XSLT XSL-FO FAQ. http://www.dpawson.co.uk - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Re: Indexing.
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 05/05/2012 11:15 AM, Norman Walsh wrote: ... Indexing is an art. 'Kurt Vonnegut's novel Cat's Cradle includes a character who is a professional indexer and believes that indexing [is] a thing that only the most amateurish author [undertakes] to do for his own book. She claims to be able to read an author's character through the index he created for his own history text, and warns the narrator, an author, Never index your own book.' from http://en.wikipedia.org/wiki/Index_(publishing)#References_in_popular_culture -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQEcBAEBAgAGBQJPpvj5AAoJEMHeSXG7afUhQrkH/33a0caryBGKwDSKB8Vyd8zp 0yzLObywaE2f0hU93ZN1G3A0/UR5tXbY8kzLw6BMQizcHzXOw4JJ0KaKJgosUJ9o iiP5wMA6hbcebbSNl5D3YyGnSfipvX3pY1TFEDZ9Y8b6PSwqCUOpcV2lWeIXwo7K A+wIdCtyYlarLs/ceYmnUXfW6nWqw+haysIOmXrkFhj7u7xBMrgMGJqACUNIY1qG lcxf9dkQkAy1tTocXr7Fs33J1N0hRD8hOLMg4UZYadyZIT45i8OqF1Y4oeFgC1yV E8wFP2QO81RjK0nvJzE49rcDf/UGw4t4OhkthxTc+a82SdM9WaYoZ3fAgFKl5Xk= =r/FJ -END PGP SIGNATURE- - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: Indexing.
davep da...@dpawson.co.uk writes: Are you asking more about the indexing task itself or about the technical aspect? The docbook aspects please Thomas The sources for The Definitive Guide have quite a bit of index markup from the O'Reilly copyedit. That might be a good place to look for examples. Speaking about the indexing task itself, IHMO this is something that some books don't take it seriously enough. An index is a service to make the book more accessible to readers. I've seen lots of bad index which came just as an alibi, but with no value. So it isn't a surprise that a good index takes time and energy. When I've created the index of my book, it took lots of iterations and I guess it still isn't perfect. :) Indexing is an art. Be seeing you, norm -- Norman Walsh n...@nwalsh.com | There is no kind of dishonesty http://www.oasis-open.org/docbook/ | into which otherwise good people Chair, DocBook Technical Committee | more easily and frequently fall | than that of defrauding the | government.--Benjamin Franklin pgp2y9Pk5YZcB.pgp Description: PGP signature
[docbook-apps] Re: Indexing.
davep da...@dpawson.co.uk writes: I did made a note to for myself some time back that anindexterm inside a footnote caused an error. I was using oXygenXML v12 at the time. Not sure if this is still the case. Footnotes aren't normally indexed is one piece of advice. So perhaps docbook is right. I have a vague recollection that we may have loosened that restriction. Be seeing you, norm -- Norman Walsh n...@nwalsh.com | She was mostly immensely relieved http://www.oasis-open.org/docbook/ | to think that virtually everything Chair, DocBook Technical Committee | that anybody had ever told her was | wrong. (Mrs. E. Kapelsen)--Douglas | Adams pgpSgqUmlw0k9.pgp Description: PGP signature