public inbox for docbook-tools-discuss@sourceware.org
 help / color / mirror / Atom feed
* Indexes in PDF docs
  2001-12-19 22:49 Indexes in PDF docs Paul Webb
@ 2001-02-22  1:54 ` Paul Webb
  2001-12-19 22:49 ` Peter Toft
  1 sibling, 0 replies; 8+ messages in thread
From: Paul Webb @ 2001-02-22  1:54 UTC (permalink / raw)
  To: docbook-tools-discuss

Hi 

I have marked up my document by using the
<indexterm><primary>...</primary></indexterm> method as described in 
'DocBook: The Definitive Guide' I've also managed to produce an index in the
HTML version of the doc by using collateindex.pl.

But how do I produce an index in the PDF? Can I use collateindex.pl in
conjunction with some other commands or is there an alternative method?

Thanks in advance for your help.

Paul.

P.S.

I'm using:

jade v1.2.1-16
sp 1.3.4-1.2.1-16
cygnus stylesheets 0.10.2-2
docbase 0.7.8
sgml-base 1.2.1


-- 




^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49 ` Peter Toft
@ 2001-02-22 13:28   ` Peter Toft
  2001-12-19 22:49   ` Wookey
  1 sibling, 0 replies; 8+ messages in thread
From: Peter Toft @ 2001-02-22 13:28 UTC (permalink / raw)
  To: Paul Webb; +Cc: docbook-tools-discuss

On Thu, 22 Feb 2001, Paul Webb wrote:

> Hi
>
> I have marked up my document by using the
> <indexterm><primary>...</primary></indexterm> method as described in
> 'DocBook: The Definitive Guide' I've also managed to produce an index in the
> HTML version of the doc by using collateindex.pl.
>
> But how do I produce an index in the PDF? Can I use collateindex.pl in
> conjunction with some other commands or is there an alternative method?

Sure you can;

For HTML as well as PS/PDF I use


perl ./collateindex.pl  -s Symbols -t Index \
  -g -i index -N -o index.sgml
cp *.sgml tempdir
(cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \
   -V html-index -V nochunks MAIL_FILE.sgml > foo.html)
perl ./collateindex.pl -s Symbols -t Index  -g -i index \
 -o index.sgml tempdir/HTML.index

If it bites back mail me again.

-- 

Peter Toft, Ph.D. [pto@sslug.dk] http://www.sslug.dk/~pto

You are not alone. The penguins are everywhere.



^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49   ` Wookey
@ 2001-02-23  9:08     ` Wookey
  2001-12-19 22:49     ` Norman Walsh
  1 sibling, 0 replies; 8+ messages in thread
From: Wookey @ 2001-02-23  9:08 UTC (permalink / raw)
  To: Peter Toft; +Cc: docbook-tools-discuss

On Thu 22 Feb, Peter Toft wrote:
> On Thu, 22 Feb 2001, Paul Webb wrote:

for clarity - I'm working with Paul Webb on the same docs

> > I have marked up my document by using the
> > <indexterm><primary>...</primary></indexterm> method as described in
> > 'DocBook: The Definitive Guide' I've also managed to produce an index in the
> > HTML version of the doc by using collateindex.pl.

> > But how do I produce an index in the PDF? Can I use collateindex.pl in
> > conjunction with some other commands or is there an alternative method?

> Sure you can;

> For HTML as well as PS/PDF I use


> perl ./collateindex.pl  -s Symbols -t Index \
>   -g -i index -N -o index.sgml
> cp *.sgml tempdir
> (cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \
>    -V html-index -V nochunks MAIL_FILE.sgml > foo.html)
> perl ./collateindex.pl -s Symbols -t Index  -g -i index \
>  -o index.sgml tempdir/HTML.index

> If it bites back mail me again.

I don't quite get how this is supposed to work. The above is essentially what
we are doing for our HTML output (apart from the -V nochunks) and I get an
sgml index file which refers to <A NAME=AENxxx> tags in the HTML output. But
I don't understand how to get from here to a PDF file.

The nub seems to be
jade -t sgml -ihtml -Vhtml-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t sgml -ihtml <blah>
reprocesses the original including the index on the end into indexed html.

So is the equivalent for pdf as follows:?
jade -t sgml -ihtml -Vhtml-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t tex -ihtml <blah>
pdfjadetex
pdfjadetex
pdfjadetex

ie I just change the backend type? And what does that -i option do?
/usr/doc/jade doesn't seem to mention it, but it appears to be important.

If not do I need different index-generating options -i and -V <something>

If I just try the above then I get a 5M tex file (instead of the 1Mb I was
previously getting) and attempting to process it to PDF with jadetex make Tex
barf with 'out of memory' almost immediately. Maybe this is working but I'm
up against the 'TeX memory problem' again?

