devel:templates
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
devel:templates [2015-06-14 16:59] – mentioned cleaner "minimal" branch of starter template ach | devel:templates [2023-09-24 01:08] (current) – Klap-in | ||
---|---|---|---|
Line 13: | Line 13: | ||
- When your template is ready, consider [[# | - When your template is ready, consider [[# | ||
- | ===Template naming conventions=== | + | === Template naming conventions === |
A valid template name (directory): | A valid template name (directory): | ||
Line 20: | Line 20: | ||
* DokuWiki' | * DokuWiki' | ||
* Using underscore will also give a [[: | * Using underscore will also give a [[: | ||
+ | * Spaces '' | ||
* If the same name is used by two different templates | * If the same name is used by two different templates | ||
* they are mutually exclusive and inherent incompatible, | * they are mutually exclusive and inherent incompatible, | ||
- | * furthermore only one of them can have a template homepage on dokuwiki.org. | + | * furthermore only one of them can have a template homepage on [[: |
**It is important to have a unique base field value (i.e. template name) in [[devel: | **It is important to have a unique base field value (i.e. template name) in [[devel: | ||
Line 30: | Line 31: | ||
Templates should follow the following directory structure (all paths are relative to the template directory). | Templates should follow the following directory structure (all paths are relative to the template directory). | ||
- | CSS files are specified in the '' | + | CSS files are specified in the '' |
* ''< | * ''< | ||
Line 52: | Line 53: | ||
- | ===== Functions | + | ===== Inner workings explained |
+ | |||
+ | ==== Functions | ||
A list of available functions can be found in [[xref> | A list of available functions can be found in [[xref> | ||
Line 91: | Line 94: | ||
* Further many other useful template functions are available. Please have a look in [[xref> | * Further many other useful template functions are available. Please have a look in [[xref> | ||
- | ===== Global Variables And Constants | + | ==== Global Variables And Constants ==== |
For a complete list of useful global variables and constants please refer to the [[environment]] page. | For a complete list of useful global variables and constants please refer to the [[environment]] page. | ||
- | ===== Automated Housekeeping | + | ==== Automated Housekeeping ==== |
- | Almost at the bottom of the default template' | + | Almost at the bottom of the default template' |
- | ===== ' | + | ==== ' |
A class named '' | A class named '' | ||
- | ===== Include Hooks ===== | + | ==== Include Hooks ==== |
Include Hooks are a simple way to add some static content to your [[: | Include Hooks are a simple way to add some static content to your [[: | ||
- | The DokuWiki' | + | The DokuWiki' |
+ | |||
+ | ===== Converting existing templates ===== | ||
+ | |||
+ | If you're lacking design skills you can also convert existing templates. There are lots of free options available. If you'd like to publish one of those as well, please make sure it is [[https:// | ||
+ | |||
+ | * [[WP_to_DW_template|How to convert a WordPress theme to a DokuWiki template]] | ||
===== Avoiding problems ===== | ===== Avoiding problems ===== | ||
Line 134: | Line 143: | ||
From version Ponder Stibbons on an automated update signalling is possible. For the update process to work properly it is necessary that the date “Last updated on” on the template' | From version Ponder Stibbons on an automated update signalling is possible. For the update process to work properly it is necessary that the date “Last updated on” on the template' | ||
- | Uploads are not allowed on dokuwiki.org, | + | Uploads are not allowed on dokuwiki.org, |
+ |
devel/templates.1434293998.txt.gz · Last modified: 2015-06-14 16:59 by ach