> 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
