Editing these wiki pages

From SCA Lochac
Jump to navigation Jump to search

Namespaces

These are used to help keep our various martial endeavours separate within the wiki, so you can refer to things logically. There is a live version and a draft version for each namespace. We use:

  • Armoured Combat (this also hosts the Marshal Handbook currently)
  • Rapier (this might end up hosting youth rapier as well?)
  • Siege
  • Archery (for target archery and thrown weapons)
  • Equestrian
  • Youth Armoured Combat

If you want to refer to the Change Log for a particular martial rule set, it'll be called Change Log within the relevant namespace, and we can have an Introduction page for each rule set without having to come up with unique titles for the Rapier Introduction page and the Archery one.

Making new pages

If you think you need a new page in your part of the wiki, all you need to do is to create a link to it [[ Sample:This_Page_Doesnt_Exist_Yet ]]. Use underscores for spaces and Capitalise Each New Word. The best place to make a new page is the landing page, so you'll be able to find it again later. Don't forget that there should end up being a draft version of each page

Page layout

Characters you can't use

  • Don't use " for inches or ' for feet - it mucks up actual "quotes" within the pdf generation, and looks funny. Use inches and feet where required. Be careful when you copy and paste text from another source that it's not using smart quotes - it pays to retype them in the editing window, just to make sure. See the Combat Rules Writing Style Guide
  • most special characters, like an e with a ^ over it, umlauts etc.

Headings

Using ==symbols surrounding== the words you want as a heading will give you a heading like the one above.

It helps break up the text into readable chunks, and makes paragraph tags that can help you link to the right section of a page, and not just the page itself.

Check that you aren't inadvertently creating a numbering collision, as numbered rules under headings will end up with the same rule reference number as a sub heading below! Eg:

  1. this rule number collides with the subheading below

Subheadings

This subheading uses === to surround the heading to create a subheading.

These also make tags you can use, and they will show up in tables of contents for each page that has more than 3 headings.

One more level of subheading

They stop looking different once to get to ==== (this layer).

These also make tags you can use, and they will show up in tables of contents for each page that has more than 3 headings.

Lists

Numbered lists

Most of our rules are numbered lists. It helps people find things when you can tell them which number rule to look for.

The pound/hash # at the start of a line gives you an item in a numbered list. Using them elsewhere in text will give you a # symbol.

  1. Item 1
  2. Item 2
  3. Using it twice ## gives you a numbered item in the next level of list
    1. Like this
    2. and this
      1. These lists can get deeper
        1. and deeper
          1. and deeper, but it breaks the pdf generator if you go beyond ### under a == heading or ## under a === heading - you get 6 layers max.

Bullet-pointed lists

Using a * at the start of the line makes a bullet point

  • like this
    • Using it twice increases the indent, but doesn't change the bullet style.

You can use bullet points within a numbered list too by typing #* at the start of the line. The number of ##s will need to match the depth of list you are up to.

  1. Item one
  2. Item two
    • bullet point item under Item 2 has a #*

Table formatting

Check this out in editing to see the formatting used to create it

This is a table caption
I'm a header I'm a header too
I'm a new cell I'm a new cell too
I'm on a new row
  1. with a numbered list
  2. with several things
I need
  • a bulleted list
  • with more listed things
  • like this

and I just want to be on another line

more stuff