Latest Posts

Changes in WikiHelp

Editor Comment

Warning "Save before image upload"


Revision Differences of Revision 19

This page describes the usage of the wiki itself. If you find outdated information in an article, misspelled words, a dead link or anything else that needs fixing, don't be scared of editing. You can use the preview function at any time to examine your changes before you save anything. If something should go wrong, you can also revert to a previous revision of an article. Helping on the wiki is highly recommended. If you want to make big changes to an existing article, please ask on the [Forums](https://wl.widelands.org/forum/forum/11/) prior to editing. ¶

Some of the wiki’s pages are created automatically, those pages can't be edited. This article explains the handling of handmade articles. ¶

[TOC] ¶

## Main actions ¶
On the top right above each wikipage, you will see three green links: ¶

* _'Edit this article'_ - This will open the article in editor mode. You have to be logged in to edit an article. ¶
* _'Editing history'_ - Shows all revisions of this article with the possibility to compare and [revert](/wiki/WikiHelp#reverting_to_a_previous_revision) articles. ¶
* _'Observe'_ - If you click on this, you will be e-mailed about changes in this article. If logged in, you can also [manage your notifications](https://wl.widelands.org/notification/). ¶

## Editing ¶
Checkout the WikiSyntax before you edit an article. There is also a WikiSandbox where you can play around with the syntax without changing any actual content. ¶

The editor consists of four rows: ¶

1. _'Title'_ – The title of the article. ___Don't change this!___ This field is to be used for renaming articles only. If you change this, a redirect from "Old Name"' to "New Name" will be created. If "New Name" already exists, a call on "New Name" will trigger an error (c.f. the corresponding [bug](https://bugs.launchpad.net/widelands-website/+bug/1399461)). ¶
1. _'Content'_ – This is the place where the article’s text is edited/inserted. ¶
1. _'Page Summary'_ – Mandatory for the first revision. This field should reflect the article’s contents in a few words. Be descriptive as well as concise, as this is shown in the [list of all articles](/wiki/list). ¶
1. _'Comment for this revision'_ – A short description of your changes. ¶

After editing, always use the _'Preview'_ button to examine your edits. If everything is OK, press _'Save'_. Clicking the _'Diff'_ button will show all edits compared to the last saved revision. ¶

At the bottom is the possibility to upload images. Please read the section on [Images](/wiki/WikiHelp#images) about limitations and how it works. ¶

## New articles ¶
To create a new article, you have to be logged in. Now change the web address in you browser like this: ¶

~~~~~~ ¶
https://wl.widelands.org/wiki/edit/YourNewArticleName ¶
~~~~~~ ¶

Be sure to create an article name as in the example and do not add blank spaces, e.g. as in "my new page". Those names won’t be caught by the wiki parser and you would have to use the [syntax for external links](/wiki/WikiSyntax#links_and_images) to use them in other articles. So, always use **Camel****Case** instead. ¶

The chapter on [Editing](/wiki/WikiHelp#editing) explains the fields of the editor. You will have to save a newly created article before you can upload images to it. ¶

## Images ¶

You can add images to an article, but keep in mind: ¶

* There is currently no limitation on size! Be sure to upload only pictures that fit in size. Screenshots with a resolution of 1800x1600 are definitely too large. A maximum width of around 600 pixels is appreciated. ¶
* All images will be displayed in their actual size. There is NO way to make them display smaller. ¶
* Remember that not all picture types are sure to show up for everybody. To be safe, use mainly _.png_, _.jpg_ or similar formats, as these are most widely supported. ¶
* Pictures will NOT work for the wiki if they contain a space in the filename. ¶
* It is currently not possible to remove an image once it is uploaded (unless an administrator does some serious hacking), so only add images you know you need to use! ¶
* A newly created article has to be saved before the image upload can work. ¶

### Uploading ¶

Be sure to save the article before you uplaod images. Otherwise previous edits get lost! ¶

To upload an image to the wiki, press _'Edit this article'_ in the top right hand corner of the article that you wish to add the picture to. ¶

Scroll down to the bottom of the edit options. Under 'Imagename:', press the _'choose file'_ button and find the image you wish to upload. When you have chosen the image(s), press the _'Upload Image'_ button. The code which is used to display each image will be shown on the right. ¶

### Displaying images in your article ¶

To add an image to your article, you must do the following: ¶

1. If it is a newly created article, save it first ¶
1. Press _'Edit this article'_ ¶
1. Copy the code displayed to the right of the image you wish to show ¶
1. Paste the code into your article in the spot where you wish to show it ¶
1. Press _'Save'_ ¶

## Reverting to a previous revision ¶

All articles are stored as revisions, which you will find in their _'Editing history'_. To revert the contents to a previous revision, select the appropriate revision and click on _'Revert to selected revision'_. ¶


##[Discussion on this article](https://wl.widelands.org/forum/topic/1600)