Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
rules_conventions_and_policies [2022/09/03 03:09] – [Conventions] adminrules_conventions_and_policies [2026/01/03 01:26] (current) – [Linkage & Signposting] admin
Line 1: Line 1:
 ===== General ===== ===== General =====
  
-  * Make use of [[doku>https://www.dokuwiki.org/namespace_templates|NameSpace Templates]].+  * Make use of [[https://www.dokuwiki.org/namespace_templates|NameSpace Templates]].
     * Create a c_template page under the namespace after your first competition of a page under a namespace.     * Create a c_template page under the namespace after your first competition of a page under a namespace.
-  * Hints on [[doku>https://www.dokuwiki.org/tips:good_style|good style]] and [[doku>https://www.dokuwiki.org/tips:good_content|content]]. +  * Hints on [[https://www.dokuwiki.org/tips:good_style|good style]] and [[https://www.dokuwiki.org/tips:good_content|content]]. 
-  * Setting up [[doku>https://www.dokuwiki.org/interwiki|interwiki]] shortcuts can help with linking to common resources.+  * Use [[https://www.dokuwiki.org/plugin:indexmenu|indexmenu]] sparingly. Describe the indexed namespace. 
 + 
 +==== Linkage & Signposting ==== 
 + 
 +=== Linking === 
 + 
 +  * DON'T link shortcuts can help with linking to common resources.
   * Don't link images from external sites, unless when allowed to do so explicitly.   * Don't link images from external sites, unless when allowed to do so explicitly.
-  * Use [[doku>https://www.dokuwiki.org/plugin:indexmenu|indexmenu]] sparingly. Describe the indexed namespace. 
  
-GDoc and Dokuwiki conventions may not translateConsider building new conventions specifically for doku.+=== Signposting === 
 + 
 +  * Signpost the important terms such as the first time it is used with bold and linkage. Subsequent re-formatting, **in the same way**, is not necessary nor prohibited (but it would be a lot of work). 
 +  * If the signposted section is a page header, no need to link. 
 +  * ALWAYS try to link child page with ~ (self reference as namespace) where possible. Especially with extensions, as doku __wiki's auto link adjustment does not cover extension blocks__. 
 + 
 + 
 +==== Namespace ==== 
 + 
 +  * **Use full names:** The_[insername] for proper nouns. 
 +  * **Default start page: **should be __under the namespace it is under__ rather than under the parent namespace. 
 +    * Use the page name (instead of start for the namespace) and, 
 +    * Try __not to use a page with the same name as the namespace__. However, if you do,  it should be for the following reasons: 
 +      * The page will introduce the namespace as a portal to its namespaces and/or pages (as a start page). 
 + 
 +==== Quotes ==== 
 + 
 +>//Quotations are indented by %%>%% , italicised and the source is indicated by a bullet point outside of the quotation immediately after it.// 
 + 
 +  * Like this. 
 + 
 +=== Aggregating Books === 
 + 
 +  * Include any thought up quotes as a page under that respective ebooks and include the quoted block with %%{{page>lore:world_bible:book_of_alice:chapter_0:1&firstseconly&noheader&noreadmore}}%%.
  
 ===== Prosemirror ===== ===== Prosemirror =====
Line 30: Line 58:
 ===== Note for Writing ===== ===== Note for Writing =====
  
-Must separate __prescriptive__ and __descriptive__ writingSeparate advice (guides) in appendixes to classifications (study) of the main body. The derivative and generative contents (product) will exist under their own context as a project.+//GDoc and Dokuwiki conventions may not translateConsider building new conventions specifically for doku.//
  
-  * Always began a project writing in small, segregated documents that carry a distinct +Must separate __prescriptive__ and __descriptive__ writing. Separate advice (guides) in appendices to classifications (study) of the main body. The derivative and generative content (product) will exist within its own context as a project. 
 + 
 +  * Always begin a project by writing in small, separate documents that focus on a distinct topic.
     * **Aim:** add a subtitle summary to supplement the title. Merge the documents before publishing.     * **Aim:** add a subtitle summary to supplement the title. Merge the documents before publishing.
   * Always use section breaks.   * Always use section breaks.
   * Always complete/perfect ONE piece of content to establish a writing style before writing another similar piece of content.   * Always complete/perfect ONE piece of content to establish a writing style before writing another similar piece of content.
-  * Never edit while writingEdit in one week.  +  * Never edit while writingEdit in one week.  
-  * Never revise until a document is completed.+  * Never revise a document until it is complete.
  
 Italic and indent for examples and quotes. Italic and indent for examples and quotes.
Line 44: Line 74:
   * Underline for __emphasis__.   * Underline for __emphasis__.
   * Hyphens --- Used to make extended points and extrapolation of loaded terms.   * Hyphens --- Used to make extended points and extrapolation of loaded terms.
-  * Square Brackets highlight previous defined [Concepts]. +  * Square Brackets highlight previously defined [Concepts]. 
   * Braces for {mathematical expressions}.   * Braces for {mathematical expressions}.
   * Italic Bold for recurring **//key terms//**.   * Italic Bold for recurring **//key terms//**.
   * Always construct an **Aim** statement for a piece of document and a summative subtitle.   * Always construct an **Aim** statement for a piece of document and a summative subtitle.
 +
  
 ==== Notes for Style ==== ==== Notes for Style ====
 +
 +Use generic terms where possible. A good convention is to examine the name and see if you can deconstruct it into a composition of terms, such as when explaining English to someone learning it. If you can, use the basic lexicon that you would use to explain the term to that beginner.
 +
 +  * Scripture of Alice -> Book of Alice
 +  * Chronicles of Maple -> Book of Maple
 +  * Tome of Marowlyth -> Book of Marowlyth
 +
 +However, the specialised terms will be retained in the [[Thematic Term Library|Thematic Term Library]].
 +
  
 ==== Writing Tenets ==== ==== Writing Tenets ====
Line 59: Line 99:
     * Precise     * Precise
   * **Usable: **Is this usable in an actual play of a game?   * **Usable: **Is this usable in an actual play of a game?
 +  * **%%Ambivalence:%%**
 +  * **Apathy:**
  
 === Good Activities to do to test out your entity's quality: === === Good Activities to do to test out your entity's quality: ===
Line 65: Line 107:
  
   * **Querying for Reference: **After writing, come back after at least a week. Open it up, read and with no more than **30 sec**, try to find out as much of the following queries:   * **Querying for Reference: **After writing, come back after at least a week. Open it up, read and with no more than **30 sec**, try to find out as much of the following queries:
-    * You ran into (inavoidable) cross-road confrontation with an urchin with stolen bread.+    * You ran into an (inavoidable) cross-road confrontation with an urchin with stolen bread.
       * **Character: **Construct at least __three conversation chains__ detailing an //internal response// and an //external response// accurate to their characteristics in attitude and disposition.       * **Character: **Construct at least __three conversation chains__ detailing an //internal response// and an //external response// accurate to their characteristics in attitude and disposition.
       * **Location:** Construct a scene description with __at least three features__ that you may immediately recite to the table accurate to the location's characteristics in theme and mood.       * **Location:** Construct a scene description with __at least three features__ that you may immediately recite to the table accurate to the location's characteristics in theme and mood.
  
 ===== Conventions ===== ===== Conventions =====
 +
 +==== Entities ====
  
 The page content of this wiki loosely follows the [[http://www.kjd-imc.org/blog/entity-template-updated-and-explained/|entity template]] scaffolding principle. The page content of this wiki loosely follows the [[http://www.kjd-imc.org/blog/entity-template-updated-and-explained/|entity template]] scaffolding principle.
  
   * [[Lore:lore|Lore]] is freeform.   * [[Lore:lore|Lore]] is freeform.
-  * Characters, Locations and Events/Stimuli fall under entities principle.+  * Characters, Locations and Events/Stimuli fall under the entities principle
 + 
 +==== Religion ==== 
 + 
 +  * Idols instead of deities. 
 +  * Devotees refer to followers, believers etc.
  
  
Driven by DokuWiki
rules_conventions_and_policies.1662188957.txt.gz · Last modified: 2022/09/03 03:09 by admin