How to edit

From RISC OS
Revision as of 12:22, 13 April 2007 by Adamr (talk | contribs) (Add note on revert guidance)
Jump to navigationJump to search

Before you start

In order to edit the riscos.info wiki, you will need to log in. Before you can log in, you must first create an account. This is a simple process - just go to the Login page and enter the relevant details. Having created an account and logged in, you can then make whetever changes you please throughout most of the wiki. (There are a few sections where only trusted users with greater privileges can make changes.)

Be warned that after a certain amount of inactivity, you will automatically be logged out again. The cutoff is approximately an hour. If you are making anything more than trivial changes, it is better to write them in an external text editor, then cut-and-paste them into place. This reduces the risk that you will lose your work.

How to edit a Wiki

NB: This is meant as a getting started guide to wiki editing. For a complete list of commands, visit http://en.wikipedia.org/wiki/Help:Editing

  • Every page will have at least one blue Edit link in a tab at the top of the page (with the exception of certain locked pages).
  • Clicking this button when logged in takes you to the editing page

Once at the Editing page, you'll need to know about the format of Wikis.

Generally, everything is designed to be straightforward. riscos.info uses the same MediaWiki software as Wikipedia, so more information can be found reading the MediaWiki Handbook.

Formatting

Normal text only needs to be typed.

A single new line doesn't create a break.

An empty line starts a new paragraph.

  • Lines starting with * create lists. Multiple *s nest the list
  • You can use apostrophes to add emphasis
    • ''some text'' will be italicised: some text
    • '''some more text''' will be bold: some more text
    • 5 apostrophes are bold and italicised
  • Sections are marked with the = symbol
    • == Main Heading ==
    • === Sub-heading ===
    • ==== Smaller sub-heading ====
  • NB: HTML emphasis can be used too

Linking

To link to another article in the wiki, eg: RISC OS, simply type [[Page name here]]

To link to a URL, either type the URL: http://riscos.com or to change how it appears: [http://riscos.com Text to appear] gives Text to appear

If you link to a page that doesn't exist, following the link will enable you to edit, and thus create the page: A page that doesn't exist.

If you wanted to link to a page X, but display Y, you would use a piped link: [[RISC OS|Front page]] gives Front page

General Advice

The front page has several categories listed on it. While this list can grow, if your article can fit in one of these categories, then go to the category page in question and add a link to it.

When creating a new page, make use of the Preview button to avoid filling up the change log with lots of revisions to your new article and always include some information in the 'Summary' box to help others see what's happened in the change log

If you spot a mistake in someone else's work, correct it, but make a note in the 'Summary' box stating the reason for the change, eg: Fixed speeling mistooks.

If you feel you can add useful information to an existing page, then add it. If you feel something should be removed, remove it, but state why in the 'Summary' box. If it's a point of contention, use the article discussion link at the top of every page to start a talk about it. Make sure you sign points you raise on the discussion pages by typing ~~~~.

If you think a page should exist, but you don't have time to create it, link to it anyway. People are far more likely to fill in blanks if they can just follow a link than if they have to edit links all over the place.

Above all, keep it factual, professional and clean. If you don't, you are liable to be banned from further contribution, and someone will fix your errors anyway! As the disclaimer says: 'If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here.' Wikipedia is proof that the idea works, and works well.

Templates

Templates allow information to be displayed in the same format on different, related, pages (such as the info box on this Wikipedia page), or to link together related articles (such as the box on this page).

See a Getting Started HOWTO. Or try editing a Wikipedia template to see the source for an existing example.

Moderating Others' Work

Before removing someone else's contribution, consider the guidance on "reverting" from wikimedia.