Help:Editing

From KCpedia

Jump to: navigation, search

KCpedia is a Wiki, which means that anyone can easily edit any unprotected article or discussion page and have those changes posted immediately to that page.

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.

Contents

Editing basics

Start editing
To start editing a KCpedia article page, click on the "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 just want to experiment, please do so in the sandbox, not here. Please note that in order to edit KCpedia content, you must first create an account and login to the server.
Summarize your changes
You should write a short Edit summary in the small field below the edit-box. This field, limited to 200 characters should be used to describe the changes made in your edit.
Preview before saving
When you have finished, press Show 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.
Discussion pages
You can also click on the "Discussion" tab to see the corresponding talk page, which contains stories or perspectives about the article topic contributed by other KCpedia contributors. Click on the "+" tab to add a new section, or edit the page in the same way as an article page. When editing talk pages, please sign your contribution.
Neutral Point of View
Always use a neutral point of view in articles, as KCpedia is not a place to promote points of view. Write as if the information is a non-judgmental news article. It is acceptable to show two sides of an argument if appropriate, as long as you do not include personal opinion or judgment on which is correct. Discussion pages can be more subjective.
Citations
Cite your sources: readers want to know where information comes from; other editors may want to check and extend your work. Please help by researching online and print resources to find references for the article you are working on, then cite them in proper form, and consider in-text citation for contentious facts. The preferred method of citation is using footnotes and following Turabian's Style Manual.
After making a new page, it's a good idea to
  • use What links here (with your page displayed) to check the articles that already link to it, and make sure that they are all expecting the same meaning that you have supplied; and
  • use the Search button to search KCpedia for your topic title—and possible variants—to find articles that mention it, and make links from them if appropriate.

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

  • If you want to try out things without danger of doing any harm, you can do so in the KCpedia:Sandbox.

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: Christopher Barth
Four tildes give your user name plus date/time: Christopher Barth 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

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>

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.

:A colon indents a line or paragraph.
A newline after that starts a new paragraph.

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.

Commenting page source:
not shown when viewing page

  • Used to leave comments in a page for future editors.


<!-- comment here -->

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 Commencement. You can even say commencements and the link will show up right.

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

The first letter will automatically be capitalized, so collegian goes to the same place as Collegian. Capitalization matters after the first letter.

The weather in Gambier 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 [[Commencement]].
You can even say [[commencement]]s
and the link will show up right.

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

The ''first letter'' will automatically be capitalized,
so [[collegian]] is the same as [[Collegian]].
Capitalization matters after the first letter.

[[The weather in Gambier]] is a page that doesn't exist
yet. You can 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:

