- 1 Wiki quickstart guide
- 1.1 How to create a new page?
- 1.2 How to edit a page?
- 1.3 Level 2
- 1.4 How to add white lines between paragraphs
- 1.5 How to add a picture to a page?
- 1.6 How to create an internal link?
- 1.7 How to create an external link?
- 1.8 How to add footnotes and references?
- 1.9 How to get an email notification when a page has changed?
- 1.10 How to import text from a word document?
Wiki quickstart guide
How to create a new page?
1) Enter the url of the non-existing page into your browser's address bar. You can use spaces in the title of a new page. These will automatically be replaced by underscores. Please note that the names of wiki pages are case sensitive. main page will not be the same as Main Page
2) The page will only be created once you make your first edit. Click on create in the right corner to start editing your page.
3) After entering some content you save the page.
For more information on editing wiki pages see 2. How to edit a page.
4) You can reach your newly created page at the url you specified in 1).
How to edit a page?
1) Make sure you are logged in.
2) Go to the page you would like to edit.
3) Click on the edit tab.
4) Type in your text and hit the Save page button.
Pages are formatted using the wiki markup. By adding specific characters to your text you can change the formatting. For example to put a piece of text in bold just put it between 3 apostrophes: '''bold text'''.
The most used wiki markup code:
|Description||You type||You get|
|Character (inline) formatting – applies anywhere|
|Bold and italic||
'''''bold & italic'''''
bold & italic
<strike> strike text </strike>
|Escape wiki markup||
|Escape wiki markup once||
|Section formatting – only at the beginning of the line|
|Headings of different levels||== Level 2 == === Level 3 === ==== Level 4 ==== ===== Level 5 ===== ====== Level 6 ======||
Text before ---- Text after
* Start each line * with an [[Wikipedia:asterisk|asterisk]] (*). ** More asterisks give deeper *** and deeper levels. * Line breaks <br />don't break levels. *** But jumping levels creates empty space. Any other start ends the list.
Any other start ends the list.
# Start each line # with a [[Wikipedia:Number_sign|number sign]] (#). ## More number signs give deeper ### and deeper ### levels. # Line breaks <br />don't break levels. ### But jumping levels creates empty space. # Blank lines # end the list and start another. Any other start also ends the list.
Any other start also ends the list.
;item 1 : definition 1 ;item 2 : definition 2-1 : definition 2-2
: Single indent :: Double indent ::::: Multiple indent
|Mixture of different types of list||
# one # two #* two point one #* two point two # three #; three item one #: three def one # four #: four def one #: this looks like a continuation #: and is often used #: instead <br />of <nowiki><br /></nowiki> # five ## five sub 1 ### five sub 1 sub 1 ## five sub 2
Start each line with a space. Text is '''preformatted''' and ''markups'' '''''can''''' be done.
Start each line with a space. Text is preformatted and markups can be done.
|Preformatted text blocks||
<nowiki>Start with a space in the first column, (before the <nowiki>). Then your block format will be maintained. This is good for copying in code blocks: def function(): """documentation string""" if True: print True else: print False</nowiki>
Start with a space in the first column, (before the <nowiki>). Then your block format will be maintained. This is good for copying in code blocks: def function(): """documentation string""" if True: print True else: print False
! You can't use the preformatted text options for importing the markup used in word text. For this see: How to import text from a word document
In addition some html-tags are allowed. For example <br/> to start a new line.
You don't have to remember all these codes but could simply use the editor's tool bar. By selectting a formatting option the markup code is automatically printed in the editor.
Table of contents
The wiki will automatically create a Table of contents.
However if you do not want to display this table of contents you can remove it by adding __NOTOC__ somewhere in the page.
Tables can be created by using wikicode or xhtml.
- For wikicode tables see: http://www.mediawiki.org/wiki/Help:Tables
- For xhtml tables see: http://www.w3schools.com/html/html_tables.asp
How to add white lines between paragraphs
MediaWiki ignores single line breaks.
However there are several ways to add a space between paragraphs.
1) You can simply add an extra white line in the editor between two paragraphs.
2) or you could use the <br/> code. There is also a shortcut for this in the editor's toolbar.
How to add a picture to a page?
Uploading a picture to the wiki is a two step process. You need to upload the image file first under special pages after which you can add the image to the page by using wiki markup.
1) First go to Special:Upload or click on Upload file in the navigation bar on the left.
2) Select the file you would like to upload and press upload file.
3) On the next page you will get the filename. This filename is needed to display the file on the page.
Put picture in page
You can add the image on your page by using the following syntax: [[File:Wiki guide 1.png]]. This filename is found when uploading the image or in the image library.
You can also add a border : [[File:Wiki guide 1.png| border |caption]]
Or put the image in a frame: [[File:Wiki guide 1.png| frame |caption]]
Internal links to wiki pages are created by putting the page name between a pair of square brackets ([[ ]]). Linking to the Main Page would be done by entering [[Main Page]].
You can change the display text by adding it after a pipe ("|") [[Main Page|main page of the dca wiki]]
Links to external pages or files are created by putting the page name between single square brackets ([ ]). Linking to www.google.com would be done by entering [http://www.google.be].
You can change the display text by adding it after a space [[http://dca-project.eu Website of the dca project]
How to add footnotes and references?
To add references you should put the contents of the notes between a ref-tag. For example <ref>This is reference 1</ref>. To display all the references enter <references /> in the text where you want them to show up.
To add footnotes follow the same procedure except add a group to the <ref>-tags and the <references>-tag. <ref group=note>Footnote 1</ref>. To display all the footnotes enter <references group="note"/>
How to get an email notification when a page has changed?
1) First you have to add the page to your watchlist. You can do this when editing a page or going to Special:Watchlist.
2) Then go to Special:Preferences and make sure you have selected watchlist notification if you want to receive an email when pages on your watchlist have been edited.
How to import text from a word document?
- there are multiple ways to convert a word document to a format which can be pasted in the wiki's text editor. The method presented here converts doc-files to html and then cleans the html using an online service.
- Other options are using https://www.archlinux.org/packages/extra/x86_64/libreoffice-extension-wiki-publisher/ for libreoffice or http://sourceforge.net/projects/word2mediawikip/files/Word2MediaWikiPlus/ or / http://www.microsoft.com/en-us/download/details.aspx?id=12298 for MS word.
- The results of these conversions are always far from perfect, but could be a first step.
- These instructions are for the mac OSX version of word, for windows it should be similar
1) Save your word document as a webpage
Make sure the option 'Save entire file into html' is checked!
2) You might have to change the character encoding of the file to UTF-8 (for OS X it is set to macintosh but the online html cleaner won't accept this encoding).
I am using TextWrangler for this.
a) Change it in the text
b) save the file with the correct encoding
3) Go to http://textism.com/wordcleaner/ and upload the utf-8 .htm-file you just created.
4) Copy this text and paste in into the wiki-editor. You'll have to remove some html tags which are not recognised by the wiki manually, such as the <a></a> tags.