Difference between revisions of "Help:Editing"

From MythTV Official Wiki
Jump to: navigation, search
m (Reverted edit of Blackgizmo, changed back to last version by Isaac)
 
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
<div style="border: solid 1px; border-color: blue; margin: 1em; padding: 1em; background-color: lightblue; font-size: 80%">
 +
This page has several links to '''Wikipedia''' to provide detailed explanations. If you are editing a section, make sure you are '''NOT''' editing Wikipedia.
 +
</div>
 +
 
This Editing Overview has a lot of '''wikitext''' examples. You may want to keep this page open in a separate browser window for reference while you edit.
 
This Editing Overview has a lot of '''wikitext''' examples. You may want to keep this page open in a separate browser window for reference while you edit.
  
Line 5: Line 9:
  
 
;Start editing
 
;Start editing
:To start editing a MythTV page, click on the "'''Edit this page'''" (or just "'''edit'''") link at one of its edges. This will bring you to the '''edit page''': a page with a text box containing the ''[[w:wikitext|wikitext]]'': the editable source code from which the server produces the webpage.
+
:To start editing a MythTV page, click on the "'''Edit this page'''" (or just "'''edit'''") link at one of its edges. This will bring you to the '''edit page''': a page with a text box containing the ''[[wikipedia:wikitext|wikitext]]'': the editable source code from which the server produces the webpage.
 +
:If you want to create a new page, either put the URL for the page you want in your address bar and start a new page, or edit a page like your User page (click your login name at the top) and add the page you want as a link.
  
 
;Summarize your changes
 
;Summarize your changes
:You should write a short [[Help:Edit summary|edit summary]] in the small field below the edit-box. You may use shorthand to describe your changes, as described in the [[{{ns:4}}:Edit summary legend|legend]].
+
:You should write a short [[wikipedia:Help:Edit summary|edit summary]] in the small field below the edit-box. You may use shorthand to describe your changes, as described in the [[wikipedia:Wikipedia:Edit summary legend|legend]].
  
 
;Preview before saving
 
;Preview before saving
:When you have finished, press [[Help:Show preview|preview]] to see how your changes will look -- '''before''' you make them permanent.  Repeat the edit/preview process until you are satisfied, then click "Save" and your changes will be immediately applied to the article.
+
:When you have finished, press [[wikipedia:Help:Show preview|preview]] to see how your changes will look -- '''before''' you make them permanent.  Repeat the edit/preview process until you are satisfied, then click "Save" and your changes will be immediately applied to the article.
 +
 
 +
== [[wikipedia:Wikitext|Wikitext]] markup -- making your page look the way you want==
 +
 
 +
<!-- This is the part everybody wants, therefore transcluded and not just linked.-->
 +
 
 +
=== Basic text formatting ===
 +
 
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
You can ''emphasize text'' by putting two
 +
apostrophes on each side. Three apostrophes
 +
will emphasize it '''strongly'''. Five
 +
apostrophes is '''''even stronger'''''.
 +
|<pre><nowiki>
 +
You can ''emphasize text'' by putting two
 +
apostrophes on each side. Three apostrophes
 +
will emphasize it '''strongly'''. Five
 +
apostrophes is '''''even stronger'''''.
 +
</nowiki></pre>
 +
|-
 +
|
 +
A single newline
 +
has no effect
 +
on the layout.
 +
 
 +
But an empty line
 +
starts a new paragraph.
 +
|<pre><nowiki>
 +
A single newline
 +
has no effect
 +
on the layout.
 +
 
 +
But an empty line
 +
starts a new paragraph.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can break lines<br>
 +
without starting a new paragraph.<br>
 +
Please use this sparingly.
 +
|<pre><nowiki>
 +
You can break lines<br>
 +
without starting a new paragraph.<br>
 +
Please use this sparingly.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You should "sign" your comments on talk pages:
 +
: Three tildes gives your user name: [[User:Gregturn|Gregturn]]
 +
: Four tildes give your user name plus date/time: [[User:Gregturn|Gregturn]] 07:46, 27 November 2005 (UTC)
 +
: Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC)
 +
|<pre><nowiki>
 +
You should "sign" your comments on talk pages:
 +
: Three tildes gives your user name: ~~~
 +
: Four tildes give your user name plus date/time: ~~~~
 +
: Five tildes gives the date/time alone: ~~~~~
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can use <b>HTML tags</b>, too, if you
 +
want. Some useful ways to use HTML:
 +
 
 +
