Help:Editing: Difference between revisions

From Alpine Linux
(added link to mediawiki help)
 
(Use {{TOC right}})
 
(42 intermediate revisions by 5 users not shown)
Line 1: Line 1:
http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page
{{TOC right}}
== Guidelines ==
 
<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# 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.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].
 
<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).
 
To experiment with markup, use [[Sandbox]].
 
<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* 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.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.
 
<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''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}}Subpage{{rb}}</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.
-->
</dl>
 
== Inline elements ==
 
* ''<nowiki>''italic''</nowiki>'' or use <i>&lt;i></i> or <em>&lt;em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b>&lt;b></b> or <strong>&lt;strong></strong> or {font-weight:bold} in a style attribute
<!-- <b><nowiki>''''</nowiki></b>''''bold and italic''''<b><nowiki>''''</nowiki></b> -->
 
* <small>&lt;small></small> or use {font-size:smaller} in a style attribute
* <big>&lt;big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup>&lt;sup></sup> or use {vertical-align:super} in a style attribute
* <sub>&lt;sub></sub> or use {vertical-align:sub} in a style attribute
<!--
Here is a footnote.<ref>Insert footnote text here.</ref>
Here is a recallable footnote.<ref name="foo">Recallable footnote.</ref>; now let's recall it.<ref name="foo" />
References: {{reflist}}
-->
 
* &lt;font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>"&gt;
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>"&gt;
* <u>&lt;u></u> or use <ins>&lt;ins></ins> or {text-decoration:underline} in a style attribute (&lt;u> is valid in HTML5 but not HTML4/strict; &lt;ins> can also be a block element)
* <s>&lt;s></s> or use <del>&lt;del></del> or {text-decoration:line-through} in a style attribute (&lt;s> is valid in HTML5 but not HTML4/strict; &lt;del> can also be a block element)
<!-- <strike> also works, but is deprecated -->
 
* <code>&lt;code></code> uses {font-family:monospace;} (&lt;tt> is invalid in HTML5)
*: <code><var>markup</var> and &rarr; entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd>&lt;kbd></kbd> and <samp>&lt;samp></samp>
* <var>&lt;var></var> and <dfn>&lt;dfn></dfn>
* <cite>&lt;cite></cite>
* <q>&lt;q></q>
 
* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}
 
* Here is one line, followed by &lt;br /><br /><!-- a line break here terminates the list item --> and another line.
 
* Here is &lt;!-- a comment -->.
 
* [[HTML Entities]]
 
=== Links ===
 
Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with &lt;nowiki /> to suppress.
 
Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.
 
Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.
 
Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use &lt;nowiki> to suppress). <!-- This wiki's server can be specified using <nowiki>{{SERVERNAME}}</nowiki>. -->
 
<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.
 
In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)
 
<!--
In general when pointing to Alpine Linux downloads stick with the '''[[Downloads|Downloads Page]]''', but if you for any reason need to include direct download information, do so by using one of below.
 
