Cunnan:How does one edit a page: Difference between revisions

From Cunnan
Jump to navigationJump to search
m (fixed tables)
(Swapped Cunnan:How does one edit a page with Help:Editing, to setup the help system.)
 
(28 intermediate revisions by 21 users not shown)
Line 1: Line 1:
#redirect [[Help:Editing]]
[[Cunnan]] is a [[WikiWiki]], meaning that anyone can easily edit any [[Cunnan:What is an article|article]] and have those changes posted immediately. This page is the reference for '''Wiki markup'''. You may also want to learn about:

* [[cunnan:How to start a page|How to start a page]]
* General policies in [[Cunnan:Policies and guidelines]]
* [[Cunnan:Naming conventions]] for how to name articles themselves

It's very easy to edit a Wiki page. Simply click on the "'''Edit'''" link at the top or bottom of a Wiki page to change the page itself, or click on "'''Discussion'''" link and then on "Edit this page" to write on the corresponding [[Cunnan:Talk page|talk page]]. This will bring you to a page with a text box containing the editable text of that Wiki page.

Then type away, write a short Edit summary on the small field below the edit-box and when finished press "Save page"! You can also preview your changes before saving if you like. Depending on your system, pressing Enter while the edit box is not active (there is no typing cursor in it) may have the same effect as pressing Save.

Please use a [[Cunnan:Neutral point of view|neutral point of view]].

It is often more convenient to copy and paste the text first into your favorite text editor, edit and spell check there, and then paste back into the browser to preview. This way, you can also keep a local backup copy of the pages you authored so that you can make changes offline.

==Minor edits==
When editing a page, a [[Cunnan:How to log in|logged-in]] user has the option of flagging the edit as a "minor edit". When to use this is somewhat a matter of personal preference. The rule of thumb is that an edit of a page that is spelling corrections, formatting, and minor rearranging of text should be flagged as a "minor edit". A major edit is basically something that makes the entry worth relooking at for somebody who wants to watch the article rather closely, so any "real" change, even if it is a single word. This feature is important, because users can choose to ''hide'' minor edits in their view of the Recent Changes page, to keep the volume of edits down to a manageable level.

The reason for not allowing a user who is not logged in to mark an edit as minor is that vandalism may be marked as a minor edit, in which case it may stay unnoticed longer. This limitation is another reason to log in.

==The wiki markup==
In the left column of the table below, you can see what effects are possible. In the right column, you can see how those effects were achieved. In other words, to make text look like it looks in the left column, type it in the format you see in the right column.

You may want to keep this page open in a separate browser window for reference. If you want to try out things without danger of doing any harm, you can do so in the [[cunnan:Sandbox|Sandbox]].

=== Sections, paragraphs, lists and lines ===

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>
<tr>
<td>
Start your sections with header lines:

== New section ==
=== Subsection ===
==== Sub-subsection ====

</td>
<td><pre><nowiki>

== New section ==

=== Subsection ===

==== Sub-subsection ====
</nowiki></pre>
</td>
</tr>

<tr>
<td>
A single [[newline]]
has no effect
on the layout.
These can be used to separate
sentences within a paragraph.

This aids editing and
improves the ''diff'' function.


But an empty line
starts a new paragraph.
</td>
<td><pre><nowiki>A single newline
has no effect
on the layout.
These can be used to separate
sentences within a paragraph.
This aids editing and
improves the ''diff'' function.

But an empty line
starts a new paragraph.
</nowiki></pre>
</td>
</tr>

<tr valign="top"><td>You can break lines<br>
without starting a new paragraph.</td>
<td><pre><nowiki>You can break lines<br>
without starting a new paragraph.</nowiki></pre>
</td>
</tr>

<tr>
<td>
* Lists are easy to do:
** start every line with a star
** more stars means deeper levels
</td>
<td><pre><nowiki>* Lists are easy to do:
** start every line with a star
** more stars means deeper levels
</nowiki></pre>
</td>
</tr>

<tr>
<td>
# Numbered lists are also good
## Very organized
## easy to follow
</td>
<td><pre><nowiki># Numbered lists are also good
## Very organized
## easy to follow</nowiki></pre>
</td>
</tr>

<tr>
<td>
* You can even do mixed lists
*# and nest them
*#* like this
</td>
<td><pre><nowiki>* You can even do mixed lists
*# and nest them
*#* like this</nowiki></pre>
</td>
</tr>

<tr>
<td>
; Definition list : list of definitions
; item : the item's definition
</td>
<td><pre><nowiki>; Definition list : list
of definitions
; item : the item's definition</nowiki></pre>
</td>
</tr>

<tr>
<td>
:A colon indents a line or paragraph.
A manual newline starts a new paragraph.

This is, however, considered bad practice.
</td>
<td><pre><nowiki>:A colon indents a line or paragraph.
A manual newline starts
a new paragraph.</nowiki></pre>
</td>
</tr>

<tr valign=top>
<td>
<pre><nowiki>IF a line starts with a space THEN
it will be formatted exactly
as typed;
in a fixed-width font;
lines won't wrap;
ENDIF
this is useful for:
* pasting preformatted text;
* algorithm descriptions;
* program source code
* ascii art;</nowiki></pre>

WARNING If you make it wide,
you [[page widening|force the whole page to be wide]] and
hence less readable. Never start ordinary lines with spaces.
</td>
<td><pre><nowiki> IF a line starts with a space THEN
it will be formatted exactly
as typed;
in a fixed-width font;
lines won't wrap;
ENDIF
this is useful for:
* pasting preformatted text;
* algorithm descriptions;
* program source code
* ascii art;</nowiki></pre></td>
</tr>

<tr valign="top"><td><center>Centered text.</center>
</td>
<td><pre><nowiki><center>Centered text.</center></nowiki></pre>
</td>
</tr>

<tr>
<td>A horizontal dividing line: above
----

and below.
</td>
<td><pre><nowiki>A horizontal dividing line: above
----
and below. </nowiki></pre>
</td>
</tr>
</table>


=== Links, URLs, images ===

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>
<tr valign="top">
<td>London has good [[public transport]].
*First letter of target is automatically capitalized.
*Internally spaces are automatically represented as underscores (typing an underscore has the same effect as typing a space, but is not recommended).

Thus the link above is to <nowiki>http://www.cunnan.org/wiki/Public_transport</nowiki>, which is the article with the name "Public transport".
</td>
<td><pre><nowiki>London has good [[public transport]].</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>Same target, different name: [[cunnan FAQ|answers]].
</td>
<td><pre><nowiki>Same target, different name:
[[cunnan FAQ|answers]]</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>Endings are blended into the link: [[test]]ing, [[gene]]s
</td>
<td>

<pre><nowiki>Endings are blended
into the link: [[test]]ing, [[gene]]s</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>
Automatically hide stuff in parentheses: [[kingdom (biology)|kingdom]].

Automatically hide namespace: [[Cunnan:Village Pump|Village Pump]].

The server fills in the part after the | when you save the page.

</td>
<td>
<pre><nowiki>Automatically hide stuff in parentheses:
[[kingdom (biology)|]]. </nowiki></pre>


<pre><nowiki>Automatically hide namespace:
[[Cunnan:Village Pump|]].</nowiki></pre>
</td></tr>

<tr>
<td>When adding a comment to a Talk page,
you should sign it. You can do this by
adding three tildes for your user name:
: [[User:Montrealais|Montrealais]]
or four for user name plus date/time:
: [[User:Montrealais|Montrealais]] 08:10 Oct 5, 2002 (UTC)
</td>
<td><pre><nowiki>When adding a comment to a Talk page,
you should sign it. You can do this by
adding three tildes for your user name:
: ~~~
or four for user name plus date/time:
: ~~~~</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>[[The weather in London]] is a page that doesn't
exist yet.

*You can create it by clicking on the link.


*To create a new page:
*#Create a link to it on some other page.
*#Save that page.
*#Click on the link you just made. The new page will open for editing.
*Have a look at [[Cunnan:How to start a page|how to start a page]] guide and Cunnan's [[Cunnan:Naming conventions|naming conventions]].
*After creating a page, search for its title and make sure that everyone correctly links to it.
</td>
<td><pre><nowiki>[[The weather in London]] is a page
that doesn't exist yet.</nowiki></pre>
</td>
</tr>

<tr valign="top"><td>
Redirect one article title to another by putting text like this in its first line. Note that there must be no text following this, or the redirect may not work. See [[Cunnan:How to use redirect pages]] for more.
</td>
<td><pre><nowiki>#REDIRECT [[United States]]</nowiki></pre>
</td>
</tr>

<tr valign="top"><td>
For a special way to link to the article on the same subject in another language, see [[Cunnan:Interlanguage links]].

</td>
<td>&nbsp;</td>
</tr>

<tr valign="top"><td>External link: [http://www.nupedia.com Nupedia]
</td>
<td><pre><nowiki>External link:
[http://www.nupedia.com Nupedia]</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>Or just give the URL: http://www.nupedia.com.

*In the [[URL]] all symbols must be among: A-Z a-z 0-9 ._\/~%-+&amp;#?!=()@ \x80-\xFF. If a URL contains a different character it should be converted; for example, ^ has to be written %5E (to be looked up in [[ASCII]]).
</td>
<td><pre><nowiki>Or just give the URL:
http://www.nupedia.com.</nowiki></pre>
</td>
</tr>
<tr valign="top">
<td>A picture: [[Image:Wiki.png|Cunnan - The Free Encyclopedia]]

* Only images that have been uploaded to Cunnan can be used. To upload images, use the [[Special:Upload|upload page]]. You can find the uploaded image on the [[Special:Imagelist|image list]]. See [[Cunnan:Image use policy]] for many more hints.

</td>
<td><pre><nowiki>
A picture: [[Image:Wiki.png]]</nowiki></pre>
or, with alternate text (''strongly'' encouraged) <!-- actually required in HTML4 -->
<pre><nowiki>[[Image:Wiki.png|Cunnan - The Free Encyclopedia]] </nowiki>
</pre>

Browsers render alternate text when not displaying an image -- for example, when the image isn't loaded, or in a text-only browser, or when spoken aloud. See [[Cunnan:Alternate text for images|Alternate text for images]] for help on choosing alternate text.
</td>
</tr>
<tr>
<td>
Clicking on an uploaded image displays a description page, which you can also link directly to: [[:Image:Wiki.png]]
</td>
<td><pre><nowiki>


[[:Image:Wiki.png]]
</nowiki></pre>
</td>
</tr>
<tr>
<td>
To include links to non-image uploads such as sounds, or to images shown as links instead of drawn on the page, use a "media" link.

<br>[[media:Sg_mrob.ogg|Sound]]
<br>
<br>[[media:Tornado.jpg|Image of a Tornado]]
</td>
<td>
<pre>
<nowiki>

[[media:Sg_mrob.ogg|Sound]]

[[media:Tornado.jpg|Image of a Tornado]]

</nowiki></pre>
</td>
</tr>
<tr>
<td>
To link to books, you can use [[Cunnan:ISBN]] links.

ISBN 0123456789X
</td>
<td>
<nowiki>ISBN 0123456789X</nowiki>
</td>
</tr>
</table>

=== Character formatting ===


<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>

<tr valign="top"><td>
''Emphasize'', '''strongly''', '''''very strongly'''''.
*These are double and triple apostrophes, not double quotes.
</td>
<td>
<pre><nowiki>''Emphasize'', '''strongly''',
'''''very strongly'''''.</nowiki></pre>
</td>
</tr>

<tr valign="top"><td>
You can also write <i>italic</i> and <b>bold</b>
if the desired effect is a specific font style
rather than emphasis, as in mathematical formulae:

:<b>F</b> = <i>m</i><b>a</b>

*However, the difference between these two methods is not very important for graphical browsers, and many people choose to ignore it.
</td>
<td>
<pre><nowiki>You can also write <i>italic</i> and <b>bold</b>
if the desired effect is a specific font style
rather than emphasis, as in mathematical formulas:

:<b>F</b> = <i>m</i><b>a</b></nowiki></pre><!-- that's not a mathematical formula, though -- sure it is, just because it's being applied to physics doesn't make it stop being mathematics -->
</td>
</tr>

<tr valign=top>
<td>A typewriter font for <tt>technical terms</tt>.
</td>
<td><pre><nowiki>A typewriter font for <tt>technical terms</tt>.</nowiki></pre>
</td><!-- tt is really 'teletype', not 'technical term' -->
</tr>

<tr valign=top>
<td>You can use <small>small text</small> for captions.
</td>
<td><pre><nowiki>You can use <small>small text</small> for captions.</nowiki></pre>
</td>
</tr>

<tr valign="top"><td>You can <strike>strike out deleted material</strike>
and <u>underline new material</u>.
</td>
<td><pre><nowiki>You can <strike>strike out deleted material</strike>
and <u>underline new material</u>.</nowiki></pre>
</td>
</tr>

<tr valign="top">
<td>
'''Umlauts and accents:''' (See [[cunnan:Special characters]])<br>
&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring; <br>
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml; <br>
&Igrave; &Iacute;
&Icirc; &Iuml; &Ntilde; &Ograve; <br>
&Oacute; &Ocirc; &Otilde;
&Ouml; &Oslash; &Ugrave; <br>
&Uacute; &Ucirc; &Uuml; &szlig;
&agrave; &aacute; <br>
&acirc; &atilde; &auml; &aring; &aelig;
&ccedil; <br>
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;<br>
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc; <br>
&oelig; &otilde;
&ouml; &oslash; &ugrave; &uacute; <br>
&ucirc; &uuml; &yuml;</td>
<td><pre><nowiki>


&amp;Agrave; &amp;Aacute; &amp;Acirc; &amp;Atilde; &amp;Auml; &amp;Aring;
&amp;AElig; &amp;Ccedil; &amp;Egrave; &amp;Eacute; &amp;Ecirc; &amp;Euml;
&amp;Igrave; &amp;Iacute; &amp;Icirc; &amp;Iuml; &amp;Ntilde; &amp;Ograve;
&amp;Oacute; &amp;Ocirc; &amp;Otilde; &amp;Ouml; &amp;Oslash; &amp;Ugrave;
&amp;Uacute; &amp;Ucirc; &amp;Uuml; &amp;szlig; &amp;agrave; &amp;aacute;
&amp;acirc; &amp;atilde; &amp;auml; &amp;aring; &amp;aelig; &amp;ccedil;
&amp;egrave; &amp;eacute; &amp;ecirc; &amp;euml; &amp;igrave; &amp;iacute;
&amp;icirc; &amp;iuml; &amp;ntilde; &amp;ograve; &amp;oacute; &amp;ocirc;
&amp;oelig; &amp;otilde; &amp;ouml; &amp;oslash; &amp;ugrave; &amp;uacute;
&amp;ucirc; &amp;uuml; &amp;yuml;</nowiki></pre></td>
</tr>

<tr valign=top>
<td>
'''Punctuation:'''<br>
&iquest; &iexcl; &laquo; &raquo; &sect; &para;<br>
&dagger; &Dagger; &bull; &mdash;
</td>
<td><pre><nowiki>

&amp;iquest; &amp;iexcl; &amp;laquo; &amp;raquo; &amp;sect; &amp;para;
&amp;dagger; &amp;Dagger; &amp;bull; &amp;mdash;</nowiki></pre></td>
</tr>

<tr valign="top">
<td>
'''Commercial symbols:'''<br>
&trade; &copy; &reg; &cent; &euro; &yen; <br>
&pound; &curren;</td>
<td><pre><nowiki>

&amp;trade; &amp;copy; &amp;reg; &amp;cent; &amp;euro; &amp;yen;
&amp;pound; &amp;curren;
</nowiki></pre></td>
</tr>

<tr valign="top"><td>Subscript: x<sub>2</sub><br>
Superscript: x<sup>2</sup> or x&sup2;
*The latter method of superscript can't be used in the most general context, but is preferred when possible (as with units of measurement) because most browsers have an easier time formatting lines with it.
&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.</td>

<td><pre><nowiki>Subscript: x<sub>2</sub>
Superscript: x<sup>2</sup> or x&amp;sup2;
&amp;epsilon;<sub>0</sub> =
8.85 &amp;times; 10<sup>&amp;minus;12</sup>
C&amp;sup2; / J m.</nowiki></pre></td>
</tr>

<tr valign="top"><td>'''Greek characters:''' <br>
&alpha; &beta; &gamma; &delta; &epsilon; &zeta; <br>
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu; <br>
&xi; &omicron; &pi; &rho; &sigma; &sigmaf; <br>
&tau; &upsilon; &phi; &chi; &psi; &omega;<br>
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi; <br>
&Sigma; &Phi; &Psi; &Omega;
</td>
<td><pre><nowiki>

&amp;alpha; &amp;beta; &amp;gamma; &amp;delta; &amp;epsilon; &amp;zeta;
&amp;eta; &amp;theta; &amp;iota; &amp;kappa; &amp;lambda; &amp;mu; &amp;nu;
&amp;xi; &amp;omicron; &amp;pi; &amp;rho; &amp;sigma; &amp;sigmaf;
&amp;tau; &amp;upsilon; &amp;phi; &amp;chi; &amp;psi; &amp;omega;
&amp;Gamma; &amp;Delta; &amp;Theta; &amp;Lambda; &amp;Xi; &amp;Pi;
&amp;Sigma; &amp;Phi; &amp;Psi; &amp;Omega;
</nowiki></pre></td>
</tr>
<tr valign="top">
<td>
'''Math characters:''' <br>
&int; &sum; &prod; &radic; &minus; &plusmn; &infin;<br>
&asymp; &prop; &equiv; &ne; &le; &ge; &rarr;<br>
&times; &middot; &divide; &part; &prime; &Prime;<br>
&nabla; &permil; &deg; &there4; &alefsym; &oslash;<br>
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;<br>
&not; &and; &or; &exist; &forall; &rArr; &hArr;<br>
&rarr; &harr;<br>
(See also [[Cunnan:WikiProject Mathematics|WikiProject Mathematics]])
</td>
<td valign="middle"><pre><nowiki>
&amp;int; &amp;sum; &amp;prod; &amp;radic; &amp;minus; &amp;plusmn; &amp;infin;
&amp;asymp; &amp;prop; &amp;equiv; &amp;ne; &amp;le; &amp;ge; &amp;rarr;
&amp;times; &amp;middot; &amp;divide; &amp;part; &amp;prime; &amp;Prime;
&amp;nabla; &amp;permil; &amp;deg; &amp;there4; &amp;alefsym; &amp;oslash;
&amp;isin; &amp;notin; &amp;cap; &amp;cup; &amp;sub; &amp;sup; &amp;sube; &amp;supe;
&amp;not; &amp;and; &amp;or; &amp;exist; &amp;forall; &amp;rArr; &amp;hArr;
&amp;rarr; &amp;harr;</nowiki></pre></td>
</tr>

<tr valign="top"><td><i>x</i><sup>2</sup>&nbsp;&nbsp;&nbsp;&ge;&nbsp;&nbsp;&nbsp;0 true.
*To space things out, use non-breaking spaces - <tt>&amp;nbsp;</tt>.
*<tt>&amp;nbsp;</tt> also prevents line breaks in the middle of text, this is useful in formulas.
</td>
<td><pre><nowiki>
<i>x</i><sup>2</sup>&amp;nbsp;&amp;nbsp;&amp;ge;&amp;nbsp;&amp;nbsp;0 true.
</nowiki></pre></td>
</tr>



<tr>
<td>
'''Suppressing interpretation of markup:'''<br>
<nowiki>Link &rarr; (<i>to</i>) the [[Cunnan FAQ]]</nowiki>
* Used to show literal data that would otherwise have special meaning.
* Escapes all wiki markup, including that which looks like HTML tags.
* Does not escape HTML character entities.
</td>
<td>
<pre><nowiki><nowiki>Link &amp;rarr; (<i>to</i>)
the [[Cunnan FAQ]]</nowiki></nowiki></pre>
</td>
</tr>

<tr>
<td>
'''Commenting page source:'''<br>
''not shown in page''
* Used to leave comments in a page for future editors.
</td>
<td>
<pre><nowiki><!-- comment here --></nowiki></pre>
</td>
</tr>
</table>

=== Tables ===

HTML tables can be quite useful as well. For details on how to use them and discussion about when they are appropriate, see [[Cunnan:How to use tables]].

Latest revision as of 21:33, 13 June 2014

Redirect to: