Pieter Hollants <[EMAIL PROTECTED]> writes:
> > Pieter Hollants <[EMAIL PROTECTED]> writes:
> > OK, I've been setting up XML/Docbook on my computer today, and finally got
> > it all working after a bit of fighting ;-) Have started to port some of my
> > docs to XML so I hope to publish some more IrDA documentation in near
> > future.
>
> XML or SGML? If XML, what utilities are you using?
Well, SGML and XML is very similar and there's just a few differences. So I
thought it would be best to stay at the "cutting edge" of documentation,
and started to get XML working instead of SGML (SGML is trivial because of
the sgml-tools package). Anyway I think it's good to learn XML these days,
so documenting my stuff in XML will help me understand a lot of other stuff
as well. SGML is old and dead, so it's much better to learn XML directly if
you ask me.
The DocBook book is not that good at helping you start from scratch, but I
found some really good help at:
http://www.debian.org/~bortz/SGML-HOWTO/potato/howto.html
It explains how to make a Makefile for running jade with XML files. It took
me some time to figure out that the sgml-tools (db2...) didn't understand
XML, so you had to run jade directly.
I'm using the XML docbook DTD from the CDROM which I got with the book, but
you should be able to get that from the web as well.
-- Dag
--
/ Dag Brattli | The Linux-IrDA Project /
// University of Tromsoe, Norway | Infrared communication for Linux //
/// http://www.cs.uit.no/~dagb | http://www.cs.uit.no/linux-irda/ ///
_______________________________________________
Linux-IrDA mailing list - [EMAIL PROTECTED]
http://www4.pasta.cs.UiT.No/mailman/listinfo/linux-irda
