Difference between revisions of "Help:First Help"

Revision as of 15:26, 13 December 2012

Please add you own questions as well as links to helpful further pages on using the mediawiki software at the bottom.

How to write wiki pages

Note: The following refers to general introductory pages, not to the special pages for concepts, concepts collections, concept schemes, etc.

In many cases it is sufficient to simply look at existing pages and repeat what you see there. The most important hints are:

• Paragraphs are separated by an empty line.
• Headings are surrounded by multiple "=", the first of which must start at the start of a new line.
• List elements (like this list) start with 1-several "*" (unnumbered) or "#" (numbered list), the first of which must start at the start of a new line. "**" or "##" indicate a second level list, "***"/"###" a third level list, etc.
• Surround text by double apostrophes (2x ' = ) for italics, triple apostrophes for bold.
• Link external pages in the web by surrounding "URL displaytext" with single square brackets (i.e. type "[http://example.org/path/object displaytext]").
• Link internal pages in the wiki by sourrounding Page-name | displaytext with double square brackets (i.e. type "[[Main page|See also the start page]]").
• Images must first be uploaded (see Toolbox, Upload file in the left hand side bar). Like for pages, avoid names like "image 1" and choose a long and descriptive name instead. Images are available to all pages, not nested in a single page and each name can only be used once. Once uploaded, you refer to the image name, including the "File:" in double square brackets, add a vertical bar, the desired width in pixel, etc. Many more options exist, see [Wikipedia: Visual file markup].

Please feel free to edit this very brief starter should something be misleading or missing! Please feel free to ask questions here as well!

In general the Help pages of the English Wikipedia (which uses the same software) provide detailed help, see especially:

• Cheatsheet
• Tutorial: Editing
• Tutorial: Formatting
• Tutorial: Links (Ignore the "Wikipedia" in it)
• more technical, but sometimes useful: User's Guide

Limiting visibility of pages to signed-in users

Preface: The function to limit visibility prevents Google and other indexing engines from accidentally indexing a page and users finding it prematurely. It is not meant for strictly confidential information, which should not be put on the wiki at all.

Pages that start with the page name "Internal:" are visible only to signed-in users. Simply create a new page that starts with this string or move (= rename, see below) an existing page to a name starting with this string. To make a page public, move (= rename) it such that the prefix "Internal:" is removed.

Move = rename a page (move and rename are considered synonyms): You always rename the current page. If you are on a page you want to rename, go to the page menu (the downwards-pointing triangle on top of the page,left of the SEARCH field) and select "Move". Now in the field "To new Title": add the name. Klick on the button "Move Page".

Creating new pages

Preface: Pages and Mediafiles must have full, self-contained titles. Since they can be linked from anywhere, you may have to repeat some information in the title = name of a page, even if for the moment you consider it a subpage. Please consider that the same information may be found by users using a search engine and displayed out of context. The only information that can be consistently omitted is a reference to pro-iBiosphere.

Three main methods exist to create new pages:

1. On an existing page add a link which refers to a non-existing page that you desire to link from there. It is always good practice to have no unconnected pages. Once you save the existing page, the link will be shown in red. Click on the link and start typing or copying the content of a new page.
2. Search for a page in the search box on the top right. If no page exists already, you are given the option to create a new one (= red link with your new page title at the bottom of the search).
3. As a convenience, you can also create a new page here:

Inserting text created in editors (text editor, Microsoft Office, Open/LibreOffice)

Plain text editor: In general such text can simply be copied using the clipboard. A routine problem is that the wiki considers simple new lines as part of a paragraph, only an empty line creates a new paragraph. If you text uses single line breaks to indicate paragraphs, please replace single with double paragraph signs (\n -> \n\n, \r\n -> \r\n\r\n, ^p -> ^p, etc., depending on your editor). Alternatively, if your text relies on short lines, you can use <br/> at then end of lines to force new lines.

Word processor: For simple, short texts, inserting via clipboard and adding the few lost formats is quickest. For longer text, both for Microsoft Word and Libre/OpenOffice, plugins are available.

• MS Word: http://www.microsoft.com/en-us/download/details.aspx?id=12298 - this may or may not work. Select "Save As" in a Word document See also http://en.wikipedia.org/wiki/Help:WordToWiki
• LibreOffice: Works perhaps more reliable. Note that the command is under "File, export as", not "save as". Older versions create a text file, from which the text can be copied to a wikipage using the clipboard. Some newer methods also offer to directly save a file into a mediawiki (not yet tested, your additions to the help are welcome!).

Your topic here...

Please feel free to add new topics, or ask questions under new headings at the end.