| 1 |
On Thu, Feb 22, 2001 at 06:03:52PM +0100, Achim Gottinger wrote: |
| 2 |
|
| 3 |
> Daniel, |
| 4 |
|
| 5 |
> What do you think about using docbook for these docs. The sgml-tools should |
| 6 |
> work quite well and we can produce the following output formates: dvi html |
| 7 |
> man pdf ps rtf tex texi txt. We can add our own html-backend or an xml |
| 8 |
> backend that can be used for xslt transformation. |
| 9 |
|
| 10 |
Well, I'm not too familiar with the docbook syntax, but I took a quick look at |
| 11 |
a sample docbook SGML document and I'm afraid that it would require a monstrous |
| 12 |
amount of custom XSLT to get into the format that we want. |
| 13 |
|
| 14 |
I agree that having a unified doc format that can generate man pages as well as |
| 15 |
web documents is what we need. Part of me thinks that it may be easier to |
| 16 |
create our own man page conversion XSLT than it would be to create our web page |
| 17 |
conversion docbook XSLT. |
| 18 |
|
| 19 |
If I am going to be doing most of the documentation, then I'll most likely go |
| 20 |
with a custom XML format. If someone else wants to invest some time getting |
| 21 |
our docs into docbook format (and handling the web page conversion issues), |
| 22 |
then maybe we can go in that direction. |
| 23 |
|
| 24 |
-- |
| 25 |
Daniel Robbins <drobbins@g.o> |
| 26 |
President/CEO http://www.gentoo.org |
| 27 |
Gentoo Technologies, Inc. |
Archives