Re: Index creation

Re: Index creation

[Christophe Guillon]

Content-transfer-encoding: 7bit 
--------

	You have to do it in a two-pass process (for more information get the
docbook stylesheets documentation http://nwalsh.com/docbook/dsssl/db146d.zip ) :

	Run jade with the html-index variable set and the html stylesheet :
	jade -t sgml -d ...html/docbook.dsl -V html-index file.sgm

	generate the index pages with collateindex.pl (in the bin directory of the 
docbook stylesheets distribution) :
	perl collateindex.pl -o genindex.sgm

	Reprocess your document with jade
	jade -t sgml -d .../docbook.dsl file.sgm

	Your document must contain an external entity inclusion for the generated 
index :

	<...[
	<!ENTITY index	SYSTEM "genindex.sgm">
	]>
	...
	<!-- at a chapter/section level in your document -->
	&index;


	C.Guillon



	

ANNOUNCE Support for XML

[Eric Bischoff]

Hi all,

Now it's possible to convert XML DocBook files through Jade with the comfort 
of the DocBook-tools. As usually, everything is available under

	ftp://sourceware.cygnus.com/pub/docbook-tools/new-trials

or one of its mirrors.

The supported versions of the DTD include only DocBook 4.1 for the moment.

The conversion is still done through the DSSSL style sheets. Andrey and I are 
currently evaluating the best tools to process through XSL style sheets, with 
the help of Norm.

The docbook-utils detect automatically that the processed file is an XML file 
so the process is fully transparent. In case the automated detection would not
work, you can use a new "--dcl" option to specify the SGML declaration to 
use. This new feature works even if it's not a XML document of course.

The modified packages are:
- sgml-common-0.4:
  now includes the SGML declaration for XML
  the ISO entities have been patched to support the new "euro" character

- docbook-dtd41-xml-1.0:
  the XML DTD for DocBook

- docbook-utils-6.0:
  support for XML
  new --dcl option

Enjoy! ;-)

Any feedback welcome, of course.
 

Re: ANNOUNCE Support for XML

[Gregory Leblanc]

> The supported versions of the DTD include only DocBook 4.1 for the moment.
> 
> - docbook-utils-6.0:
>   support for XML
>   new --dcl option
> 
> Any feedback welcome, of course.


You asked for it...  :-)
I'm still having trouble re-locating this package at build time, and
there's a clear error in the spec file. I'll start with the spec file,
as that one is easier to fix
line 40 in docbook-utils.spec reads


make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en docdir=/usr/share/doc


it should read


make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en docdir=$DESTDIR/usr/share/doc


Not a big fix.  HOWEVER, that will break the RPM build, as the docbook
utils package doesn't really support being installed to anywhere other
than the locations that you've specified.  You can easily see this if
you try to build the package as a non-root user, or if you try using the
above fix to the spec file.  This is the last bug on my list, so as soon
as it gets fixed, I'll be happy to recomend that these tools be moved
out of the trials stage.  Later,

    Greg

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1040 bytes --]

Le Vendredi 10 Novembre 2000 21:35, vous avez écrit :
> > The supported versions of the DTD include only DocBook 4.1 for the
> > moment.
> >
> > - docbook-utils-6.0:
> >   support for XML
> >   new --dcl option
> >
> > Any feedback welcome, of course.
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=/usr/share/doc
>
> it should read
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=$DESTDIR/usr/share/doc

Will be done, thank you for the bug report.

> Not a big fix.  HOWEVER, that will break the RPM build, as the docbook
> utils package doesn't really support being installed to anywhere other
> than the locations that you've specified.  You can easily see this if
> you try to build the package as a non-root user, or if you try using the
> above fix to the spec file.  This is the last bug on my list, so as soon
> as it gets fixed, I'll be happy to recomend that these tools be moved
> out of the trials stage.  Later,

I hope that Mark gives his "go ahead" then ;-).

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 899 bytes --]

Le Vendredi 10 Novembre 2000 21:35, Gregory Leblanc a écrit :
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=/usr/share/doc
>
> it should read
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=$DESTDIR/usr/share/doc

I just checked. It is intentional that docdir is not buildrooted unlike 
mandir. It is due to the way the autoconf process works.

In the Makefile, you have the following:
	...
	htmldir = $(docdir)/html/docbook-utils-0.6
	...
	install-htmlDATA: $(html_DATA)
	        ...
	        $(mkinstalldirs) $(DESTDIR)$(htmldir)
                                          ^^^^^^^^^^^
so the buildrooting is done outside of the "docdir" variable by autoconf 
default behaviour.

I know this is not logical, but I'm not responsible for that.

I encourage you to give a try at building once agin the package to check what 
I'm saying.

Re: ANNOUNCE Support for XML

[Gregory Leblanc]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1677 bytes --]

