Difference between revisions of "Help:Editing"

From MadaCamp
Jump to: navigation, search
(ewmsBKVSPZKKHvPRStc)
Line 1: Line 1:
__INDEX__
+
You got to push it—this essteinal info that is!
 
 
== 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. Alternatively, the syntax is simple. For '''bold text''', enclose the word(s) within three single quotes:
 
 
 
<nowiki>bold text</nowiki>
 
 
 
For ''italic text'', enclose the text with two single quotes:
 
 
 
<nowiki>italic text</nowiki>
 
 
 
To link a text to another page within the wiki, enclose the word in square double brackets:
 
 
 
<nowiki>[[</nowiki>[[Anakao]]<nowiki>]]</nowiki>
 
 
 
The link will thereafter point to [[Anakao|http://www.madacamp.com/Anakao]]
 
 
 
To link to a page on another website, enclose the link location within single square brackets and the linked word(s) after the URL:
 
 
 
<nowiki>[http://www.example.com example]</nowiki>
 
 
 
This will result in [http://www.example.com example]
 
 
 
Alternatively, type a full URL without the brackets, eg: ...
 
 
 
<nowiki>http://www.example.com</nowiki>
 
 
 
... to display the link as follows:
 
 
 
http://www.example.com
 
 
 
To make a listing, prefix the list items with asterixes: ...
 
 
 
<pre><nowiki>
 
* item 1
 
* item 2
 
* item 3
 
</nowiki></pre>
 
 
 
... which will appear as follows:
 
 
 
* item 1
 
* item 2
 
* item 3
 
 
 
Nested lists are done as follows: ...
 
 
 
<pre><nowiki>
 
* item 1
 
* item 2
 
** item 2.2
 
*** item 2.3
 
* item 3
 
</nowiki></pre>
 
 
 
... which will appear as:
 
 
 
* item 1
 
* item 2
 
** item 2.2
 
*** item 2.3
 
* item 3
 
 
 
etc.
 
 
 
<!--
 
Some HTML tags are permitted in wikitext. The vast of fancy formatting seen on wiki sites is acheived using these limited tags (e.g. tables with CSS styles). See [http://en.wikipedia.org/wiki/Help:HTML_in_wikitext HTML tags in wikitext]
 
-->
 
 
 
== Image links ==
 
 
 
To make an image link to a page instead of leading to the larger version of the same image which is clicked on, add the link parameter to the image markup, eg.:
 
 
 
[[Image:Big_fish.jpg|100px|link=Big_fish]]
 
 
 
<pre>[[Image:Big_fish.jpg|100px|link=Big_fish]]</pre>
 
 
 
 
 
== Displaying an email address  ==
 
 
 
The following code:
 
 
 
<nowiki>[mailto:hello@madacamp.com hello@madacamp.com]</nowiki>
 
 
 
... will display as:
 
 
 
[mailto:hello@madacamp.com hello@madacamp.com]
 
 
 
== Skype button ==
 
 
 
To display a Skype button that will launch Skype and call or start a chat to a specified Skype address as well as indicate its online or offline status, first configure your Skype application to allow its status be shown online (if it has not already been configured as such). This is done within the Skype application section <b>Tools->Options->Privacy</b>. Tick the checkbox ''Allow my status to be shown on the web'':
 
 
 
<!--[[File:Skype_configuration.jpg]]-->
 
 
 
The following example will create a button for which a call can be made when clicked on:
 
 
 
<pre><nowiki><skype style="bigclassic" action="call">YourSkypeName</skype></nowiki></pre>
 
 
 
<skype style="bigclassic" action="call">madacamp</skype>
 
 
 
The available styles are: balloon, bigclassic, smallclassic, smallicon, mediumicon
 
 
 
See examples at http://www.skype.com/intl/en/share/buttons/status.html
 
 
 
The available actions are: add, chat or call
 
 
 
== '''Google maps''' ==
 
 
 
To create new or edit existing Google maps on pages, click on the map button http://www.madacamp.com/extensions/GoogleMaps/images/button_map_open.gif above the edit box.
 
 
 
Find the region to display, set the various size and display options and thereafter copy the resulting &lt;googlemap>...&lt;googlemap> 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:'' -->
 
<!-- broken URLs:
 
* [http://emiller.info/mov/map1.mov 3 minute instructions video] in Quicktime format (part 1).
 
* [http://emiller.info/mov/map-path1.mov 3.5 minute instruction video] in Quicktime format (part 2).
 
-->
 
<!-- too technical: * [http://www.mediawiki.org/wiki/Extension:Google_Maps/Syntax Google Maps Extension syntax] documentation. -->
 
 
 
== Adding RSS news feeds to pages ==
 
 
 
RSS means Really 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 http://news.google.com] for any given keyword or phrase. Thereafter scroll to the bottom of the page and find the RSS symbol [[File:RSS_icon.png|14px]]. Follow the link to the URL of the raw RSS feed.
 
 
 
The web browser may automatically display the news items of the raw RSS feed in a tidy HTML format as well as offer to add the newsfeed to a browser's [http://www.mozilla.com/en-US/firefox/livebookmarks.html Live Bookmarks] and various social bookmarking applications, such as Google Reader, My Yahoo, Bloglines etc. Alternatively, the browser may display the raw RSS feed in XML source code. Either way, copy the location of the page (URL) and place it within the &lt;rss>...&lt;/rss> tags, like the following example:
 
 
 
<pre><rss>http://news.google.com/news?pz=1&cf=all&ned=us&hl=en&q=%22madagascar+lemurs%22&cf=all&output=rss|short|date|max=20</rss></pre>
 
 
 
The output of this, which is a news search for the phrase ''madagascar lemurs'', becomes:
 
 
 
<rss>http://news.google.com/news?pz=1&cf=all&ned=us&hl=en&q=%22madagascar+lemurs%22&cf=all&output=rss|short|date|max=20</rss>
 
 
 
'''Note:''' Not only [http://news.google.com Google News] offer RSS feeds but many major as well as niche portals do. Wherever you see the familiar RSS button, it should be for a compatible news feed that can be displayed on any page as described above. For additional usage and customisation of the output of news items on a page, see: http://www.mediawiki.org/wiki/Extension:RSS#Usage
 
 
 
== Images ==
 
 
 
[[Image:Nahampoana_Main_Building.jpg|left|70px|]] Align an image to the left of the text...
 
 
 
<br clear="all">
 
 
 
<pre><nowiki>[[Image:Nahampoana_Main_Building.jpg|left|70px|]]  Align an image to the left of the text...
 
 
 
<br clear="all"></nowiki></pre>
 
 
 
For further info on image display, visit http://en.wikipedia.org/wiki/Image_markup
 
 
 
== Image gallery ==
 
 
 
To display a collection of images without captions in a standard size that wlll work well in conjuction with a Google map display on the same page and in the the size of 600 pixels width, copy the following wiki-markup and replace the image names with the images to be dislayed. This example will display one large image on top, spanning three colums with two rows of images below it:
 
 
 
<pre><nowiki>{| class="imageTable"
 
|-
 
|colspan="3" | [[File:Photo 001.jpg|600px]]
 
|-
 
|[[File:Photo 002.jpg|196px]]
 
|align="center"|[[File:Photo 003.jpg|196px]]
 
|align="right"|[[File:Photo 004.jpg|196px]]
 
|-
 
|[[File:Photo 005.jpg|196px]]
 
|align="center"|[[File:Photo 006.jpg|196px]]
 
|align="right"|[[File:Photo 007.jpg|196px]]
 
|}</nowiki></pre>
 
 
 
Just add or remove rows as required. Example, as on the [[Tulear]] page:
 
 
 
{| class="imageTable"
 
|-
 
|colspan="3" | [[File:Tulear 016.jpg|600px]]
 
|-
 
|[[File:Tulear 010.jpg|196px]]
 
|align="center"|[[File:Tulear 005.jpg|196px]]
 
|align="right"|[[File:Tulear 006.jpg|196px]]
 
|-
 
|[[File:Tulear 012.jpg|196px]]
 
|align="center"|[[File:Tulear 008.jpg|196px]]
 
|align="right"|[[File:Tulear 018.jpg|196px]]
 
|}
 
 
 
== Thumbnail gallery ==
 
 
 
Using <nowiki><gallery> ... </gallery></nowiki> tags to display a thumbnail gallery with images which link to the larger versions of the uploaded images. This is useful for creating quick and easy thumbnail galleries with many images.
 
 
 
Images can also be individually captioned and wiki-markup can be used within captions.
 
 
 
<gallery>
 
Image:Ilakaka 001.jpg
 
Image:Ilakaka 002.jpg
 
Image:Ilakaka 003.jpg
 
Image:Ilakaka 004.jpg|[[Help:Contents/Links|Links]] can be put in captions.
 
Image:Ilakaka 005.jpg
 
Image:Ilakaka 006.jpg|Full [[MediaWiki]]<br />[[syntax]] may now be used...
 
</gallery>
 
 
 
 
 
The code example of the above gallery is shown below:
 
 
 
<pre><nowiki>
 
<gallery>
 
Image:Ilakaka 001.jpg
 
Image:Ilakaka 002.jpg
 
Image:Ilakaka 003.jpg
 
Image:Ilakaka 004.jpg|[[Help:Contents/Links|Links]] can be put in captions.
 
Image:Ilakaka 005.jpg
 
Image:Ilakaka 006.jpg|Full [[MediaWiki]]<br />[[syntax]] may now be used...
 
</gallery>
 
</nowiki></pre>
 
 
 
== Wide images ==
 
 
 
To display an image that is generally wider than most screens in a sideways scrollable box, typically a panorama, the syntax is:
 
 
 
:<nowiki>{{</nowiki>Wide image|''name''|''image width''|''caption''|''box width''|''alignment''<nowiki>}}</nowiki>
 
 
 
<b>Examples:</b>
 
 
 
The below example is done by the following code:
 
 
 
<pre><nowiki>{{wide image|Bezavona_pano2.jpg|1800px|Fort Dauphin panorama}}</nowiki></pre>
 
 
 
{{wide image|Bezavona_pano2.jpg|1800px|Fort Dauphin panorama}}
 
 
 
To display the same image but without a caption, simply omit the caption:
 
 
 
<pre><nowiki>{{wide image|Bezavona_pano2.jpg|1800px}}</nowiki></pre>
 
 
 
To right-align the image while taking up 45% of the paragraph width:
 
 
 
<pre><nowiki>{{wide image|Bezavona_pano2.jpg|1800px|Fort Dauphin panorama|45%|right}}</nowiki></pre>
 
 
 
Or define a fixed width for the scrollbox, eg. 250 pixels:
 
 
 
<pre><nowiki>{{wide image|Bezavona_pano2.jpg|1800px|Fort Dauphin panorama|250px|right}}</nowiki></pre>
 
 
 
== Random image display ==
 
 
 
'''A random image can be displayed along with various optional parameters, such as size, left or right aligned and a pre-defined array of named images to limit the selection from.'''
 
 
 
<randomimage float="left" />
 
 
 
This code can be used to display a random image from the complete repository of images on the site:<br>
 
 
 
<span style="background:#f6f6f6;"><nowiki><randomimage float="left" /></nowiki></span><br>
 
 
 
An caption will automatically be pulled from the image descripion page if one exists or if added when the image was originally uploaded on the site.
 
<br clear="all">
 
 
 
<randomimage float="left">Random image</randomimage>
 
 
 
This example code can be used to display a random image with a pre-defined caption, eg. 'A random image', for all images:<br>
 
<span style="background:#f6f6f6;"><nowiki><randomimage float="left">A random image</randomimage></nowiki></span>
 
<br clear="all">
 
 
 
The <nowiki><randomimage></nowiki> tag supports the following attributes:
 
* size - set the image width (default is the user's thumbnail width).
 
* float - float the image; valid values are 'left', 'center' and 'right'.
 
* choices - limits the image selection to a list of images separated by a vertical bar. For example:
 
 
 
<randomimage size="150" float="left" choices="Chocolaterie_Robert_024.jpg|Chocolaterie_Colbert_01.jpg|Cinagra_066.jpg" />
 
 
 
This example is a 150 pixels width image, aligned to the left and with a pre-defined array of named images to choose from:<br>
 
<span style="background:#f6f6f6;"><nowiki><randomimage size="150" float="left" choices="Chocolaterie_Robert_024.jpg|Chocolaterie_Colbert_01.jpg|Cinagra_066.jpg" /></nowiki></span>
 
 
 
<br clear="all">
 
 
 
== Table of Contents ==
 
 
 
The table of contents (TOC) is automatically shown at the top of a page if there are four or more headings in an article. To hide this on a page, add the string <nowiki>__NOTOC__</nowiki> anywhere in the page markup.
 
 
 
<!--
 
== CSS ==
 
 
 
Modify styles in http://www.madacamp.com/MediaWiki:Monobook.css
 
-->
 
 
 
== Displaying YouTube videos ==
 
 
 
To display a video from YouTube on this site, extract and copy the relevant video ID that is part of a YouTube URL, e.g.
 
[http://www.youtube.com/watch?v=_OKs7qpJvRI&feature=related http://www.youtube.com/watch?v=<font color="#bd0000">_OKs7qpJvRI</font>&feature=related] and paste it into the edit form as follows:
 
 
 
<pre><nowiki><youtube>_OKs7qpJvRI</youtube></nowiki></pre>
 
 
 
<youtube>_OKs7qpJvRI</youtube>
 
 
 
<!-- Google officiall stops hosting videos in May 2011:
 
To add a Google video on a page retrieve the ID by clicking the '''Embed video''' link next to the video screen or extract the ID from the URL if one is part of it. For example:
 
[http://video.google.com/videoplay?docid=7281432690466273651&hl=en http://video.google.com/videoplay?docid=<font color="#ff0000">7281432690466273651</font>&hl=en]
 
 
 
Then simply place the ID in the following googlevideo tag:
 
<pre><nowiki><googlevideo>7281432690466273651</googlevideo></nowiki></pre>
 
 
 
<googlevideo>7281432690466273651</googlevideo>
 
-->
 
 
 
== Editing and publishing videos ==
 
 
 
While YouTube offers an easy conversion process from any original video file format into website compatible Flash video (FLV) format by simply uploading your video onto a YouTube account, YouTube will display links to other user's YouTube hosted videos at the end of your video, often in combination with Google syndicated advertising. To prevent this mostly irrelevant information from being displayed along with your video, you can upload your video directly on MadaCamp, after first having converted it into FLV format. If your video has been shot with a digital camera, it is likely an Mpeg, AVI, Quicktime or some other format. The conversion into FLV format can be done using an advanced video editor such as [http://en.wikipedia.org/wiki/Avidemux Avidemux], which is available for free download on all operating systems:
 
 
 
[[File:Avidemux.jpg|600px]]
 
 
 
Within Avidemux, open the video file, select FLV format via the ''Video'', ''Audio'' and ''Format'' selectors. Optionally add filters. Give the file an '''.flv''' extension and ''Save Video''. Thereafter upload the FLV file onto this site and simply add it on a page, as follows:
 
 
 
<nowiki>[[File:Video.flv]]</nowiki>
 
 
 
The size and aspect ratio can be tweaked like a normal on-page image by defining the pixel display values, as follows:
 
 
 
<nowiki>[[File:Video.flv|300x375px]]</nowiki>
 
 
 
Alternatively, [http://ffmpeg.org FFmpeg] is an excellent and free video editing tool, but requires command line editing, which is mainly done on Linux and OSX systems.
 
 
 
For Windows users, a nice and simple FLV conversion tool is [http://www.miksoft.net/mobileMediaConverter.htm Mobile Media Converter]. While Mobile Media Converter lack various advanced editing features that exists in Avidemux, if all you need is to simply convert a video into FLV format without fancy editing, Mobile Media Converter is a perfectly good tool for the purpose. Various pre-configured size, bandwidth and quality level options are available in the conversion process.
 
 
 
<table cellpadding="0" cellpadding="0" border="0" style="border:1px solid #cccccc; float:left; margin-right:10px; width:328px;"><tr>
 
<td style="padding:3px 3px 3px 3px;">
 
[[File:Chocolaterie_Robert_320x240_low.flv|320x240px]]
 
</td></tr></table>
 
 
 
Click the screen on the left to see an example of a video that has been converted from a Quicktime (.mov) file into FLV format using ''Mobile Media Converter'' and thereafter uploaded and displayed here via the following code:<br>
 
 
 
<div style="border:1px dashed #296dad; background: #fffbff; padding:10px; display:table;margin-bottom:8px;">
 
<nowiki>[[File:Chocolaterie_Robert_320x240_low.flv|320x240px]]</nowiki>
 
</div>
 
 
 
''The video is 13 minutes and features [[Chocolaterie Robert]]'s bean-to-bar chocolate production in Madagascar, in French language.''
 
 
 
<br clear="all">
 
 
 
For tips a tricks on editing video in Windows or Mac OSX or using various cloud based (online) tools, watch BBC's [http://news.bbc.co.uk/2/hi/programmes/click_online/9484842.stm The essential guide to video editing] webcast from 13 May 2011.
 
 
 
== Adding language switches ==
 
 
 
To add language switches for French and Malagasy versions to appear in the left column of any content page is simple. For example, the following code was added in the edit box of the page [[Lemur|http://madacamp.com/Lemur]]:
 
<nowiki>[[fr:Lémurien]]</nowiki>
 
<nowiki>[[mg:Maki]]</nowiki>
 
 
 
The Français and Malagasy link therefore appears on the English version of the page, which lead to [http://fr.madacamp.com/Lémurien http://fr.madacamp.com/Lémurien] and [http://mg.madacamp.com/Maki http://mg.madacamp.com/Maki] respectively
 
(note: Maki means lemur in Malagasy).
 
 
 
[[File:Language switch example.gif]]
 
 
 
On the French page, adding links to the English and Malagasy versions is done by:
 
<nowiki>[[en:Lemur]]</nowiki>
 
<nowiki>[[mg:Maki]]</nowiki>
 
 
 
And on the Malagasy page, add the links to the English and French pages by:
 
<nowiki>[[en:Lemur]]</nowiki>
 
<nowiki>[[fr:Maki]]</nowiki>
 
 
 
If a page title contains two or more words, the words are separated by underscores or spaces, for example:
 
 
 
<table width="100%" border="0" cellpadding="0" cellspacing="0"><tr>
 
<td style="border:1px dashed #296dad; background: #fffbff; padding:10px;width:48%;">
 
<nowiki>[[fr:Grande_Île]]</nowiki><br>
 
<nowiki>[[en:Big_island]]</nowiki><br>
 
<nowiki>[[mg:Nosy_be]]</nowiki>
 
</td><td align="center" style="width:4%;">or</td>
 
<td style="border:1px dashed #296dad; background: #fffbff; padding:10px;width:48%;">
 
<nowiki>[[fr:Grande Île]]</nowiki><br>
 
<nowiki>[[en:Big island]]</nowiki><br>
 
<nowiki>[[mg:Nosy be]]</nowiki>
 
</td></tr></table>
 
 
 
The language swith codes can be added anywhere in the editing box, for example at the end.
 
 
 
== Article comments ==
 
 
 
To add a blog style comments field below an article, such as this one: ...
 
 
 
<comments hideForm="false" />
 
 
 
... insert the following at the end of the article:
 
 
 
<pre><nowiki><comments hideForm="false" /></nowiki></pre>
 
 
 
The comments are added to the discussion section of each page.
 
 
 
== Further manuals ==
 
 
 
* [http://meta.wikimedia.org/wiki/Help:Contents User's Guide]
 
* [http://en.wikipedia.org/wiki/Help:HTML_in_wikitext HTML tags in wikitext]
 
* [http://www.mediawiki.org/wiki/Manual:Configuration_settings Configuration settings list]
 
* [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
 
* [http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
 
* [http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax Displaying images]
 
* [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page How to edit a page]
 
* [http://en.wikipedia.org/w/index.php?title=Help:Table Wikitable syntax]
 
* http://www.mediawiki.org/wiki/Special:AllPages/Manual:
 
* http://meta.wikimedia.org/wiki/Help:Template
 
* http://www.mediawiki.org/wiki/Template
 
* http://www.mediawiki.org/wiki/Special:AllPages/Extension:
 
* http://meta.wikimedia.org/wiki/Layout_customization
 
* http://meta.wikimedia.org/wiki/MediaWiki_FAQ
 

Revision as of 05:56, 16 July 2011

You got to push it—this essteinal info that is!