Difference between revisions of "Editing Quickstart Guide"

From eLinux.org
Jump to: navigation, search
(Basic formatting)
(Basic formatting)
Line 18: Line 18:
 
|-
 
|-
 
|preceding spaces
 
|preceding spaces
|<nowiki>
+
|
  words
+
words
  run
+
  run
    on
+
  on
</nowiki>
 
 
|preformat
 
|preformat
 
  words
 
  words
Line 29: Line 28:
 
|-
 
|-
 
|leading '*' or '#'
 
|leading '*' or '#'
|bullets or numbered lists
+
|
 +
*
 +
**
 +
#
 +
##
 +
|bullets or numbered lists:
 
* item 1
 
* item 1
 
** sub-item
 
** sub-item
* item 2
 
 
# number 1
 
# number 1
 
## number 1.1
 
## number 1.1
# number 2
 
 
|-
 
|-
|special tags||<nowiki><nowiki>text</nowiki></nowiki>||''don't process markup for'' text
+
|special tags||<nowiki><nowiki>text</nowiki></nowiki>
 +
|''don't process markup for'' text
 
|-
 
|-
 
|leading and trailing '='||<nowiki>== Section heading ==</nowiki>||''See section headings on this page''.  Number of '=' signs indicates section level.  You should use 2 or more '='.
 
|leading and trailing '='||<nowiki>== Section heading ==</nowiki>||''See section headings on this page''.  Number of '=' signs indicates section level.  You should use 2 or more '='.

Revision as of 12:55, 5 December 2006

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
preceding spaces
words
 run
  on
preformat
words
 run
  on
leading '*' or '#'
*
**
#
##
bullets or numbered lists:
  • item 1
    • sub-item
  1. number 1
    1. number 1.1
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}}