General
-
-
Use
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.
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
Quotes
Quotations are indented by > , italicised and the source is indicated by a bullet point outside of the quotation immediately after it.
Aggregating Books
Prosemirror
When using the prosemirror editor, save often and BEFORE you toggle the editor switch (often from WYSIWYG to default). Data may be lost.
Transferring from Word or GDoc:
Copy into posemirror editor.
Toggle back to default editor.
Copy into a better editor (vscode) and replace the non-edit syntaxes
(i.e. %%, //, \\)
Copy back into the default editor and save.
Note for Writing
GDoc and Dokuwiki conventions may not translate. Consider building new conventions specifically for doku.
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.
Always use section breaks.
Always complete/perfect ONE piece of content to establish a writing style before writing another similar piece of content.
Never edit while writing. Edit in one week.
Never revise a document until it is complete.
Italic and indent for examples and quotes.
Bold for signposting.
Underline for emphasis.
Hyphens — Used to make extended points and extrapolation of loaded terms.
Square Brackets highlight previously defined [Concepts].
Braces for {mathematical expressions}.
Italic Bold for recurring key terms.
Always construct an Aim statement for a piece of document and a summative subtitle.
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.
Writing Tenets
Good Activities to do to test out your entity's quality:
Assuming play session conditions at a table, read through the following activities and practice it:
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:
Conventions
Entities
The page content of this wiki loosely follows the entity template scaffolding principle.
Religion