> Le Vendredi 10 Novembre 2000 21:35, Gregory Leblanc a écrit :
> > make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> > docdir=/usr/share/doc
> >
> > it should read
> >
> > make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> > docdir=$DESTDIR/usr/share/doc
> 
> I just checked. It is intentional that docdir is not buildrooted unlike 
> mandir. It is due to the way the autoconf process works.
> 
> In the Makefile, you have the following:
>       ...
>       htmldir = $(docdir)/html/docbook-utils-0.6
>       ...
>       install-htmlDATA: $(html_DATA)
>               ...
>               $(mkinstalldirs) $(DESTDIR)$(htmldir)
>                                           ^^^^^^^^^^^
> so the buildrooting is done outside of the "docdir" variable by autoconf 
> default behaviour.


I don't really see how this works, but I'm not an auto* expert (yet).  

> I know this is not logical, but I'm not responsible for that.


Do you mean to say that I can't blame my autoconf problems on you?  :)
> I encourage you to give a try at building once agin the package to check what 
> I'm saying.


I know that this can be fixed somehow, as there are countless other
packages that work.  In it's current form, I am NOT able to build an 
RPM for the docbook-utils package unless I'm logged in as root.  The 
RPM guru's say that the only packages that you MUST be root to build are
the kernel packages, because root access is required to create the DEV
entries.  If you want info on building RPMs as non-root, let me know as 
I've got a short article on that. I'll post a message to the RPM-list
tomorrow to see if they can help out.  Thanks,    Greg

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1962 bytes --]

Le Lundi 13 Novembre 2000 07:08, Gregory Leblanc a écrit :
> > In the Makefile, you have the following:
> >       ...
> >       htmldir = $(docdir)/html/docbook-utils-0.6
> >       ...
> >       install-htmlDATA: $(html_DATA)
> >               ...
> >               $(mkinstalldirs) $(DESTDIR)$(htmldir)
> >                                           ^^^^^^^^^^^
> > so the buildrooting is done outside of the "docdir" variable by autoconf
> > default behaviour.
>
> I don't really see how this works, but I'm not an auto* expert (yet).

Assume it is braindead. Did it? Okay, you did half of the way... ;-)

> > I know this is not logical, but I'm not responsible for that.
>
> Do you mean to say that I can't blame my autoconf problems on you?  :)

You haven't autoconf problems. Everyone has a problem with autoconf.

;-)

> > I encourage you to give a try at building once agin the package to check
> > what I'm saying.
>
> I know that this can be fixed somehow, as there are countless other
> packages that work.

It hasn't to be fixed, because it is not a problem. The only problem is that 
when you read the specfile it looks strange that mandir and docdir behave 
differently.

>  In it's current form, I am NOT able to build an
> RPM for the docbook-utils package unless I'm logged in as root.

???? What happens? Should not be needed.

>  The
> RPM guru's say that the only packages that you MUST be root to build are
> the kernel packages, because root access is required to create the DEV
> entries.  If you want info on building RPMs as non-root, let me know as
> I've got a short article on that. I'll post a message to the RPM-list
> tomorrow to see if they can help out.  Thanks,    Greg

No it should not be necessary. First tell me what's wrong with docbook-utils.

-- 
Éric Bischoff  -  Documentation and Localization
Caldera (Deutschland) GmbH - Linux for eBusiness
Tel: +49 9131 7192 300 -  Fax: +49 9131 7192 399
http://www.caldera.de/

Re: ANNOUNCE Support for XML

[Gregory Leblanc]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1677 bytes --]

> Le Vendredi 10 Novembre 2000 21:35, Gregory Leblanc a écrit :
> > make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> > docdir=/usr/share/doc
> >
> > it should read
> >
> > make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> > docdir=$DESTDIR/usr/share/doc
> 
> I just checked. It is intentional that docdir is not buildrooted unlike 
> mandir. It is due to the way the autoconf process works.
> 
> In the Makefile, you have the following:
>       ...
>       htmldir = $(docdir)/html/docbook-utils-0.6
>       ...
>       install-htmlDATA: $(html_DATA)
>               ...
>               $(mkinstalldirs) $(DESTDIR)$(htmldir)
>                                           ^^^^^^^^^^^
> so the buildrooting is done outside of the "docdir" variable by autoconf 
> default behaviour.


I don't really see how this works, but I'm not an auto* expert (yet).  

> I know this is not logical, but I'm not responsible for that.


Do you mean to say that I can't blame my autoconf problems on you?  :)
> I encourage you to give a try at building once agin the package to check what 
> I'm saying.


