Le vendredi 18 février 2011 13:53:58, Shelagh Manton a écrit : >You can export dokuwiki pages > to pdf with a plugin called bookcreator. > http://www.dokuwiki.org/plugin:bookcreator > > Perhaps this might be a solution to people asking for a downloadable > manual? I could look into how it works and see if it might be a > suitable candidate for publishing the wiki to a pdf.
I don't know bookcreator, but I recently discovered that the doc of the gEDA project http://www.gpleda.org has been moved to a wiki like RG doc has been. Nevertheless, unlike RG doc, gEDA doc is always embedded in each release tarball as an html directory. The way the gEDA guys convert their doc from wiki to html is explained in http://geda.seul.org/wiki/geda:release_engineering It works perfectly on RG doc. Here is the recipe I used : PHP-CLI and the PHP-PEAR extension (for Console/Getopt.php and maybe more...) have to be installed (distro packages) on the system used. -1) Get the dokuwiki tarball dokuwiki-2010-11-07a.tgz at http://www.splitbrain.org/projects/dokuwiki and expand it somewhere. Don't install anything : only the content of the conf directory is needed. -2) Get the offline-doku tarball offline-doku-0.1.1.tar.gz at http://sourceforge.net/projects/limb/files/offline-doku/ and expand it somewhere (there is nothing to install). -3) Get a copy of the RG wiki from svn : cd elsewhere svn co https://rosegarden.svn.sourceforge.net/svnroot/rosegarden/website/wiki rg_wiki -4) Add some missing empty directories to the wiki data : mkdir rg_wiki/data/attic mkdir rg_wiki/data/cache mkdir rg_wiki/data/index mkdir rg_wiki/data/locks mkdir rg_wiki/data/meta mkdir rg_wiki/data/tmp -5) Copy the whole conf directory from dokuwiki-2010-11-07a to rg_wiki cp -r somewhere/dokuwiki-2010-11-07a/conf rg_wiki -6) Run offline-doku : cd somewhere/offline-doku-0.1.1 php make.php elsewhere/rg_wiki elsewhere/rg_html Now a complete offline HTML version of the wiki should be in elsewhere/rg_html. Such a manual should be usable on a laptop without internet connection. If some pdf are needed htmldoc (http://www.htmldoc.org) may be used to get them from the html tree. This conversion to pdf works, but scarcely very well (or very easily) because: -1) a printable pdf book needs a better structure than an html one with lots of hyperlinks. -2) Sometimes pictures are badly truncated in the pdf and the only way I know to fix it is to manually edit the html, which is tedious. Yves ------------------------------------------------------------------------------ The ultimate all-in-one performance toolkit: Intel(R) Parallel Studio XE: Pinpoint memory and threading errors before they happen. Find and fix more than 250 security defects in the development cycle. Locate bottlenecks in serial and parallel code that limit performance. http://p.sf.net/sfu/intel-dev2devfeb _______________________________________________ Rosegarden-user mailing list [email protected] - use the link below to unsubscribe https://lists.sourceforge.net/lists/listinfo/rosegarden-user
