How to edit a page

From AgeofWiki

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

Editing a Wiki page is very easy. Simply click on the "edit" tab at the top of a Wiki page. This will bring you to a page with a text box containing the editable text of that page. If you just want to experiment, please do so in the sandbox instead of on other pages. Alternatively, you can press the " Show Preview" button instead of actually saving the page. You should write a short edit summary in the small field below the edit-box. You may use shorthand to describe your changes, and when you have finished, press preview to see how your changes will look. You can also see what changes you have made in comparison to the previous version by pressing the Show Changes button. If you're happy with what you see, then press "Save" and your changes will be immediately applied to the article. Don't "sign" edits you make to regular articles (the software keeps track of who makes every change).

You can also click on the "Discussion" tab to see the corresponding talk page. 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 change using --~~~~

Table of contents

Tips on editing AgeofWiki articles

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 AgeofWiki for your topic title—and possible variants—to find articles that mention it, and make links from them if appropriate.

Minor edits

When editing a page, logged-in user can mark that edit as being "minor." Minor edits generally mean spelling corrections, formatting, and minor rearrangement of text. It is possible to hide minor edits when viewing Special:Recent Changes. Marking a significant change as a minor edit is considered bad behavior, and even more so if it involves the deletion of some text. If one has accidentally marked an edit as minor, the person should edit the source once more, mark it major (or, rather, ensure that the check-box for "This is a minor edit" is not checked), and, in the summary, state that the previous change was a major one.

Major edits

All editors are encouraged to Be Bold, but there are several things that a user can do to ensure that major edits are performed smoothly. Before engaging in a major edit, consider discussing proposed changes on the article discussion/talk page. Once the edit has been completed, the inclusion of an edit summary will assist in documenting the changes. These steps will all help to ensure that major edits are well received by the AgeofWiki community.

Wiki markup

The wiki markup is the syntax system you can use to format an AgeofWiki page.

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, or take a screen-shot of it. If you want to try out things without danger of doing any harm, you can do so in the Sandbox. Try opening the Sandbox in a separate window or tab and keeping this page open for reference.

What it looks like What you type

Start your sections as follows:


New section<h2>

Subsection<h3>

Sub-subsection<h4>

Sub-sub-subsection<h5>
  • Start with a second-level heading (==); don't use first-level headings (=).
  • Don't skip levels (for example, second-level followed by fourth-level).
  • A table of contents will automatically be added to an article that has four or more sections.
== New section ==

=== Subsection ===

==== Sub-subsection ====

