please read the guidelines
Here are a few guidelines to follow in order to keep the wiki organized and easy to use.
Changes in formatting wiki pages here
vs. the old Cranenthaulipedia
In addition to the WYSIWYG editor you will find when editing page source, the OP wiki on this site supports Textile (RedCloth 4) markup, the full reference for which can be found here: Textile Reference Manual for RedCloth 4
|Syntax||This Wiki||Old Wiki|
|Internal Wiki Links||Same as old wiki (but now pages can have spaces, capitals, and apostrophes, so now [[Bilbo’s Left Kidney]] is fine). Links are now case sensitive, so watch for this when converting pages from old to new wiki.||[[bilbos_left_kidney|Bilbo’s Left Kidney]], links are not case sensitive.|
|Bold text||*Make this bold.*||**Make this bold.**|
|Italicized text||_Make this italicized._||//Make this italicized.//|
|Underlined text||NA||__Underline this text.__|
|-Strike out this text.-||NA|
|HTML||Most simple HTML can be used.||NA|
|CSS||Custom CSS rules can be added (ask Craig).||NA|
|Line break/carriage return||Just use carriage returns normally, or use <br/> if necessary.||\\|
|Tables||Same as old site with addition of Textile markup for outlines, table headers, etc.; can also use HTML tables.||Vertical pipe characters (|) define table cells.|
|Headings||h1. Make this is Heading One
h2. Make this Heading Two
|======Make this Heading One ======
===== Make this Heading Two =====
|Horizontal rule||Same as old wiki, or use <hr/>.||----|
|Numbered lists||# This is the first item.
# This is the second item.
|- This is the first item.
- This is the second item.
|Bulleted lists||Same as the old wiki||* This is the first item.
* This is the second item.
If you have any technical questions, you can always message either Craig (dr_venture) or Chet (cheterez) via the messaging system on this site, or put a message in the forums… or just call or email.
Migrating from the Old Cranenthaulipedia
CHARACTER PAGE LINKS: Page code moved from the old wiki to the new wiki will at least have their links work without any modifications. However, this new site has regular wiki pages, and character pages that not surprisingly hold character info. The Character pages are handled a little differently than the wiki pages, and links to those pages are slightly different … thus the two links to the right, “Character Link” and “Wiki Link.” This new functionality breaks all of the character links in the old wiki. To compensate, I’ve created a “reference” link for each character at the address that that old site pointed to… so any character links in the wiki pages that are migrated from the old site will take the user to a place holder page that has a correct link to their new character page. So theoretically, no links should be broken.
Creating New Pages
- Give adventure stories/prose their own ‘History’ page. Stories of adventures or prose should be given a link on the ‘History’ page, then a new page should be created by clicking on that link.
- Keep non-history pages specific. Please keep the content of the page focused on the topic of the page for pages on specific ‘things’… i.e., people, places, items, etc. Create additional pages for specific ‘things’ that need further description and are named or unique.
- Only link to the first instance of a related topic. Often something that you want to link to is mentioned many times on a page. You do not need to link to every mention of that thing, just link the first time it’s mentioned.
- Link to related pages. If a ‘thing’ appears on another page – particularly story pages – link to the other pages from the ’thing’s page.
- Watch out when creating new links! (see below)
Creating Links to Existing Pages
Just use the built-in link widget in the toolbar on the right “Character Link” for character pages, and “Wiki Link” for all other pages. You can type into the resulting window to narrow the search for the page you’re looking for.
Creating Links to New Pages
Be careful – it’s very easy to accidentally create multiple links to a new page from different places, but with each accidentally having a slightly different spelling.
For instance, you create a page for ‘Smaug’ and link to a non-existent Bilbo page with the link ‘Bilbo’, then you create a page for ‘Sting’ and another link to the new ‘Bilbo’ page, but this time you use the link ‘B Baggins’, and so on. However, when you finally do create Bilbo’s page, it can have only one page correct link. If you use ‘Bilbo’, the 2nd link won’t work. Even worse, if you got to the ‘Sting’ page, the Bilbo link will be red (since it is pointing to ‘B Baggins’, not the ‘Bilbo’ link)… if you click on that incorrect link, you will be prompted to create a new page. So if you’re not careful, it’s easy to wind up with multiple pages for the same thing with slightly different links.
To best avoid this problem, try to do the following when you’re creating a link to a new page.
- First check the appropriate main topic pages listed on the Main Page. You may find a link there to the page you’re looking for, even if the page for that topic was never actually created and the link is red. Using existing links whenever possible will help avoid duplicate links.
- Look through the listings in the link buttons to see if you can find the link there. This can be kind of a pain, but please take a stab at it.
- If you’re feeling confident that a new link needs to be created, you’ll need to create a link to the new page. Just type the link text you want into the body of the text, with double square brackets around it. For the Bilbo link mentioned previously, you might choose, [[Bilbo Baggins]]
When you naming a new link, follow these rules:
- Make the name of the link the same as the new page’s title. Capital letters and spaces are OK, as are apostrophes (they will be automatically stripped out). Periods are not allowed.
Dealing with Duplicate Pages
If you find that there are duplicate pages for the same subject/item/thingie, say for instance a page for “Bilbo” and a page for Bilbo Baggins", that situation should be corrected using the following steps:
- Choose one of the pages to keep as the ‘official’ new page — use the one with the most logical page name.
- Migrate all of the information on any duplicate page(s) to the one official page you selected above. This should leave any duplicate pages essentially blank. Do not delete any of the duplicate pages as it will break any links to those pages spread around in the wiki. Instead…
- Put a brief message on each of the empty duplicate pages that indicates that that page was found to be a duplicate of another page, and all of the info on the subject can be found on the page you chose above. Most importantly, include a link to the new official page on the subject that you chose above.
- Include a h1 title on the top of each page.*
- Look at existing pages for examples. Find similar pages and look at the code to see how it it is being done.
Please use image editing software to limit the size of uploaded images to something reasonable. I’d suggest the following rules be followed whenever possible:
- Make sure the image’s resolution is set to [[http://en.wikipedia.org/wiki/Dots_per_inch|72 dpi]].
- Scale the image so that it’s width is no more than 1000 pixels maximum (which is fairly big).
- Scale the image as small as possible while still maintaining a decent level of detail for the information the picture contains. For instance, a scan of a detailed map will need more detail (and thus a larger size) than a sketch of a sign post.
- When you upload the image, use a logical name. If it’s a map, preface the name with ‘map’. If it’s a player’s aid (i.e., a picture of a sign post), preface it with ‘p-aid’. And if it’s a map meant as a player’s aid, preface it with ‘p-map’.