Personal tools
Class Notes

Help:Editing

From Our Story

Revision as of 20:40, January 30, 2009 by Wsm (talk | contribs)

Return to the Help Desk

Edit a page

You must be a registered user and logged in to edit or create pages in Our Story.

Most of all, we want you to jump right in and start writing your stories and recollections of WSU! If you ever have any questions, please contact us.

To edit a page, click on the "Edit" link in the top right corner of a page, or on an individual section of a page. A page may be protected, meaning not everyone can edit that page.

If a page is not yet created, there will be a "Create" link at the top right of the page, or you can just start editing.

Most of the editing tools will be in the toolbar, which looks very similar to Microsoft Word or other word processors. One special button is labeled "Wikitext." Wikis, like Our Story or Wikipedia, use a special formatting "language." This help page describes many of the wiki formatting codes, but you don't need to learn wiki formatting language to add or edit stories.

When editing or creating a page, please note these requests:

  • Add a category or categories to your story. There is some guidance for selecting or making categories on this page: Help:Categories. This will help others navigate Our Story and link related stories.
  • Add plenty of links. Links will also help people build Our Story.


Formatting

When formatting a page, you can use the tools at the top of the edit box for most of your needs.

If you click on the "Wikitext" button, which will allow you to format your text using "wiki markup." This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in italic, you include it in two single quotes like see="See" the="the" table="table" below="below" for="for" common="common" wiki="wiki" formatting="formatting" our="Our" story="Story" ignores="ignores" normal="normal" line="line" to="To" start="start" a="a" new="new" leave="leave" an="an" empty="empty" you="You" can="can" also="also" with="with" html="HTML" tags="tags"><br> or <br/>.

Some HTML tags are allowed, for example <code>, <div>, <span> and <font>.

You can learn more about formatting in a wiki at: http://en.wikipedia.org/wiki/Wikipedia:WikiProject_User_Page_Help/Do-It-Yourself/Formatting_Text


Preview

It's a good idea to use the 'Show preview' button to see what your change will look like, before you save it. This is also related to tracking changes because every time you save, this is displayed to others as a separate change. This isn't something to worry about too much, but it's good to get into the habit of eliminating mistakes in your own work, by using a preview before saving, rather than saving several minor corrections afterwards.


Text formatting in a wiki

Description You type You get
applies anywhere
Italic text ''italic'' italic
Bold text '''bold''' bold
Bold and italic '''''bold & italic''''' bold & italic
Escape wiki markup <nowiki>no "markup"</nowiki> no ''markup''
Fixed width text

<tt>Fixed width text</tt>

Fixed width text

only at the beginning of the line
Indent text

:Single indent
::Double indent
:::::Multiple indent

Single indent
Double indent
Multiple indent
Headings of

different levels <ref>An article with four or more headings will automatically create a table of contents.</ref>

=level 1=<ref>Use of a level 1 heading is highly discouraged as it appears with the same formatting and size as the page title, which can be confusing.</ref>
==level 2==
===level 3===
====level 4====
=====level 5=====
======level 6======

Level 1

Level 2

Level 3
Level 4
Level 5
Level 6

Horizontal rule

----


Bullet list
  • one
    * two
    * three
    ** three point one
    ** three point two
  • one
  • two
  • three
    • three point one
    • three point two
Numbered list
  1. one
    # two<br />spanning several lines<br />without breaking the numbering
    # three
    ## three point one
    ## three point two
  1. one
  2. two
    spanning several lines
    without breaking the numbering
  3. three
    1. three point one
    2. three point two
Mixture of bulleted
and numbered lists
  1. one
    # two
    #* two point one
    #* two point two
  1. one
  2. two
    • two point one
    • two point two
Definition list
Definition
 
item 1
 :item 2
Definition
item 1
item 2
Preformatted text

  preformatted text is done with
  a space at the
  beginning of the line

preformatted text is done with
a space at the 
beginning of the line
Preformatted text with no indentation

 <pre> some preformatted text with no indentation </pre>

some preformatted
text with no indentation
Blockquotes

Body
text text text text text text text text text text text text text text text text text text text text text text text text

<blockquote> quote quote quote quote quote quote </blockquote>

text text text text text text text text text text text text

Body
text text text text text text text text text text text text text text text text text text text text text text text text

quote quote quote quote quote quote

text text text text text text text text text text text text

Comment

<!--This is comment-->

|}


How to link