Put text in a <tt>typewriter font</tt>.
 +
The same font is generally used for
 +
<code>computer code</code>.
 +
 
 +
<strike>Strike out</strike> or
 +
<u>underline</u> text, or write it
 +
<span style="font-variant:small-caps">
 +
in small caps</span>.
 +
 
 +
Superscripts and subscripts:
 +
x<sup>2</sup>, x<sub>2</sub>
 +
 
 +
Invisible comments that only appear while editing the page.
 +
<!-- Note to editors: blah blah blah. -->
 +
Comments should usually go on the talk page, though.
 +
|<pre><nowiki>
 +
You can use <b>HTML tags</b>, too, if you
 +
want. Some useful ways to use HTML:
 +
 
 +
Put text in a <tt>typewriter font</tt>.
 +
The same font is generally used for
 +
<code>computer code</code>.
 +
 
 +
<strike>Strike out</strike> or
 +
<u>underline</u> text, or write it
 +
<span style="font-variant:small-caps">
 +
in small caps</span>.
 +
 
 +
Superscripts and subscripts:
 +
x<sup>2</sup>, x<sub>2</sub>
 +
 
 +
Invisible comments that only appear while editing the page.
 +
<!-- Note to editors: blah blah blah. -->
 +
Comments should usually go on the talk page, though.
 +
</nowiki></pre>
 +
|}
 +
 
 +
For a list of HTML tags that are allowed, see [[Wikipedia:Help:HTML in wikitext|HTML in wikitext]]. However, you should avoid HTML in favor of Wiki markup whenever possible.
 +
 
 +
=== Organizing your writing ===
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
<span style="font-size: 150%"><b>Section headings</b></span>
 +
 
 +
Headings organize your writing into sections.
 +
The Wiki software can automatically generate
 +
a [[Wikipedia:Help:table of contents|table of contents]] from them.
 +
 
 +
 
 +
<span style="font-size: 125%"><b>Subsection</b></span>
 +
 
 +
Using more equals signs creates a subsection.
 +
 
 +
 
 +
<b>A smaller subsection</b>
 +
 
 +
Don't skip levels, like from two to four equals signs.
 +
Start with two equals signs; don't use single equals signs.
 +
|<pre><nowiki>
 +
== Section headings ==
 +
 
 +
Headings organize your writing into sections.
 +
The Wiki software can automatically generate
 +
a table of contents from them.
 +
 
 +
=== Subsection ===
 +
 
 +
Using more equals signs creates a subsection.
 +
 
 +
==== A smaller subsection ====
 +
 
 +
Don't skip levels, like from two to four equals signs.
 +
Start with two equals signs; don't use single equals signs.
 +
</nowiki></pre>
 +
|-
 +
|
 +
* ''Unordered [[Wikipedia:Help:List|list]]s'' are easy to do:
 +
** Start every line with a star.
 +
*** More stars indicate a deeper level.
 +
*A newline
 +
*in a list 
 +
marks the end of the list.
 +
*Of course you can start again.
 +
|<pre><nowiki>
 +
* ''Unordered lists'' are easy to do:
 +
** Start every line with a star.
 +
*** More stars indicate a deeper level.
 +
*A newline
 +
*in a list 
 +
marks the end of the list.
 +
*Of course you can start again.
 +
</nowiki></pre>
 +
|-
 +
|
 +
# Numbered lists are also good:
 +
## Very organized
 +
## Easy to follow
 +
A newline marks the end of the list.
 +
#New numbering starts with 1.
 +
 
 +
|<pre><nowiki>
 +
# Numbered lists are also good:
 +
## Very organized
 +
## Easy to follow
 +
A newline marks the end of the list.
 +
#New numbering starts with 1.
 +
</nowiki></pre>
 +
|-
 +
|
 +
* You can even do mixed lists
 +
*# and nest them
 +
*#* or break lines<br>in lists.
 +
|<pre><nowiki>* You can even do mixed lists
 +
*# and nest them
 +
*#* or break lines<br>in lists.</nowiki></pre>
 +
|-
 +
|
 +
Another kind of list is a '''definition list''':
 +
; word : definition of the word
 +
; longer phrase
 +
: phrase defined
 +
|<pre><nowiki>
 +
Another kind of list is a '''definition list''':
 +
; word : definition of the word
 +
; longer phrase
 +
: phrase defined</nowiki></pre>
 +
|-
 +
|
 +
:A colon indents a line or paragraph.
 +
A newline after that starts a new paragraph.
 +
