Help:Editing

The Bibliotheca Anonoma Wiki is powered by MediaWiki, a free software wiki package written in PHP, originally designed for use on Wikipedia. More in-depth help can be found at Help:Contents on MediaWiki and Help:Contents on Wikipedia.

This is a short tutorial about editing the Bibliotheca Anonoma Wiki. Before editing or creating pages, users are encouraged to familiarize themselves with the general tone, layout, and style of existing articles. An effort should be made to maintain a level of consistency throughout the wiki. See Help:Reading for an overview of common stylistic conventions. See Help:Style for more detail.

You must be logged-in to edit pages. See the Main page for information about creating an account. To experiment with editing, please use the sandbox. For an overview of wiki markup, see Help:Cheatsheet. For wiki tasks, see Bibliotheca Anonoma:Contributing.

Editing
To begin editing a page, click the edit tab at the top of the page. Alternatively, users may edit a specific section of an article by clicking the edit link to the right of the section heading. The Editing page will be displayed, which consists of the following elements:


 * Edit toolbar (optional)
 * Edit box
 * Edit summary box
 * Save page, Show preview, Show changes, and Cancel links

The edit box will contain the wikitext (the editable source code from which the server produces the web page) for the current revision of the page or section. To perform an edit:


 * 1) Modify the wikitext as needed (see  below for details).
 * 2) Explain the edit in the Summary box (e.g. "fixed typo" or "added info on xyz").
 * 3) Use the Show preview button to facilitate proofreading and verify formatting before saving.
 * 4) Mark the edit as minor by checking the This is a minor edit box if the edit is superficial and indisputable.
 * 5) Save changes by clicking Save page. If unsatisfied, click Cancel instead (or repeat the process until satisfied).

Reverting edits
If a page was edited incorrectly, the following procedures describe how to revert an article to a previous version. To revert a single edit:


 * 1) Click the history tab at the top of the page to be modified (beside the edit tab). A list of revisions is displayed.
 * 2) Click the undo link to the right of the unwanted edit. An edit preview is displayed, showing the current revision on the left and the text to be saved on the right.
 * 3) Write the reason why you are undoing this edit to the edit summary field.
 * 4) If satisfied, click the Save page button at the bottom of the page.

The wiki page should now be back in its original state.

Occasionally, it is necessary to revert several last edits at once. To revert an article to a previous version:


 * 1) Click the history tab at the top of the page to be modified (beside the edit tab). A list of revisions is displayed.
 * 2) View the desired revision (i.e. the last good version) by clicking on the appropriate timestamp. That revision is displayed.
 * 3) Click the edit tab at the top of the page. A warning is displayed: You are editing an out-of-date revision of this page.
 * 4) Write the revision timestamp (displayed at the top of page) and a reason why you are reverting page state to the edit summary field.
 * 5) If satisfied, simply click the Save page button to revert to this version.

Creating pages
Before creating a new page, please consider the following:


 * Is your topic relevant to Arch Linux? Irrelevant or unhelpful articles will be deleted.
 * Is your topic of interest to others? Consider not only what you wish to write about, but also what others may wish to read. Personal notes belong on your user page.
 * Is your topic worthy of a new page? Search the wiki for similar articles. If they exist, consider improving or adding a section to an existing article instead.
 * Will your contribution be significant? Avoid creating stubs unless planning to expand them shortly thereafter.

Creating a new page requires selection of a descriptive title and an appropriate category.

Please read Help:Article naming guidelines and Help:Style for article naming advice. Do not include "Arch Linux" or variations in page titles. This is the Arch Linux wiki; it is assumed that articles will be related to Arch Linux (e.g., "Installing Openbox"; not "Installing Openbox in Arch Linux").

Visit the Table of contents to help choose an appropriate category. Articles may belong to multiple categories.

To add a new page to some category (say "My new page" to "Some category") you need to:


 * 1) Create a page with your new title by browsing to https://wiki.bibanon.org/My_new_page (remember to replace "My_new_page" with the intended title!)
 * 2) Add  to the top of your page

At this stage the new article is still considered an orphan. To complete the job, take a little extra time to link to the new article from others: this will improve its visibility and encourage more users to contribute to it. Likely candidates are articles about related software, more generic overview pages, or even simple lists such as List of applications.

Formatting
Text formatting is accomplished with wiki markup whenever possible; learning HTML is not necessary. Various templates are also available for common formatting tasks; see Help:Template for information about templates. The Help:Cheatsheet summarizes the most common formatting options.

Headings and subheadings
Headings and subheadings are an easy way to improve the organization of an article. If you can see distinct topics being discussed, you can break up an article by inserting a heading for each section. See Help:Style and Help:Effective use of headers for style information.

Headings must start from second level, and can be created like this:

== Second-level heading == === Third-level heading === ==== Fourth-level heading ==== ===== Fifth-level heading ===== ====== Sixth-level heading ======

If an article has at least four headings, a table of contents (TOC) will be automatically generated. If this is not desired, place in the article. Try creating some headings in the Sandbox and see the effect on the TOC.

Line breaks
An empty line is used to start a new paragraph while single line breaks have no effect in regular paragraphs.

