Page 1 of 1

Prepare for 3.1: local help file?

Posted: Mon Apr 28, 2014 10:47 am
by VilleK
As we update the documentation for 3.1, we should also look again at finding a tool that can generate a local help file from a website so that we do not need to update the documentation in two places.

yoffset has done a good job so far (thanks!) but I think it could be much easier and consistently done with such a tool.

Anyone has a suggestion of tools or other way to deal with the local help?

Posted: Tue Apr 29, 2014 9:19 pm
by Rado1
I did some exploration and experiments. First, I used MS HTML Help Workshop which provides very basic editing features, then I tried HelpMaker which can do much more for user. Both are free editors and can produce chm files without watermarks.

To produce chm help file, I copy/pasted either wiki html sources or the rendered texts and images and then formatted manually. Ville does ZGE PmWiki support some kind of export to plain HTML without sidebar, or some extension for creating PDF documentation, which can also be an alternatine?

Posted: Wed Apr 30, 2014 8:35 am
by VilleK
Here is a list of extensions to PMWiki related to publishing:

http://www.pmwiki.org/wiki/Cookbook/Publishing

This one does PDF but I can't find any example of what the output looks like:

http://www.pmwiki.org/wiki/Cookbook/PmWiki2PDF-v2

Also it seems it only makes "View this page as PDF" functionality. It does not crawl the whole site and make a combined PDF. So probably not of any use for us.

Here are more variants:

http://www.pmwiki.org/wiki/Category/PDF

Let me know if I should install/configure something.