Wiki Guide

World of Hearts' Wiki Project is hosted on Wikidot, an easy to use wiki system that's been around for a few years. It is rather extendable, and has a lot of neat features, but it's also pretty easy to use, which influenced the staff's decision to use it. Its syntax is relatively easy to get used to, and there's no real big curve to figuring out how to use it. There are some features that Wikidot offers that we do make use of on this wiki, so this page is intended to go over how to contribute to the game's wiki like a champ.

Joining Wikidot

The first thing players will need to do is register for an account on Wikidot. Once this account is registered, however, you can use it to join and create other wikis on Wikidot, so you'll only need one account. Once you've made an account, you can use any Join button on a Wiki to join that site. Ours is on the front page - this join button does not display to members that have joined the wiki already.

Wikidot's Syntax

For the most part, Wikidot's syntax is pretty straight-forward. There are also formatting buttons on page creation and edit that will help with it, but the most basic Wikidot formatting codes are:

**bold**
//italic//
__underline__
|| Simple table || this is another cell ||
||~ this is a th || this is a td ||
||= this is centered ||> this is right aligned ||
|||| this row spans two columns ||
|||| this is a line _
that breaks in two ||
[/base:rules this is a link to the rules]
[http://worldofhearts.net this is an external link]

Creating Pages

To create a page, all you need to do is visit the URL for the page that you want to use (wiki.worldofhearts.net/page-name). This page most likely will not exist, and will have a link on it to create it.

When creating and editing pages, the system grants you a lock. What this means is that nobody else can create or edit that page while you have a lock on it, in order to prevent users from trying to edit the same page at the same time, and overriding one another's changes. This lock, by default, lasts 15 minutes, but will refresh itself and start the counter over whenever there is activity in the text area.

Page Categories

Some pages' URL have a prefix. This is in the form of a word with a semicolon at the end. The setting pages are all in a category called setting, and their pages are prefixed with setting:. Likewise, pages created in certain categories, which appear on indexes, will need to be prefixed with a category name. This is so that the page template appears as it is intended to, and these pages show up in the index page they are meant to.

There are four categories for user usage:
bestiary: (non-human magical creatures)
lineages: (family pages)
vessels: (ships, both water and sky)
technology: (for user-created technology that has been established in board canon)

Page Templates

When creating a page in certain categories, a page template will auto-populate in the text box. These sections are separated by
====
and each will place itself in the appropriate location within a page template. In this way, the fancy templates are uniform, and happen on their own, so users don't need to fuss with making things look special on their own.

A thing to note is that most templates have sections that go into a table. When adding a line-break within these table sections, you'll need to use a single space and an underscore at the end of the first line, so that the table will properly do a line-break.

This is a table That has a line break
in one if its columns.
In this row, we'll do

without the underscore. ||

If you do happen to do this on accident and break it, it's a very easy fix, don't worry.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License