Re[2]: Is there a need for a printable Flux-CMS-User-Documentation?

qMax <[email protected]> Mon, 13 Feb 2006 14:28:15 +0600
Newsgroups gmane.comp.cms.bitflux.general
Message-ID <[email protected]>
Saturday, February 11, 2006, 4:50:19 PM, Adrian Nussbaum wrote:

>> That be great, but I think It should be available online and be
>> printable, not just "printable".
AN> does this mean, that it should be directly online - in your  
AN> docs.bitflux.org-style?
AN> i can understand that you'd prefer to have an online-version, too.
AN> but my clients mostly won't go there to have a look at it... so i  
AN> thought of a really easy-to-understand-written manual - almost "for  
AN> dummies"... but i'm not shure about that. maybe i could create out of
AN> the (updated) online-version a nice printed one as well...
AN> or should i create some pages (pdf) as draft so we can discuss about
AN> this try? (the online version could maybe be updated out of this  
AN> thing...?)

I'd suggest using docbook xml format (http://docbook.sourceforge.net/)
as a source of such documentation, and then apply Norman Walsh xslt stylesheets
(http://wiki.docbook.org/topic/DocBookXslStylesheets)
to convert it to either xsl-fo, html, chunked html, windows help, or whatever.

Docbook is very convenient and was designed to write documentation of
any kind, especially technical.
And there're some xml editors featuring wysiwyg mode for docbook.
(xmlMind, Oxygen as an instance)

-- 
 qMax

-- 
bitflux-cms mailing list
[email protected]
http://lists.bitflux.ch/cgi-bin/listinfo/bitflux-cms