::This is often used for discussion on [[Wikipedia:Help:Talk page|Talk page]]s.
 +
|<pre><nowiki>
 +
:A colon indents a line or paragraph.
 +
A newline after that starts a new paragraph.
 +
::This is often used for discussion on talk pages.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can make [[Wikipedia:horizontal dividing line|horizontal dividing line]]s
 +
to separate text.
 +
----
 +
But you should usually use sections instead,
 +
so that they go in the table of contents.
 +
|<pre><nowiki>
 +
You can make horizontal dividing lines
 +
to separate text.
 +
----
 +
But you should usually use sections instead,
 +
so that they go in the table of contents.
 +
</nowiki></pre>
 +
|}
 +
 
 +
=== Links ===
 +
 
 +
You will often want to make clickable ''links'' to other pages.
 +
 
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
Here's a link to a page named [[Video capture card]].
 +
You can even say [[Video capture card]]s
 +
and the link will show up correctly.
 +
 
 +
You can put formatting around a link.
 +
Example: ''[[bttv]]''.
 +
 
 +
The ''first letter'' will automatically be capitalized,
 +
so [[hauppauge PVR-350]] goes to the same place as [[Hauppauge PVR-350]].
 +
Capitalization matters after the first letter.
 +
 
 +
[[The weather in London]] is a page that doesn't exist
 +
yet. You can create it by clicking on the link.
 +
|<pre><nowiki>
 +
Here's a link to a page named [[Video capture card]].
 +
You can even say [[Video capture card]]s
 +
and the link will show up correctly.
 +
 
 +
You can put formatting around a link.
 +
Example: ''[[bttv]]''.
 +
 
 +
The ''first letter'' will automatically be capitalized,
 +
so [[hauppauge PVR-350]] goes to the same place as [[Hauppauge PVR-350]].
 +
Capitalization matters after the first letter.
 +
 
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can link to a page section by its title:
 +
 
 +
