Help:Editing: Difference between revisions
(the Help Page doesn't have any information...let's put some there...) |
(NEW PAGE, Eding Help) |
||
Line 1: | Line 1: | ||
In the | In the hope that Community Bike Shops will share knowledge via the Bike Collectives Wiki, this page provides examples of basic wiki editing and links to websites with additional information. | ||
== Basic | == Basic text formatting == | ||
*From [http://en.wikipedia.org/wiki/Help:Wikitext_examples WikiText Examples] | |||
You can format the page using Wikitext special characters. | |||
{|width="80%" border="1" cellpadding="2" cellspacing="0" | |||
|- | |||
!What it looks like | |||
!What you type | |||
|- | |||
| | |||
You can ''italicize text'' by putting 2 | |||
apostrophes on each side. | |||
3 apostrophes will '''bold the text'''. | |||
5 apostrophes will '''bold''' and ''italicize'' | |||
'''''the text'''''. | |||
(Using 4 apostrophes doesn't do anything special -- <br>they are just '''' left over ones'''' that are included as part of the text.) | |||
|<pre> | |||
You can ''italicize text'' by putting 2 | |||
apostrophes on each side. | |||
3 apostrophes will '''bold the text'''. | |||
5 apostrophes will '''bold''' and ''italicize'' | |||
'''''the text'''''. | |||
(Using 4 apostrophes doesn't do anything | |||
special -- <br /> they are just ''''left | |||
over ones'''' that are included as part | |||
of the text.) | |||
</pre> | |||
|- | |||
| | |||
A single newline | |||
generally has no effect on the layout. | |||
These can be used to separate | |||
sentences within a paragraph. | |||
Some editors find that this aids editing | |||
and improves the ''diff'' function | |||
(used internally to compare | |||
different versions of a page). | |||
But an empty line | |||
starts a new paragraph. | |||
When used in a list, a newline ''does'' affect the layout ([[#lists|see below]]). | |||
|<pre> | |||
A single newline | |||
generally has no effect on the layout. | |||
These can be used to separate | |||
sentences within a paragraph. | |||
Some editors find that this aids editing | |||
and improves the ''diff'' function | |||
(used internally to compare | |||
different versions of a page). | |||
But an empty line | |||
starts a new paragraph. | |||
When used in a list, a newline ''does'' | |||
affect the layout ([[#lists|see below]]). | |||
</pre> | |||
|- | |||
| | |||
You can break lines<br/> | |||
without a new paragraph.<br/> | |||
Please use this sparingly. | |||
|} | |||
== Organizing your writing == | |||
*From [http://en.wikipedia.org/wiki/Help:Wikitext_examples WikiText Examples] | |||
{| border="1" cellpadding="2" | |||
!width="1000"|What it looks like | |||
!width="500"|What you type | |||
|- | |||
| | |||
<div style="font-size:150%;border-bottom:1px solid #000000;">Section headings</div> | |||
''Headings'' organize your writing into | |||
sections. The Wiki software can automatically | |||
generate a [[Help:table of contents|table of contents]] from them. | |||
<div style="font-size:132%;font-weight:bold;">Subsection</div> | |||
Using more "equals" (=) signs creates a subsection. | |||
<div style="font-size:116%;font-weight:bold;">A smaller subsection</div> | |||
Don't skip levels, like from two to four equals signs. | |||
Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title. | |||
|<pre> | |||
== 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 2 equals signs not 1 | |||
because 1 creates H1 tags | |||
which should be reserved for page title. | |||
</pre> | |||
|- id="lists" | |||
| | |||
* ''Unordered [[Help:List|list]]s'' are easy to do: | |||
** Start every line with a star. | |||
*** More stars indicate a deeper level. | |||
*: Previous item continues. | |||
** A newline | |||
* in a list | |||
marks the end of the list. | |||
*Of course you can start again. | |||
|<pre> | |||
* ''Unordered lists'' are easy to do: | |||
** Start every line with a star. | |||
*** More stars indicate a deeper level. | |||
*: Previous item continues. | |||
** A newline | |||
* in a list | |||
marks the end of the list. | |||
*Of course you can start again. | |||
</pre> | |||
|- | |||
| | |||
# ''Numbered lists'' are: | |||
## Very organized | |||
## Easy to follow | |||
A newline marks the end of the list. | |||
# New numbering starts with 1. | |||
|<pre> | |||
# ''Numbered lists'' are: | |||
## Very organized | |||
## Easy to follow | |||
A newline marks the end of the list. | |||
# New numbering starts with 1. | |||
</pre> | |||
|- | |||
| | |||
Here's a ''definition list'': | |||
; Word : Definition of the word | |||
; A longer phrase needing definition | |||
: Phrase defined | |||
; A word : Which has a definition | |||
: Also a second one | |||
: And even a third | |||
Begin with a semicolon. One item per line; | |||
a newline can appear before the colon, but | |||
using a space before the colon improves | |||
parsing. | |||
|<pre> | |||
Here's a ''definition list'': | |||
; Word : Definition of the word | |||
; A longer phrase needing definition | |||
: Phrase defined | |||
; A word : Which has a definition | |||
: Also a second one | |||
: And even a third | |||
Begin with a semicolon. One item per line; | |||
a newline can appear before the colon, but | |||
using a space before the colon improves | |||
parsing. | |||
</pre> | |||
|- | |||
| | |||
* You can even do mixed lists | |||
*# and nest them | |||
*# inside each other | |||
*#* or break lines<br>in lists. | |||
*#; definition lists | |||
*#: can be | |||
*#:; nested : too | |||
|<pre> | |||
* You can even do mixed lists | |||
*# and nest them | |||
*# inside each other | |||
*#* or break lines<br>in lists. | |||
*#; definition lists | |||
*#: can be | |||
*#:; nested : too | |||
</pre> | |||
|- | |||
| | |||
: A colon (:) indents a line or paragraph. | |||
A newline starts a new paragraph. <br> | |||
Should only be used on [[talk pages]]. <br> | |||
For articles, you probably want the blockquote tag. | |||
: We use 1 colon to indent once. | |||
:: We use 2 colons to indent twice. | |||
::: 3 colons to indent 3 times, and so on. | |||
|<pre> | |||
: A colon (:) indents a line or paragraph. | |||
A newline starts a new paragraph. | |||
Should only be used on talk pages. | |||
For articles, you probably want the blockquote tag. | |||
: We use 1 colon to indent once. | |||
:: We use 2 colons to indent twice. | |||
::: 3 colons to indent 3 times, and so on. | |||
</pre> | |||
|- | |||
| | |||
You can make [[w: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> | |||
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. | |||
</pre> | |||
|- | |||
| | |||
You can add footnotes to sentences using the ''ref'' tag -- this is especially good for citing a source. | |||
:There are over six billion people in the world.<ref>CIA World Factbook, 2006.</ref> | |||
References: <references/> | |||
For details, see [[Wikipedia:Footnotes]] and [[Help:Footnotes]]. | |||
| | |||
<pre> | |||
You can add footnotes to sentences using | |||
the ''ref'' tag -- this is especially good | |||
for citing a source. | |||
:There are over six billion people in the | |||
world.<ref>CIA World Factbook, 2006.</ref> | |||
References: <references/> | |||
For details, see [[Wikipedia:Footnotes]] | |||
and [[Help:Footnotes]]. | |||
</pre> | |||
|} | |||
== Links == | |||
*From [http://en.wikipedia.org/wiki/Help:Wikitext_examples WikiText Examples] | |||
You will often want to make clickable ''links'' to other pages. | |||
{|width="100%" border="1" cellpadding="2" cellspacing="0" | |||
|- | |||
!What it looks like | |||
!What you type | |||
|- | |||
| | |||
Here's a link to a page named [[Official position]]. | |||
You can even say [[official position]]s | |||
and the link will show up correctly. | |||
|<pre> | |||
Here's a link to a page named [[Official position]]. | |||
You can even say [[official position]]s | |||
and the link will show up correctly. | |||
</pre> | |||
|- | |||
| | |||
You can put formatting around a link. | |||
Example: ''[[Wikipedia]]''. | |||
|<pre> | |||
You can put formatting around a link. | |||
Example: ''[[Wikipedia]]''. | |||
</pre> | |||
|- | |||
| | |||
The ''first letter'' of articles is automatically | |||
capitalized, so [[wikipedia]] goes to the same place | |||
as [[Wikipedia]]. Capitalization matters after the | |||
first letter. | |||
|<pre> | |||
The ''first letter'' of articles is automatically | |||
capitalized, so [[wikipedia]] goes to the same place | |||
as [[Wikipedia]]. Capitalization matters after the | |||
first letter. | |||
</pre> | |||
|- | |||
| | |||
[[Intentionally permanent red link]] is a page that doesn't exist | |||
yet. You could create it by clicking on the link. | |||
|<pre> | |||
[[Intentionally permanent red link]] is a page that doesn't exist | |||
yet. You could create it by clicking on the link. | |||
</pre> | |||
|- | |||
| | |||
You can link to a page section by its title: | |||
* [[List of cities by country#Morocco]]. | |||
If multiple sections have the same title, add | |||
a number. [[#Example section 3]] goes to the | |||
third section named "Example section". | |||
|<pre> | |||
You can link to a page section by its title: | |||
* [[List of cities by country#Morocco]]. | |||
If multiple sections have the same title, add | |||
a number. [[#Example section 3]] goes to the | |||
third section named "Example section". | |||
</pre> | |||
|- | |||
| | |||
You can make a link point to a different place | |||
with a [[Help:Piped link|piped link]]. Put the link | |||
target first, then the pipe character "|", then | |||
the link text. | |||
* [[Help:Link|About Links]] | |||
* [[List of cities by country#Morocco|Cities in Morocco]] | |||
Or you can use the "pipe trick" so that a title that | |||
contains disambiguation text will appear with more concise | |||
link text. | |||
* [[Spinning (textiles)|Spinning]] | |||
* [[Boston, Massachusetts|Boston]] | |||
|<pre> | |||
You can make a link point to a different place | |||
with a [[Help:Piped link|piped link]]. Put the link | |||
target first, then the pipe character "|", then | |||
the link text. | |||
* [[Help:Link|About Links]] | |||
* [[List of cities by country#Morocco|Cities in Morocco]] | |||
Or you can use the "pipe trick" so that a title that | |||
contains disambiguation text will appear with more concise | |||
link text. | |||
* [[Spinning (textiles)|]] | |||
* [[Boston, Massachusetts|]] | |||
</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] | |||
External link can be used to link to a wiki page that cannot be linked to with <nowiki>[[page]]</nowiki>: | |||
http://meta.wikimedia.org/w/index.php?title=Fotonotes&oldid=482030#Installation | |||
| | |||
<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] | |||
External link can be used to link to a wiki page that | |||
cannot be linked to with <nowiki>[[page]]</nowiki>: | |||
http://meta.wikimedia.org/w/index.php?title=Fotonotes | |||
&oldid=482030#Installation | |||
</pre> | |||
|- | |||
| | |||
Linking to an e-mail address works the same way: | |||
mailto:someone@example.com or [mailto:someone@example.com someone] | |||
| | |||
<pre> | |||
Linking to an e-mail address works the same way: | |||
mailto:someone@example.com or [mailto:someone@example.com someone] | |||
</pre> | |||
|- | |||
| | |||
You can [[Help:Redirect|redirect]] the user to another page. | |||
|<pre> | |||
#REDIRECT [[Official position]] | |||
</pre> | |||
|- | |||
| | |||
[[Help:Category|Category links]] do not show up in line | |||
but instead at page bottom ''and cause the page to be | |||
listed in the category.'' | |||
Add an extra colon to ''link'' to a category in line | |||
without causing the page to be listed in the category: | |||
[[:Category:English documentation]] | |||
|<pre> | |||
[[Help:Category|Category links]] do not show up in line | |||
but instead at page bottom ''and cause the page to be | |||
listed in the category.'' | |||
[[Category:English documentation]] | |||
Add an extra colon to ''link'' to a category in line | |||
without causing the page to be listed in the category: | |||
[[:Category:English documentation]] | |||
</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]]: | |||
* [[1969-07-20]] | |||
* [[July 20]], [[1969]] | |||
* [[20 July]] [[1969]] | |||
|<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|]]: | |||
* [[1969-07-20]] | |||
* [[July 20]], [[1969]] | |||
* [[20 July]] [[1969]] | |||
</pre> | |||
|} | |||
== See Also == | == See Also == | ||
[http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page Wikipedia Editing Article] | [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page Main Wikipedia Editing Article] |
Revision as of 20:26, 21 November 2008
In the hope that Community Bike Shops will share knowledge via the Bike Collectives Wiki, this page provides examples of basic wiki editing and links to websites with additional information.
Basic text formatting
- From WikiText Examples
You can format the page using Wikitext special characters.
What it looks like | What you type |
---|---|
You can italicize text by putting 2 apostrophes on each side. 3 apostrophes will bold the text. 5 apostrophes will bold and italicize the text. (Using 4 apostrophes doesn't do anything special -- |
You can ''italicize text'' by putting 2 apostrophes on each side. 3 apostrophes will '''bold the text'''. 5 apostrophes will '''bold''' and ''italicize'' '''''the text'''''. (Using 4 apostrophes doesn't do anything special -- <br /> they are just ''''left over ones'''' that are included as part of the text.) |
A single newline generally has no effect on the layout. These can be used to separate sentences within a paragraph. Some editors find that this aids editing and improves the diff function (used internally to compare different versions of a page). But an empty line starts a new paragraph. When used in a list, a newline does affect the layout (see below). |
A single newline generally has no effect on the layout. These can be used to separate sentences within a paragraph. Some editors find that this aids editing and improves the ''diff'' function (used internally to compare different versions of a page). But an empty line starts a new paragraph. When used in a list, a newline ''does'' affect the layout ([[#lists|see below]]). |
You can break lines |
Organizing your writing
- From WikiText Examples
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 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title. |
== 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 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title. |
marks the end of the list.
|
* ''Unordered lists'' are easy to do: ** Start every line with a star. *** More stars indicate a deeper level. *: Previous item continues. ** A newline * in a list marks the end of the list. *Of course you can start again. |
A newline marks the end of the list.
|
# ''Numbered lists'' are: ## Very organized ## Easy to follow A newline marks the end of the list. # New numbering starts with 1. |
Here's a definition list:
Begin with a semicolon. One item per line; a newline can appear before the colon, but using a space before the colon improves parsing. |
Here's a ''definition list'': ; Word : Definition of the word ; A longer phrase needing definition : Phrase defined ; A word : Which has a definition : Also a second one : And even a third Begin with a semicolon. One item per line; a newline can appear before the colon, but using a space before the colon improves parsing. |
|
* You can even do mixed lists *# and nest them *# inside each other *#* or break lines<br>in lists. *#; definition lists *#: can be *#:; nested : too |
A newline starts a new paragraph.
|
: A colon (:) indents a line or paragraph. A newline starts a new paragraph. Should only be used on talk pages. For articles, you probably want the blockquote tag. : We use 1 colon to indent once. :: We use 2 colons to indent twice. ::: 3 colons to indent 3 times, and so on. |
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. |
You can add footnotes to sentences using the ref tag -- this is especially good for citing a source.
References: <references/> For details, see Wikipedia:Footnotes and Help:Footnotes. |
You can add footnotes to sentences using the ''ref'' tag -- this is especially good for citing a source. :There are over six billion people in the world.<ref>CIA World Factbook, 2006.</ref> References: <references/> For details, see [[Wikipedia:Footnotes]] and [[Help:Footnotes]]. |
Links
- From WikiText Examples
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 Official position. You can even say official positions and the link will show up correctly. |
Here's a link to a page named [[Official position]]. You can even say [[official position]]s and the link will show up correctly. |
You can put formatting around a link. Example: Wikipedia. |
You can put formatting around a link. Example: ''[[Wikipedia]]''. |
The first letter of articles is automatically capitalized, so wikipedia goes to the same place as Wikipedia. Capitalization matters after the first letter. |
The ''first letter'' of articles is automatically capitalized, so [[wikipedia]] goes to the same place as [[Wikipedia]]. Capitalization matters after the first letter. |
Intentionally permanent red link is a page that doesn't exist yet. You could create it by clicking on the link. |
[[Intentionally permanent red link]] is a page that doesn't exist yet. You could create it by clicking on the link. |
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: * [[List of cities by country#Morocco]]. 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. Or you can use the "pipe trick" so that a title that contains disambiguation text will appear with more concise link text. |
You can make a link point to a different place with a [[Help:Piped link|piped link]]. Put the link target first, then the pipe character "|", then the link text. * [[Help:Link|About Links]] * [[List of cities by country#Morocco|Cities in Morocco]] Or you can use the "pipe trick" so that a title that contains disambiguation text will appear with more concise link text. * [[Spinning (textiles)|]] * [[Boston, Massachusetts|]] |
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] External link can be used to link to a wiki page that cannot be linked to with [[page]]: http://meta.wikimedia.org/w/index.php?title=Fotonotes&oldid=482030#Installation |
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] External link can be used to link to a wiki page that cannot be linked to with [[page]]: http://meta.wikimedia.org/w/index.php?title=Fotonotes &oldid=482030#Installation |
Linking to an e-mail address works the same way: mailto:someone@example.com or someone |
Linking to an e-mail address works the same way: mailto:someone@example.com or [mailto:someone@example.com someone] |
You can redirect the user to another page. |
#REDIRECT [[Official position]] |
Category links do not show up in line but instead at page bottom and cause the page to be listed in the category. Add an extra colon to link to a category in line without causing the page to be listed in the category: Category:English documentation |
[[Help:Category|Category links]] do not show up in line but instead at page bottom ''and cause the page to be listed in the category.'' [[Category:English documentation]] Add an extra colon to ''link'' to a category in line without causing the page to be listed in the category: [[:Category:English documentation]] |
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|]]: * [[1969-07-20]] * [[July 20]], [[1969]] * [[20 July]] [[1969]] |