Difference between revisions of "Help:A CWC Guide to Wiki Editing"

From CWCki
Jump to navigation Jump to search
(Created page with 'Editing the CWCki does not and should not depend on knowledge about Chris. One can have no idea who Chris is and still be a valued CWCki editor. The following is a "cwc" (pro…')
 
Line 1: Line 1:
Editing the [[CWCki]] does not and should not depend on knowledge about Chris. One can have no idea who Chris is and still be a valued CWCki editor. The following is a "cwc" (pronounced "quick") guide to the basics of wiki editing.
Editing the [[CWCki]] does not and should not depend on knowledge about Chris. One can have no idea who Chris is and still be a valued CWCki editor. The following is a "cwc" (pronounced "quick") guide to the basics of wiki editing.
==Editing==
Editing most CWCki pages is simple. Simply click on the "'''edit'''" tab at the top of a CWCki page. This will bring you to a new page with a text box containing the editable text of the current page.
===Minor edits===
A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo corrections, formatting and presentational changes, rearranging of text without modifying content, etc.
===Talk (discussion) pages===
Talk pages are similar to articles in that they also have a "new section" tab to start a new section or edit the whole page. One thing to remember is that that are exclusively for discussing improvements made to the article, they are
[[CWCki:NOTAFORUM|not to discuss the article's subject itself.]]
==Formatting==
===Sections===
====Section headings====
Use headings to split articles into sections. Put a heading on a separate line. A level-two heading is the highest level editors use in an article.
{| class="wikitable"
! style="width: 50%" | What it looks like
! style="width: 50%" | What you type
|-
|
<div style="font-size:150%;border-bottom:1px solid rgb(170,170,170);">Section headings</div>
''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.
Start with 2 'equals' characters.
<div style="font-size:132%;font-weight:bold;">Subsection</div>
Using more 'equals' characters 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' characters.
;A non-TOC subsection
A semicolon at the start of a line is a way of making headings
that don't appear in the Table of Contents. It actually bolds the
entire line (see [[#Text formatting|below]]).
|<pre>
==Section headings==
''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.
Start with 2 'equals' characters.
===Subsection===
Using more 'equals' characters creates a subsection.
====A smaller subsection====
Don't skip levels, like from two to four 'equals' characters.
;A non-TOC subsection
A semicolon at the start of a line is a way of making headings
that don't appear in the [[WP:TOC|TOC]]. It actually bolds the
entire line (see [[#Text formatting|below]]).
</pre>
|-
|'''Horizontal line'''
Separating with a horizontal dividing line:<br/>
:this is above it...
----
:...and this is below it.
If you don't use a section header, you don't get a TOC entry.
|<pre><nowiki>'''Horizontal line'''
Separating with a horizontal dividing line:
:this is above it...
----
:...and this is below it.
If you don't use a section header, you don't get a TOC entry.
</nowiki></pre>
|}
====Table of contents====
When a page has at least four headings, a table of contents (TOC) will appear in front of the first header (after the lead).  Putting <nowiki>__TOC__</nowiki> anywhere forces the TOC to appear at that point (instead of just before the first heading). Putting <nowiki>__NOTOC__</nowiki> anywhere forces the TOC to disappear.
===Line breaks===
* You can make the wikitext more readable by putting in newlines.
* To break lines use the <code><nowiki><br /></nowiki></code> element. The HTML tag <code><nowiki><br></nowiki></code> will be converted to the XHTML <code><nowiki><br /></nowiki></code> tag by HTML Tidy in most instances.
* Please use these sparingly.
* Close markup between lines; do not start a link or ''italics'' or '''bold''' on one line and close it on the next.
* When used in a list, a newline ''does'' affect the layout.
{| class="wikitable"
! style="width: 50%" | What it looks like
! style="width: 50%" | What you type
|-
|
A single newline has no
effect on the layout.
But an empty line starts a new paragraph, or ends a list or indented part.
|
<pre><nowiki>
A single newline has no
effect on the layout.
But an empty line starts a new paragraph, or ends a list or indented part.
</nowiki></pre>
|-
|
You can break lines<br />
without starting a new paragraph.
|
<pre><nowiki>You can break lines<br />
without starting a new paragraph.</nowiki></pre>
|}
===Indent text===
{| class="wikitable"
! What it looks like
! What you type
|-
| colspan="2"|
'''Left indent'''
|-
|
:A colon at the start of a line
::causes the line to be indented,
:::most commonly used on Talk pages.
|
<pre><nowiki>
:A colon at the start of a line
::causes the line to be indented,
:::most commonly used on Talk pages.
</nowiki></pre>
|-
| colspan="2"|
'''Blockquote'''<br/>
When there is a need for separating a block of text. This is useful for (as the name says) inserting blocks of quoted (and cited) text.
|-
|
<blockquote>
The '''blockquote''' tag will indent both margins when needed instead of the left margin only as the colon does.
</blockquote>
|
<code><nowiki>
<blockquote>
The '''blockquote''' tag will indent both margins when needed instead of the left margin only as the colon does.
</blockquote>
</nowiki></code>
|}
===Center text===
{| class="wikitable"
! style="width: 50%" | What it looks like
! style="width: 50%" | What you type
|-
|<div class="center" style="width:auto; margin-left:auto; margin-right:auto;">Centered text</div>
|<code><nowiki><div class="center" style="width:auto; margin-left:auto; margin-right:auto;">Centered text</div> </nowiki></code>
|}
===Lists===
{| class="wikitable"
! style="width: 50%" | What it looks like
! style="width: 50%" | What you type
|- id="lists"
|
* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
**: Previous item continues.
** A new line
* 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 new line
* in a list
marks the end of the list.
* Of course you can start again.
</pre>
|-
|
# ''Numbered lists'' are:
## Very organized
## Easy to follow
#: Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.
|<pre>
# ''Numbered lists'' are:
## Very organized
## Easy to follow
#: Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.
</pre>
|}
==See also==
[[Help:A_Quick_Guide_to_CWCki|A Quick Guide to CWCki]]


{{stub}}
{{stub}}

Revision as of 00:00, 17 December 2011

Editing the CWCki does not and should not depend on knowledge about Chris. One can have no idea who Chris is and still be a valued CWCki editor. The following is a "cwc" (pronounced "quick") guide to the basics of wiki editing.

Editing

Editing most CWCki pages is simple. Simply click on the "edit" tab at the top of a CWCki page. This will bring you to a new page with a text box containing the editable text of the current page.

Minor edits

A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo corrections, formatting and presentational changes, rearranging of text without modifying content, etc.

Talk (discussion) pages

Talk pages are similar to articles in that they also have a "new section" tab to start a new section or edit the whole page. One thing to remember is that that are exclusively for discussing improvements made to the article, they are not to discuss the article's subject itself.

Formatting

Sections

Section headings

Use headings to split articles into sections. Put a heading on a separate line. A level-two heading is the highest level editors use in an article.

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. Start with 2 'equals' characters.

Subsection

Using more 'equals' characters creates a subsection.

A smaller subsection

Don't skip levels, like from two to four 'equals' characters.

A non-TOC subsection

A semicolon at the start of a line is a way of making headings that don't appear in the Table of Contents. It actually bolds the entire line (see below).

==Section headings==

''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.
Start with 2 'equals' characters.

===Subsection===

Using more 'equals' characters creates a subsection.

====A smaller subsection====

Don't skip levels, like from two to four 'equals' characters.

;A non-TOC subsection
A semicolon at the start of a line is a way of making headings
that don't appear in the [[WP:TOC|TOC]]. It actually bolds the
entire line (see [[#Text formatting|below]]).
Horizontal line

Separating with a horizontal dividing line:

this is above it...

...and this is below it.

If you don't use a section header, you don't get a TOC entry.

'''Horizontal line'''
Separating with a horizontal dividing line:
:this is above it...
----
:...and this is below it.
If you don't use a section header, you don't get a TOC entry.

Table of contents

When a page has at least four headings, a table of contents (TOC) will appear in front of the first header (after the lead). Putting __TOC__ anywhere forces the TOC to appear at that point (instead of just before the first heading). Putting __NOTOC__ anywhere forces the TOC to disappear.

Line breaks

  • You can make the wikitext more readable by putting in newlines.
  • To break lines use the <br /> element. The HTML tag <br> will be converted to the XHTML <br /> tag by HTML Tidy in most instances.
  • Please use these sparingly.
  • Close markup between lines; do not start a link or italics or bold on one line and close it on the next.
  • When used in a list, a newline does affect the layout.
What it looks like What you type

A single newline has no effect on the layout.

But an empty line starts a new paragraph, or ends a list or indented part.

A single newline has no
effect on the layout.

But an empty line starts a new paragraph, or ends a list or indented part.

You can break lines
without starting a new paragraph.

You can break lines<br />
without starting a new paragraph.

Indent text

What it looks like What you type

Left indent

A colon at the start of a line
causes the line to be indented,
most commonly used on Talk pages.
:A colon at the start of a line
::causes the line to be indented,
:::most commonly used on Talk pages.

Blockquote
When there is a need for separating a block of text. This is useful for (as the name says) inserting blocks of quoted (and cited) text.

The blockquote tag will indent both margins when needed instead of the left margin only as the colon does.

<blockquote> The '''blockquote''' tag will indent both margins when needed instead of the left margin only as the colon does. </blockquote>

Center text

What it looks like What you type
Centered text
<div class="center" style="width:auto; margin-left:auto; margin-right:auto;">Centered text</div>

Lists

What it looks like What you type
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
      Previous item continues.
    • A new line
  • 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.
**: Previous item continues.
** A new line
* in a list
marks the end of the list.
* Of course you can start again.
  1. Numbered lists are:
    1. Very organized
    2. Easy to follow
    Previous item continues

A new line marks the end of the list.

  1. New numbering starts with 1.
# ''Numbered lists'' are:
## Very organized
## Easy to follow
#: Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.

See also

A Quick Guide to CWCki