==== Download Links ====
*<code><nowiki>{{#latestalp:alpine|url}}</nowiki></code> will give you latest download url for Alpine Linux Standard:<br/>
:{{#latestalp:alpine|url}}
*<code><nowiki>{{#latestalp:alpine-mini|url}}</nowiki></code> will give you latest download url for Alpine Linux mini:<br/>
:{{#latestalp:alpine|url}}
<big>'''Example:'''</big><br/>
Start from <nowiki>[{{#latestalp:alpine|url}}</nowiki> Downloading latest Alpine Linux Standard], than continue ...
'''produces:'''<br/>
Start from [{{#latestalp:alpine|url}} Downloading latest Alpine Linux Standard], than continue ...
 
==== Download Boxes ====
{| cellspacing="3"
|- valign="top"
|width="33%" class="ClassForFutureCSS" |
<div style="padding: .4em .9em .1em">
<p style="text-align:center"><code><nowiki>{{Download|alpine}}</nowiki></code></p>
For standard</div>
|width="33%" class="ClassForFutureCSS" |
<div style="padding: .4em .9em .1em">
<p style="text-align:center"><code><nowiki>{{Download|alpine-mini}}</nowiki></code></p>
For mini</div>
|width="33%" class="ClassForFutureCSS" |
<div style="padding: .4em .9em .1em">
<p style="text-align:center"><code><nowiki>{{DownloadDev|alpine}}</nowiki></code></p>
For standard</div>
|- valign="top"
| <div style="padding: .4em .9em .9em"><center>{{Download|alpine}}</center></div>
| <div style="padding: .4em .9em .9em"><center>{{Download|alpine-mini}}</center></div>
| <div style="padding: .4em .9em .9em"><center>{{DownloadDev|alpine}}</center></div>
|}
-->
 
== 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 <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.
 
Start headings at level 2, and don't skip levels.
 
<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>
 
<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>
 
<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>
 
 
<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:
<!--
{{subst:Delete|Message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>
 
{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:
<!--
{{subst:Obsolete|Alternate message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
 
{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:
<!--
{{subst:Merge|Page to merge with|Additional message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
 
<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:
<!--
{{subst:Move|New page name|Reason.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>
 
{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:
<!--
{{subst:Draft|Alternate message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>
 
{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:
<!--
{{subst:Expand|Alternate message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>
 
{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:
<!--
{{subst:Style|Alternate message.}}
-->
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>
 
== Block elements ==
 
=== Lists ===
 
<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.
 
* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>
 
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. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>
 
and similarly for <code>&lt;ul></code>. Closing <code>&lt;/li></code> tags are permitted but not necessary.
 
Each of these:
<pre>
;item: Body text
 
{{Define|item|Body text}}
 
<dl>
<dt>item
<dd>Body text
</dl>
</pre>
 
will produce:
;item: Body text
 
The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code>&lt;/dt></code> or <code>&lt;/dd></code> tags.
 
=== Indenting unstyled text ===
 
<b>:</b> Simply indented text (on left side only).
&lt;blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.&lt;/blockquote>
 
will produce:
: Simply indented text (on left side only).
 
<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>
 
<!--
<center> is deprecated; use <div class="center" style="width:auto; margin-left:auto; margin-right:auto;">Centered text</div>
-->
 
=== Displaying code ===
 
<dl>
<dt id="inlinecode">Inline code
<dd>Use <code>&lt;code></code> for styling, and <code>&lt;nowiki></code> to suppress markup. If you use both, they must appear in that order. <code>&lt;nowiki></code> converts &rarr; entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code>&lt;span style="color:green"></code>HTML<code>&lt;/span></code> <nowiki>[[markup]]</nowiki>.
 
 
<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a &lt;var><var>command</var>&lt;/var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code>&lt;kbd></code>. Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.
 
 
<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code>&lt;pre></code>:
<pre>
Every line
begins with '''a space'''.
 
<pre>
Lines aren't
indented with '''a space.'''
&lt;/pre>
 
&lt;nowiki>Only first
line begins with '''a space'''.&lt;/nowiki>
</pre>
 
will produce:
 
Every line
begins with '''a space'''.
 
<pre>
Lines aren't
indented with '''a space.'''
</pre>
 
<nowiki>Only first
line begins with '''a space'''.</nowiki>
 
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>&lt;samp></code> or <code>&lt;code></code>.
 
All of these markup options convert &rarr; entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.
<!-- Can contain any inline element except: IMG OBJECT BIG SMALL SUP SUB -->
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 <code>&lt;/nowiki></code>.
 
<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>
 
will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &amp;#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &amp;#124; or {{lb}}!{{rb}}
: {{lb}}                  use &amp;#123; twice or {{lb}}lb{{rb}}
: {{rb}}                  use &amp;#125; twice or {{lb}}rb{{rb}}
: unmatched &#91;&#91;        use &amp;#91; twice
: unmatched &#93;&#93;        use &amp;#93; twice
: # at start of line          use &amp;#35;
: * at start of line          use &amp;#42;
 
As an alternative to all of these escapes, you could instead wrap the body in &lt;nowiki> tags.
 
 
<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code>&lt;pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.
 
<!-- this extension not present
<math>
\sum_{n=0}\infty\frac{x^n}{n!}
</math>
-->
</dl>
 
=== Message Boxes ===
 
{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}
 
== Tables ==
 
{{Expand}}
 
=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>
 
{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
 
=== Advanced table ===
 
<pre>
{|  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
| ...
|}
</pre>
 
{|  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
| ...
|}
 
See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table
 
 
 
<!--
    <table>
        <caption>
        <th>
        <tr>
        <td>
-->
 
== Images ==
 
{{Expand}}
 
<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:
 
[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code>&lt;span title="">&lt;/span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki> <!-- <code>&lt;br style="clear:both" /></code> --> before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''
 
To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].
 
See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image
 
== Other ==
 
Create HRs like this:
<pre>----</pre>
 
<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>
 
To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>
 
A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>
 
== See also ==
 
* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup
 
There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.
 
[[Category:Wiki]]

Latest revision as of 13:08, 30 May 2017

Guidelines

Starting a page
There are 2 ways to start a new page:
  1. Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
  2. Create a [[New page]] link on an existing page, then click the link.
New pages should be assigned at least one catgeory. If it's a top-level page, it should also be added to Tutorials and Howtos, or if it concerns Alpine development, to Developer Documentation. Pages added to the latter index should include one of the categories Package Manager, ACF, or Development.
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). To experiment with markup, use Sandbox.
Moving/renaming pages
  • If the move might be controversial, propose it first and try to resolve any disagrements on the discussion page.
  • 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.)
  • In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
  • Always move the discussion 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 {{Delete}} to propose the page for deletion. (Don't clear the page's content except where it's obviously spam.)

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)
    markup and → entities are still honored
    See also below
  • <kbd> and <samp>
  • <var> and <dfn>
  • <cite>
  • <q>
  • {{Hint|term|explanation}}
  • {{Path|/a/path/name}}
  • {{Key| Ctrl}}+{{Key| C}}
  • Here is one line, followed by <br />
    and another line.
  • Here is <!-- a comment -->.

Links

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 {{Pkg|gtk+2.0}}: gtk+2.0.

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).

[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info].

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__.

Start headings at level 2, and don't skip levels.

== Heading2 ==

will produce:

Heading2

=== Heading3 ===

will produce:

Heading3

==== Heading4 ====

will produce:

Heading4


{{Delete|Message.}}

will produce:

This material is proposed for deletion ...

Message. (Discuss)
Make sure no other pages link here and check the page's history before deleting.

{{Obsolete|Alternate message.}}

will produce:

This material is obsolete ...

Alternate message. (Discuss)

{{Merge|Page to merge with|Additional message.}}

will produce:

This material is proposed for merging ...

It should be merged with Page to merge with. Additional message. (Discuss)

{{Move|New page name|Reason.}}

will produce:

This page is proposed for moving ...

It should be renamed to New page name. Reason. (Discuss)

{{Draft|Alternate message.}}

will produce:

This material is work-in-progress ...

Alternate message.
(Last edited by Dubiousjim on 30 {{{05}}} 2017.)

{{Expand|Alternate message.}}

will produce:

This material needs expanding ...

Alternate message.

{{Style|Alternate message.}}

will produce:

This material needs wiki syntax or style improvements ...

Alternate message.

Block elements

Lists

# 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:

  1. Here is a numbered list item.
    1. Doubly-numbered
    • Numbered and bulleted.
  • Here is a bulleted list item.
    • Doubly-bulleted
    1. Bulleted and numbered.
    2. Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:

<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>

and similarly for <ul>. Closing </li> tags are permitted but not necessary.

Each of these:

;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>

will produce:

item
Body text

The second markup option also wraps a <span id="item"> around the block. Note that with the third option, you shouldn't use closing </dt> or </dd> tags.

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]].
User input

{{Cmd|a <var>command</var> to try}}

This is a block-level equivalent for the inline HTML element <kbd>. Note that wiki markup is still honored in the command text; but whitespace is not collapsed. See below for how to escape some special characters.


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 <samp> or <code>.

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 converted, though entities still are. You must escape characters as follows:

= not inside [[..]] use &#61; or {{=}}
| not inside [[..]] use &#124; or {{!}}
{{ use &#123; twice or {{lb}}
}} use &#125; twice or {{rb}}
unmatched [[ use &#91; twice
unmatched ]] use &#93; twice
# at start of line use &#35;
* at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.


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} in a style attribute.

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.

Simple table

{| cellpadding="5" border="1" class="wikitable"
|- 
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
Row 1 Row 2 Row 3
1.1 1.2 1.3
2.1 2.2 2.3

Advanced table

{|  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
| ...
|}
The table's caption
columnlabel 1 columnlabel 2 columnlabel 3
rowlabel1 Cell 1 Cell 2 Cell 3
Cell A Cell B Cell C
rowspan=2 Cell D ...

See also:



Images

This material needs expanding ...

Please feel free to help us complete it.

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
will produce:
Caption text


Options can appear in any order:

  • Caption text defaults to filename; to wholly suppress, use <span title=""></span>
  • alt=text
  • Size can be [width][xheight]px
  • page=number, for PDF images
  • rendered inline, Caption shows as hover text: frameless, and/or border
    • rendered inline, on separate line: none
    • Valign for inline images, defaults to middle: middle|baseline|sub|super|top|text-top|bottom|text-bottom
    • Text flow can be stopped by placing {{Clear}} before the text that should start below the floating image
    • link=URL|pagetitle|blank, only for inline images
  • rendered floating, defaults to right align, Caption displayed below image: thumb, thumb=alternate filename, frame (ignores size options)
    • rendered floating, defaults to thumb: left|right|center

To instead link to the file, you need to add a colon: File:Alpinelinux 01.png.

See also:

Other

Create HRs like this:

----

Every page should be assigned at least one Category, by placing the following at the bottom of the page:

[[Category:Category name]]

To link to a Category page, without adding the linking page to the category: [[:Category:Not in this category]]

A redirect page should contain only:

#REDIRECT [[pagename]]

See also

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.