[pmwiki-users] Re: Root README.txt With a docs/ Directory

[Patrick R. Michaud]

On Sat, Dec 31, 2005 at 07:18:48PM +0100, Dominique Faure wrote:
> 2005/12/31, Patrick R. Michaud <pmichaud at pobox.com>:
> > [...]
> > * The bulk of the documentation will remain as wiki pages in wikilib.d,
> >   and not HTML files or text files generated from wiki pages.  We should
> >   put a note about it in INSTALL.txt, but we'll also create a short
> >   docs/DOCUMENTATION.txt with a pointer to the local docs, as well
> >   as a note in the initial Main.HomePage.
> 
> I would enjoy having a command-line PHP script in docs/ in order to
> "dump" a complete wiki to HTML/text files. Perhaps a stripped-down
> version of PublishPDF would do the trick...

This has been discussed in the past -- the big issue is in
getting the links correct between pages.  Also, we have to figure 
out what to do with links containing '?action=', since they obviously 
won't work for a static HTML page.  And we probably want to be
able to export any attachments as well, and make sure those links
are correct.

I worked on this a bit back in September and I know that it's
do-able, but there are a lot of issues to handle in order to get
it correct.

Pm