Difference between revisions of "Help:Editing"

Latest revision as of 00:05, April 23, 2010

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, you can click "Write a story" in the menu to the left to get started.

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 ''this''. See the table below for common wiki formatting. To make extra lines, just enter them or use the HTML tag <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	one # two<br />spanning several lines<br />without breaking the numbering # three ## three point one ## three point two	one two spanning several lines without breaking the numbering three three point one three point two
Mixture of bulleted and numbered lists	one # two #* two point one #* two point two	one 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.

Go to this page for more help on images and how to include a gallery of images on your page.

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

@@ Line 9: / Line 9: @@
 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.<br>
-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.
+If a page is not yet created, you can click "Write a story" in the menu to the left to get started.
-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.
+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:
@@ Line 288: / Line 290: @@
 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 [[:Image:Apple Cup 1939 KenWise.jpg|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.
+[[Help:Images|'''Go to this page for more help on images and how to include a gallery of images on your page.''']]
-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:
-*[[Special:Newimages|Gallery of new images]] - If you just uploaded one, you will see it here.
-*[[Special:Imagelist|All images]] - Shows all of the image files uploaded to Our Story.
-You can also find images of WSU at these websites:
-*[http://www.wsulibs.wsu.edu/holland/masc/masc.htm WSU Libraries, Manuscripts, Archives, and Special Collections] - A partner in the development of Our Story.
-*[http://photos.wsu.edu/ WSU Photos Online]
-<br>
-'''Images, the wiki markup way'''
-If you want to include an image by directly coding in the wiki language, the wiki formatting is: <code><nowiki>[[Image:{name}|{options}]]</nowiki></code> Where options can be zero or more of the following, separated by pipes:
-*<code>thumb</code>, <code>thumbnail</code>, <code>frame</code>, or <code>frameless</code>: Controls how the image is formatted
-*<code>left</code>, <code>right</code>, <code>center</code>, <code>none</code>: Controls the alignment of the image on the page
-*<code>baseline</code>, <code>sub</code>, <code>super</code>, <code>top</code>, <code>text-top</code>, <code>middle</code>, <code>bottom</code>, <code>text-bottom</code>: Controls the vertical alignment of the image on the page
-*<code>{width}px</code>: Resizes the image to the given width in pixels
-*Special cases:
-**<code>page=1</code>: Displays the specified page when showing a djvu file
-*<code>link={destination}</code>: Allows to link to an arbitrary title, URL or just nowhere ([[Rev:41727|1.14+]])
-*<code>alt={alternative text}</code>: For changing the alternative text (<code>alt=""</code>) of an image ([[Rev:41837|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
 <br>

Personal tools

Navigation

Help

Tools

Class Notes

Our Story

Views