# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New_page]]</nowiki></code> link on an existing page, then click the link.
<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).
<dt>Moving/renaming pages
<dd>
* Discuss first, FIXME
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* Always move the talk page, too, unless you have a very good reason for not doing so.
<dt>
<dd>Deleting pages
<dt>Only administrators can delete pages. Other users should instead use <code><nowiki>[[Template:Delete]]</nowiki></code> to propose the page for deletion; see below FIXME. (''Don't'' clear the page's content except where it's obviously spam.)
<dt>Subpages
<dd>
Subpages are a way to split up pages to make them easier to follow. They should be used where there are sections which only apply to certain setups or are optional extras. As a general guide, if you think some material should be in different (or extra) categories from those of a linking page, it probably shouldn't be a subpage.
Also, subpages should not be used as a way to categorize (for example, using Wireless/Atheros 5xxx instead of just Atheros 5xxx; instead, use or create a Wireless category).
<!--
The template <code>{{lb}}</code> can be used to tag subpages so that they do not appear in the Uncategorized pages list. It has no visible content; but adds a page to Category:Subpage.
Create a [[New_page]] link on an existing page, then click the link.
Temporary pages
If you wish to create a temporary page, please use a subpage of your User namespace. For example: User:Hillary/Temporary page. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).
Moving/renaming pages
Discuss first, FIXME
The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
Always move the talk page, too, unless you have a very good reason for not doing so.
Deleting pages
Only administrators can delete pages. Other users should instead use [[Template:Delete]] to propose the page for deletion; see below FIXME. (Don't clear the page's content except where it's obviously spam.)
Subpages
Subpages are a way to split up pages to make them easier to follow. They should be used where there are sections which only apply to certain setups or are optional extras. As a general guide, if you think some material should be in different (or extra) categories from those of a linking page, it probably shouldn't be a subpage.
Also, subpages should not be used as a way to categorize (for example, using Wireless/Atheros 5xxx instead of just Atheros 5xxx; instead, use or create a Wireless category).
Inline elements
''italic'' or use <i> or <em> or {font-style:italic} in a style attribute
'''bold''' or use <b> or <strong> or {font-weight:bold} in a style attribute
<small> or use {font-size:smaller} in a style attribute
<big> or use {font-size:larger} in a style attribute (invalid in HTML5)
<sup> or use {vertical-align:super} in a style attribute
<sub> or use {vertical-align:sub} in a style attribute
<font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
<span style="color:gray">
<span style="color:white; background:red">
<u> or use <ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
<s> or use <del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)
<code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
Here is [[Wiki pagetitle|a wiki page]]: a wiki page. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.
Here is an Alpine Issue link {{Issue|279}}: #279. The issue's description can be included as an optional second argument.
Here is [http://www.example.org/ an external link]: an external link. If no link text is supplied: [1]. Omit brackets for http://www.example.org/ (use <nowiki> to suppress).
In Talk pages, -- ~~~~ gives a signature and timestamp: -- Dubiousjim 10:00, 4 March 2012 (UTC)
Headings
An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting __TOC__. You can suppress the table of contents by inserting __NOTOC__.
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.
* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
will produce:
Here is a numbered list item.
Doubly-numbered
Numbered and bulleted.
Here is a bulleted list item.
Doubly-bulleted
Bulleted and numbered.
Another item.
Blank lines, or non-bulleted/numbered lines, end the lists.
Each of these:
;item: Body text
{{Define|item|Body text}}
will produce:
item
Body text
The second markup option also wraps a <span id="item"> around the block.
Indenting unstyled text
: Simply indented text (on left side only).
<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>
will produce:
Simply indented text (on left side only).
This is a blockquote.
It collapses whitespace, and indents on both sides.
Displaying code
Inline code
Use <code> for styling, and <nowiki> to suppress markup. If you use both, they must appear in that order. <nowiki> converts → entities and collapses whitespace (even multiple \ns), but ignores all '''wiki''' and <span style="color:green">HTML</span> [[markup]].
This is a block-level equivalent for the inline HTML element (which the wiki does not process). Note that wiki markup is still honored in the command text; but whitespace is not collapsed.
Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
Use space-indented blocks or <pre>:
Every line
begins with '''a space'''.
<pre>
Lines aren't
indented with '''a space.'''
</pre>
<nowiki>Only first
line begins with '''a space'''.</nowiki>
will produce:
Every line
begins with a space.
Lines aren't
indented with '''a space.'''
Only first
line begins with '''a space'''.
All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code> or <samp> (which the wiki does not process).
All of these markup options convert → entities. The first also processes '''wiki''' and <span style="color:green">HTML</span> [[markup]].
The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing </nowiki>.
File contents
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
will produce:
Contents of /path/to/file
body '''text''' <br /> more
Second line.
Note that wiki and HTML markup in the file contents aren't coverted, though entities still are. You must escape characters as follows:
= not inside [[..]] use = or {{=}}
| not inside [[..]] use | or {{!}}
{{ use { twice or {{lb}}
}} use } twice or {{rb}}
unmatched [[ use [ twice
unmatched ]] use ] twice
Block-level code with no additional styling
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
will produce:
One line.
Second line.
This would be the behavior of HTML's <pre> without any styling. To wrap to screen width, use {white-space:pre-wrap}.
Message Boxes
Warning: {{Warning|Write your Warning here.}}
Note: {{Note|Write your Note here.}}
Tip: {{Tip|Write your Tip here.}}
Todo: {{Todo|Write your Todo here.}}
Heading: {{Box|Heading:|Body}}
Heading: {{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}
Tables
This material needs expanding ...
Please feel free to help us complete it.
{| border="1" style="width:75%; height:200px" <!-- align=right makes table float -->
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" <!-- or style="background:transparent" -->
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top <!-- have to be applied to every row, default is valign=middle; or use style="vertical-align:top;" -->
| rowspan=2 Cell D
| ...
|}
Warning: {{Warning|Write your Warning here.}}
Todo: {{Todo|Write your Todo here.}}