I know that this can be fixed somehow, as there are countless other
packages that work.  In it's current form, I am NOT able to build an 
RPM for the docbook-utils package unless I'm logged in as root.  The 
RPM guru's say that the only packages that you MUST be root to build are
the kernel packages, because root access is required to create the DEV
entries.  If you want info on building RPMs as non-root, let me know as 
I've got a short article on that. I'll post a message to the RPM-list
tomorrow to see if they can help out.  Thanks,    Greg

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1040 bytes --]

Le Vendredi 10 Novembre 2000 21:35, vous avez écrit :
> > The supported versions of the DTD include only DocBook 4.1 for the
> > moment.
> >
> > - docbook-utils-6.0:
> >   support for XML
> >   new --dcl option
> >
> > Any feedback welcome, of course.
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=/usr/share/doc
>
> it should read
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=$DESTDIR/usr/share/doc

Will be done, thank you for the bug report.

> Not a big fix.  HOWEVER, that will break the RPM build, as the docbook
> utils package doesn't really support being installed to anywhere other
> than the locations that you've specified.  You can easily see this if
> you try to build the package as a non-root user, or if you try using the
> above fix to the spec file.  This is the last bug on my list, so as soon
> as it gets fixed, I'll be happy to recomend that these tools be moved
> out of the trials stage.  Later,

I hope that Mark gives his "go ahead" then ;-).

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 899 bytes --]

Le Vendredi 10 Novembre 2000 21:35, Gregory Leblanc a écrit :
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=/usr/share/doc
>
> it should read
>
> make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en
> docdir=$DESTDIR/usr/share/doc

I just checked. It is intentional that docdir is not buildrooted unlike 
mandir. It is due to the way the autoconf process works.

In the Makefile, you have the following:
	...
	htmldir = $(docdir)/html/docbook-utils-0.6
	...
	install-htmlDATA: $(html_DATA)
	        ...
	        $(mkinstalldirs) $(DESTDIR)$(htmldir)
                                          ^^^^^^^^^^^
so the buildrooting is done outside of the "docdir" variable by autoconf 
default behaviour.

I know this is not logical, but I'm not responsible for that.

I encourage you to give a try at building once agin the package to check what 
I'm saying.

ANNOUNCE Support for XML

[Eric Bischoff]

Hi all,

Now it's possible to convert XML DocBook files through Jade with the comfort 
of the DocBook-tools. As usually, everything is available under

	ftp://sourceware.cygnus.com/pub/docbook-tools/new-trials

or one of its mirrors.

The supported versions of the DTD include only DocBook 4.1 for the moment.

The conversion is still done through the DSSSL style sheets. Andrey and I are 
currently evaluating the best tools to process through XSL style sheets, with 
the help of Norm.

The docbook-utils detect automatically that the processed file is an XML file 
so the process is fully transparent. In case the automated detection would not
work, you can use a new "--dcl" option to specify the SGML declaration to 
use. This new feature works even if it's not a XML document of course.

The modified packages are:
- sgml-common-0.4:
  now includes the SGML declaration for XML
  the ISO entities have been patched to support the new "euro" character

- docbook-dtd41-xml-1.0:
  the XML DTD for DocBook

- docbook-utils-6.0:
  support for XML
  new --dcl option

Enjoy! ;-)

Any feedback welcome, of course.
 

Re: ANNOUNCE Support for XML

[Gregory Leblanc]

> The supported versions of the DTD include only DocBook 4.1 for the moment.
> 
> - docbook-utils-6.0:
>   support for XML
>   new --dcl option
> 
> Any feedback welcome, of course.


You asked for it...  :-)
I'm still having trouble re-locating this package at build time, and
there's a clear error in the spec file. I'll start with the spec file,
as that one is easier to fix
line 40 in docbook-utils.spec reads


make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en docdir=/usr/share/doc


it should read


make install prefix=$DESTDIR/usr mandir=$DESTDIR/usr/share/man/en docdir=$DESTDIR/usr/share/doc


Not a big fix.  HOWEVER, that will break the RPM build, as the docbook
utils package doesn't really support being installed to anywhere other
than the locations that you've specified.  You can easily see this if
you try to build the package as a non-root user, or if you try using the
above fix to the spec file.  This is the last bug on my list, so as soon
as it gets fixed, I'll be happy to recomend that these tools be moved
out of the trials stage.  Later,

    Greg

Re: ANNOUNCE Support for XML

[Eric Bischoff]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1962 bytes --]

Le Lundi 13 Novembre 2000 07:08, Gregory Leblanc a écrit :
> > In the Makefile, you have the following:
> >       ...
> >       htmldir = $(docdir)/html/docbook-utils-0.6
> >       ...
> >       install-htmlDATA: $(html_DATA)
> >               ...
> >               $(mkinstalldirs) $(DESTDIR)$(htmldir)
> >                                           ^^^^^^^^^^^
> > so the buildrooting is done outside of the "docdir" variable by autoconf
> > default behaviour.
>
> I don't really see how this works, but I'm not an auto* expert (yet).

