Thread: sgml

Hi,

I'm writing some documentation about my recent changes to the backend
but I'm having problems with the sgml format used in the doc sources.
The makefile in doc/src references some files in /usr/lib/sgml/stylesheets
which aren't installed in my system. I would like to know where to find
those files and if it is possible to convert the sgml format to and from
some format easier to edit. I've found converters to lyx and html, which
could easily be edited with proper programs, but none to convert back one
of these formats into sgml. Any suggestion?

--
Massimo Dal Zotto

+----------------------------------------------------------------------+
|  Massimo Dal Zotto                email:  dz@cs.unitn.it             |
|  Via Marconi, 141                 phone:  ++39-461-534251            |
|  38057 Pergine Valsugana (TN)     www:  http://www.cs.unitn.it/~dz/  |
|  Italy                            pgp:  finger dz@tango.cs.unitn.it  |
+----------------------------------------------------------------------+

Hi,
I have cvs'ed PostgreSQL

cd /usr/local/pgsql
cvs -z3 update -d

and when I do:

cd src
autoconf (all fine)
autoheader (lot's of harmless warning messages)
./configure --with-tcl --with-perl

configure: warning: perl support disabled; must be root to install

make

some harmless messages
All of PostgreSQL is successfully made. Ready to install.

make install

Thank you for choosing PostgreSQL, the most advanced open source database
engine.

cd ../doc

make
if [ ! -d /usr/local/pgsql/doc ]; then mkdir /usr/local/pgsql/doc; fi

cd src

oh mei (18.000 lines with docs on my screen!!)

cd /usr/lib/sgml
mkdir stylesheets
cd stylesheets
mkdir jade
ln -s /usr/lib/dsssl/stylesheets/docbook /usr/lib/sgml/stylesheets/jade

cd /usr/local/pgsql/doc/src
make

only two warnings
jade:ref/set.sgml:455:5:E: document type does not allow element "PARA"
here
jade:start.sgml:229:26:X: reference to non-existent ID "PROGRAMMERS-GUIDE"

Wow, looks great! Many thanks to Oliver.

-Egon

> I'm writing some documentation about my recent changes to the backend
> but I'm having problems with the sgml format used in the doc sources.

OK, first off, just remember that the words are the most important, and
the markup can be fixed later. And I'll help as much as you want.

> The makefile in doc/src references some files in
>   /usr/lib/sgml/stylesheets
> which aren't installed in my system. I would like to know where to
> find those files

  http://www.nwalsh.com/docbook/dsssl/index.html

I'm using the v1.18 experimental release at the moment. Look in the
appendix on docs inside the postgres integrated documentation for a
description of what your Makefile.custom would look like.

The docs also discuss how to install jade and the other pieces used to
convert the sgml into html and hardcopy.

> ... and if it is possible to convert the sgml format to
> and from some format easier to edit. I've found converters to lyx and
> html, which could easily be edited with proper programs, but none to
> convert back one of these formats into sgml. Any suggestion?

The problem with both lyx (latex) and html is that these formats mark up
appearance, not content. So, there is no easy way to go back to the
complete content-markup of the original sgml. I've heard that the lyx
folks are working toward understanding DocBook sgml, but would guess
that it isn't coming soon.

I have the impression that FrameMaker can use sgml for input and output,
but that is a commercial product.

emacs has an sgml editing mode, but I haven't been able to get it to
work completely for me yet. It has trouble finding or reading the DTDs
to teach itself how to understand the DocBook definitions.

I just type the stuff in emacs or vi, which is pretty primitive.

                        - Tom