Re: [Gramps-devel] GRAMPS documentation on wiki: Gramps-devel Digest,

[<rom...@ya...>]

> I saw some of the GRAMPS-xxx pages. Is it the intention, in the first step, do copy paste the manual on separate wikipages, that can then be organized in a wiki-manual?

I don't know !!!

I had generate a basic XSL for parsing docbook.xml, split on multiples 
pages before pasting it on wiki. I just make some templates and a mix 
between HTML and wiki code.

Make a main page with related pages on wiki or modify the file, try :

$ xsltproc wiki.xsl gramps.xml -o gramps.html

If you don't have this parser, then I can send you a python file.

> How should coordination be done? We start as of the first chapter? split up
> the work or just follow what is already on the wiki and what not?

I try to test a migration ... but wiki code is far away from SGML :(
I don't know how to retrieve wiki modifications on documentation, except 
using diffs and add it manualy.

Most docbook-data seems to be on wiki. Maybe 
paste/modify/remove/substitute it, we cannot make errors ...
I just try to keep the same docbook page-settings, but there is not a 
lot of tags on wiki !!!

> Step 1: convert present docbook manual to wiki. Jerome started this, check out
> the wiki pages starting with gramps. A lot to do still: text is missing, no
> figures, ...
> Only the english manual would be kept like this.
> Help can be used!
> 
> Step 2: once step 1 is finished, make the links as you say: double the pages:
> one everbody of the community can edit, and one which is official 
> documentation
> only a designated group can edit, with a link from one to the other
> 
> Step 3: merge changes back to official manual (corresponds to big releases)
> 
> Step 4: convert this wiki entry to docbook (we would need some automation for
> this, some things do exist already.)
> 
> As you can see, we hardly have step 1 up at the moment, and nobody has stepped
> forward to put his shoulders under it