From: <bm...@ca...> - 2007-06-06 22:06:56
|
Hoi Erik, Jerome has a script to generate some wiki code from the docbook format. He pasted that on the wiki to show how it went. I think they can be a first start. Now it would be needed to put this wiki data next to the html code: http://gramps-project.org/gramps-manual/2.2/en/index.html They should be compared, and the following done: 1/make sure no text has gone missing 2/copy the pictures to the wiki (so upload them, and include them in the text) 3/markup. Some good wiki markup must be chosen so it reflects a good manual. So we need wiki analogues for all markup: http://gramps-project.org/gramps-manual/2.2/en/pr01s02.html 4/indexing, we would need also an index page, and every pages should provide access to previous, next, and index page, just like the html manual now actually Once all info is there, we need to give it a good naming scheme. I would suggest all pages have chapter names, and are in a separate namespace, so eg wiki page: 'Manual: Introduction' We can then add to the license page that all articles in the Manual: section must be dual licensed as GPL (for inclusion with GRAMPS) and GNU FDL for reuse on the wiki. I'd make a small banner to notify people of this and add the banner to on all manual pages. That is step one. For editing the manual, and contributing, we can decide on how to do that once the manual is up on the wiki. Erik, you think you can do these first steps? I would suggest you start with reworking part of http://www.gramps-project.org/wiki/index.php?title=Gramps-preface that corresponds to http://gramps-project.org/gramps-manual/2.2/en/pr01s02.html and asks on the mailing list if people are ok with the wiki translation of the markup code. If nobody suggests improvements, Jerome can perhaps rerun his script with as much of the convention we have chosen added (if that is possible). Then the above steps 1->4 can be done. Benny PS: I will be very busy or away up to the end of july, so inactivity on my side does not mean i lost interest. Quoting Erik De Richter <eri...@be...>: > I'm willing to elaborate on the transfer of the documentation/manual to > wiki. > > 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? > > 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? > > please give your thoughts > > Erik > ---------------------------------------------------------------- This message was sent using IMP, the Internet Messaging Program. |