*[[Editing#Editing basics]].
*[[Editing#Tips and tricks]].

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 piped link. Put the link
target first, then the pipe character "|", then
the link text.

*[[Help:Contents|Index to Help Documents]]
*[[Help:Editing#Editing basics|
Introduction to Editing]]

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

You can give it a title: Kenyon College

Or leave the title blank: [1]

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

You can give it a title:
[http://www.kenyon.edu Kenyon College]

Or leave the title blank:
[http://www.kenyon.edu]

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:KCpedia Help

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

Add an extra colon to actually link to the category:
[[:Category:KCpedia Help]]

Link to books using their ISBN. This is preferred to linking to a specific online bookstore, because it gives the reader a choice of vendors. ISBN links do not need any extra markup, provided you use one of the indicated formats.

ISBN 012345678X

ISBN 0-12-345678-X

ISBN 012345678X

ISBN 0-12-345678-X

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'' like [[Philander Chase]]. It reformats text by removing newlines and multiple spaces. It still interprets special characters: →

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

</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 Wiki markup like Philander Chase 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 Wiki ''markup'' like [[Philander Chase]] and special
 characters: &rarr;

Images, Media, Tables

Only images that have been uploaded to KCpedia can be used. To upload images, use the upload page. You can find the uploaded image on the image list.

What it looks like What you type
A picture:

Image:P-douglass.jpg

A picture: 
[[Image:P-douglass.jpg]]


With alternative text:

David Bates Douglass

With alternative text:
[[Image:P-douglass.jpg|David Bates Douglass]]
  • Alternative text, used when a mouse hovers over the image, when the image is loaded in a text-only browser, or when spoken aloud, is strongly encouraged.


Floating to the right side of the page and with a caption:
David Bates Douglass

Floating to the right side of the page and with a caption:
[[Image:P-douglass.jpg|frame|David Bates Douglass]]
  • The frame tag automatically floats the image right.
  • The caption is also used as alternate text.


Floating to the right side of the page without a caption:
David Bates Douglass
Floating to the right side of the page ''without'' a caption:
[[Image:P-douglass.jpg|right|David Bates Douglass]]

A link to KCpedia's page for the image: Image:P-douglass.jpg

Or a link directly to the image itself: Media:P-douglass.jpg

A link to KCpedia's page for the image:
[[:Image:P-douglass.jpg]]

Or a link directly to the image itself:
[[Media:P-douglass.jpg]]

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

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

See the KCpedia's image use policy as a guideline used on KCpedia.

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

This text comes from the page named Template:Transclusion demo. It has been transcluded into this page.

{{Transclusion demo}}

This template takes two parameters, and creates underlined text with a hover box:

Hover your mouse over this text

Go to this page to see the H:title template itself.

This template takes two parameters, and creates
underlined text with a hover box:

{{H:title|This is the hover text|
Hover your mouse over this text}}

Go to [[template:H:title|this page]] to see the H:title template itself.

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.

Table of contents

Having at least four headers on a page triggers a "table of contents" (a clickable list of section headers) to appear just before the first header, after any introductory text. You can modify this behavior by putting one of the following tags in the page:

  • __TOC__ - places a table of contents at the exact spot on the page where this tag is positioned.
  • __NOTOC__ - disables the automatic table of contents
  • __FORCETOC__ - a table of contents is added even if the page has fewer than four headings

Variables

Code Effect
{{CURRENTMONTH}} 07
{{CURRENTMONTHNAME}} July
{{CURRENTMONTHNAMEGEN}} July
{{CURRENTDAY}} 30
{{CURRENTDAYNAME}} Friday
{{CURRENTYEAR}} 2010
{{CURRENTTIME}} 02:22
{{NUMBEROFARTICLES}} 1,031
{{PAGENAME}} Editing
{{NAMESPACE}} Help
{{REVISIONID}} 5535
{{localurl:pagename}} /kcpedia/Pagename
{{localurl:KCpedia:Sandbox|action=edit}} /k/index.php?title=KCpedia:Sandbox&action=edit
{{SERVER}} http://www.kenyonhistory.net
{{ns:1}} Talk
{{ns:2}} User
{{ns:3}} User talk
{{ns:4}} KCpedia
{{ns:5}} KCpedia talk
{{ns:6}} File
{{ns:7}} File talk
{{ns:8}} MediaWiki
{{ns:9}} MediaWiki talk
{{ns:10}} Template
{{ns:11}} Template talk
{{ns:12}} Help
{{ns:13}} Help talk
{{ns:14}} Category
{{ns:15}} Category talk
{{SITENAME}} KCpedia

NUMBEROFARTICLES is the number of pages in the main namespace which contain a link and are not a redirect--in other words, it is the number of articles, stubs containing a link, and disambiguation pages.

CURRENTMONTHNAMEGEN is the genitive (possessive) grammatical form of the month name, as used in some languages; CURRENTMONTHNAME is the nominative (subject) form, as usually seen in English.

In languages where it makes a difference, you can use constructs like {{grammar:case|word}} to convert a word from the nominative case to some other case. For example, {{grammar:genitive|{{CURRENTMONTHNAME}}}} means the same as {{CURRENTMONTHNAMEGEN}}.

Links to editing pages

The variables mentioned above can be used to create links to talk, editing, history, and other useful pages associated with an article. (Generally to be avoided in articles, but sometimes useful in project pages.)

  • [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} edit]
  • [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=history}} history]
  • [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=watch}} watch]
  • [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=unwatch}} unwatch]
  • [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=purge}} purge]

Hiding the edit links

Insert __NOEDITSECTION__ into the document to suppress the edit links that appear next to every section header.

More information on editing wiki pages

You may also want to learn about:

This page is derived from [Wikipedia] and is covered under the [GNU Free Documentation License].

Personal tools