Conworlds:Editing

From Constructed Worlds Wiki
Jump to navigation Jump to search

Also see the following: Help:Format, Help:Image, Help:Link, Help:List, Help:Media.

General

To edit a page, click on the "edit" link at the top.

After adding to or changing the wikitext, it is useful to click on the "Show preview" button, which produces the corresponding webpage in your browser, but does not make it publicly available yet (not until you press the "Save page" button). Errors in formatting, links, tables, etc. are often much easier to discover from the rendered page than from the raw wikitext.

If you are not satisfied, you can make additional changes and preview the page as many times as necessary. Then write a short edit summary in the small text field below the edit box and press "Save page" when finished. Depending on your browser, pressing the "Enter" key while the edit box is not active (i.e. there is no typing cursor in it) may have the same effect as pressing "Save page".

Minor edits

The Minor Edit checkbox is found above the "Save page" button. Click the checkbox to mark the edit as minor.

A minor edit is an edit that doesn't really change the content of a page, but rather, fixes small details or mistakes, and other such maintenance work. When editing a page, users have the option of marking the edit as minor. To do so, simply click the checkbox above the "Save page" button (as pictured) prior to saving the page. An "m" will then be displayed alongside the edit on the list of recent changes, the page's history, watchlists, and the user's list of contributions, thus indicating that the edit was minor. This feature is important, because users can choose to hide minor edits in their view of the recent changes to keep the volume of edits down to a manageable level.

Edits that can be marked as minor include:

  • Correcting coding errors
  • Fixing spelling or grammar mistakes (however, please note that American spellings should not be changed to British spellings)
  • Fixing typos and misinformation (unless this involves significant rewriting)
  • Adding or modifying {{aboutfile}}
  • Adding, exchanging or removing navigation templates or categories
  • Exchanging an image that is pending deletion for the replacement image (i.e. a blurry JPEG being replaced by a crisp PNG)
  • Maintenance work done on large amounts of pages at a time, creating floods of edits (usually, this involves one or more of the above types of edits to begin with)

Edits that should not be marked as minor include:

  • Removing, changing or adding to the written content of an article, including image captions or any other text besides the main body paragraphs
  • Incorporating Trivia and other maintenance work that involves rewriting parts of a page
  • Conducting a substantial amount of maintenance work on any given page (i.e. adding or reorganizing many templates or categories, fixing numerous grammar errors, etc.)
  • Adding or removing tables or infoboxes
  • Adding an image to or removing an image from an article, or replacing an image with a completely different image
  • Adding a gallery to an article or moving a preexisting gallery to a subpage
  • Adding a comment to a talk page attached to an article

Please note that neither of these lists are exhaustive, with common sense being the best tool in determining whether an edit is minor or not, and when in doubt, simply do not mark an edit as minor. Remember that different users have slightly different takes on what "minor" entails, and so some may be quick to mark their edits as minor, while others may be quite hesitant to mark any of their edits. However, if a user fails to mark large amounts of edits as minor, or often marks substantial mainspace edits as "minor", they are committing a level one offense, and a {{reminder}} may be issued to inform them of the problem. When doing so, keep in mind that the user may not have been aware they were breaking any rules, so be sure to explain the policy and possibly even link here for further reference.

Dummy edit

If the wikitext is not changed no edit will be recorded and the edit summary is discarded.

A dummy edit is a change in wikitext that has no effect on the rendered page. This allows an edit summary, and is useful for correcting a previous edit summary, or an accidental marking of a previous edit as "minor" (see below). Also it is sometimes needed to refresh the cache of some item in the database.

Edit summaries

Edit summaries are short descriptions of changes that have been made to a page. These notes appear next to edits on page histories, watchlists and recent changes, allowing other users to know exactly what changes were made to the page and making it easier to track these changes. When editing a page, the user can write a description of the changes on the "Summary" text field that is located under the edit area. Users should always try to submit accurate, straightforward and informative edit summaries, and when undoing an edit, edit summaries should be used to explain why it was undone, so as to avoid confusion.

Page protection

In a few cases the link labeled "edit" is replaced by the text "view source" (or equivalents in the language of the project). In that case the page can not be edited.

The wiki markup

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. If you want to try out things without danger of doing any harm, you can do so in the sandbox.

Sections, paragraphs, lists, and lines

What it looks like What you type

Start your sections with header lines:


New section

Subsection

Sub-subsection


==New section==

===Subsection===

====Sub-subsection====

New line:

A single new line has no effect on the layout.

But an empty line starts a new paragraph.




A single
new line
has no
effect on the
layout.

But an empty line
starts a new paragraph.
You can break lines
without starting a new paragraph.

Sufficient as wikitext code is <br>, the XHTML code <br /> is not needed, the system produces this code.

You can break lines<br>
without starting a new paragraph.
  • Lists are easy to do:
    • start every line with a star
      • more stars means deeper levels
  • A newline
  • in a list

marks the end of the list.

  • Of course
  • you can
  • start again.
*Lists are easy to do:
**start every line with a star
***more stars means deeper levels
*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
  2. A newline
  3. in a list

marks the end of the list.

  1. New numbering starts
  2. with 1.
#Numbered lists are also good
##very organized
##easy to follow
#A newline
#in a list  
marks the end of the list.
#New numbering starts
#with 1.
  • You can even do mixed lists
    1. and nest them
      • like this
        or have newlines
        inside lists
*You can even do mixed lists
*#and nest them
*#*like this<br>or have newlines<br>inside lists
  • You can also
    • break lines
      inside lists
      like this
*You can also
**break lines<br>inside lists<br>like this
Definition list
list of definitions
item
the item's definition
;Definition list: list
of definitions
;item: the 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.
IF a line of plain text starts with a space THEN
  it will be formatted exactly
    as typed;
  in a fixed-width font;
  lines won't wrap;
ENDIF
this is useful for:
  *pasting preformatted text;
  *algorithm descriptions;
  *program source code
  *ASCII art;
  *chemical structures;

WARNING If you make it wide, you force the whole page to be wide and hence less readable. Never start ordinary lines with spaces.

(see also below)
 IF a line of plain text starts with a space THEN
   it will be formatted exactly
     as typed;
   in a fixed-width font;
   lines won't wrap;
 ENDIF
 this is useful for:
   *pasting preformatted text;
   *algorithm descriptions;
   *program source code
   *ASCII art;
   *chemical structures;
Centered text.
<center>Centered text.</center>
A horizontal dividing line: above

and below.

Mainly useful for separating threads on Talk pages.

A horizontal dividing line: above
----
and below.

Summarizing the effect of a single newline: no effect in general, but it ends a list item or indented part; thus changing some text into a list item, or indenting it, is more cumbersome if it contains newlines, they have to be removed.

Links, URLs

What it looks like What you type
Sue is reading about Sierra.
  • First letter of target is automatically capitalized.
  • Internally spaces are automatically represented as underscores (typing an underscore has the same effect as typing a space, but is not recommended).

Thus the link above is to http://www.altverse.miraheze.org/wiki/Sierra, which is the page with the name "Sierra".

Sue is reading about [[Sierra]].

Link to a section on a page, e.g. Sierra#History; when section editing does not work the link is treated as link to the page, i.e. to the top; this applies for:

  • links to non-existent sections
  • links in redirects
  • interwiki links
