docbook: Thread: Help! How do I generate use sgmltools under debian to format LDP docs?

I've been fighting with sgmltools for a while now, and it's been
throughly frustrating experience.  I need some help!

I'm using debian unstable, and I've installed the sgmltools-lite
package, jade, docbook-dssl, and all the rest.  

I downloaded big-howto-template.sgml, and tried to generate a txt file
using:

	sgmltools -b txt big-howto-template.sgml

And I got something which didn't have a table of contents, and which
didn't number the sections.  You also couldn't distinguish subsections
from sections; it looked horrible.

OK, says, I, I'll download ldp.dsl from the tdlp.org LDP Author Guide
page, and try to use it:

	sgmltools -b txt -s ldp.dsl big-howto-template.sgml

And the generated txt file looks like garbage:

>HOWTO-template for Big HOWTOsSteinGjoen ####@####.#### GregoryLeblanc
####@####.#### GregFerguson ####@####.#### 0.062001-01-08gjf Changed
>date format (YYYY-MM-DD) template This is a fully working template for big
>HOWTOs. The source contains fully described slots to make a convenient
>framework for you to fill in for making your own HOWTO; suggesting some names,
>conventions and contents for the chapters. SGML source for this doc

How do you make sgmltools do anythign at all sane?  I've tried reading
all of the man pages, and HOWTO's, and I can't find anything which tells
me how to make the stupid tool work correctly.

Help?

						- Ted

Theodore Ts'o ####@####.#### wrote:
> How do you make sgmltools do anythign at all sane?  I've tried reading
> all of the man pages, and HOWTO's, and I can't find anything which
> tells me how to make the stupid tool work correctly.

Just install the docbook-utils package and use the docbook2html,
docbook2txt, docbook2pdf etc. directly

	Giridhar

--
Y Giridhar Appaji Nag        ####@####.####

Not throwing out the baby with the bath-water doesn't mean that
you cannot improve the system. I'm only arguing against stupid
people who think they need a revolution to improve - most real
improvements are evolutionary. - Linus Torvalds

an individual are not necessarily those of UbiNetics

On Sun, Apr 20, 2003 at 04:50:46PM +0530, Y Giridhar Appaji Nag wrote:
> 
> Theodore Ts'o ####@####.#### wrote:
> > How do you make sgmltools do anythign at all sane?  I've tried reading
> > all of the man pages, and HOWTO's, and I can't find anything which
> > tells me how to make the stupid tool work correctly.
> 
> Just install the docbook-utils package and use the docbook2html,
> docbook2txt, docbook2pdf etc. directly

Or skip all the wrapper scripts and just use jade direct:
 
 jade -t sgml -ihtml -d /home/hal/ldp/ldp.dsl\#html $some_file.sgml

That should generate multi-page HTML.

-- 
Hal Burgiss
 

On Sat, Apr 19, 2003 at 10:47:05PM -0400, Theodore Ts'o wrote:
> 
> I've been fighting with sgmltools for a while now, and it's been
> throughly frustrating experience.  I need some help!
> 
> I'm using debian unstable, and I've installed the sgmltools-lite
> package, jade, docbook-dssl, and all the rest.  
> 

I don't know about debian (you may have to sort out the pathology),
but take a look at my make file at:

http://cvsview.tldp.org/index.cgi/*checkout*/LDP/howto/docbook/Linux-Complete-Backup-and-Recovery-HOWTO/Makefile?rev=HEAD&content-type=text/plain

And, BTW, thanks for all the work you've done on Linux.

-- 

Charles Curley                  /"\    ASCII Ribbon Campaign
Looking for fine software       \ /    Respect for open standards
and/or writing?                  X     No HTML/RTF in email
http://www.charlescurley.com    / \    No M$ Word docs in email

Key fingerprint = CE5C 6645 A45A 64E4 94C0  809C FFF6 4C48 4ECD DFDB