Editing Quickstart Guide

From eLinux.org
Revision as of 11:58, 5 December 2006 by Tim Bird (talk | contribs) (Basic formatting)
Jump to: navigation, search

This page exists to get new wiki contributors up and running quickly. There are three main things you need to know in order to start adding useful content to a page:

  1. basic formating, including sections
  2. adding links to other pages and external web sites
  3. uploading files

For more advanced topics, like creating tables

Basic formatting

Here are some very basic MediaWiki formatting helps:

markup example result
double or triple quote ''italic'' '''bold''' italic bold
leading spaces
words
 spaced
  exactly
words
 spaced
  exactly
leading '*' or '#'
*
**
#
##
bullets or numbered lists.
  • item 1
    • sub-item
  1. number 1
    1. number 1.1

Number of leading symbols indicates indent level in list.

special tags <nowiki>text</nowiki> don't process markup for text
leading and trailing '=' == Section heading == See section headings on this page. Number of '=' signs indicates section level. You should use 2 or more '='.

Adding Links

To make a word or phrase into an internal link, use two square brackets around the word(s). Use a pipe if you wish to show different cover text for the link.

To link to external material, just put the URL in the page source. To use different cover text, put a space between the URL and the covert text, and enclose in single brackets.

Here are some examples:

markup result
[[one or more words]] one or more words
[[one or more words|alt text]] alt text
http://www.google.com/ http://www.google.com/
[http://www.google.com/ Google] Google

Uploading files

To upload a file, click on the "Upload file" link in the toolbox in the left sidebar. Then enter the filename to upload and click submit.

Files uploaded can be presented in 3 ways to the user:

  1. an image can be inlined on the page.
  2. a page describing the file can be displayed
  3. a link can be provided to directly download the file to a client's computer

To inline an image, use the syntax: [[Image:filename.jpg]] If the image is clicked on, then the description page will be shown. To present a direct-download link, use the syntax: [[Media:filename.ext]]

For files with a well-known type, use a template to show an icon for the file type. Here is an example using the PDF template: {{pdf|media:pdf-filename.pdf|alternate text}}