doc:templates

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:templates [2026/04/25 09:59] – Simon Grantdoc:templates [2026/05/04 21:10] (current) – [A template for concepts] Simon Grant
Line 5: Line 5:
 You can try out some of these on the [[playground:playground]] page. You can try out some of these on the [[playground:playground]] page.
  
-A template is a way to give a kind of scaffolding — in this case, suggesting the elements that we think work well in a page. It helps both writers and readers:+Templates are set up for particular [[namespace]]s. If a template has been set up, it will appear as a kind of scaffolding when you create a new page on the wiki — in this case, suggesting the elements that we think work well in the particular kind of page you are creating. It helps both writers and readers:
   * for writers and curators, it gives a good idea of how to structure a page;   * for writers and curators, it gives a good idea of how to structure a page;
   * for readers, it gives more consistency, so they know what to expect and therefore can read and understand more easily.   * for readers, it gives more consistency, so they know what to expect and therefore can read and understand more easily.
  
-Templates are useful guides, but are not set in concrete. They can be changed when needed, though to maintain consistency and readability, we want these to be changed by agreement rather than by individuals. Individuals can always change any page they create or edit in any case, so they don't need to change the templates. When needed, we will update the templates after general consultation.+The essential idea is that the template is there to help you know what might be expected on the page, and you set up and continue to edit the page on that basis. 
 + 
 +Templates are useful guides, but are not intended to dictate exactly what to do. They can be changed when needed, though to maintain consistency and readability, we want these to be changed by agreement rather than by individuals. Individuals can always change any page they create or edit in any case, so they don't need to change the templates. When needed, we will update the templates after general consultation.
  
 Below are outlines of the page templates we either have or are working on. Below are outlines of the page templates we either have or are working on.
  
-===== Helpful comments within templates =====+==== Helpful comments within templates ====
  
 In some templates, we have put comments to guide us to fill in the template. You can leave these comments in if you like — they won't appear in the displayed page, or delete them if you don't need them any more. In some templates, we have put comments to guide us to fill in the template. You can leave these comments in if you like — they won't appear in the displayed page, or delete them if you don't need them any more.
Line 25: Line 27:
 Something to fill in here /* but it doesn't matter really what */. Something to fill in here /* but it doesn't matter really what */.
  
-However, be careful, as if you write `/*` and not the balancing `*/`, lots of text may disappear!+However, be careful, as if you write `/*` and not the balancing `*/`, lots of text may disappear! It won't have been lost … you would just need to check the comment starts and ends.
  
 ===== A template for curator ("user") home pages ===== ===== A template for curator ("user") home pages =====
Line 72: Line 74:
     * references to sources cited (with links if available)     * references to sources cited (with links if available)
   * Curators / contributors   * Curators / contributors
-    * links to their home pages on our wiki +    * links to their home pages on our wiki, with affiliations if desired
-    * with affiliations if desired+
   * Developing the … topic   * Developing the … topic
-    * curator commentary: for adding personal perspectives, opinions, links,+    * curator commentary: for brief personal perspectives, opinions, etc.; with links as appropriate.
       * //being respectfully open about any diversity of views on the topic//       * //being respectfully open about any diversity of views on the topic//
     * open questions on this topic     * open questions on this topic
       * //where curators together can formulate questions that point to possible areas, for further investigation, and to grow the knowledge base//       * //where curators together can formulate questions that point to possible areas, for further investigation, and to grow the knowledge base//
  
-For a more detailed explanation, please see the annotated [[template for topics]].+For a more detailed example with explanation, please see the separate, annotated [[template for topics]].
  
 ===== A template for concepts ===== ===== A template for concepts =====
Line 95: Line 96:
     * //as with topics, we want to highlight the growing edge of our knowledge commons//     * //as with topics, we want to highlight the growing edge of our knowledge commons//
  
-===== Template for other Commoners =====+This template will work in the "c:" [[namespace]]. If you create or link to a concept, use `c:` as the namespace, immediately before the page name. 
 + 
 +===== Template for notable Commoners =====
 For people significant to the Commons, who are not curators, the template is somewhat lighter than the one for curator/users. If possible (and if the person is alive), all content of this page should be all agreed by the person themselves. For people significant to the Commons, who are not curators, the template is somewhat lighter than the one for curator/users. If possible (and if the person is alive), all content of this page should be all agreed by the person themselves.
  
Line 110: Line 113:
  
  
-Always link to the names of significant people, such as [[p:Elinor Ostrom]] (coded `[[p:Elinor Ostrom]]` — p stands for "person") in topic or concept pages, and then there is no need to list pages in which the person is mentioned, as these can be found using the Backlinks button.+This template will work in the "p:" [[namespace]]. 
 +Always link to the names of significant people, such as [[p:Elinor Ostrom]] (coded `[[p:Elinor Ostrom]]` — p stands for "person") in topic or concept pages, and then there is no need to list pages in which the person is mentioned, as these can be found using the Backlinks button. 
  
 ===== Template for groups ===== ===== Template for groups =====
  
 To come. To come.
-===== Related topics =====+===== Related information =====
  
 See the DokuWiki documentation on [[doku>namespace_templates]]. See the DokuWiki documentation on [[doku>namespace_templates]].
  • doc/templates.1777111150.txt.gz
  • Last modified: 2026/04/25 09:59
  • by Simon Grant