[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [SLUG] Tools for documentation.

Wrote Andrew Morton on Tue, Jun 27, 2000 at 08:20:04AM +0000:
> Jeff Waugh wrote:
> > 
> > DocBook is extraordinarily fast to work with - once you have a working
> > knowledge of the tags you need, it's lucid.
>
> erm..  I once did a 60 pager in Docbook and nearly died.  It were
> 'orrid.
> 
> What tool do you people use for the actual editing?  Do you edit the
> tags directly?  Use emacs PSGML mode?  Anyone tried Conglomerate?  (I
> think that's xml-only...)

I did a 70 pager in DocBook using Vim. It gave me syntax highlighting
but that was about it. I'm accustomed to writing my HTML by hand though
so the angle brackets are rather comfortable. I remember it being much
more annoying a few years ago.

I have used LyX in DocBook mode - it is very nice but not particularly
powerful. 

It doesn't have all the tags built in (mainly has the structural ones)
and you enter the rest by hand. But this is still useful for converting
HTML/whatever docs to DocBook because you simply paste the document in
then mark sections, authors, <pre> style sections, etc. 

psgml I have not braved yet. I am on the way. I spent half a day
becoming proficient with emacs but didn't get far enough to find it
really useful (easy indenting, nice syntax highlighting) so I lapsed
back to Vim. psgml sounds like what I need though - C-c C-e gives you
the list of tags available where you are at the moment.

Conglomerate:

	Is only in proof of concept stage at the moment. The proof, however,
	looks very very nice. I like the idea a lot.

	http://www.conglomerate.net

	Even if it only supports XML, so does DocBook, so no problem there.

	It is being totally rewritten/implemented at the moment so waiting
	with dripping jaws.

> And one other thing:  changebars.

Non capito. What is a changebar?

Chuck

               [ charles hamilton dale <bug@nospam.aphid.net> ]
--
SLUG - Sydney Linux Users Group Mailing List - http://www.slug.org.au
To unsubscribe send email to slug-request@nospam.slug.org.au with
unsubscribe in the text