Help:Editing

From StoriesWiki
Jump to: navigation, search

Editing Note

Please note that in order to edit any of the pages on the site, you have to register, log in and confirm your email address. Editing is forbidden to those without a confirmed email address.

This is done in order to cut down on the spam and the vandalism.


Creating Pages

New pages can be created by following a link to a nonexistent page ("red link" for default preferences settings) or by editing the last part of the URL of another page in the same project. It is useful to create a page by following a link, or create links to the new page right after creating the page, to avoid the new page being isolated.

Before following the edit link, decide whether you want to give the new page the suggested name. If not, first edit the link on the referring page.

Newly created pages should have Created and/or short description of page put in edit summary.

See also:


Formatting

To edit a page, click on the "Edit this page" (or just "edit") link at one of its edges. Before saving page, please do examine the preview, as many times as it is needed. When you are satisfied with changes write a short edit summary in the small text field below the edit-box and when finished press "Save". If the change is small (e.g. corrected typo or spelling) check box marked "This is a minor edit".

It is quite important to fill in the edit summary, as it helps e.g. to decide if to examine changes.

See also:

  • MediaWiki's Wiki Formatting Guide. Not all formatting is presented here, so please consider following this link.

Sections

To start a section, subsection and sub-subsection type the section name between double, triple and quadruple equal signs, like this:

== Section title ==

in separate line. If you want for section to not appear in table of contents use instead <h2></h2>, <h3></h3>, <h4></h4> respectively.

You can link to specific section of article using [[Article#Section|Label]] syntax. You can also edit one section of article at the time, minimizing preview time and chance for edit conflict.

Paragraphs, Lists etc.

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 by using <br> (or <br />) tag.

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. To make numbered (ordered) list use hash sign # at the beginning of the line.

A colon : at the beginning of the line indents a line or paragraph; more colons means deeper indentation. A manual newline starts a new paragraph. It is often used for discussion on Talk pages.

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!!!. Compare with <pre></pre>.

Links

To make a link to another article (story) use [[Article name]]. First letter of target is automatically capitalized. Endings are blended into the link. To have other label for link use piped link, e.g. [[Help:Editing|User's Guide]]; you can use redirects instead. You can simply put pipe at the end of the link to hide namespace [[Help:Editing|]] or stuff in parentheses [[Venom (comics)|]]; it will be expanded at saving page.

To create link to article on other Wiki (e.g. Wikipedia or Wiktionary), making interwiki link, precede link with appropriate prefix (see Interwiki map). For example [[Wikipedia:Wiki|]] links to Wiki article on Wikipedia; see how we used pipe to hide Wiki name from link label.

To create link to external page use [URL Link-name], e.g. [http://www.google.com Google] gives Google. You can also use bare URLs, e.g. http://www.google.com, but it is not recommended.

Character Formatting

By surrounding fragment of text in ''double'', '''triple''', '''''pentuple''''' apostrophes you can emphasize, strongly, very strongly.

You can also use <strike></strike> or <del></del> tags for strikethru (or deleted material; rather on talk pages), <u></u> or <ins></ins> for underline (or inserted material; rather on talk pages). You can also use <b></b> for bold, and <i></i> for italics, although former formatting is preferred.

Use <tt></tt> for typewriter (monospace) font. Use <nowiki></nowiki> to suppress interpretation of wiki markup.

Comments

You can put HTML comments in Wiki, i.e. <!-- Some comment here, won't be visible on page -->. Usually though talk page (link marked "discussion" at the top of the page) is better solution.


Importing existing content

Converting from HTML text file

If you have only a HTML excerpt or a few pages to convert, you might want to try Diberri's html2wiki converter, which uses HTML::WikiConverter Perl module from CPAN. For larger collection of files one shoud probably use the module itself.

There are probably other HTML to Wiki markup converters.


Categories

A page in any namespace can be put in a category by adding a category tag anywhere on the page (preferably at the bottom of the page), i.e.:

[[Category:Category name]]

Pages can be included in more than one category by adding multiple category tags. To create a subcategory put parent category tag in subcategory page.

If you want to put link to the category somewhere on the page, put colon before Category, i.e. [[:Category:Category name]]. To hide Category: part from link name, you can use automatic piped link, i.e. [[:Category:Category name|]].

Sorting Key

If you want an item in a list to be positioned in other order than the article page name, based on an alternative name (sort key) for that item, then this can be specified in the category tag that places the item in the list:

[[Category:category name|sort key]]

Category names should usually use plural form, e.g. Category:Stories.

See also:


Templates and Variables

Templates are pages in the template namespace. This means any page beginning with "Template:", such as [[Template:Templatename]]. The content of a template can be added to a page by typing {{templatename}}.

Templates are used to add recurring messages to pages in a consistent way, to add boilerplate messages, to create navigational boxes and similar tasks.

If templatename starts with a valid namespace prefix, or a colon, then it is not prefixed with "Template:". This way any page can be used as template (a colon at the start refers to the main namespace). One can use it to transclude other article, creating a compound document.

Variables are used in the same way as templates by typing {{variablename}}. They are builtin into MediaWiki engine. Example variables are {{SITENAME}}: StoriesWiki, {{SERVER}}: http://storieswiki.org; example variables depending on the page are {{NAMESPACE}} (Help here), {{PAGENAME}} (Editing here), {{PAGENAMEE}} (Editing here). Quite useful in templates; they are evaluated after insertion in referring page. For list of all variables see Help:Variables at MediaWiki.

See also:

Creating and Editing Templates

You start a new template in the same way you would start a normal page. The only difference is that its title must start with Template:.

Once you have made the template, you can add {{templatename}} to the pages you want to use it on.

If the template you want to edit looks like {{stub}}, you would go to Template:Stub to edit it. To get there, type in the URL to your address bar, search for it, or make a link in the sandbox and click on it.

Once you are there, just click "edit" or "edit this page" and edit it in the same way you would any other page. You can add anything you would add to a normal page, including text, images and other templates. Please be aware that your edit might affect many pages, so be cautious.

Parameters

Template parameters are either named or numbered. The syntax is {{templatename|parname1=parvalue1|parname2=parvalue2}} with {{{parname1}}}, {{{parname2}}}, etc. tags in the template, or {{templatename|parvalue1|parvalue2}} with {{{1}}}, {{{2}}}, etc. tags in the template. (Note that parameter tags in the template have three braces rather than two.)

Spaces before or after a parameter value are normally ignored. On rendering, surplus parameter values (including named parameters that do not occur in the template) are ignored. A parameter value cannot contain a template tag.

Description of Templates

The template page is of a different nature than other pages. It is not for explaining anything to the reader, but for defining the template for the system (this is done by the wikitext, the rendered page is just a by-product). Therefore the template talk page (available under link "discussion" at the top of the page) has an especially important role of describing the template. It typically consists of two parts:

  • the first part explaining the template and its parameters
    • the source (text) of template, separated from the rest with horizontal line ----: it usually can be done by putting {{msgnw:{{PAGENAME}}}} at the top of the page; in more complicated cases one would have to copy the text of template from edit page in nowiki tags
    • preferably examples are given of template calls (put them in nowiki tags, or at least put opening braces in nowiki tags) and the results (put the template call without nowiki tags in the wikitext)
  • the second part used for the ordinary talk page function


MediaWiki and Wikipedia Guides

MediaWiki
Wikipedia