Dave Hall wrote: > On Sun, 2007-03-04 at 00:01 +0100, Sigurd Nes wrote: >> Dave Hall wrote: >>> On Sat, 2007-03-03 at 19:24 +0100, Sigurd Nes wrote: >>> >>>> Hi all, >>>> Had a quick look at the manual at egw - they are using wiki for the >>>> manual - any reason for not trying this approach? >>>> For the link for addressbook they are using 'page=ManualAddressbook'. >>>> I would propose to also include the language - something like >>>> 'page=Manual<lang><manualitem>' >>>> >>> IMHO the wiki is not core functionality, but the manual is. The problem >>> with using a wiki for such documentation is that all installs the need >>> the wiki installed in order for the manual to function. Also our wiki >>> does not support ACLs and relies on people using (and understanding) the >>> wiki syntax. I think the energy involved in mod'ing the wiki and manaul >>> apps to make this work would be better spent on writing the docs :) >>> >>> The manuals and other docs should be ODT files as produced by OO.o2 >>> Writer, AbiWord or Kwrite (or MS Office 2007 with a FOSS plugin). This >>> is the most flexible way of maintaining and producing documentation. It >>> also means that we can produce HTML and PDF. We can even use XSLT to >>> convert the docs within phpgw to html. >>> >>> >> Found some mention of "odt2html" - do you have any experience with it >> (or anything like it)? I think I read somewhere that it was out of sync >> with the latest format (I might be wrong). > > No, but the XSLT for ODT -> XHTML is included with OO.o2 > >> Would be nice to have the ability to navigate directly to the correct >> spot in the manual from where one is crying for help. >> > > A master doc for an app with each section of functionality as a separate > doc would work pretty well then we can just use: > > /manual/index.php#function?app=<app>§ion=<section> :) >
Ok - also found a "ODT 2 XHTML" at http://www.phpclasses.org/browse/package/3071.html I will do some testing as time and energy permit. Regards Sigurd _______________________________________________ phpGroupWare-developers mailing list [email protected] http://lists.gnu.org/mailman/listinfo/phpgroupware-developers