The HTML tag can be used to manually insert line breaks, but should be avoided. A manual break may be justified with other formatting elements, such as lists.

See Help:Style/White space for information on proper use of whitespace characters.

Bold and italics
Bold and italics are added by surrounding a word or phrase with two, three or five apostrophes :

Strike-out
Use strike-out text to show that the text no longer applies or has relevance.

Indenting
To indent text, place a colon at the beginning of a line. The more colons you put, the further indented the text will be. A newline marks the end of the indented paragraph.

Lists
Remember that wiki syntax does not support multi-line list items; every newline character ends the list item definition. To start a new line inside a list item, use the tag. To enter a multi-line code block inside a list item, use Template:bc and escape the content using tags. See also Help:Style/White space and Help:Template.

Bullet points
Bullet points have no apparent order of items.

To insert a bullet, use an asterisk. Multiple s will increase the level of indentation.

Numbered lists
Numbered lists introduce numbering and thus order the list items. You should generally use unordered lists as long as the order in which items appear is not the primary concern.

To create numbered lists, use the number sign or hash symbol. Multiple s will increase the level of indentation.

Definition lists
Definition lists are defined with a leading semicolon and a colon  following the term.

Definition lists must not be simply used for formatting, see W3's examples.

Code
To add code to the wiki, use one of the code formatting templates. Alternatively, simply start each line with a single whitespace character, for example: $ echo Hello World

See also Help:Style.

Tables
Used effectively, tables can help organize and summarize swaths of data. For advanced table syntax and formatting, see Help:Table.

Links
Links are essential to help readers navigate the site. In general, editors should ensure that every article contains outgoing links to other articles (avoid dead-end pages) and is referenced by incoming links from other articles (the what links here special page can be used to display incoming links).

Internal links
You can extensively cross-reference existing wiki pages using internal links. To make a link to another page on the same wiki, just put the title in double square brackets.

For example, if you want to make a link to, say, the pacman article, use:

pacman

If you want to use words other than the article title as the text of the link, you can add an alternative name after the pipe "|" divider ( + on English-layout and similar keyboards).

For example:

The ArchWiki is the primary documentation source for Arch Linux.

...is rendered as:


 * The ArchWiki is the primary documentation source for Arch Linux.

When you want to use the plural of an article title (or add any other suffix) for your link, you can add the extra letters directly outside the double square brackets.

For example:

makepkg is used in conjunction with PKGBUILDs.

...is rendered as:


 * makepkg is used in conjunction with PKGBUILDs.

Links to sections of a document
To create a link to a section of a document, simply add a followed by the section's heading.

For example:

Help:Editing

...is rendered as:


 * Help:Editing

Pipe trick
In some cases, it is possible to use the pipe trick to save writing the label of wiki links. The most important cases usable on this wiki are:


 * 1) In article titles, it allows to hide the language suffix. For example,  is turned into Main page.
 * 2) In links to different namespace or wiki, the pipe trick hides the prefix. For example,  is turned into About and  is turned into Help:Pipe trick.

When the page is saved, the pipe trick will automatically generate the alternative text for the link and change the wikitext accordingly.

Interlanguage links
See Help:i18n

Interwiki links
So-called interwiki links can be used to easily link to articles in other external Wikis, like Wikipedia for example. The syntax for this link type is the wiki name followed by a colon and the article you want to link to enclosed in double square brackets.

If you want to create link to the Arch Linux article you can use the following:

Arch Linux

Or you can create a piped link with an alternate link label to the Arch Linux Wikipedia article:

Arch Linux Wikipedia article

See: Interwiki links

The list of all interwiki links working on this wiki can be viewed here.

Redirects
To redirect automatically from one page to another, add and an internal link to the page to be redirected to at the beginning of a page.

For example, you could redirect "Penguins" to "Penguin" with:


 * 1) redirect Penguin

Thus, anyone typing either version in the search box will automatically go to "Penguin".

Note that redirects do not work for category pages.

Also note that redirects are resolved internally by the server and will not make it any slower to open an article.

See also Help:Procedures.

Note that redirecting an existing page to another can create double redirects: see Help:Procedures for fixing them.

Wiki variables, magic words, and templates
MediaWiki recognizes certain special strings within an article that alter standard behavior. For example, adding the word anywhere in an article will prevent generation of a table of contents. Similarly, the word can be used to alter the default position of the table of contents. See Help:Magic words for details.

Templates and variables are predefined portions of wikitext that can be inserted into an article to aid in formatting content.

Variables are defined by the system and can be used to display information about the current page, wiki, or date. For example, use to display the wiki's site name (here it displayed as ""). To set an alternate title header for the current page, another wiki variable can be used:. (But it's very restricted: you are only allowed to change first letter to lowercase and replace spaces with underscores — normalized title string must match with real page name, otherwise it will not work; use template to display first letter of title in lower case).

Templates, on the other hand, are user-defined. The content of any page can be included in another page by adding to an article, but this is rarely used with pages outside the Template namespace. (If the namespace is omitted, Template is assumed.) For example, Template:Note, which can be included in an article with the following wikitext:

...is rendered as:

See Help:Template for more information.