===== Sub-sub-subsection =====

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 function diff (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.
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 function ''diff'' 
(used internally to compare
different versions of a page).

But an empty line
starts a new paragraph.

You can break lines
without starting a new paragraph.

  • Please use this sparingly.
  • Close markup between lines; do not start a link or italics or bold on one line and close it on the next.
You can break lines<br/>
without starting a new paragraph.
  • It's easy to create a list:
    • Start every line with a star.
      • More stars means deeper levels.
        • A newline in a list

marks the end of a list item.

  • An empty line starts a new list.
* It's easy to create a list:
** Start every line with a star.
*** More stars means deeper levels.
**** A newline in a list
marks the end of a list item.

* An empty line starts a new list.
  1. Numbered lists are also good
    1. very organized
    2. easy to follow
      1. easier still
# Numbered lists are also good
## very organized
## easy to follow
### easier still
  • You can even create mixed lists
    1. and nest them
      • like this
* You can even create mixed lists
*# and nest them
*#* like this
Definition list 
list of definitions
item 
the item's definition
another item
the other item's definition
  • One item per line; a newline can appear before the colon, but using a space before the colon improves parsing.
; Definition list : list of definitions
; item : the item's definition
; another item
: the other item's definition
A colon indents a line or paragraph.

A manual newline starts a new paragraph.

  • This is primarily for displayed material, but is also used for discussion on Talk pages.
: A colon indents a line or paragraph.
A manual newline starts a new paragraph.

When there is a need for separating a block of text

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

This is useful for (as the name says) inserting blocks of quoted (and cited) text.

<blockquote>
The '''blockquote''' command will indent 
both margins when needed instead of the 
left margin only as the colon does.  
</blockquote>
IF a line starts with a space THEN
   it will be formatted exactly
   as typed;
   in a fixed-width font;
   lines will not wrap;
ENDIF

For larger preformatted text passages you can use the <pre>a lot of text</pre> tag.

  • This is useful for:
    • pasting preformatted text;
    • program source code;
    • ASCII art;
  • WARNING: If you make it wide, you force the whole page to be wide and hence less readable, especially for people who use lower resolutions. Never start ordinary lines with spaces.
 IF a line starts with a space THEN
    it will be formatted exactly
    as typed;
    in a fixed-width font;
    lines will not wrap;
 ENDIF
Centered text.
  • Please note the American spelling of "center."
<center>Centered text.</center>

A horizontal dividing line: this is above it...


...and this is below it.

  • Mainly useful for
    • disambiguation - but to be used sparsely--only when separating completely different, unrelated (groups of) meanings
    • separating threads on Talk pages.
A horizontal dividing line:
this is above it...
----
...and this is below it.

Links and URLs

What it looks like What you type

I love Triggers.

  • A link to another AgeofWiki article.
  • Internally, the first letter of the target page is automatically capitalized and spaces are represented as underscores (typing an underscore in the link has the same effect as typing a space, but is not recommended).
  • Thus the link above is to the URL http://wiki.heavengames.com/age/index.php/Triggers, which is the AgeofWiki article with the name "Triggers".
She also [[Triggers|loves triggers]].

She also loves triggers.

  • Same target, different name.
  • The text before the pipe | is the link, the second is the text that appears on the screen.
  • The "piped" text must be placed first, the text that will be displayed, second.
San Francisco also has
[[public transport|public transportation]].

I enjoy Mapworking and Mapworks

  • Endings are blended into the link.
  • Preferred style is to use this instead of a piped link, if possible.
I enjoy [[Mapwork]]ing and [[Mapwork]]s

The weather in London is a page that does not exist yet.

  • You can create it by clicking on the link (but please do not do so with this particular link).
  • To create a new page:
    1. Create a link to it on some other (related) page.
    2. Save that page.
    3. Click on the link you just made. The new page will open for editing.
  • For more information, see How to start a new article.
  • Please do not create a new article without linking to it from at least one other article.
[[The weather in London]] is a page 
that does not exist yet.

How to edit a page is this page.

  • Self links appear as bold text when the article is viewed.
[[How to edit a page]] is this page.

When adding a comment to a Talk page, you should sign it by adding three tildes to add your user name:

Ben Brockert

or four to add user name plus date/time:

Ben Brockert 00:18, Nov 19, 2004 (UTC)

Five tildes gives the date/time alone:

00:18, Nov 19, 2004 (UTC)
  • The first two both provide a link to your user page.
When adding a comment to a Talk page,
you should sign it by adding
three tildes to add your user name:
: ~~~
or four for user name plus date/time:
: ~~~~
Five tildes gives the date/time alone:
: ~~~~~

What links here and Related changes pages can be linked as: Special:Whatlinkshere/How to edit a page and Special:Recentchangeslinked/How to edit a page

'''What links here''' and '''Related changes'''
pages can be linked as:
[[Special:Whatlinkshere/How to edit a page]]
and
[[Special:Recentchangeslinked/How to edit a page]]

A user's Contributions page can be linked as: Special:Contributions/UserName or Special:Contributions/192.0.2.0

A user's '''Contributions''' page can be linked as:
[[Special:Contributions/UserName]]
or
[[Special:Contributions/192.0.2.0]]

Sound

  • To include links to non-image uploads such as sounds, use a "media" link. For images, see next section.

Some uploaded sounds are listed at AgeofWiki:Sound.

[[media:Sg_mrob.ogg|Sound]]

Images

Only images that have been uploaded to AgeofWiki 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:AoW.png

A picture: 
[[Image:AoW.png]]
With alternative text:

logo

With alternative text:
[[Image:AoW.png|logo]]
  • Alternative text, used when a mouse hovers over the image or when the image is not 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:
AgeofWiki Encyclopedia
AgeofWiki Encyclopedia

Floating to the right side of the page and with a caption:
[[Image: AoW.png|frame|AgeofWiki Encyclopedia]]
  • 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:
AgeofWiki Encyclopedia
Floating to the right side of the page ''without'' a caption:
[[Image: AoW.png|right|AgeofWiki Encyclopedia]]
Linking directly to the description page of an image:

Image:AoW.png

Linking directly to the description page of an image:
[[:Image:AoW.png]]
  • Clicking on an image displayed on a page (such as any of the ones above) also leads to the description page
Linking directly to an image without displaying it:

Image of the logo

Linking directly to an image without displaying it:
[[media:wiki.png|Image of the logo]]
  • To include links to images shown as links instead of drawn on the page, use a "media" link.

Character formatting

What it looks like What you type

Emphasize, strongly, very strongly.

  • These are double, triple, and quintuple apostrophes (single-quote marks), not double-quote marks.
''Emphasize'', '''strongly''', '''''very strongly'''''.

A typewriter font for monospace text or for computer code: int main()

  • For semantic reasons, using <code> where applicable is preferable to using <tt>.
A typewriter font for <tt>monospace text</tt>
or for computer code: <code>int main()</code>

You can use small text for captions.

You can use <small>small text</small> for captions.

You can strike out deleted material and underline new material.

You can also mark deleted material and inserted material using logical markup rather than visual markup.

  • When editing regular AgeofWiki articles, just make your changes and do not mark them up in any special way.
  • When editing your own previous remarks in talk pages, it is sometimes appropriate to mark up deleted or inserted material.
You can <s>strike out deleted material</s>
and <u>underline new material</u>.

You can also mark <del>deleted material</del> and
<ins>inserted material</ins> using logical markup
rather than visual markup.

Punctuation:
¿ ¡ § ¶
† ‡ • – —
‹ › « »
‘ ’ “ ”


&iquest; &iexcl; &sect; &para;
&dagger; &Dagger; &bull; &ndash; &mdash;
&lsaquo; &rsaquo; &laquo; &raquo;
&lsquo; &rsquo; &ldquo; &rdquo;

Commercial symbols:
™ © ® ¢ € ¥
£ ¤


&trade; &copy; &reg; &cent; &euro; &yen; 
&pound; &curren;

Commenting page source:
not shown when viewing page

  • Used to leave comments in a page for future editors.
  • Note that most comments should go on the appropriate Talk page.


<!-- comment here -->

Table of contents

At the current status of the wiki markup language, having at least four headers on a page triggers the TOC to appear in front of the first header (or after introductory sections). Putting __TOC__ anywhere forces the TOC to appear at that point (instead of just before the first header). Putting __NOTOC__ anywhere forces the TOC to disappear.

Tables

There are two ways to build tables:

  • using the table template
  • with the usual HTML elements: <table>, <tr>, <td> or <th>.

Variables

Code Effect
{{CURRENTMONTH}} 03
{{CURRENTMONTHNAME}} March
{{CURRENTMONTHNAMEGEN}} March
{{CURRENTDAY}} 16
{{CURRENTDAYNAME}} Tuesday
{{CURRENTYEAR}} 2010
{{CURRENTTIME}} 23:59
{{NUMBEROFARTICLES}} 470
{{PAGENAME}} How to edit a page
{{localurl:pagename}} /age/Pagename
{{localurl:AgeofWiki:Sandbox|action=edit}} /ageofwiki/index.php?title=AgeofWiki:Sandbox&action=edit
{{SERVER}} http://wiki.heavengames.com
{{ns:1}} Talk
{{ns:2}} User
{{ns:3}} User_talk
{{ns:4}} AgeofWiki
{{ns:5}} AgeofWiki_talk
{{ns:6}} Image
{{ns:7}} Image_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}} AgeofWiki

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}}.

Templates

The MediaWiki software used by AgeofWiki has support for templates. This means standardized text chunks (such as boilerplate text) can be inserted into articles. For example, typing {{stub}} will appear as "This article is a stub. You can help AgeofWiki by expanding it." when the page is saved. See Templates for the complete list. Other commonly used templates are: {{spoiler}} for spoiler warnings and {{sectstub}} like an article stub but for a section.

Templates are considered too complex to be explained within the scope of this article.

Hiding the edit links

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

This page is based on content taken from a Wikipedia article (http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page).