(→‎Avoid huge image files: added link to mac resize photo instructions)
(Replacing page with '{{TOCright}} ''You can also see the Appropedia help for more.'' '''Editing a wiki is easy!''' Just type it in like an email. If you want to do mo...')
Line 2: Line 2:
''You can also see the [[:Category:Appropedia help|Appropedia help]] for more.''
''You can also see the [[:Category:Appropedia help|Appropedia help]] for more.''


'''Editing a wiki is easy!''' Just type it in like an email. If you want to do more, then read the page below for info on formatting. And you can always [http://www.appropedia.org/index.php?title=Appropedia_talk:Village_pump&action=edit&section=new drop us a line] and we'll format it for you.
'''Editing a wiki is easy!''' Just type it in like an email. If you want to do more, then read the page below for info on formatting. And you can always [http://www.appropedia.org/index.php?title=Appropedia_talk:Village_pump
 
==Creating a new page==
{{main|Help:Creating a page}}
There are two main ways to create a page:
#Perform a search for the new title with the Go button. When the search finds nothing, click on the red link "create this page".
#If you're edting a page and want to link to a new page, create the link as usual, then save the page. Clicking on the redlink allows you to start editing the new page (don't forget to save).
 
===Naming conventions===
:{{main|Help:Page naming}}
The name is case-sensitive, except for the first letter, which is automatically made upper-case. Don't capitalize all words, except for proper names, e.g. we use '''Appropriate technology''', not '''Appropriate Technology'''. 
 
For guidelines on naming projects and other types of pages, see [[Help:Page naming]].
 
==Formatting==
You can 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 <tt><nowiki>''this''</nowiki></tt>
 
===Paragraphs===
 
Appropedia ignores normal line breaks. To start a new paragraph, leave an empty line. You can also start a newline with the HTML tag <tt><nowiki><br></nowiki></tt>. 
 
===Formatting Marks===
<div style="float:left">
{| {{Prettytable}}
|-
|{{Hl3}} align="center"|'''Description'''
|{{Hl3}} align="center"|'''You type'''
|{{Hl3}} align="center"|'''You get'''
|-
| colspan="3" align="center" | ''applies anywhere''
|-
|Italify text
|<tt><nowiki>''italic''</nowiki></tt>
|''italic''
|-
| Bold text
|<tt><nowiki>'''bold'''</nowiki></tt>
|'''bold'''
|-
| Bold and italic
|<tt><nowiki>'''''bold & italic'''''</nowiki></tt>
|'''''bold & italic'''''
|-
|Escape wiki markup
|<tt><nowiki><nowiki>no ''markup''</nowiki></nowiki></tt>
|<nowiki>no ''markup''</nowiki>
|-
| colspan="3" align="center" | ''only at the beginning of the line''
|-
|Headings<br>
of different sizes
|
<tt><nowiki>==level 1==</nowiki></tt><br />
<tt><nowiki>===level 2===</nowiki></tt><br />
<tt><nowiki>====level 3====</nowiki></tt><br />
<tt><nowiki>=====level 4=====</nowiki></tt>
| <!--Below are manually formatted heading samples, to avoid section edit links.-->
<big><big><big>'''Level 1'''</big></big></big><br><br>
----
<big><big>'''Level 2'''</big></big><br><br>
'''Level 3'''<br><br>
'''Level 4'''
|-
|Horizontal rule (use sparingly)
|
<tt><nowiki>----</nowiki></tt>
|
----
|-
|Bullet list
|
&#42; one<br>
&#42; two<br>
&#42; three<br>
|
* one
* two
* three
|-
|Numbered list
|
&#35; one<br>
&#35; two<br>
&#35; three<br>
|
# one
# two
# three
|-
|Definition list
|
&#59;Definition<br>
&#58;item 1<br>
&#58;item 2<br>
|
;Definition
:item 1
:item 2
|-
|Preformatted text
|
&nbsp;&nbsp;a space at the<br>
&nbsp;&nbsp;beginning of the line<br>
&nbsp;&nbsp;creates<br>
&nbsp;&nbsp;preformatted text
|
a space at the
begin of the line
creates
preformatted text
|}
</div>
 
<br clear="both">
 
===Links===
<div style="float:right">
{| {{Prettytable}}
|-
|{{Hl3}} align="center"|'''Description'''
|{{Hl3}} align="center"|'''You type'''
|{{Hl3}} align="center"|'''You get'''
|-
|Internal link
|<tt><nowiki>[[Page]]</nowiki></tt>
|[[Page]]
|-
|Piped link
|<tt><nowiki>[[Page|different text]]</nowiki></tt>
|[[Page|different text]]
|-
|External link
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
|http://mediawiki.org
|-
|External link,<br />
different title
|<tt><nowiki>[http://mediawiki.org MediaWiki]</nowiki></tt>
|[http://mediawiki.org MediaWiki]
|-
|External link,<br />
unnamed
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
|[http://mediawiki.org]
|}
</div>
Here are some variations of two important types of links in Appropedia: internal links to other pages in the wiki - including [[#Files|files]] (such as pictures) and external links to other websites.
 
To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already, it is displayed in blue, empty pages are displayed in red.
 
The first letter of the target page is automatically capitalized and spaces are represented as underscores (typing an underscore in the link has the same effect as typing a space, but is not recommended).
 
External links are in the form [http://www.example.org link name] (resulting in link name), with the link name separated from the URL by a space. Links without link names will be numbered: [http://www.example.org] becomes [1]. Links with no square brackets will be displayed in their entirety: http://www.example.org .
 
 
===HTML===
 
Some HTML-Tags are allowed in Appropedia, for example <tt><nowiki><code></nowiki></tt>, <tt><nowiki><div></nowiki></tt>, <tt><nowiki><span></nowiki></tt> and <tt><nowiki><font></nowiki></tt>.
 
==Files==
Appropedia strongly encourages the use of supporting media as a pedagogical tool.  Media that supports multilingual learning is also encouraged.  Following are some instructions and guidelines on including media in your page.
 
===Uploading===
Before uploading, please ensure that you have rights to upload and redistribute the file(s) in question and that you in turn grant these rights to others.
 
#Save a file on your computer and remember where, i.e. what folder.
#*Make sure to give it a unique name, such as your projectname_description.jpg
#*For photos: Save the photo with no dimension greater than 800 pixels, and do less if big is not necessary
#*For photos: Save the photo rotated in the proper orientation
#In Appropedia Click "Upload file"
#*This link is located in the menu on the left in the "toolbox"
#Click "Browse..."
#*This button is located in the Upload file page you now have up
#*This will bring up your operating system's standard file open dialog
#Browse your computer for you file
#Choose the file
##This will fill the Source and Destination Name of that file into the corresponding text fields.
#Enter a summary (this step is optional but considerate)
#Then press the "Upload file" button to finish the upload. This may take some time if you have a slow internet connection.
 
The preferred formats are JPEG for photographic images, PNG for drawings and other iconic images, and OGG for sounds. Please name your files descriptively to avoid confusion.
 
Please note that as with wiki pages, others may edit your uploads (and admins may delete them) if they think it serves the project, and you may be blocked from uploading if you abuse the system.
 
Once your file is uploaded you will probably want to put it in your page.
 
===Avoid huge image files===
Huge image files should be avoided - it puts a load on the servers and makes pages load slowly (especially in remote or underdeveloped areas). Usually the file should be compressed to 100 kB or less (200 kB or less for a very large or detailed picture). Raw photos from digital cameras can be more than 1 MB, which is much too large.
 
An image editing tool can help you make it smaller. An excellent free program for Windows users is [http://fookes.com/ezthumbs/index.php Easy Thumbnails]. By default it makes small "thumbnail" images, but the output can be adjusted to any size, and a preview is given (with the output file's size in the top bar). This program seems to give optimal quality for a relatively small image size.  Here are [http://www.playingwithwire.com/2006/11/resizing-images-from-comfort-of-your.html some instructions for the mac], the file sizes are reported to be a little bigger, but it should work.
 
===Linking===
 
To put your picture (file) in your page, you link to it by placing double brackets around the name of the file page (as if it was another Appropedia page).  For instance if you just uploaded a file named AEFprevfilt2.jpg, you would put double brackets around image:AEFprevfilt2.jpg.
 
<div style="float:right">
{| {{Prettytable}}
|-
|{{Hl3}} align="center"|'''Description'''
|{{Hl3}} align="center"|'''You type'''
|{{Hl3}} align="center"|'''You get'''
|-
|Just the picture
|<tt><nowiki>[[Image:AEFprevfilt2.jpg]]</nowiki></tt>
|[[Image:AEFprevfilt2.jpg]]
|-
|Thumbnailed
|<tt><nowiki>[[Image:AEFprevfilt2.jpg|thumb]]</nowiki></tt>
|[[Image:AEFprevfilt2.jpg|thumb]]
|-
|Thumbnailed with caption
|<tt><nowiki>[[Image:AEFprevfilt2.jpg|thumb|Fig 1: Cleaning out the old filter]]</nowiki></tt>
|[[Image:AEFprevfilt2.jpg|thumb|Fig 1: Cleaning out the old filter]]
|-
|Thumbnailed with <br> caption and location
|<tt><nowiki>[[Image:AEFprevfilt2.jpg|thumb|left|Fig 1: Cleaning out the old filter]]</nowiki></tt>
|[[Image:AEFprevfilt2.jpg|thumb|left|Fig 1: Cleaning out the old filter]]
|-
|Gallery
|<tt><nowiki><gallery></nowiki><br><nowiki>
Image:AEFprevfilt2.jpg|Fig 1: Cleaning out the old filter</nowiki><br><nowiki>
Image:AEFprevfilt2.jpg|Fig 1a: This would be cooler as a different photo</nowiki><br><nowiki>
Image:AEFprevfilt2.jpg|Fig 1b: This would be cooler as a different different photo</nowiki><br><nowiki>
</gallery></nowiki></tt>
|<gallery>
Image:AEFprevfilt2.jpg|Fig 1: Cleaning out the old filter
Image:AEFprevfilt2.jpg|Fig 1a: This would be cooler as a different photo
Image:AEFprevfilt2.jpg|Fig 1b: This would be cooler as a different different photo
</gallery>
|}
</div>
 
See [[Wikipedia:Wikipedia:Picture_tutorial]] for more options.
 
==More info==
See [[Wikipedia:How to edit a page]] and [[Wikipedia:Help:Contents/Editing Wikipedia]]
 
If you have a technical question which is not answered here, you may wish to check the [[Wikipedia:Help:Contents|help pages on Wikipedia]] (as Appropedia and Wikipedia use the same software); or please ask at the [[Appropedia talk:Technical questions|Technical questions]] page or the [[Appropedia_talk:Village_pump|Village pump]] - we'll be glad to help!
 
==External links==
*[[Wikipedia:Help:Contents|Help pages on Wikipedia]]
 
[[Category:Appropedia help|{{PAGENAME}}]]

Revision as of 12:49, 12 April 2007

You can also see the Appropedia help for more.

Editing a wiki is easy! Just type it in like an email. If you want to do more, then read the page below for info on formatting. And you can always [http://www.appropedia.org/index.php?title=Appropedia_talk:Village_pump

Cookies help us deliver our services. By using our services, you agree to our use of cookies.