Re : Docbook usage (was : official inkscape user docs)
Yep, i know that Ryan. Docbook is sometimes quite heavy to use. But this is the standard way to do this. All the documentation project use Docbook (see inkscape tutorials for example) because it is precise, XML base, and that we have many commands to transform it in HTML, PDF and many other format.
Wouldn't you really like to try again, even if i have to proofread ?
I'm also testing some possibilities via OpenOffice since there is a tool to convert ODT to docbook. Atthis time, some tag are missing, but i'm sure we good succeed in this way.
Cedric
Im prepared to help work on an _official_ version of the user docs... IMO, using the SVN and docbook format for developing something like an entire user manual may be a bit daunting for an artist or a non-dev type person that may want to contribute to user docs for inkscape - that is why i suggested maybe using the wiki for a development space of the docs, (with a strict template structure that would allow for easy conversion into the docbook format.)
On Thu, 2007-03-01 at 12:12 +0100, Cédric GEMY wrote:
Yep, i know that Ryan. Docbook is sometimes quite heavy to use. But this is the standard way to do this. All the documentation project use Docbook (see inkscape tutorials for example) because it is precise, XML base, and that we have many commands to transform it in HTML, PDF and many other format.
Wouldn't you really like to try again, even if i have to proofread ?
I'm also testing some possibilities via OpenOffice since there is a tool to convert ODT to docbook. Atthis time, some tag are missing, but i'm sure we good succeed in this way.
Cedric
Also, there are extensions to convert mediawiki markup to docbook. I think this would significantly lower the barrier. You can find by doing a google search of mediawiki docbook.
Jon
Im prepared to help work on an _official_ version of the user docs... IMO, using the SVN and docbook format for developing something like an entire user manual may be a bit daunting for an artist or a non-dev type person that may want to contribute to user docs for inkscape - that is why i suggested maybe using the wiki for a development space of the docs, (with a strict template structure that would allow for easy conversion into the docbook format.)
Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys-and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=D... _______________________________________________ Inkscape-devel mailing list Inkscape-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/inkscape-devel
On 3/1/07, Jon Phillips wrote:
Also, there are extensions to convert mediawiki markup to docbook. I think this would significantly lower the barrier. You can find by doing a google search of mediawiki docbook.
The google search might not give the latest version, improved by Audacity's lead developer :) But even that one doesn't handle images.
Alexandre
participants (3)
-
Alexandre Prokoudine -
Cédric GEMY -
Jon Phillips