Dokuwiki - Cache Dev configuration
Table of Contents
1 - Cache
2 - Cache Structure
2.1 - Instruction
In cache.php, set $_nocache to true
- cache.php
/** * Generic handling of caching */ class cache { public $key = ''; // primary identifier for this item public $ext = ''; // file ext for cache data, secondary identifier for this item public $cache = ''; // cache file name public $depends = array(); // array containing cache dependency information, // used by _useCache to determine cache validity var $_event = ''; // event to be triggered during useCache var $_time; var $_nocache = true; // if set to true, cache will not be used or stored
2.2 - Rendering
Disable the whole render cache by setting the cache page time to -1.
See cache→_addDependencies in cache.php, instructions if ($conf['cachetime'] == -1)
2.3 - No cache
~~NOCACHE~~
disable only XHTML cache ?
2.4 - Purge
2.5 - Javascript
http://www.example.com/lib/exe/js.php?purge=true
When you are developing new JavaScript, be sure to refresh your browser cache (hitting Shift-F5, Shift+CTRL+R or similar) whenever your script was updated.
DokuWiki will load JavaScript from the following places:
- autogenerated JavaScript (language strings, config settings, toolbar)
- lib/scripts/*.js
- lib/plugins/*/script.js
- lib/tpl/<currenttemplate>/script.js
- conf/userscript.js
Plugin !!!
The script file is named script.js
at the root directory of the plugin. If this file is an include as in the move
plugin, be sure to touch this file when one of the scripts has been updated to refresh caching. As the cache check the date of this file.
jQuery(function() { /* DOKUWIKI:include script/form.js */ /* DOKUWIKI:include script/progress.js */ /* DOKUWIKI:include script/tree.js */ /* DOKUWIKI:include script/rename.js */ /* DOKUWIKI:include script/admin_list.js */ });
2.6 - Css
http://www.example.com/lib/exe/css.php?purge=true
Ctrl+F5 to suppress the browser cache because browsers cache stylesheets even when new versions are available.
2.7 - Image
Local Server:
{{php.gif?nocache}} {{php.gif?300x50&nocache}}
External Server with the cachetime config option
{{http://de3.php.net/images/php.gif?recache}}
2.8 - Configuration
Turn off “Compact CSS and JavaScript files” while developing a template