Differences

This shows you the differences between two versions of the page.

--- namespace_templates [2020-05-11 09:59] – removed feature request -> use issue tracker andi
+++ namespace_templates [2024-05-03 09:02] (current) – [Template files] differentiated zweihorn
@@ Line 9: / Line 9: @@
 Two kinds of template files can be used:
-  * ''_template.txt'', which are used in the current namespace.
+  * ''_template.txt'', which will be used in the current namespace (but not below).
-  * ''%%__%%template.txt'' (two leading underscores), which work as the normal ''_template.txt'' files apart from the fact they are used in all namespaces below as well (they are inherited).
+  * ''%%__%%template.txt'' (note the two leading underscores), will cover the current namespace and all namespaces below as well (thus this kind of template will be inherited).
-If both (inherited and normal) templates are present in a namespace, the normal one is taken.
+If both (normal and inherited) templates are present in the same namespace, the normal ''_template.txt'' will take precedence when a new page is created. This allows the pages of the top namespace to be differentiated from all pages of any sub-namespaces inherited below, which could become quite handy.
-One way to create the template file is to
+**NOTE:** Any changes to a.m. template files will //only effect newly created pages// and existing pages are always left untouched.
+One way to create the template file is to:
   - use the wiki to save a page with the content that you want to use as a template into the appropriate namespace
-  - use FTP or WebDAV to rename it as _template.txt, then
+  - use FTP or WebDAV to rename it as _template.txt
-  - Note: ((These changes only apply to new pages that you create in the namespace.))
+However, one should prefer the [[plugin:TemplatePagename]] Plugin if possible (see explanations below).
 ===== Syntax =====
 The content of the file is just standard [[wiki:syntax|wiki markup]].
@@ Line 26: / Line 28: @@
 Inside of the file, you may also use some replacement patterns to make the template a little more dynamic.
-^ @ID@     | full ID of the page                                                                    |
+^ @ID@              | full ID of the page                                                                    |
-^ @NS@     | namespace of the page                                                                  |
+^ @NS@              | namespace of the page                                                                  |
-^ @CURNS@  | last part of the namespace of the page                                                 |
+^ @CURNS@           | last part of the namespace of the page                                                 |
-^ @PAGE@   | page name (ID without namespace and underscores replaced by spaces)                    |
+^ @!CURNS@          | same as above but with the first character uppercased                                  |
-^ @!PAGE@  | same as above but with the first character uppercased                                  |
+^ @!!CURNS@         | same as above but with the first character of all words uppercased                     |
-^ @!!PAGE@ | same as above but with the first character of all words uppercased                     |
+^ @!CURNS!@         | same as above but with all characters uppercased                                       |
-^ @!PAGE!@ | same as above but with all characters uppercased                                       |
+^ @PAGE@            | page name (ID without namespace and underscores replaced by spaces)                    |
-^ @FILE@   | page name (ID without namespace, underscores kept as is)                               |
+^ @!PAGE@           | same as above but with the first character uppercased                                  |
-^ @!FILE@  | same as above but with the first character uppercased                                  |
+^ @!!PAGE@          | same as above but with the first character of all words uppercased                     |
-^ @!FILE!@ | same as above but with all characters uppercased                                       |
+^ @!PAGE!@          | same as above but with all characters uppercased                                       |
-^ @USER@   | ID of user who is creating the page                                                    |
+^ @FILE@            | page name (ID without namespace, underscores kept as is)                               |
-^ @NAME@   | name of user who is creating the page                                                  |
+^ @!FILE@           | same as above but with the first character uppercased                                  |
-^ @MAIL@   | mail address of user who is creating the page                                          |
+^ @!FILE!@          | same as above but with all characters uppercased                                       |
-^ @DATE@   | date and time when edit session started                                                |
+^ @USER@            | ID of user who is creating the page                                                    |
-^ %a %d-%m-%y etc. | e.g. Thu 06-12-12. [[phpfn>strftime]] placeholders are replaced by page creation time |
+^ @NAME@            | name of user who is creating the page                                                  |
-^ %%       | a literal ''%'' character appears in your template                                     |
+^ @MAIL@            | mail address of user who is creating the page                                          |
+^ @DATE@            | date and time when edit session started                                                |
+^ %a %d-%m-%y etc.  | e.g. Thu 06-12-12. [[phpfn>strftime]] placeholders are replaced by page creation time  |
+^ %%                | a literal ''%'' character appears in your template                                     |
@@ Line 91: / Line 96: @@
   * [[plugin:Headerfooter]] Plugin adds header text or footer text to pages only when they are displayed.
+==== Troubleshooting ====
+Problem: An unexpected error occurs "no timestamp" when server (Linux Ubuntu) cannot write the directory ''/dokuwiki/data/pages/namespace''. This might happen, when the namespace directory is created by the admin as ''<root>'' in order to put the namespace template file in ''/dokuwiki/data/pages/namespace/'', before creating the first page.
+. Solution: Before establishing the hidden template file, first create a dummy page via the DokuWiki GUI, like so: ''yourserver/doku.php?id=namespace:dummy&do=edit''. This allows DokuWiki to create the namespace directory under own control and assures full write permissions for DokuWiki on the created directory.
+. Solution: The admin ''<root>'' should be able to change //owner and group// settings through the [[https://askubuntu.com/a/6727|chown command]] (e.g., ''chown www-data:www-data /dokuwiki/data/pages/namespace/'' on CLI) and in the first place should establish new directories and files with ''owner:group'' settings applicable to the DokuWiki installation anyway.