Re: [HACKERS] Building Documentation under Debian

If anyone cares, here is what I had to do to build the postgresql
documentation on a Debian system.

1. install jade, docbook, and unzip
apt-get install jade
apt-get install docbook
apt-get install unzip

2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
and unzip it somewhere (I chose /usr/share).

3. edit Makefile.custom to add appropriate HSTYLE and PSTYLE
definitions
HSTYLE= /usr/share/docbook/html
PSTYLE= /usr/share/docbook/print

And thats it.

--

Mark Hollomon
mhh(at)nortelnetworks(dot)com
ESN 451-9008 (302)454-9008

"Mark Hollomon" wrote:
>If anyone cares, here is what I had to do to build the postgresql
>documentation on a Debian system.

...

Thomas, don't you do some hand-tweaking after the standard build?

--
Oliver Elphick Oliver(dot)Elphick(at)lfix(dot)co(dot)uk
Isle of Wight http://www.lfix.co.uk/oliver
PGP key from public servers; key ID 32B8FAA1
========================================
"For we wrestle not against flesh and blood, but
against principalities, against powers, against the
rulers of the darkness of this world, against
spiritual wickedness in high places. Wherefore take
unto you the whole armour of God, that ye may be able
to withstand in the evil day, and having done all, to
stand." Ephesians 6:12,13

Mark Hollomon wrote:
>
> If anyone cares, here is what I had to do to build the postgresql
> documentation on a Debian system.

Thanks. I've added a section on Debian to the "Doc Guide" appendix.

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

> >If anyone cares, here is what I had to do to build the postgresql
> >documentation on a Debian system.
> Thomas, don't you do some hand-tweaking after the standard build?

For hardcopy, yes, to spiff up the page breaks and get the page
numbering right. But nothing gets tweaked for html...

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

> > > 2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
> > > and unzip it somewhere (I chose /usr/share).
> > FWIW, this stuff is available in a package as as docbook-stylesheets.
> Ah - that's what they named it. I looked for a package called dsssl.
> Where does the package install the files /usr/share, /usr/lib,
> something else?
> Thomas, change step 2 to:
> 2. install the docbook-stylesheets package
> apt-get install docbook-stylesheets
> drop the unzip package from step 1.

Actually, unless there is an objection I'll add the
docbook-stylesheets package but will retain mention of the Norm Walsh
zip files since these are usually a bit more up to date than those in
a packaged distro. I use them on my Linux box even though there are
rpms available...

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

On 2000-01-22, Thomas Lockhart mentioned:

> > > > 2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
> > > > and unzip it somewhere (I chose /usr/share).
> > > FWIW, this stuff is available in a package as as docbook-stylesheets.
> > Ah - that's what they named it. I looked for a package called dsssl.
> > Where does the package install the files /usr/share, /usr/lib,
> > something else?
> > Thomas, change step 2 to:
> > 2. install the docbook-stylesheets package
> > apt-get install docbook-stylesheets
> > drop the unzip package from step 1.
>
> Actually, unless there is an objection I'll add the
> docbook-stylesheets package but will retain mention of the Norm Walsh
> zip files since these are usually a bit more up to date than those in
> a packaged distro. I use them on my Linux box even though there are
> rpms available...

I think a lot of people found sgmltools to work for them (and perhaps a
lot more would, if they knew about it). That way you don't have to get
five different things and tune them to each other.

--
Peter Eisentraut Sernanders väg 10:115
peter_e(at)gmx(dot)net 75262 Uppsala
http://yi.org/peter-e/ Sweden

> I think a lot of people found sgmltools to work for them (and perhaps a
> lot more would, if they knew about it). That way you don't have to get
> five different things and tune them to each other.

Currently, sgmltools is in an essentially unsupported state. Cees De
Groot has tried to enlist additional developers, to no avail, and has
resigned.

But if someone has a procedure to install sgmltools and can give the
mods for the makefiles we already have I'll be happy to put it in the
docs.

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California