Dokukiwix

dokukiwix plugin by Yann Hamon
Generates a static HTML, offline browseable version of your Wiki

Provides Admin.
Compatible with DokuWiki 2006-11-06, not tested on newer releases.

Similar to offline, siteexport.

Tagged with html, offline, static.

Details and Download

Discussion

After making the changes described below the plugin works fine on MacOSX. It does not work with the Safari browser however, recent versions of Firefox on MacOSX seem to work just fine for creating the archive. Once the archive is created that works fine with Safari.

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

Error: plugin_dokukiwix_toggle_startpause is not defined
Source File: http://yoursite/wiki/doku.php/start?do=admin&page=dokukiwix
Line: 1

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 here
  • change ajax.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'));\\
  • change common.php ( add line 16 and 17 )
# file: lib\plugins\dokukiwix\common.php
org: 15            global $offlineVersionPath;
new: 15            global $offlineVersionPath;
     16            global $archivePath;
     17            $offlineVersionPath=$archivePath;
  • 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


Information for Russian users of dokukiwix. На моей вики названия страниц естественно на русском языке. Если не включить полную транслитерацию в Настройках Вики (настройки отображения), то dokukiwix генерирует ссылки в виде htmlspecialchars (типа %D0%B0%D1%80%D0%BC.txt), а файлы сохраняются (dokuwiki установлена на сервере под Windows Server 2003) с совсем другими искаженными именами. Короче - включайте транслитерацию названий страниц. Если кто знает более лучшее решение – напишите пожалуйста.


 
plugin/dokukiwix.txt · Last modified: 2009/05/04 15:23 by gamma
 
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Imprint Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
WikiForumIRCBugsDarcsXRefTranslate