Trying a slightly different tack (as I'm not sure about that -i option):
jade -t sgml -ihtml -V html-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t tex -V html-index <blah>
pdfjadetex
pdfjadetex


This produces a sensible size tex file and it processes OK. It even has an
index, but most of the page numbers are '?' and the rest are '-999', so
that's not quite right. It feels like I'm getting warm....

Trying the above without even -V html-index on the second jade run works a
bit better still - now I have about a third of the index page numbers filled
in, but only around page 12, pages 70-76 and page 124. Nor do they point to
the correct pages :-(

Can someone tell me if I'm on the right track so I can try the right
things/ask the right questions? Or even better just tell me which rune I need
:-)

Is it just a matter of changing the second jade run or do I need to generate
the index with different options in the first place?

thanx muchly.

Wookey
-- 
Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK  Tel (00 44) 1223 811679
work: http://www.aleph1.co.uk/     play: http://www.chaos.org.uk/~wookey/

^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49     ` Norman Walsh
@ 2001-02-23 12:58       ` Norman Walsh
  0 siblings, 0 replies; 8+ messages in thread
From: Norman Walsh @ 2001-02-23 12:58 UTC (permalink / raw)
  To: Wookey; +Cc: Peter Toft, docbook-tools-discuss

/ Wookey <wookey@aleph1.co.uk> was heard to say:
| I don't quite get how this is supposed to work. The above is essentially what
| we are doing for our HTML output (apart from the -V nochunks) and I get an
| sgml index file which refers to <A NAME=AENxxx> tags in the HTML output. But
| I don't understand how to get from here to a PDF file.

The SGML index file doesn't use <a>, it uses <ulink>, and with the
appropriate options you can run this through the print backend and get
a print index.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com> | I'm not tense, I'm just terribly,
http://nwalsh.com/            | terribly alert.

^ permalink raw reply	[flat|nested] 8+ messages in thread

* Indexes in PDF docs
@ 2001-12-19 22:49 Paul Webb
  2001-02-22  1:54 ` Paul Webb
  2001-12-19 22:49 ` Peter Toft
  0 siblings, 2 replies; 8+ messages in thread
From: Paul Webb @ 2001-12-19 22:49 UTC (permalink / raw)
  To: docbook-tools-discuss

Hi 

I have marked up my document by using the
<indexterm><primary>...</primary></indexterm> method as described in 
'DocBook: The Definitive Guide' I've also managed to produce an index in the
HTML version of the doc by using collateindex.pl.

But how do I produce an index in the PDF? Can I use collateindex.pl in
conjunction with some other commands or is there an alternative method?

Thanks in advance for your help.

Paul.

P.S.

I'm using:

jade v1.2.1-16
sp 1.3.4-1.2.1-16
cygnus stylesheets 0.10.2-2
docbase 0.7.8
sgml-base 1.2.1


-- 




^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49 ` Peter Toft
  2001-02-22 13:28   ` Peter Toft
@ 2001-12-19 22:49   ` Wookey
  2001-02-23  9:08     ` Wookey
  2001-12-19 22:49     ` Norman Walsh
  1 sibling, 2 replies; 8+ messages in thread
From: Wookey @ 2001-12-19 22:49 UTC (permalink / raw)
  To: Peter Toft; +Cc: docbook-tools-discuss

On Thu 22 Feb, Peter Toft wrote:
> On Thu, 22 Feb 2001, Paul Webb wrote:

for clarity - I'm working with Paul Webb on the same docs

> > I have marked up my document by using the
> > <indexterm><primary>...</primary></indexterm> method as described in
> > 'DocBook: The Definitive Guide' I've also managed to produce an index in the
> > HTML version of the doc by using collateindex.pl.

> > But how do I produce an index in the PDF? Can I use collateindex.pl in
> > conjunction with some other commands or is there an alternative method?

> Sure you can;

> For HTML as well as PS/PDF I use


> perl ./collateindex.pl  -s Symbols -t Index \
>   -g -i index -N -o index.sgml
> cp *.sgml tempdir
> (cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \
>    -V html-index -V nochunks MAIL_FILE.sgml > foo.html)
> perl ./collateindex.pl -s Symbols -t Index  -g -i index \
>  -o index.sgml tempdir/HTML.index

> If it bites back mail me again.

I don't quite get how this is supposed to work. The above is essentially what
we are doing for our HTML output (apart from the -V nochunks) and I get an
sgml index file which refers to <A NAME=AENxxx> tags in the HTML output. But
I don't understand how to get from here to a PDF file.

The nub seems to be
jade -t sgml -ihtml -Vhtml-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t sgml -ihtml <blah>
reprocesses the original including the index on the end into indexed html.

So is the equivalent for pdf as follows:?
jade -t sgml -ihtml -Vhtml-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t tex -ihtml <blah>
pdfjadetex
pdfjadetex
pdfjadetex

ie I just change the backend type? And what does that -i option do?
/usr/doc/jade doesn't seem to mention it, but it appears to be important.

If not do I need different index-generating options -i and -V <something>

If I just try the above then I get a 5M tex file (instead of the 1Mb I was
previously getting) and attempting to process it to PDF with jadetex make Tex
barf with 'out of memory' almost immediately. Maybe this is working but I'm
up against the 'TeX memory problem' again?

Trying a slightly different tack (as I'm not sure about that -i option):
jade -t sgml -ihtml -V html-index <blah> generates an index file
collateindex put this back into sgml form, then
jade -t tex -V html-index <blah>
pdfjadetex
pdfjadetex


This produces a sensible size tex file and it processes OK. It even has an
index, but most of the page numbers are '?' and the rest are '-999', so
that's not quite right. It feels like I'm getting warm....

Trying the above without even -V html-index on the second jade run works a
bit better still - now I have about a third of the index page numbers filled
in, but only around page 12, pages 70-76 and page 124. Nor do they point to
the correct pages :-(

Can someone tell me if I'm on the right track so I can try the right
things/ask the right questions? Or even better just tell me which rune I need
:-)

Is it just a matter of changing the second jade run or do I need to generate
the index with different options in the first place?

thanx muchly.

Wookey
-- 
Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK  Tel (00 44) 1223 811679
work: http://www.aleph1.co.uk/     play: http://www.chaos.org.uk/~wookey/

^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49   ` Wookey
  2001-02-23  9:08     ` Wookey
@ 2001-12-19 22:49     ` Norman Walsh
  2001-02-23 12:58       ` Norman Walsh
  1 sibling, 1 reply; 8+ messages in thread
From: Norman Walsh @ 2001-12-19 22:49 UTC (permalink / raw)
  To: Wookey; +Cc: Peter Toft, docbook-tools-discuss

/ Wookey <wookey@aleph1.co.uk> was heard to say:
| I don't quite get how this is supposed to work. The above is essentially what
| we are doing for our HTML output (apart from the -V nochunks) and I get an
| sgml index file which refers to <A NAME=AENxxx> tags in the HTML output. But
| I don't understand how to get from here to a PDF file.

The SGML index file doesn't use <a>, it uses <ulink>, and with the
appropriate options you can run this through the print backend and get
a print index.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com> | I'm not tense, I'm just terribly,
http://nwalsh.com/            | terribly alert.

^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: Indexes in PDF docs
  2001-12-19 22:49 Indexes in PDF docs Paul Webb
  2001-02-22  1:54 ` Paul Webb
@ 2001-12-19 22:49 ` Peter Toft
  2001-02-22 13:28   ` Peter Toft
  2001-12-19 22:49   ` Wookey
  1 sibling, 2 replies; 8+ messages in thread
From: Peter Toft @ 2001-12-19 22:49 UTC (permalink / raw)
  To: Paul Webb; +Cc: docbook-tools-discuss

On Thu, 22 Feb 2001, Paul Webb wrote:

> Hi
>
> I have marked up my document by using the
> <indexterm><primary>...</primary></indexterm> method as described in
> 'DocBook: The Definitive Guide' I've also managed to produce an index in the
> HTML version of the doc by using collateindex.pl.
>
> But how do I produce an index in the PDF? Can I use collateindex.pl in
> conjunction with some other commands or is there an alternative method?

Sure you can;

For HTML as well as PS/PDF I use


perl ./collateindex.pl  -s Symbols -t Index \
  -g -i index -N -o index.sgml
cp *.sgml tempdir
(cd tempdir; jade -t sgml -ihtml -d $(cygnus)\#print \
   -V html-index -V nochunks MAIL_FILE.sgml > foo.html)
perl ./collateindex.pl -s Symbols -t Index  -g -i index \
 -o index.sgml tempdir/HTML.index

If it bites back mail me again.

-- 

Peter Toft, Ph.D. [pto@sslug.dk] http://www.sslug.dk/~pto

You are not alone. The penguins are everywhere.



^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2001-12-19 22:49 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2001-12-19 22:49 Indexes in PDF docs Paul Webb
2001-02-22  1:54 ` Paul Webb
2001-12-19 22:49 ` Peter Toft
2001-02-22 13:28   ` Peter Toft
2001-12-19 22:49   ` Wookey
2001-02-23  9:08     ` Wookey
2001-12-19 22:49     ` Norman Walsh
2001-02-23 12:58       ` Norman Walsh

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).