*[[Linux Distros#Debian]].
 +
*[[Linux Distros#Ubuntu]].
 +
 
 +
If multiple sections have the same title, add
 +
a number. [[#Example section 3]] goes to the
 +
third section named "Example section".
 +
|<pre><nowiki>
 +
You can link to a page section by its title:
 +
 
 +
*[[Linux Distros#Debian]].
 +
*[[Linux Distros#Ubuntu]].
 +
 
 +
If multiple sections have the same title, add
 +
a number. [[#Example section 3]] goes to the
 +
third section named "Example section".
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can make a link point to a different place
 +
with a [[wikipedia:Help:Piped link|piped link]]. Put the link
 +
target first, then the pipe character "|", then
 +
the link text.
 +
 
 +
*[[wikipedia:Help:Link|About Links]]
 +
*[[Linux Distros#Ubuntu|Ubuntu Linux distribution]]
 +
|<pre><nowiki>
 +
You can make a link point to a different place
 +
with a [[wikipedia:Help:Piped link|piped link]]. Put the link
 +
target first, then the pipe character "|", then
 +
the link text.
 +
 
 +
*[[wikipedia:Help:Link|About Links]]
 +
*[[Linux Distros#Ubuntu|Ubuntu Linux distribution]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can make an external link just by typing a URL:
 +
http://www.nupedia.com
 +
 
 +
You can give it a title:
 +
[http://www.nupedia.com Nupedia]
 +
 
 +
Or leave the title blank:
 +
[http://www.nupedia.com]
 +
|
 +
<pre><nowiki>
 +
You can make an external link just by typing a URL:
 +
http://www.nupedia.com
 +
 
 +
You can give it a title:
 +
[http://www.nupedia.com Nupedia]
 +
 
 +
Or leave the title blank:
 +
[http://www.nupedia.com]
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can [[wikipedia:Help:Redirect|redirect]] the user to another page with
 +
a special link. For example, you might want to
 +
redirect [[wikipedia:USA|USA]] to [[wikipedia:United States|United States]].
 +
|<pre><nowiki>
 +
#REDIRECT [[United States]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
[[wikipedia:Help:Category|Category links]] don't show up, but add the page
 +
to a category. <includeonly>[[Category:Knowledge Base]]</includeonly>
 +
 
 +
Add an extra colon to actually link to the category:
 +
[[:Category:Knowledge Base]]
 +
|<pre><nowiki>
 +
Category links don't show up, but add the page
 +
to a category. [[Category:Knowledge Base]]
 +
 
 +
Add an extra colon to actually link to the category:
 +
[[:Category:Knowledge Base]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
The Wiki reformats linked dates to match the reader's date
 +
preferences. These three dates will show up the same if you
 +
choose a format in your [[Special:Preferences|Preferences]]:
 +
* [[July 20]], [[1969]]
 +
* [[20 July]] [[1969]]
 +
* [[1969]]-[[07-20]]
 +
|<pre><nowiki>
 +
The Wiki reformats linked dates to match the reader's date
 +
preferences. These three dates will show up the same if you
 +
choose a format in your [[Special:Preferences|]]:
 +
* [[July 20]], [[1969]]
 +
* [[20 July]] [[1969]]
 +
* [[1969]]-[[07-20]]
 +
</nowiki></pre>
 +
|}
 +
 
 +
===Just show what I typed===
 +
 
 +
A few different kinds of formatting will tell the Wiki to display things as you typed them.
 +
 
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
! style="width:8em" |
 +
!What it looks like
 +
!What you type
 +
|-
 +
|'''&lt;nowiki&gt; tags'''
 +
|
 +
<nowiki>
 +
The nowiki tag ignores [[Wiki]] ''markup''.
 +
It reformats text by removing newlines    and multiple spaces.
 +
It still interprets special characters: &rarr;
 +
</nowiki>
 +
|<pre><nowiki>
 +
&lt;nowiki&gt;
 +
The nowiki tag ignores [[Wiki]] ''markup''.
 +
It reformats text by removing newlines    and multiple spaces.
 +
It still interprets special characters: &amp;rarr;
 +
&lt;/nowiki&gt;
 +
</nowiki></pre>
 +
|-
 +
|'''&lt;pre&gt; tags'''
 +
|
 +
<pre>
 +
The pre tag ignores [[Wiki]] ''markup''.
 +
It also doesn't    reformat text.
 +
It still interprets special characters: &rarr;
 +
</pre>
 +
|<pre><nowiki>
 +
<pre>
 +
The pre tag ignores [[Wiki]] ''markup''.
 +
It also doesn't    reformat text.
 +
It still interprets special characters: &amp;rarr;
 +
</pre>
 +
</nowiki></pre>
 +
|-
 +
|'''Leading spaces'''
 +
|
 +
Leading spaces are another way to preserve formatting.
 +
 
 +
Putting a space at the beginning of each line
 +
stops the text  from being reformatted. It still
 +
interprets [[wikipedia:Wiki]] ''markup'' and special
 +
characters: &rarr;
 +
|<pre><nowiki>
 +
Leading spaces are another way to preserve formatting.
 +
 
 +
Putting a space at the beginning of each line
 +
stops the text  from being reformatted. It still
 +
interprets [[wikipedia:Wiki]] ''markup'' and special
 +
characters: &amp;rarr;
 +
</nowiki></pre>
 +
|}
 +
 
 +
===Images, tables, video, and sounds===
 +
This is a very quick introduction. For more information, see:
 +
* [[wikipedia:Help:Images and other uploaded files]] for how to upload files
 +
* [[wikipedia:Help:Extended image syntax]] for how to arrange images on the page
 +
* [[wikipedia:Help:Table]] for how to create a table
 +
 
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
A picture, including alternate text:
 +
 
 +
[[Image:Wiki.png|The logo for this Wiki]]
 +
 
 +
You can put the image in a frame with a caption:
 +
[[Image:Wiki.png|frame|The logo for this Wiki]]
 +
|<pre><nowiki>
 +
A picture, including alternate text:
 +
 
 +
[[Image:Wiki.png|The logo for this Wiki]]
 +
 
 +
You can put the image in a frame with a caption:
 +
[[Image:Wiki.png|frame|The logo for this Wiki]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
A link to Wikipedia's page for the image:
 +
[[:Image:Wiki.png]]
 +
 
 +
Or a link directly to the image itself:
 +
[[Media:Wiki.png]]
 +
|<pre><nowiki>
 +
A link to Wikipedia's page for the image:
 +
[[:Image:Wiki.png]]
 +
 
 +
Or a link directly to the image itself:
 +
[[Media:Wiki.png]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
Use '''media:''' links to link to sounds
 +
or videos: [[wikipedia:media:Sg_mrob.ogg|A sound file]]
 +
|<pre><nowiki>
 +
Use '''media:''' links to link to sounds
 +
or videos: [[wikipedia:media:Sg_mrob.ogg|A sound file]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
<center>
 +
{| border=1 cellspacing=0 cellpadding=5
 +
| This
 +
| is
 +
|-
 +
| a
 +
| '''table'''
 +
|}
 +
</center>
 +
|<pre><nowiki>
 +
<center>
 +
{| border=1 cellspacing=0 cellpadding=5
 +
| This
 +
| is
 +
|-
 +
| a
 +
| '''table'''
 +
|}
 +
</center>
 +
</nowiki></pre>
 +
|}
 +
 
 +
===Templates===
 +
 
 +
'''[[wikipedia:Help:Template|Templates]]''' are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page.
 +
You add them by putting the template's name in <nowiki>{{double braces}}</nowiki>.
 +
 
 +
Some templates take ''parameters'', as well, which you separate with the pipe character.
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
{{Click || image=Hardware.png | link=:Category:Hardware | width=48px | height=48px }}
 +
|<pre><nowiki>
 +
{{Click || image=Hardware.png | link=:Category:Hardware | width=48px | height=48px }}
 +
</nowiki></pre>
 +
|}
 +
 
 +
== Tips and tricks ==
 +
 
 +
===Page protection===
 +
In a few cases, where an administrator has [[wikipedia:Help:Administration#Page_protection|protected]] a page, the link labeled "{{MediaWiki:Editthispage}}" is replaced by the text "{{MediaWiki:Viewsource}}" (or equivalents in the language of the project). In that case the page cannot be edited. Protection of an image page includes protection of the image itself.
 +
 
 +
===Edit conflicts===
 +
If someone else makes an edit while you are making yours, the result is an [[wikipedia:Help:Edit conflict|edit conflict]]. Many conflicts can be automatically resolved by the Wiki. If it can't be resolved, however, you will need to resolve it yourself. The Wiki gives you two text boxes, where the top one is the other person's edit and the bottom one is your edit. Merge your edits into the top edit box, which is the only one that will be saved.
 +
 
 +
===Reverting===
 +
The edit link of a page showing an old version leads to an edit page with the old wikitext. This is a useful way to [[wikipedia:Help:Reverting a page to an earlier version|restore the old version]] of a page. However, the edit link of a [[wikipedia:Help:Diff|diff]] page gives the current wikitext, even if the diff page shows an old version below the table of differences.
 +
 
 +
===Error messages===
 +
If you get an error message upon saving a page, you can't tell whether the actual save has failed or just the confirmation. You can go back and save again, and the second save will have no effect, or you can check "My contributions" to see whether the edit went through.
 +
 
 +
===Checking spelling and editing in your favorite editor===
 +
You may find it more convenient to copy and paste the text first into your favorite [[wikipedia:text editor|text editor]], edit and spell check it there, and then paste it back into your [[wikipedia:web browser|web browser]] to preview. This way, you can also keep a local backup copy of the pages you have edited. It also allows you to make changes offline.
 +
 
 +
If you edit this way, it's best to leave the editing page open after you copy from it, using the same edit box to submit your changes, so that the usual edit conflict mechanism can deal with it. If you return to the editing page later, please make sure that nobody else has edited the page in the meantime. If someone has, you'll need to merge their edits into yours by using the [[wikipedia:Help:diff|diff]] feature in the page history.
 +
 
 +
===Composition of the edit page===
 +
The editing page consists of these sections:
 +
 
 +
* The [[wikipedia:Help:Edit toolbar|edit toolbar]] (optional)
 +
* The editing text box
 +
* The [[wikipedia:Help:Edit summary|edit summary]] box
 +
* Save/Preview/Cancel links
 +
* A list of [[wikipedia:Help:Template|template]]s used on the page
 +
* A preview, if you have requested one. Your preferences may place the preview at the top of the page instead.
  
{{Wikitext quick reference}} <!-- Edit this at [[Template:Wikitext quick reference]] -->
+
===Position-independent wikitext===
  
{{Editing tips and tricks}} <!-- Edit this at [[Template:Editing tips and tricks]] -->
+
No matter where you put these things in the wikitext, the resulting page is displayed the same way:
 +
*[[wikipedia:Help:Category|Categories]]
 +
*The [[wikipedia:Help:Magic words|magic words]] <nowiki>__NOTOC__ and __FORCETOC__</nowiki>. See [[wikipedia:Help:Section]].
  
 
== Minor edits ==
 
== Minor edits ==
  
A [[Help:Logging in|logged-in]] user can mark an edit as "minor". [[Help:Minor edit|Minor edit]]s are generally spelling corrections, formatting, and minor rearrangement of text. Users may choose to ''hide'' minor edits when viewing [[Help:Recent changes|Recent Changes]].
+
A [[wikipedia:Help:Logging in|logged-in]] user can mark an edit as "minor". [[wikipedia:Help:Minor edit|Minor edit]]s are generally spelling corrections, formatting, and minor rearrangement of text. Users may choose to ''hide'' minor edits when viewing [[wikipedia:Help:Recent changes|Recent Changes]].
  
Marking a significant change as a minor edit is considered bad Wikiquette. If you have accidentally marked an edit as minor, make a [[Help:Dummy edit|dummy edit]], verify that the "<small>'''[&nbsp;] This is a minor edit'''</small>" check-box is unchecked, and explain in the edit summary that the previous edit was not minor.
+
Marking a significant change as a minor edit is considered bad Wikiquette. If you have accidentally marked an edit as minor, make a [[wikipedia:Help:Dummy edit|dummy edit]], verify that the "<small>'''[&nbsp;] This is a minor edit'''</small>" check-box is unchecked, and explain in the edit summary that the previous edit was not minor.
  
 
==External links==
 
==External links==
 
*[http://home.earthlink.net/~awinkelried/keyboard_shortcuts.html Special characters in HTML]
 
*[http://home.earthlink.net/~awinkelried/keyboard_shortcuts.html Special characters in HTML]

Latest revision as of 21:56, 9 March 2006

This page has several links to Wikipedia to provide detailed explanations. If you are editing a section, make sure you are NOT editing Wikipedia.

This Editing Overview has a lot of wikitext examples. You may want to keep this page open in a separate browser window for reference while you edit.

Each of the topics covered here is covered somewhere else in more detail. Please look in the box on the right for the topic you are interested in.

Editing basics

Start editing
To start editing a MythTV page, click on the "Edit this page" (or just "edit") link at one of its edges. This will bring you to the edit page: a page with a text box containing the wikitext: the editable source code from which the server produces the webpage.
If you want to create a new page, either put the URL for the page you want in your address bar and start a new page, or edit a page like your User page (click your login name at the top) and add the page you want as a link.
Summarize your changes
You should write a short edit summary in the small field below the edit-box. You may use shorthand to describe your changes, as described in the legend.
Preview before saving
When you have finished, press preview to see how your changes will look -- before you make them permanent. Repeat the edit/preview process until you are satisfied, then click "Save" and your changes will be immediately applied to the article.

Wikitext markup -- making your page look the way you want

Basic text formatting

What it looks like What you type

You can emphasize text by putting two apostrophes on each side. Three apostrophes will emphasize it strongly. Five apostrophes is even stronger.

You can ''emphasize text'' by putting two
apostrophes on each side. Three apostrophes
will emphasize it '''strongly'''. Five
apostrophes is '''''even stronger'''''.

A single newline has no effect on the layout.

But an empty line starts a new paragraph.

A single newline
has no effect
on the layout.

But an empty line
starts a new paragraph.

You can break lines
without starting a new paragraph.
Please use this sparingly.

You can break lines<br>
without starting a new paragraph.<br>
Please use this sparingly.

You should "sign" your comments on talk pages:

Three tildes gives your user name: Gregturn
Four tildes give your user name plus date/time: Gregturn 07:46, 27 November 2005 (UTC)
Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC)
You should "sign" your comments on talk pages:
: Three tildes gives your user name: ~~~
: Four tildes give your user name plus date/time: ~~~~
: Five tildes gives the date/time alone: ~~~~~

You can use HTML tags, too, if you want. Some useful ways to use HTML:

Put text in a typewriter font. The same font is generally used for computer code.

Strike out or underline text, or write it in small caps.

Superscripts and subscripts: x2, x2

Invisible comments that only appear while editing the page. Comments should usually go on the talk page, though.

You can use <b>HTML tags</b>, too, if you
want. Some useful ways to use HTML:

Put text in a <tt>typewriter font</tt>.
The same font is generally used for
<code>computer code</code>.

<strike>Strike out</strike> or
<u>underline</u> text, or write it
<span style="font-variant:small-caps">
in small caps</span>.

Superscripts and subscripts:
x<sup>2</sup>, x<sub>2</sub>

Invisible comments that only appear while editing the page.
<!-- Note to editors: blah blah blah. -->
Comments should usually go on the talk page, though.

For a list of HTML tags that are allowed, see HTML in wikitext. However, you should avoid HTML in favor of Wiki markup whenever possible.

Organizing your writing

What it looks like What you type

Section headings

Headings organize your writing into sections. The Wiki software can automatically generate a table of contents from them.


Subsection

Using more equals signs creates a subsection.


A smaller subsection

Don't skip levels, like from two to four equals signs. Start with two equals signs; don't use single equals signs.

== Section headings ==

Headings organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.

=== Subsection ===

Using more equals signs creates a subsection.

==== A smaller subsection ====

Don't skip levels, like from two to four equals signs.
Start with two equals signs; don't use single equals signs.
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
  • A newline
  • in a list

marks the end of the list.

  • Of course you can start again.
* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*A newline
*in a list  
marks the end of the list.
*Of course you can start again.
  1. Numbered lists are also good:
    1. Very organized
    2. Easy to follow

A newline marks the end of the list.

  1. New numbering starts with 1.
# Numbered lists are also good:
## Very organized
## Easy to follow
A newline marks the end of the list.
#New numbering starts with 1.
  • You can even do mixed lists
    1. and nest them
      • or break lines
        in lists.
* You can even do mixed lists
*# and nest them
*#* or break lines<br>in lists.

Another kind of list is a definition list:

word 
definition of the word
longer phrase
phrase defined
Another kind of list is a '''definition list''':
; word : definition of the word
; longer phrase 
: phrase defined
A colon indents a line or paragraph.

A newline after that starts a new paragraph.

This is often used for discussion on Talk pages.
:A colon indents a line or paragraph.
A newline after that starts a new paragraph.
::This is often used for discussion on talk pages.

You can make horizontal dividing lines to separate text.


But you should usually use sections instead, so that they go in the table of contents.

You can make horizontal dividing lines
to separate text.
----
But you should usually use sections instead,
so that they go in the table of contents.

Links

You will often want to make clickable links to other pages.

What it looks like What you type

Here's a link to a page named Video capture card. You can even say Video capture cards and the link will show up correctly.

You can put formatting around a link. Example: bttv.

The first letter will automatically be capitalized, so hauppauge PVR-350 goes to the same place as Hauppauge PVR-350. Capitalization matters after the first letter.

The weather in London is a page that doesn't exist yet. You can create it by clicking on the link.

Here's a link to a page named [[Video capture card]].
You can even say [[Video capture card]]s
and the link will show up correctly.

You can put formatting around a link.
Example: ''[[bttv]]''.

The ''first letter'' will automatically be capitalized,
so [[hauppauge PVR-350]] goes to the same place as [[Hauppauge PVR-350]].
Capitalization matters after the first letter.

You can link to a page section by its title:

If multiple sections have the same title, add a number. #Example section 3 goes to the third section named "Example section".

You can link to a page section by its title:

*[[Linux Distros#Debian]].
*[[Linux Distros#Ubuntu]].

If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".

You can make a link point to a different place with a piped link. Put the link target first, then the pipe character "|", then the link text.

You can make a link point to a different place
with a [[wikipedia:Help:Piped link|piped link]]. Put the link
target first, then the pipe character "|", then
the link text.

*[[wikipedia:Help:Link|About Links]]
*[[Linux Distros#Ubuntu|Ubuntu Linux distribution]]

You can make an external link just by typing a URL: http://www.nupedia.com

You can give it a title: Nupedia

Or leave the title blank: [1]

You can make an external link just by typing a URL:
http://www.nupedia.com

You can give it a title:
[http://www.nupedia.com Nupedia]

Or leave the title blank:
[http://www.nupedia.com]

You can redirect the user to another page with a special link. For example, you might want to redirect USA to United States.

#REDIRECT [[United States]]

Category links don't show up, but add the page to a category.

Add an extra colon to actually link to the category: Category:Knowledge Base

Category links don't show up, but add the page
to a category. [[Category:Knowledge Base]]

Add an extra colon to actually link to the category:
[[:Category:Knowledge Base]]

The Wiki reformats linked dates to match the reader's date preferences. These three dates will show up the same if you choose a format in your Preferences:

The Wiki reformats linked dates to match the reader's date
preferences. These three dates will show up the same if you
choose a format in your [[Special:Preferences|]]:
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
* [[1969]]-[[07-20]]

Just show what I typed

A few different kinds of formatting will tell the Wiki to display things as you typed them.

What it looks like What you type
<nowiki> tags

The nowiki tag ignores [[Wiki]] ''markup''. It reformats text by removing newlines and multiple spaces. It still interprets special characters: →

<nowiki>
The nowiki tag ignores [[Wiki]] ''markup''.
It reformats text by removing newlines    and multiple spaces.
It still interprets special characters: &rarr;
</nowiki>
<pre> tags
The pre tag ignores [[Wiki]] ''markup''.
It also doesn't     reformat text.
It still interprets special characters: →
<nowiki>
<pre>
The pre tag ignores [[Wiki]] ''markup''.
It also doesn't     reformat text.
It still interprets special characters: &rarr;

</nowiki></pre>

Leading spaces

Leading spaces are another way to preserve formatting.

Putting a space at the beginning of each line
stops the text   from being reformatted. It still
interprets wikipedia:Wiki markup and special
characters: →
Leading spaces are another way to preserve formatting.

 Putting a space at the beginning of each line
 stops the text   from being reformatted. It still
 interprets [[wikipedia:Wiki]] ''markup'' and special
 characters: &rarr;

Images, tables, video, and sounds

This is a very quick introduction. For more information, see:

What it looks like What you type

A picture, including alternate text:

The logo for this Wiki

You can put the image in a frame with a caption:

The logo for this Wiki
A picture, including alternate text:

[[Image:Wiki.png|The logo for this Wiki]]

You can put the image in a frame with a caption:
[[Image:Wiki.png|frame|The logo for this Wiki]]

A link to Wikipedia's page for the image: Image:Wiki.png

Or a link directly to the image itself: Media:Wiki.png

A link to Wikipedia's page for the image:
[[:Image:Wiki.png]]

Or a link directly to the image itself:
[[Media:Wiki.png]]

Use media: links to link to sounds or videos: A sound file

Use '''media:''' links to link to sounds
or videos: [[wikipedia:media:Sg_mrob.ogg|A sound file]]
This is
a table
<center>
{| border=1 cellspacing=0 cellpadding=5
| This
| is
|- 
| a
| '''table'''
|}
</center>

Templates

Templates are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page. You add them by putting the template's name in {{double braces}}.

Some templates take parameters, as well, which you separate with the pipe character.

What it looks like What you type
{{Click || image=Hardware.png | link=:Category:Hardware | width=48px | height=48px }}

Tips and tricks

Page protection

In a few cases, where an administrator has protected a page, the link labeled "Edit this page" is replaced by the text "View source" (or equivalents in the language of the project). In that case the page cannot be edited. Protection of an image page includes protection of the image itself.

Edit conflicts

If someone else makes an edit while you are making yours, the result is an edit conflict. Many conflicts can be automatically resolved by the Wiki. If it can't be resolved, however, you will need to resolve it yourself. The Wiki gives you two text boxes, where the top one is the other person's edit and the bottom one is your edit. Merge your edits into the top edit box, which is the only one that will be saved.

Reverting

The edit link of a page showing an old version leads to an edit page with the old wikitext. This is a useful way to restore the old version of a page. However, the edit link of a diff page gives the current wikitext, even if the diff page shows an old version below the table of differences.

Error messages

If you get an error message upon saving a page, you can't tell whether the actual save has failed or just the confirmation. You can go back and save again, and the second save will have no effect, or you can check "My contributions" to see whether the edit went through.

Checking spelling and editing in your favorite editor

You may find it more convenient to copy and paste the text first into your favorite text editor, edit and spell check it there, and then paste it back into your web browser to preview. This way, you can also keep a local backup copy of the pages you have edited. It also allows you to make changes offline.

If you edit this way, it's best to leave the editing page open after you copy from it, using the same edit box to submit your changes, so that the usual edit conflict mechanism can deal with it. If you return to the editing page later, please make sure that nobody else has edited the page in the meantime. If someone has, you'll need to merge their edits into yours by using the diff feature in the page history.

Composition of the edit page

The editing page consists of these sections:

  • The edit toolbar (optional)
  • The editing text box
  • The edit summary box
  • Save/Preview/Cancel links
  • A list of templates used on the page
  • A preview, if you have requested one. Your preferences may place the preview at the top of the page instead.

Position-independent wikitext

No matter where you put these things in the wikitext, the resulting page is displayed the same way:

Minor edits

A logged-in user can mark an edit as "minor". Minor edits are generally spelling corrections, formatting, and minor rearrangement of text. Users may choose to hide minor edits when viewing Recent Changes.

Marking a significant change as a minor edit is considered bad Wikiquette. If you have accidentally marked an edit as minor, make a dummy edit, verify that the "[ ] This is a minor edit" check-box is unchecked, and explain in the edit summary that the previous edit was not minor.

External links