Help:Editing

From NoodleSoup
Jump to: navigation, search

Creating new pages

There are various ways to create new pages: One is to search for the title and if the page name does not exist click on the create this page link. Another way is to create a wiki link from an already existing page to a page title that does not yet exist and thereafter follow the link to create the new page (links to pages that do not yet exist appear in red). Another method is to type the URL of a page that does not already exist and click on the create tab, for example:

http://www.noodlesouop.asia/A_New_Page_Title

The underscores in the page name denotes spaces and the page name becomes the heading on the page, so the above URL would create a page with the heading A New Page Title.

Deleting, renaming or moving pages

If you create a page and would like to change the page title, either delete it and recreate a new page with the new title, or if the page has existed for a while and has links pointing to it, you can change its location via the move tab. Users visiting the old location will automatically be redirected to the new.

Deleting or moving (renaming) pages can only be done while signed in.

Uploading images

Uploading images can only be done while signed in. An Upload file link will appear in the toolbox menu on the left when signed in. Not only images can be uploaded but a wide range of file formats.

Wiki text editing

The most basic text editing features, such as boldface, italics and links can be formatted with help of the buttons above the edit box.

Editing buttons.gif

Alternatively, the syntax is simple. For bold text, enclose the word(s) within three single quotes:

'''bold text'''

For italic, enclose the text with two single quotes:

''italic text''

Link to pages within this wiki

To link a text to another page within the wiki, enclose the word or phrase in square double brackets:

[[Rice noodles]]

Underscores to denote spaces_between_words in wiki links are optional, so the same link target can also appear as:

[[Rice_noodles]]

Either syntax will lead to http://www.noodlesoup.asia/Rice_Noodles

Link to pages in another language

Linking to articles on the Vietnamese wiki for example, is done by enclosing the full URL, a space, and the linked words in a single set of square brackets:

