Text of wiki.archlinux.org › title › Help:Editing as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Help:Editing - ArchWiki

Home Packages Forums Wiki GitLab Security AUR Download Jump to content From ArchWiki Related articles ArchWiki:Bots Help:Discussion Help:Template This is a tutorial about editing the ArchWiki . Note 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 ArchWiki:Contributing , Help:Reading and Help:Style for an overview of the common conventions. To experiment with editing, please use the sandbox . For an overview of wiki markup, see Help:Cheatsheet . ArchWiki 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.

Creating an account Before registering, make yourself familiar with our Code of conduct . To be able to edit ArchWiki articles, you must create an ArchWiki account and confirm the e-mail address used for registration. Answering the captcha question requires an up-to-date Arch Linux environment: non-Arch users are very welcome to contribute to the wiki, and in order to answer the question they can for example boot into a live Arch system with the latest installation image , use pacman-static AUR (precompiled binaries are available) or simply use a container image utilizing tools such as Docker .

Once you have an account, log in from Special:UserLogin . Note Single sign-on via accounts.archlinux.org is not yet implemented. See archlinux/infrastructure#38 . Editing To begin editing a page, click the Edit source tab at the top of the page. Alternatively, users may edit a specific section of an article by clicking the edit source link to the right of the section heading. The Editing Page name or Editing Page name (section) page will be displayed, which consists of the following elements: Edit toolbar (optional) Edit box Edit summary box Save changes or 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: Modify the wikitext as needed (see #Formatting below for details). Explain the edit in the Summary box (e.g. "fixed typo" or "added info on xyz"). Note All edits should be accompanied by a descriptive summary to facilitate reviewing from other users. See ArchWiki:Contributing#The 3 fundamental rules for more information. Use the Show preview button to facilitate proofreading and verify formatting before saving.

Mark the edit as minor by checking the This is a minor edit box if the edit is superficial and indisputable. Save changes by clicking Save changes . If unsatisfied, click Cancel instead (or repeat the process until satisfied). Note Articles should not be signed because they are shared works; one editor should not be singled out above others. 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: Click the View history tab at the top of the page to be modified (beside the Edit source tab). A list of revisions is displayed. 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. Write the reason why you are undoing this edit to the edit summary field. If satisfied, click the Save changes 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: Click the View history tab at the top of the page to be modified (beside the Edit source tab). A list of revisions is displayed. View the desired revision (i.e. the last good version) by clicking on the appropriate timestamp. That revision is displayed.

Click the Edit source tab at the top of the page. A warning "You are editing an out-of-date revision of this page" will be displayed. Write the revision timestamp (displayed at the top of page) and a reason why you are reverting page state to the edit summary field. If satisfied, simply click the Save changes button to revert to this version. Note Avoid combining an undo and an edit. Revert the edit first, then make additional changes; do not edit the revision preview.

Consider using an especially detailed and verbose edit summary when performing an undo to prevent lengthy discussions. 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#Title 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, as long as one category is not already the parent of the other (see Help:Style#Categories ). To add a new page to some category (say "My new page" to "Some category") you need to: Create a page with your new title by browsing to https://wiki.archlinux.org/title/My_new_page (remember to replace "My_new_page" with the intended title!) Add [[Category:Some category]] to the top of your page Note Do not create uncategorized pages.

All pages must belong to at least one category. If you cannot find a suitable category, consider creating a new one. 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 .

In some cases it may make sense to instead create a subpage , i.e. a child of another page: subpage titles are separated from the superpage title with "/" symbols (slash). This is often useful to prepare drafts under one's own User page, for example https://wiki.archlinux.org/title/User:Myself/My_new_subpage . 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#Section headings 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 ====== Note First-level headings are not allowed, their formatting is reserved for the article title. If an article has at least four headings, a table of contents (TOC) will be automatically generated. If this is not desire

The rest of this page is on the live site.