Table of Contents
TemplateByName Plugin
Compatible with DokuWiki
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" no
- 2018-04-22 "Greebo" yes
- 2017-02-19 "Frusterick Manners" yes
Plugin that extends the page template functionality. It makes it possible to create a template for a specific file name or templates for specific namespaces.
One correction is needed to make this old plugin work again:
- in
action/findtemplate.php
on line 14 in theregister
function, remove “&” because of this function &-ed by default in all new Dokuwiki builds
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Examples/Usage
Create the page templates like you would create them when you use the basic page template functionality.
With this plugin you can also specify a name:
_yourfilename.txt
__yourfilename.txt
~yourdirectoryname.txt
~~yourdirectoryname.txt
~_yourdirectoryname.txt
~~_yourdirectoryname.txt
Replace yourfilename
or yourdirectoryname
with a filename or directoryname you are going to use in you dokuwiki.
- The
_yourfilename.txt
page template will only be used for a file in the current namespace withyourfilename
as name. - The
__yourfilename.txt
page template will only be used for a file in the current namespace or namespaces below withyourfilename
as name. - The
~yourdirectoryname.txt
page template will be used for all files in theyourdirectoryname
namespace wich resides just 1 level below the current namespace. - The
~~yourdirectoryname.txt
page template will be used for all files in theyourdirectoryname
namespaces below the current namespace. - The
~_yourdirectoryname.txt
page template will be used for the file representingyourdirectoryname
wich is just 1 level below the current namespace. In the file structure it will be the start.txt file. - The
~~_yourdirectoryname.txt
page template will be used for the files representingyourdirectoryname
for all namespaces below the current namespace.
Attention: root/…/namespace/_template.txt
have more priority than even root/__yourfilename.txt
so lock _template.txt
while generating pages
Change Log
- 2013-09-27
- Cleaning up the plugin done by Klap-in.
- Checked for compatibility with Adora Belle and Weatherwax.
- 2012-06-04
- Due to conflicts with Windows file name convention I replaced the asterisk (*) by the tilde (~). Everyone who already used the plugin, please rename your templates to the new convention when you update the plugin.
- Solved a bug in the
_yourfilename.txt
and__yourfilename.txt
convention.
- 2012-06-01
- Added the posibility to make a template for the start.txt files in a directory. (file representing the directory.)
- 2012-04-25
- Initial release
Known Bugs and Issues
- none
ToDo/Wish List
- none
Discussion
When you have a question or you want to give feedback. Please mail me or use https://github.com/jvanopstal/template-by-name/issues. Thank you.