This is an old revision of the document!
Table of Contents
Style Guide
(Right now this is less of a real style guide, but more of a “what to watch for so DokuWiki works right” document. For now the general style guideline is “just try to match the layout of the other pages in the namespace” I guess)
Creating Pages
There's a little “Create new page” button in the sidebar if you're logged in. This will create a new page in the current namespace - so if you want to make a new page in Calculations, visit a page there, then hit the button on it.
The new page form will automatically convert the page title you enter into the proper URL format and open the editor. You can also create new sub-namespaces from there if neccessary.
Headlines and Sections
There should be exactly one H1 headline on each page:
====== H1 Headline ======
DokuWiki will use the text in this heading as the page title and display it in all navigation related places (links, browser tabs, breadcrumbs, sitemap, namespace listings…).
To format the rest of the page into sections, you should only use H2 headlines and lower (by either using the “Lower Headline” or “Select Headline” buttons in the editor):
===== H2 Headline ===== ==== H3 Headline ==== === H4 Headline === == H5 Headline ==
Manually adding horizontal lines (----
) is not neccessary.
Links to Other Pages
Because DokuWiki uses the H1 Heading as the page title, you don't need to specify a link label for intrawiki links. [[gameplay:accessories|]]
results in the same link as [[gameplay:accessories|Accessories]]
, since DokuWiki will automatically load the page title for the former. In fact, the first one is better, because it will automatically update if the page title is changed.
No Hotlinking
Hotlinking is when you take an image from another site and embed it as-is. Whenever someone visits the page where you embedded it, it will cause a request to the other site, and cause extra traffic and load for the other website's owner.
Instead, download the image, upload it onto the wiki, and embed that image. We don't want to cause trouble for other sites.
Contributors to this page: