====== Dokukiwix ======

---- plugin ----
description: Generates a static HTML, offline browseable version of your Wiki
author     : Yann Hamon
email      : yann.hamon@gmail.com
type       : admin
lastupdate : 
compatible : 2006-11-06, not tested on newer releases
depends    : 
conflicts  : 
similar    : 
tags       : offline, static, html
----

[[http://dokukiwix.mandragor.org|Details and Download]]

==== Discussion ====

There is a Bug in ajax_createLock\\
date('Y-m-d_H:i') cause problems because of the ":" character. Windows based systems not allow ":" in filenames.\\
Better use date('Y-m-d_H-i')\\


I've noticed a cache problem with this plugin, and the later release of dokuwiki\\
the internal links are not replaced properly in the html export, unless the cachetime is set to 1 second\\
$conf['cachetime']   = 1;\\
within conf/dokuwiki.php\\
a more ideal solution I think would be to add\\
if(defined("dokukiwix_plugin")) clearstatcache();\\
somewhere in the plugin, to erase the cache, or somehow set "nocache" for the pages, but I'm not sure where / how

----

Does not work with Firefox 2, IE 7 is ok

----

Version 0.4 Issue\\
- does not work with Firefox 3
<code>Error: plugin_dokukiwix_toggle_startpause is not defined
Source File: http://yoursite/wiki/doku.php/start?do=admin&page=dokukiwix
Line: 1</code>

Note: I had to turn off nice urls to make it work local on a Windows XP, FF system
---rd

----
\\
I've made following changes to version 0.3 to get it running on WindowsXP: (can't find version 0.4 for download)\\
Environment: Abyss Webserver X1 (v 2.5), php 5.2.2, dokuwiki-2008-05-05, Firefox 3.0.1
  * Install plugin as described [[http://dokukiwix.mandragor.org/#installation|here]]
  * change ajax.php

<code php>
#file: lib\plugins\dokukiwix\ajax.php: (see above, no colon allowed in windows filenames)\\
org: 109           fwrite($dokukiwix_fp, date('Y-m-d_H:i'));\\
new: 109           fwrite($dokukiwix_fp, date('Y-m-d_H_i'));\\
</code>

  * change common.php ( add line 16 and 17 )
<code php>
# file: lib\plugins\dokukiwix\common.php
org: 15            global $offlineVersionPath;
new: 15            global $offlineVersionPath;
     16            global $archivePath;
     17            $offlineVersionPath=$archivePath;
</code>

  * within Dokuwiki admins-section set "cachetime=1" and "userewrite=none". I´ve not tested, if these settings are necessary.

----

this plug-in do not generate correct links if you are in a directory and the link point out of that.

For example you have the following structure:
  /start.txt
  /doc/mydoc.txt

if in mydoc.txt there is a link %%[%%:start.txt%%]%%, than the program generate the page:\\
.../pages/doc/start.html\\
and not\\
.../pages/start.html

----