To make a link, you can highlight the text to link and click on the "Link" button (a globe with a chain icon).

  • For an external link, paste or type in the full link. For example: http://www.google.com
  • For an internal link, paste or type just the page name. This can be a story title, or some other page. For example: "Notes of WSC 1940" or "Help:Editing" (without the quotes) would be the link.
  • For a Category link, type "Category:Category_name." For example: the link to type would be "Category:Apple Cup" (without the quotes).


Linking, the wiki formatting way

Description You type You get
Internal link [[Main Page]] Main_Page
Piped link [[Main Page|different text]] different text
External link http://mediawiki.org http://mediawiki.org
External link,

different title

[http://mediawiki.org MediaWiki] MediaWiki
External link,

numbered

[http://mediawiki.org] [1]
Anchor link [[#See also]] #See_also
Anchor link at another page [[Help:Images#See also]] Help:Images#See_also
Category link [[:Category:Help]] Category:Help
Internal link to image file [[media:example.jpg]] Media:Example.jpg
Internal link to pdf file [[media:example.pdf]] Media:Example.pdf
Interwiki link [[Wikipedia:MediaWiki]] wikipedia:MediaWiki
mailto link [mailto:info@example.org email me] email me
redirect #REDIRECT [[Main Page]] Main_Page
External link to video file (.avi, .mpg) [http://en.wikipedia.org/wiki/.avi .avi] .avi
External link to sound file (.mp3, .ogg, .wav) [http://en.wikipedia.org/wiki/.wav .wav] .wav
External link to a document (.doc, .pdf) [http://en.wikipedia.org/wiki/.doc .doc] .doc

By default, when you write a link (URL) as is, it will be transformed to an external link.

You can read more about links here: http://www.mediawiki.org/wiki/Help:Links

Images

Before you place an image on a page, you must first put the photo or image on Our Story, by uploading the file. "Upload file" is usually an option in the Toolbox in the right sidebar. (You can also upload more than one photo at a time, through the Multiple Upload page.)

You can use the "Image" button at the top of the edit box to place an image, or other file such as sound or video. In the image menu, you can search for your image, resize it, add a caption, and choose alignment on the page.

For example, if you want to put a photo of the 1939 Apple Cup on your page, you would click on your story where you want the photo. Then, click the "Image" button on your editing toolbar (looks like a square with a mountain on a yellow background, similar to Microsoft Word). Search for the photo by typing in the first few letters ("apple"). Some choices will appear. You can then write a caption, resize, or put a frame or border around your photo through the "Special Type" menu.

NOTE: If you want to resize your photo, choose "Thumb" or "Border" in the "Special Type" menu. If you choose "Frame," the photo will not be resized.

When editing a story, you can right-click your image to change "Image Properties."

If you would like to browse available images, you can go to these pages:

You can also find images of WSU at these websites:


Images, the wiki markup way

If you want to include an image by directly coding in the wiki language, the wiki formatting is: [[Image:{name}|{options}]] Where options can be zero or more of the following, separated by pipes:

  • thumb, thumbnail, frame, or frameless: Controls how the image is formatted
  • left, right, center, none: Controls the alignment of the image on the page
  • baseline, sub, super, top, text-top, middle, bottom, text-bottom: Controls the vertical alignment of the image on the page
  • {width}px: Resizes the image to the given width in pixels
  • Special cases:
    • page=1: Displays the specified page when showing a djvu file
  • link={destination}: Allows to link to an arbitrary title, URL or just nowhere (1.14+)
  • alt={alternative text}: For changing the alternative text (alt="") of an image (1.14+)

The options can be given in any order. If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting.

For more image formatting options and how to create a gallery of images on your page, visit: http://www.mediawiki.org/wiki/Help:Images


Tables

Tables may be authored in wiki pages using either HTML table elements directly, or using wikicode formatting to define the table. HTML table elements and their use are well described on various web pages and will not be discussed here. The benefit of wikicode is that the table is constructed of character symbols which tend to make it easier to perceive the table structure in the article editing view compared to HTML table elements.

As a general rule, it is best to avoid using a table unless you need one. Table markup often complicates page editing.

To learn more: http://www.mediawiki.org/wiki/Help:Tables

Our Story site map

Our Story main page | Our Story categories | Help Desk
Contact | Give | Advertise
Washington State Magazine | Washington State University | Class Notes

Our Story is coordinated by

In partnership with

Our Story and Washington State Magazine are publications of Washington State University. All rights reserved.
P.O. Box 641227, Washington State University, Pullman, WA 99164-1227 USA | wsm@wsu.edu, 509-335-2388
Accessibility | Copyright | Policies