[[Sierra#History]].
Link target and link label are different: help.

(This is called a piped link).

Same target, different name:
[[Help:Contents|help]]
Endings are blended into the link: Sierran
Endings are blended
into the link: [[Sierra]]n,

Automatically hide stuff in parentheses: Merveilles des Morte.

Automatically hide namespace: Introduction.

The server fills in the part after the | when you save the page. Next time you open the edit box you will see the expanded piped link. A preview interprets the abbreviated form correctly, but does not expand it yet in the edit box. Press Save and again Edit, and you will see the expanded version. The same applies for the following feature.

Automatically hide stuff in parentheses:
[[Merveilles des Morte (book series)|]]. 
Automatically hide namespace:
[[Constructed Worlds:Introduction|]].
When adding a comment to a Talk page,

you should sign it. You can do this by adding three tildes for your user name:

Admin

or four for user name plus date/time:

Admin 08:10 Oct 5, 2002 (UTC)
When adding a comment to a Talk page,
you should sign it. You can do this by
adding three tildes for your user name:
: ~~~
or four for user name plus date/time:
: ~~~~
The weather in London is a page that doesn't exist yet.
  • You can create it by clicking on the link.
  • To create a new page:
    1. Create a link to it on some other page.
    2. Save that page.
    3. Click on the link you just made. The new page will open for editing.
[[The weather in London]] is a page
that doesn't exist yet.

Redirect one article title to another by putting text like this in its first line.

#REDIRECT [[Senor]]
Category:Help

Link directly to a category, instead of adding the page to the category, by adding a colon (:) in the internal link.

[[:Category:Help]]

Link directly to a category,
instead of adding the page to the category
by adding a colon (:) in the internal link.
"What links here" and "Related changes" can be linked as:

Special:Whatlinkshere/Constructed Worlds:Editing and Special:Recentchangeslinked/Constructed Worlds:Editing

[[Special:Whatlinkshere/
Constructed Worlds:Editing]] and
[[Special:Recentchangeslinked/
Constructed Worlds:Editing]]
External links: Nintendo, [1]
External links:
[http://www.nintendo.com Nintendo],
[http://www.nintendo.com]
Or just give the URL: http://www.nintendo.com.
  • In the URL all symbols must be among: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF. If a URL contains a different character it should be converted; for example, ^ has to be written %5E (to be looked up in ASCII). A blank space can also be converted into an underscore.
Or just give the URL:
http://www.nintendo.com.

To link to books, you can use ISBN links. ISBN 0123456789X

ISBN 0123456789X

Link to Request for Comments: RFC 123 (URL specified in mediawiki:Rfcurl)

RFC 123

To include links to non-image uploads such as sounds, use a "media" link.
Sound


[[File:Jeb.ogg|Sound]]
Use links for dates, so everyone can set their own display order. Use Special:Preferences to change your own date display setting.
[[July 20]], [[1969]] , [[20 July]] [[1969]]
and [[1969]]-[[07-20]]
will all appear as 20 July 1969 if you set your date display preference to 1 January 2001.

Images

What it looks like What you type
A picture: The Conworlds icon.
  • For many projects, only images that have been uploaded to the same project can be used. To upload images, use the upload page. You can find the uploaded image on the image list
A picture: [[File:Constructed Worlds Wiki (Fandom) icon.png]]

or, with alternate text (strongly encouraged)

[[File:Constructed Worlds Wiki (Fandom) icon.png|The Conworlds icon.]] 

Web browsers render alternate text when not displaying an image -- for example, when the image isn't loaded, or in a text-only browser, or when spoken aloud.

Clicking on an uploaded image displays a description page, which you can also link directly to: File:Constructed Worlds Wiki (Fandom) icon.png

[[:File:Constructed Worlds Wiki (Fandom) icon.png]]

To include links to images shown as links instead of drawn on the page, use a "file" link.
Birds on a wire


[[File:Birds_on_the_wire_-_crop.jpg|100px|Birds on a wire]]

Character formatting

What it looks like What you type

Emphasize, strongly, very strongly.

  • These are double and triple apostrophes, not double quotes.
''Emphasize'', '''strongly''',
'''''very strongly'''''.

You can also write italic and bold if the desired effect is a specific font style rather than emphasis, as in mathematical formulae:

F = ma
  • However, the difference between these two methods is not very important for graphical browsers, and many people choose to ignore it.
You can also write <i>italic</i>
and <b>bold</b> if the desired effect is a 
specific font style rather than emphasis, as 
in mathematical formulas:
:<b>F</b> = <i>m</i><b>a</b>
A typewriter font for technical terms.
A typewriter font for 
<tt>technical terms</tt>.
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 <strike>strike out deleted material</strike>
and <u>underline new material</u>.

Umlauts and accents:
è é ê ë Ã¬ í

À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ ç
è é ê ë ì í
î ï ñ ò ó ô
œ õ ö ø ù ú
û ü ÿ


è é ê ë Ã¬ í

&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring;
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml;
&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve;
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave;
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute;
&acirc; &atilde; &auml; &aring; &aelig; &ccedil;
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc;
&oelig; &otilde; &ouml; &oslash; &ugrave; &uacute;
&ucirc; &uuml; &yuml;

Punctuation:
¿ ¡ « » § ¶
† ‡ • —

&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; &mdash;

Commercial symbols:
™ © ® ¢ € ¥

£ ¤
&trade; &copy; &reg; &cent; &euro; &yen;
&pound; &curren;
Subscript: x2

Superscript: x2 or x²

  • The latter method of superscript can't be used in the most general context, but is preferred when possible (as with units of measurement) because most browsers have an easier time formatting lines with it.

ε0 = 8.85 × 10−12 C² / J m.

Subscript: x<sub>2</sub>
Superscript: x<sup>2</sup> or x&sup2;

or in projects with the templates sub and sup:

Subscript: x{{sub|2}}
Superscript: x{{sup|2}}

&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.

Greek characters:

Α Β Γ Δ Ε Ζ
Η Θ Ι Κ Λ Μ Ν
Ξ Ο Π Ρ Σ
Τ Υ Φ Χ Ψ Ω
α β γ δ ε ζ
η θ ι κ λ μ ν
ξ ο π ρ σ ς
τ υ φ χ ψ ω

&Alpha; &Beta; &Gamma; &Delta; &Epsilon; &Zeta;
&Eta; &Theta; &Iota; &Kappa; &Lambda; &Mu; &Nu;
&Xi; &Omicron; &Pi; &Rho;  &Sigma;
&Tau; &Upsilon; &Phi; &Chi; &Psi; &Omega;
&alpha; &beta; &gamma; &delta; &epsilon; &zeta;
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu;
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;

Math characters:
∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥ →
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
→ ↔

&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; &rarr;
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &alefsym; &oslash;
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
&rarr; &harr;
x2   ≥   0 true.
  • To space things out, use non-breaking spaces - &nbsp;.
  • &nbsp; also prevents line breaks in the middle of text, this is useful in formulas.
<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

For comparison for the following examples:

arrow →

italics link

arrow      &rarr;

''italics''
[[link]]

Use <nowiki> to suppress interpretation of wiki markup, but interpret character references and remove newlines and multiple spaces:

arrow → ''italics'' [[link]]

<nowiki>arrow      &rarr;

''italics''
[[link]]</nowiki>

Use <pre> to suppress interpretation of wiki markup and keep newlines and multiple spaces, and get typewriter font, but interpret character references:

arrow      →

''italics''
[[link]]
<pre>arrow      &rarr;

''italics''
[[link]]</pre>

Use leading space on each line to keep newlines and multiple spaces, and get typewriter font:

arrow      →
italics
link
 arrow      &rarr;

 ''italics''
 [[link]]

Use typewriter font:

arrow →

italics link

<tt>arrow      &rarr;</tt>

<tt>''italics''</tt>
<tt>[[link]]</tt>

Show character references:

&rarr;

&amp;rarr;

Commenting page source:
not shown in page

  • Used to leave comments in a page for future editors.
<!-- comment here -->

HTML Tables

HTML tables can be quite useful as well. For details on how to use them and discussion about when they are appropriate, see [MediaWiki User's Guide: Using tables].

Table of contents (TOC)

For each page with more than three headings, a table of contents (TOC) is automatically generated from the section headings, unless:

  • (for a user) preferences are set to turn it off
  • (for an article) in the edit box the code __NOTOC__ is added

With __FORCETOC__ or __TOC__ in the wikitext a TOC is added even if the page has less than four headings.

The TOC is put before the first section header, or in the case of __TOC__, at the position of this code. Thus there may be some introductory text before it, known as the "lead". Although usually a header after the TOC is preferable, __TOC__ can be used to avoid being forced to insert a meaningless header just to position the TOC correctly, i.e., not too low.

Preferences can be set to number the sections automatically.

In a page calling a template with sections, the sections in the template are numbered according to their position in the rendered page, e.g. if the template tag is in the third section, then the first section of the template is numbered four. Any text in the template before its first section shows up as part of the section with the template tag, and any text after the tag before a new header shows up as part of the last section of the template. This may be done deliberately, but can usually better be avoided (see also below).

Compact TOC

Where you have a large number of very short headings (such as letters of the alphabet) you can get a very long table of contents. An alternative is a compact TOC, which you can achieve by inserting the following text:

{{compactTOC}}

which looks like this:

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

You can do similar things with years or decades e.g.

1900s - 1910s - 1920s - 1930s - 1940s - 1950s - 1960s - 1970s - 1980s - 1990s - 2000s

Both of the above make use of section linking, see below.

Templates

Some part of a page may correspond in the edit box to just a reference to another page, in the form {{name}}, referring to the page "Template:name" (or if the name starts with a namespace prefix, it refers to the page with that name; if it starts with a colon it refers to the page in the main namespace with that name without the colon). This is called a template. For changing that part of the page, edit that other page. Sometimes a separate edit link is provided for this purpose. A convenient way to put such a link in a template is with a template like m:Template:ed. Note that the change also affects other pages which use the same template.

There are two tags that can be used in templates:

  • <noinclude> and </noinclude>. Adds text between the tags onto the template page, but not when the template is used on another page ({{name}}).
  • <includeonly> and </includeonly> does the exact opposite. Text between the tags will only be seen when the template is used, not on the template page itself.
  • [[:]]
  • [[:]]