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/26 14:02] – [A template for topic pages] Simon Grantdoc:templates [2026/10/04 07:05] (current) – external edit 127.0.0.1
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.
  
-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 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 contributors, 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.
  
 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. 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 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.+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.
Line 29: Line 29:
 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. 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 advisor and contributor ("user") home pages =====
  
 The basics here include: The basics here include:
-  * Curator's real name+  * Advisor's real name
     * //"real name" here means name by which they are generally known, not necessarily legal name//     * //"real name" here means name by which they are generally known, not necessarily legal name//
   * A photo, cartoon, etc.   * A photo, cartoon, etc.
-    * //or other graphic if the curator prefers not to share photos of themselves publicly//+    * //or other graphic if the advisor prefers not to share photos of themselves publicly//
   * About: any short bio, and/or links to other pages with verifiable publicly available information, recommended to include   * About: any short bio, and/or links to other pages with verifiable publicly available information, recommended to include
-    * links to the topics on this wiki curated by this curator+    * links to the topics on this wiki curated by this advisor
     * and any other relevant writings     * and any other relevant writings
     * any chosen relevant social media presence (e.g. LinkedIn)     * any chosen relevant social media presence (e.g. LinkedIn)
Line 44: Line 44:
     * //with links, and roles within them//     * //with links, and roles within them//
   * Contact details    * Contact details 
-    * //whichever are reliable and suit the curator//+    * //whichever are reliable and suit the advisor//
  
-We want curators, particularly on their public home pages, to be free to represent themselves as they see best. The above are just guidelines.+We want contributors, particularly on their public home pages, to be free to represent themselves as they see best. The above are just guidelines.
  
-One thing we do ask, though: for some effective way of contacting curators, especially for other curators of the same pages, so that curators can work towards agreeing structure and contents for their topic pages, and hopefully, for responding to readers' feedback on the pages they curate.+One thing we do ask, though: for some effective way of contacting advisors, especially for other advisors of the same pages, so that advisors can work towards agreeing structure and contents for their topic pages, and hopefully, for responding to readers' feedback on the pages they curate.
  
 ===== A template for topic pages ===== ===== A template for topic pages =====
Line 76: Line 76:
     * links to their home pages on our wiki, with affiliations if desired     * links to their home pages on our wiki, with affiliations if desired
   * Developing the … topic   * Developing the … topic
-    * curator commentary: for adding personal perspectives, opinions, links,+    * contributor 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 contributors 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 96: 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. 
-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.+ 
 +===== Template for notable Commoners ===== 
 +For people significant to the Commons, who are not contributors, the template is somewhat lighter than the one for contributors/users. If possible (and if the person is alive), all content of this page should be all agreed by the person themselves.
  
   * Name of the Commoner   * Name of the Commoner
-    * //(as for curators, the name by which they are generally known, and publish under)//+    * //(as for contributors, the name by which they are generally known, and publish under)//
   * A photo, cartoon, etc.   * A photo, cartoon, etc.
     * //either publicly available images, or images desired by the person — acknowledge source if not public domain//     * //either publicly available images, or images desired by the person — acknowledge source if not public domain//
Line 111: 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]].
Line 124: Line 127:
  
 ===== Open questions ===== ===== Open questions =====
 +
  • doc/templates.1777212120.txt.gz
  • Last modified: 2026/07/23 08:54
  • (external edit)