How To Edit

Editing wiki pages is pretty simple once you know the tricks.

- nirar22 nirar22 has provided a wiki for users to mess around with and learn the ropes : Nirar22's Testing Edits
  • However, you can always simply start your own wiki page on this site and mess around with it if you so choose



Using Camel Brackets


Camel Brackets are the wiki standard method for hyperlinking.

Note: These type of links work in Discussion posts as well, making them very handy for linking to FAQ pages containing answers.

If the page being linked does not exist, you can still create a link to it for later use.
  • This way, you can leave the option open to create a page at some point in the future, even if you do not have time at the moment to write the other page yourself.



Editing a Table

anchor : [[How To Edit#Tables]]

So you want to add a new row to an existing table ?
  1. Click on the first cell of the first row in the table
  2. An icon will appear, click on it.
    • TableMenu.JPG
  3. Expand the menu until you see "Add above"
    • TableMenuExpanded.JPG
  4. Click that option. The table in the background will highlight in green to show you where the new row will appear
  5. After that, simply fill in each cell with the required information.

Though you may also find it easier to simply enter Wikitext Editor mode where tables are simpy defined as a series of || elements.
  • Copy one of the existing rows and then paste it at the top of the table, under the header row.
  • After that, simply change the contents of the cells to your liking.



Converting Text in Lists


To convert this:
A
B

Into this:
  • A
  • B

Highlight both the "A" and "B" lines, and pressing one of the List buttons in the editor bar. This method can be used for any size list, and is quite handy when converting text copied from another source.



Nested Lists


To create nested lists use "Tab" and "Shift-Tab".

To change this
  • A
  • B

To this :
  • A
    • B

While sitting on the "B" line, press the Tab key

To change this:
  • A
    • B

To this:
  • A
  • B

While sitting on the "B" line, press the Shift-Tab key

To change this:
  • A

  • B

To this:
  • A

  • B

Sit the cursor on the blank list entry between "A" and "B" and use the Shift-Tab key.
  • This method is quite handy when the editor starts acting up and refuses to split the list itself

To change this:
  1. The First Entry
  2. The Second Entry

To this:
  1. The First Entry

  2. The Second Entry

You must edit Wikitext Editor mode (see further down for details on how to do so), and enter a > character followed by a space, between the two list entries.
  • Using the > character ensures that the numbered list continues to count properly. If a regular space are used, both list entries would display "1."
  • Note that the number of > characters required matches the number of * characters being used by the list.
    • So when placing a space in a second level list, you require >> followed by a space
  • Note that the space after the final > character is a necessary part of the format, otherwise you will simply end up with the > character itself being displayed on the page.



Anchors


Anchor points allow users to link to a specific point in a long web page.
  • For instance : [[home]] will take you to the top of the home page, but [[home#Disclaimer]] will automatically scroll the page down to view the Disclaimer at the bottom

Since anchors are normally hidden when reading a page, the developer chooses to display the anchor point link value using a yellow tag either above or below the anchor's position.
  • You can see an example of such in the Disclaimer example above.
  • To stop the anchor link from actually being interpreted by the wiki page as a real link, the use of two single quotes is provided by the system.
    • You can see an example of this type of formatting if you edit this page, and look at the lines above
  • Remember that you require the single quotes on both sides of the wikitext you are altering.



Wikitext Editor

anchor: [[How To Edit#Wikitext Editor]]

The wikitext editor is available by pressing this button :
  • Wikitext_Editor_Option.png

This alternative editor displays the raw wikitext formatting, rather than the pretty version, allowing you to type in the format directly, without having to fidgeting around with the menu at the top.

To switch back to the Visual Editor, use the same operation as mentioned above.



Embedded Widgets


Widgets, such as page lists, embedded wiki pages, or files are sometimes easier to manipulate using the Wikitext Editor.

However if you do not know the options for the widget, simply click on the blue widget box, and press the "edit widget" option. the editor will then display the various options that are available.
  • After that, simply switch over to the Wikitext Editor, and read the parameters that were created, for future reference.



Viewing the Changes made by other users

anchor: [[How To Edit#Revisions]]

By design wikis have the ability to view the changes made in the past and compare them to the current information displayed on the page:
  • This makes it simpler to locate alterations, and verify their correctness.

To view the changes, do the following :
  1. Go to the page you are interested in
  2. Press the "Revisions" button at the top of the page.
    • RevisionButton.JPG
  3. Press the "Select" button for the first revision you wish to compare against.
    • To compare against the information currently displayed, choose the first entry in the list
    • RevisionFirstChoice.JPG
  4. Press the "Compare" button for the second revision you wish to compare against.
    • When I compare a page, I usually return to the last of my personal revisions so I can see all the intermediate changes combined together.
    • RevisionSecondChoice.JPG
  5. After you do that, the page will be displayed, with all the differences highlighted, and the top menu will have two new options :
    • WikiTextReviewChanges.JPG
    • To zoom straight to the first change on the page, press "Review Changes"
    • To view the coding side of the page, check the "View WikiText" option
      • If you don't see any changes, they may actually be page coding changes, which can only be viewed if you are looking at the WikiText itself



Issues to Watch Out For


There are a couple of gotchas I have noted with this Wiki :

Embedded Bold Text

  • The editor likes to eat spaces that follow embedded bold text, such as THIS TEXT . Each iteration of editing will eat the space after the bolding, so if there is a word afterwards, they will merged together.
  • To work around this issue, I have been placing a ".." after bolded text that has been effected. If you happen to see this format, that is why the two periods are there.

Editing List Entries

  • Occasionally if you edit the first line in a list, the editor will consume the second line for no reason. It appears to be an error in the editor software, and is quite random
  • To work around the issue, switch into Wikitext Editor mode and alter the list using that method instead.

Escaping Wikitext

  • Using the single quotes to escape wikitext, in order to stop the wiki page from interpreting it, does not work for the tilde signature codes, ~ ~ ~ (or at least I have never been able to get it to work)
    • This is why I simply link to the Signature Tags page instead, where the creators of the website have somehow escaped it themselves.

Copying Text from Other Web Pages

  • If you copy text directly off another website page, the Visual Editor, the editing software will attempt to preserve the font formatting perfectly.
    • However in doing so, it will break the ability to format the text in this editor.
  • To correct this issue, paste the text using the Wikitext Editor instead. Doing so will strip all the HTML formatting off the text and paste the text contents only.
  • If you wish to preserve some of the formatting, such as a nested list structure, do the following:
    • Paste using the Visual Editor
    • Switch over to the Wikitext Editor (you will see a pile of elements have been added containing font formatting)
    • Copy the text contents, and paste them into a text editor such as Notepad
    • In Notepad, use the Replace functionality to remove all the and elements from the text
    • Copy the corrected contents from Notepad and paste them back into the Wikitext Editor.
    • Switch back to the Visual Editor and verify that the contents look proper



What are templates ?


Templates are special pages which can be used as the basis of actual publicly available pages in the wiki.

They contain a pre-defined format, to ensure that all the pages have the same feel and layout, and save you having to rewrite each one from scratch.

You are authorized to create your own templates, such as space.template.Mod Page German, for creating translations of pages.




How do I use a Template ?


When you are prompted to create a missing page on the wiki, there is an option to specify an existing template. Choose the one you want and press the "Edit".

After that you will need to populate the page with the necessary contents, whatever that may be.

If the template has existing links, it may be necessary to alter them as well.
  • For instance : space.template.Mod Page has several links that contain the word ModName, you must change that value to the name of the mod you are creating

Special Values
  • ModName
    • The name of the mod
  • PhaseNumber
    • The Phase number of the mod. Not all links have this element, since not all links are specific to a particular phase.
    • When replacing this value, use the word Phase followed by a space and the English word for the number of the phase
  • Developer Note
    • Some pages have notes that the original creator added as a reminder to do additional steps after templating.
    • After reviewing those notes, feel free to remove them from your page.