This page contains a variety of fancy macros and shortcuts to get the most out of your wiki; most of these are custom made so if something is wrong with them, it's all my fault.

Wiki Layout and Best Practices

Page Hierarchy

This wiki has a hierarchical tree structure, wherein pages will have children pages with children pages, etc. This is reflected in the URL syntax of the pages. For example, when adding a new campaign page, it should go underneath the "campaigns" root page, and would look like this:

  • /campaigns/your-new-campaign/

Within the new campaign, you can then make more sub-pages, like so:

  • /campaigns/your-new-campaign/characters/
  • /campaigns/your-new-campaign/locations/
  • /campaigns/your-new-campaign/factions/

This system makes categorizing and organizing pages much easier. One caveat though is that sub-pages must have an existing parent page; for example, you can't create /campaigns/your-new-campaign/characters/ if "your-new-campaign" doesn't exist yet.

Known Issues

While the wiki uses the Markdown syntax to format pages, this particular version of Markdown has some issues / missing features from the standard.

  • Code blocks (using > to show blocks of text) does not work, at all.
  • Indenting lists requires the indentation to be at least one tab character or 4 more spaces on the next line; this was a choice by the developer apparently
  • Any text inside an html tag - like a <div> - will not be formatted using Markdown. This can be both annoying and desired.
  • Markdown really likes putting <p> in places it thinks a newline should go - especially when trying to use raw HTML. You've been warned.

Custom Macros

Custom code written by me to make things a little easier in formatting pages. I try to make them as simple as possible, but Markdown formatting forces me to do weird things sometimes. Note that due to the way macros work, all of the examples on this page have to be displayed as images - typing the code in to the page will simply activate the macro (they cannot be escaped - something to note).

Genesys Dice

Genesys dice will show as symbols, like this:

To do so, type in :g?: where ? is a capital letter of the color of the dice. See this image for a list of dice syntax.

Sidebar

The side bar is a narrow container positioned at the right side of the page. These can be useful for displaying quick facts about a subject. Due to Markdown restrictions, this has to be inserted as raw html as such (placed at the top of a page, ideally):

<div class="profile_bar"> Stuff goes here! </div>

Remember, since it's raw HTML, Markdown syntax will not work; please use the follow HTML tags for common things:

  • <h4>Title Bar Text</h4> - Useful for large headers of text such as the title of the bar
  • <h5>Subtitle text</h5> - Useful for smaller headers
  • <p>Normal text</p> - Normal text, like picture descriptions
  • <img src="url-of-imag" /> - Inserting an image - all images will be scaled to fit inside the sidebar
  • <hr> - Puts a horizontal line to break up content
Sidebar: Info

Additionally, a sub-macro exists to display information into formatted lists. You start with sb-info inside curly brackets, and end it with /sb-info inside curly brackets. Each element is listed as [Key:Value]. See the image for an example of this syntax.

Spoiler Tag

The spoiler tag alerts a user that a page may contained unmarked spoilers for a campaign, and can be displayed with spoiler inside curly brackets.

Example:

Untagged spoilers ahead!
This article has been marked for containing untagged spoilers for one of the campaigns. Read at your own risk!

Collapsible Section

Collapsible sections hide information until the appropriate link is clicked - currently a limitation to this macro is that all links have the same text (working on fixing that). This is shown via collapse inside curly brackets.

Note: For now you need to leave a blank line between the last line and the collapse tag; trying to see how to fix this.

Example:

Click to show

This should collapse!

Character Sheet

While technically this macro can be used to render any HTML page directly into the wiki page, its intended use is to display character sheets - specifically from RPG Sessions. This is done by typing sheet in curly brackets, followed by the URL of the sheet, and then ending with /sheet in curly brackets.

Example:


This article was last modified: Oct. 5, 2020, 9:30 p.m.

Powered by django-wiki, an open source application under the GPLv3 license. Let knowledge be the cure.