[http://vi.noodlesoup.asia/Pho_Bo A link to Pho Bo on the Vietnamese wiki]

The link will appear as follows:

A link to Pho Bo on the Vietnamese wiki

The same applies to links to external websites.

Link to external websites

Linking to external websites is done by enclosing the full URL, a space, and the linked words in a single set of square brackets:

[http://www.example.com example link]

This will result in example link

Alternatively, type out the full URL without the square brackets:

http://www.example.com

The link will then appear as follows:

http://www.example.com

Placing an asterix before will make the link appear as a list item:

* http://www.example.com

See more on lists below.

Lists

To make a list, prefix the list items with asterixes:

 * item 1 
 * item 2
 * item 3

The list will appear as follows:

  • item 1
  • item 2
  • item 3

Nested lists can be made by:

* item 1 
* item 2
** item 2.2
*** item 2.3
* item 3

To appear as:

  • item 1
  • item 2
    • item 2.2
      • item 2.3
  • item 3

etc.

Some HTML tags are permitted in wikitext. The majority of fancy formatting seen on wiki sites is done using these tags combined with CSS styles. Further information at: http://en.wikipedia.org/wiki/Help:HTML_in_wikitext

Images

Displaying images that have been uploaded on the wiki is done by the [[File:Pho.jpg]] or [[Image:Pho.jpg]] tag. By default the image appears in original size as it was uploaded, unless a pixel width is added after a vertical bar in the code to display the image in the right size, as follows:

[[File:Pho.jpg|250px]]
A tasty pho soup

To align the image on the left of the page with a text paragraph floating along the right of the image, add the left attrubute as follows:

[[File:Pho.jpg|250px|left|thumb|A tasty pho soup]]

Depending on the length of the paragraph and size of the image it may be necessary to prevent the next paragraph or section to flow around the image by adding the following html tag after the paragraph:

<br clear="all">


A tasty pho soup

Unless the left attribute is is specified the image will automatically float to the right:

Images that that do not have captions, omit the thumb keyword and the caption. Images without captions do not float to the right by default.


[[Image:Pho.jpg|150px|thumb|A tasty pho soup]]

For further info on image display, see:

Wide images

To display an image that may be wider than typical screens in a sideways scrollable box, the syntax is:

{{Wide image|name|image width|caption|box width|alignment}}

Examples:

The below example is produced by the following code:

{{wide image|Thien Vien Van Hanh 01.jpg|1200px|View of [[Da Lat]] from [[Thien Vien Van Hanh]] pagoda}}
#default=View of Da Lat from Thien Vien Van Hanh pagoda}}
{{ #if: View of Da Lat from Thien Vien Van Hanh pagoda|
View of Da Lat from Thien Vien Van Hanh pagoda
|}}

To display the same image but without a caption, simply omit the caption:

{{wide image|Thien Vien Van Hanh 01.jpg|1200px}}

To right-align the image while taking up 45% of the paragraph width:

{{wide image|Thien Vien Van Hanh 01.jpg|1200px|View of [[Da Lat]] from [[Thien Vien Van Hanh]] pagoda|45%|right}}

Or define a fixed width for the scrollbox, eg. 250 pixels:

{{wide image|Thien Vien Van Hanh 01.jpg|1200px|View of [[Da Lat]] from [[Thien Vien Van Hanh]]|250px|right}}

Image galleries

Use the <gallery> ... </gallery> tags to display a thumbnail gallery which links to the larger versions of the images. Images can be individually captioned and wiki mark-up or html code can be used within captions.

 <gallery>
 Image:Example01.jpg
 Image:Example02.jpg
 Image:Example03.jpg
 Image:Example04.jpg|Images can have captions
 Image:Example05.jpg
 Image:Example06.jpg|Standard [[Pho Bo|wiki]] syntax may be used
 </gallery>
 

Image links

Example.jpg

By default, when adding an image on a page, the image links to a larger version. To make the image link to a wiki page instead, add the link= parameter to the image code, as follows:

[[Image:Example.jpg|100px|link=Example_Page]]

Or link to an external URL:

[[Image:Example.jpg|100px|link=http://www.example.com]]

Email address link

Display an email address link by prefixing the address with the mailto: tag and place in a standard external link bracket as follows:

[mailto:hello@example.com hello@example.com]

The email link will appear as:

hello@example.com


Scaling images

There is no restriction on image sizes that can be uploaded except for that a single uploaded file can not exceed 30 MB. The uploaded original should either be larger than displayed on the actual page or the same size. In other words, images can be scaled down, not up (at least not with good quality result). Uploading images about 1000 pixels in width is usually a good size that will cover all likely display scenarios.


Section headings

Section headings are created with the following syntax:

== Heading ==

Or bold headings as they appear throughout this page:

== '''Heading''' ==

Table of Contents

The table of contents (TOC) box at the top of the page is automatically generated when there are four or more section headings on a page.

To prevent the TOC appearing on a page, add the following string anywhere in the wiki text:

__NOTOC__


Language switch

To make the Tiếng Việt language link appear in the left menu leading to a Vietnamese version of a page, add the following string anywhere in the wiki text:

[[vi:Page_name]]

To make the English link appear on the Vietnamese language wiki leading to an English version of a page, add the following string anywhere in the wiki text:

[[en:Page Name]]

Skype button

To display a button that launches Skype and calls or starts a chat, configure your Skype account to allow its status to be shown online in Tools->Options->Privacy within your Skype application. Tick the checkbox Allow my status to be shown on the web:

The following example will create a button from which a call can be made to a defined address when clicked on:

<skype style="bigclassic" action="call">ExampleSkypeName</skype>

<skype style="bigclassic" action="call">noodlesoup.asia</skype>

The available styles are: balloon, bigclassic, smallclassic, smallicon, mediumicon

The available actions are: add, chat or call

Further information at: http://www.skype.com/intl/en/share/buttons/status.html

Google Maps

To create new or edit existing Google maps on pages, click on the map button button_map_open.gif above the edit box.

Find the region to display, set the various size and display options and thereafter copy the generated Google map code into the edit box and save the page.

Various display options include satellite view, map view, adding of place markers, drawing lines etc.

Additional information:

RSS feed

For those who don't already know, RSS means Real Simple Syndication. It's a standard code format for feeding various news reader applications (including web browsers) with news summaries and corresponding links to articles. For example, do a Google news search at http://news.google.com for any given keyword or phrase. Thereafter scroll down to the bottom of the page to find the RSS link by the RSS symbol RSS icon.png. Follow this link to the URL of the raw RSS feed. The web browser may automatically display the news items in a tidy HTML format as well as offer to add the newsfeed to your browser's Live Bookmarks as well as various social bookmarking applications (Google Reader, My Yahoo, Bloglines etc.). Alternatively, the browser may display the raw RSS feed in XML formatted code. Either way, just copy the web location (URL) and place it within the <rss>...</rss> tags, like the following example:

<rss>http://news.google.com/news?um=1&cf=all&ned=us&hl=en&q=%22noodle+soup%22&cf=all&output=rss|short|date|max=20</rss>

The output of the above example, which is a search for the phrase noodle soup, becomes:

<rss>http://news.google.com/news?um=1&cf=all&ned=us&hl=en&q=%22noodle+soup%22&cf=all&output=rss%7Cshort%7Cdate%7Cmax=20</rss>

Note: Not only Google News offer RSS feeds but many major as well as niche portals do; wherever you come across an RSS feed button, it should be compatible. For additional usage and customisation of the output on a wiki, see: http://www.mediawiki.org/wiki/Extension:RSS#Usage

YouTube videos

To embed a YouTube video, simply copy the video ID from a YouTube URL, e.g.

http://www.youtube.com/watch?v=imdVKGm-RKU and paste into a youtube tag in the edit box as follows:

<youtube>imdVKGm-RKU</youtube>

<youtube>imdVKGm-RKU</youtube>

Google videos

To add a Google video on a page, retrieve the ID from the code by clicking the Embed video link next to or below the video screen, or extract the ID (docid string) from the URL if the correct one is part of it. For example:

http://video.google.com/videoplay?docid=-36756061916238161&ei=uDoYS-GgHYe62wKFiPXfDg&

Place the ID in the following googlevideo tag:

<googlevideo>-36756061916238161</googlevideo>

<googlevideo>-36756061916238161</googlevideo>

Sandbox

The Sandbox is a page for testing and experimentation with wiki syntax. It is located at http://www.noodlesoup.asia/Help:Sandbox.