headers
Hubert Feyrer | 4 Nov 2006 04:46
Picon
Favicon

DocBook made a bit easier


I've had the immense pleasure to convert an ASCII version of the NetBSD 
3.1 and 3.0.2 release announcements to DocBook/XML today. Juggling with 
all the nested lists became boring pretty fast, and so I remembered to use 
a different tool that I've learned the other day:

MoinMoin Wiki can do a DocBook export. I've it installed already, and so 
copied the ASCII version into it, fixed the markup and then did an export 
to DocBook.

As the document was all in 1 line, I had to push it through 'xmllint 
--format', but after that taking the relevant parts from what MoinMoin 
made into htdocs was just a matter of copy&paste. (The frame for the text 
was already done before).

This approach saved me from going insane tonight...

For more information, see http://moinmoin.wikiwikiweb.de/DocBook

  - Hubert
Permalink | Reply | 7 comments |
headers
Hubert Feyrer | 4 Nov 2006 19:07
Picon
Favicon

Re: DocBook made a bit easier

On Sat, 4 Nov 2006, Daniel de Kok wrote:
> MoinMoin is very nice in this respect, and IMO it's a valid question
> to ask whether it wouldn't be more productive to loosen up a bit, and
> edit the guide through a MoinMoin wiki.

Heh, if you get to do that, you're welcome. :-)

My idea was to have "normal" documentation (ports pages, release 
documentation, and the evolving stuff in htdocs/Documentation) in a Wiki, 
and then eventually port it to one of the Guides using MoinMoin's DocBook 
facility.

  - Hubert
Permalink | Reply | 1 comment |
headers
Daniel de Kok | 4 Nov 2006 18:30
Picon
Favicon

Re: DocBook made a bit easier

On Sat, Nov 04, 2006 at 04:46:01AM +0100, Hubert Feyrer wrote:
> MoinMoin Wiki can do a DocBook export. I've it installed already, and so 
> copied the ASCII version into it, fixed the markup and then did an export 
> to DocBook.

MoinMoin is very nice in this respect, and IMO it's a valid question
to ask whether it wouldn't be more productive to loosen up a bit, and
edit the guide through a MoinMoin wiki.

-- Daniel
Permalink | Reply | 2 comments |
headers
Rainer Brinkmoeller | 5 Nov 2006 01:27
Picon

Update of NetBSD/xen-howto (xml) timestamp 200611050115

Hi,

I'd update the german translation and the original NetBSD/Xen-howto because:
1. I found some typos in the german translation
2. At http://www.cl.cam.ac.uk/research/srg/netos/xen/downloads.html is no
    Link for downloading any xen-2.0.x-install.tgz anymore.
    Now there is a http download site at 
http://www.cl.cam.ac.uk/research/srg/netos/xen/downloads/
3. The xen-2.0.x-install.tgz files seem to be renamed to 
xen-2.0.x-install-x86_32.tgz

The xml-File and the diff outputs can be downloaded from 
http://xen-forum.net/nbsdxeninf.html

Rainer
Permalink | Reply | 1 comment |
headers
Martin S. Weber | 5 Nov 2006 14:48
Picon

Re: DocBook made a bit easier

MoinMoin,

On Sat, Nov 04, 2006 at 04:46:01AM +0100, Hubert Feyrer wrote:
> MoinMoin Wiki can do a DocBook export. (...)
> This approach saved me from going insane tonight...

I think it's funny to stop and look back. Hey, let's junk our
easy to edit proprietary format (list files) and instead move
on to enterprise brainfuck XML. Oh wait, you can't edit that.
Let's move to some proprietary format (moinmoin wiki syntax)
instead, yay!

Do what you must but you can't save a laugh; xml, heh...

-Martin
Permalink | Reply | 3 comments |
headers
Hubert Feyrer | 5 Nov 2006 18:55
Picon
Favicon

Re: DocBook made a bit easier


On Sun, 5 Nov 2006, Martin S. Weber wrote:
> Do what you must but you can't save a laugh; xml, heh...

Yeah, in retrospect this caused more trouble than it gained us.
But I guess we can call it making an experience, at least.

  - Hubert
Permalink | Reply | 2 comments |
headers
Klaus Heinz | 5 Nov 2006 20:22
Picon

Re: DocBook made a bit easier

Hubert Feyrer wrote:

> Yeah, in retrospect this caused more trouble than it gained us.
> But I guess we can call it making an experience, at least.

That is Hubert's opinion. I do not see the trouble that "it gained us".

ciao
     Klaus
Permalink | Reply | 1 comment |
headers
Hubert Feyrer | 5 Nov 2006 20:40
Picon
Favicon

Re: DocBook made a bit easier

On Sun, 5 Nov 2006, Klaus Heinz wrote:
>> Yeah, in retrospect this caused more trouble than it gained us.
>> But I guess we can call it making an experience, at least.
>
> That is Hubert's opinion. I do not see the trouble that "it gained us".

What I mean is that few of our developers (including releng, etc.) goes 
near htdocs to change stuff, and that updates are either done through www <at>  
or not at all. (Not saying that the XML stuff is bad per se, but the 
existing toolchain has contributed it's part to my impression of the 
current situation.

  - Hubert
Permalink | Reply | 0 comments |
headers
Martin S. Weber | 5 Nov 2006 21:32
Picon

Re: DocBook made a bit easier

On Sat, Nov 04, 2006 at 07:07:18PM +0100, Hubert Feyrer wrote:
> (...)
> My idea was to have "normal" documentation (ports pages, release 
> documentation, and the evolving stuff in htdocs/Documentation) in a Wiki, 
> and then eventually port it to one of the Guides using MoinMoin's DocBook 
> facility.

I think this is a very good idea as it would lower the hurdle to
begin working on it, especially for "small" changes (i.e. those
which are constantly required to keep that thing up to date).

(insert random [XML|Docbook] curses here :)

-Martin
Permalink | Reply | 0 comments |
headers
Hubert Feyrer | 6 Nov 2006 23:30
Picon
Favicon

Re: Update of NetBSD/xen-howto (xml) timestamp 200611050115

On Sun, 5 Nov 2006, Rainer Brinkmoeller wrote:
> I'd update the german translation and the original NetBSD/Xen-howto because:
> 1. I found some typos in the german translation
> 2. At http://www.cl.cam.ac.uk/research/srg/netos/xen/downloads.html is no
>   Link for downloading any xen-2.0.x-install.tgz anymore.
>   Now there is a http download site at 
> http://www.cl.cam.ac.uk/research/srg/netos/xen/downloads/
> 3. The xen-2.0.x-install.tgz files seem to be renamed to 
> xen-2.0.x-install-x86_32.tgz
>
> The xml-File and the diff outputs can be downloaded from 
> http://xen-forum.net/nbsdxeninf.html

I've committed the changes to the two XML files and re-generated the HTML 
files. Thanks!

  - Hubert
Permalink | Reply | 0 comments |

Gmane