Assume it is braindead. Did it? Okay, you did half of the way... ;-)

> > I know this is not logical, but I'm not responsible for that.
>
> Do you mean to say that I can't blame my autoconf problems on you?  :)

You haven't autoconf problems. Everyone has a problem with autoconf.

;-)

> > I encourage you to give a try at building once agin the package to check
> > what I'm saying.
>
> I know that this can be fixed somehow, as there are countless other
> packages that work.

It hasn't to be fixed, because it is not a problem. The only problem is that 
when you read the specfile it looks strange that mandir and docdir behave 
differently.

>  In it's current form, I am NOT able to build an
> RPM for the docbook-utils package unless I'm logged in as root.

???? What happens? Should not be needed.

>  The
> RPM guru's say that the only packages that you MUST be root to build are
> the kernel packages, because root access is required to create the DEV
> entries.  If you want info on building RPMs as non-root, let me know as
> I've got a short article on that. I'll post a message to the RPM-list
> tomorrow to see if they can help out.  Thanks,    Greg

No it should not be necessary. First tell me what's wrong with docbook-utils.

-- 
Éric Bischoff  -  Documentation and Localization
Caldera (Deutschland) GmbH - Linux for eBusiness
Tel: +49 9131 7192 300 -  Fax: +49 9131 7192 399
http://www.caldera.de/

Re: Index Creation

[Edward C. Bailey]

>>>>> "Chuck" == Chuck Mead <chuck@moongroup.com> writes:

Chuck> Will db2html generate an index if text from the document is tagged
Chuck> for it?

No.  However, check out the collateindex.pl script in the stylesheets RPM.
It'll do the trick...

                            Ed
-- 
Ed Bailey        Red Hat, Inc.          http://www.redhat.com/

Index Creation

[Chuck Mead]

Will db2html generate an index if text from the document is tagged for it?

  --
  Chuck Mead, CTO, MoonGroup Consulting, Inc. < http://www.moongroup.com >
  <chuck AT moongroup DOT com> PGP key available at: wwwkeys.us.pgp.net
  6:05pm  up 22 days, 13:37,  2 users,  load average: 0.29, 0.47, 0.82

Re: Index Creation

[Chuck Mead]

On 23 Jan 2000, Edward C. Bailey said:

ECB>>>>>> "Chuck" == Chuck Mead <chuck@moongroup.com> writes:
ECB>
ECB>Chuck> Will db2html generate an index if text from the document is tagged
ECB>Chuck> for it?
ECB>
ECB>No.  However, check out the collateindex.pl script in the stylesheets RPM.
ECB>It'll do the trick...

Thanx Ed I would never have known! :-)

  --
  Chuck Mead, CTO, MoonGroup Consulting, Inc. < http://www.moongroup.com >
  <chuck AT moongroup DOT com> PGP key available at: wwwkeys.us.pgp.net
  8:05pm  up 22 days, 15:37,  2 users,  load average: 0.12, 0.19, 0.24

Re: Index Creation

[Norman Walsh]

/ Chuck Mead <chuck@moongroup.com> was heard to say:
| Will db2html generate an index if text from the document is tagged for it?

I don't know, but generating an index is multi-step process.
See http://nwalsh.com/docbook/dsssl/doc/otherdoc.html

                                        Cheers,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | The average man, who does not know
http://nwalsh.com/                 | what to do with his life, wants
                                   | another one which will last
                                   | forever.--Anatole France

Re: Index Creation

[Chuck Mead]

On Sun, 23 Jan 2000, Norman Walsh said:

NW>/ Chuck Mead <chuck@moongroup.com> was heard to say:
NW>| Will db2html generate an index if text from the document is tagged for it?
NW>
NW>I don't know, but generating an index is multi-step process.
NW>See http://nwalsh.com/docbook/dsssl/doc/otherdoc.html

Thank you... I was already playing with the collateindex.pl script... This
pointer to documentation on the process will help a lot!

:-)

  --
  Chuck Mead, CTO, MoonGroup Consulting, Inc. < http://www.moongroup.com >
  <chuck AT moongroup DOT com> PGP key available at: wwwkeys.us.pgp.net
 10:05pm  up 22 days, 17:37,  3 users,  load average: 0.00, 0.00, 0.00

Index creation

[Andreas Kostyrka]

Hi!

I've been wondering how to create an index with the current docbook tools?

Adding <indexterm>s doesn't work, even when one adds an empty
<index></index> section (as it is done with <toc></toc>).

Andreas
--
Andreas Kostyrka                     | andreas@mtg.co.at
phone: +43/1/7070750                 | phone: +43/676/4091256   
MTG Handelsges.m.b.H.                | fax:   +43/1/7065299
Raiffeisenstr. 16/9                  | 2320 Zwoelfaxing AUSTRIA