帮助:编辑
一次编辑可以贡献全新的段落或页面信息，也可以简单到修复一个错别字或拼写错误。请始终确保您的目标是改进 wiki 的内容。
在编辑或创建页面之前，请参考Wiki 礼仪、帮助:阅读和帮助:样式页面，以概述阿尔派 Linux wiki 中遵循的常用约定。
如需更多参考，请使用 MediaWiki 和 维基百科 的帮助页面，因为本 wiki 也由 MediaWiki 驱动。
编辑 Wiki 的步骤
- 点击页面顶部的
编辑页面选项卡。对文本进行更改。当您需要使用某种类型的格式，例如用于新标题或文本加粗时，您可以使用 wiki 语法或编辑区上方编辑工具栏中的按钮来完成此操作。 - 在保存更改之前，您必须在
摘要框中输入简短的注释来描述您的更改。 - 如果编辑是修复错别字或拼写错误，请选中
这是一个小编辑框，将编辑标记为小编辑。 - 最好使用
显示预览按钮来查看您的更改效果，然后再保存。养成在保存前使用预览来消除您自己工作中的错误，而不是保存后再进行另一次编辑以进行一个或多个小的更正，这是一个好习惯。 - 另一个选项是
显示更改按钮，它允许您查看当前版本和编辑版本之间的差异。 - 点击
保存更改按钮以保存更改。如果不满意，请点击取消并重新操作。
创建页面
开始创建页面
有两种方法可以开始创建新页面
- 在现有页面上创建一个
[[新页面的标题]]链接并点击保存。再次打开该页面，然后点击红色的新页面的标题链接，将您带到新页面的编辑页面。（推荐） - 在地址栏中输入带有正确
[[新页面的标题]]的新页面的 URL。例如：https://wiki.alpinelinux.cn/wiki/新页面的标题。
在上述两种情况下，只需在新页面中输入您的文本，保存即可创建新页面。新页面应至少分配一个分类。教程也应添加到教程与指南，或者如果它与 Alpine 开发有关，则添加到开发者文档。
临时页面
如果您希望创建临时页面，请使用您用户命名空间的子页面。例如：User:用户名/Temporary page。这有助于保持主命名空间的整洁，并防止页面出现在正常搜索中（默认情况下不搜索用户命名空间）。
移动或重命名页面
- 如果移动可能引起争议，请先提出建议，并尝试在讨论页面上解决任何分歧。
- 新名称必须不存在页面，或者作为重定向页面存在，且页面历史记录中只有 1 个条目。
- 使用侧边栏中的“链入页面”链接，并确保更新所有指向内部页面目标的链接。如果未完成此操作，则会创建双重重定向。（即重定向指向另一个重定向，在这种情况下，仅会自动跟踪第一个重定向。）
- 在默认的 wiki 皮肤中，移动页面（以及监视页面）的链接位于“查看历史”和搜索框之间的弹出菜单中。
- 始终移动讨论页面，除非您有非常充分的理由不这样做。
删除页面
只有管理员可以删除页面。其他用户应使用 {{Delete}} 来提议删除页面。（不要清除页面的内容，除非它明显是垃圾信息。）
格式化
行内元素
- ''斜体'' 或使用 <i> 或 <em> 或 {font-style:italic} 在样式属性中
- '''粗体''' 或使用 <b> 或 <strong> 或 {font-weight:bold} 在样式属性中
- <small> 或使用 {font-size:smaller} 在样式属性中
- <big>或使用 {font-size:larger} 在样式属性中（在 HTML5 中无效）
- <sup> 或使用 {vertical-align:super} 在样式属性中
- <sub> 或使用 {vertical-align:sub} 在样式属性中
- <font> 已弃用；请使用 {font-size:10pt; color:red; font-family:"Courier"} 在样式属性中
- <span style="color:gray">
- <span style="color:white; background:red">
- <u> 或使用 <ins> 或 {text-decoration:underline} 在样式属性中（<u> 在 HTML5 中有效，但在 HTML4/strict 中无效；<ins> 也可以是块级元素）
<s>或使用<del>或 {text-decoration:line-through} 在样式属性中（<s> 在 HTML5 中有效，但在 HTML4/strict 中无效；<del> 也可以是块级元素）
<code>使用 {font-family:monospace;} （<tt> 在 HTML5 中无效）标记 和 → 实体仍然有效- 另请参阅下方
- <kbd> 和 <samp>
- <var> 和 <dfn>
- <cite>
<q>
- {{Hint|术语|解释}}
- {{Path|/a/路径/名称}}
- {{Key| Ctrl}}+{{Key| C}}
- 这是一行，后跟 <br />
以及另一行。
- 这里是 <!-- 注释 -->。
标题
一篇包含 4 个或更多标题的文章会自动创建目录。您可以通过插入 __TOC__ 来强制显示目录（或微调其位置）。您可以通过插入 __NOTOC__ 来禁止显示目录。
从级别 2 开始标题，并且不要跳过级别。不允许使用一级标题，其格式保留用于文章标题。
== Heading2 ==
=== Heading3 ===
==== Heading4 ====
列表
# Here is a numbered list item. ## Doubly-numbered #* Numbered and bulleted. * Here is a bulleted list item. ** Doubly-bulleted *# Bulleted and numbered. *# Another item.
将产生
- 这是一个编号列表项。
- 双重编号
- 编号和项目符号。
- 这是一个项目符号列表项。
- 双重项目符号
- 项目符号和编号。
- 另一个项目。
空行或非项目符号/编号行会结束列表。您也可以手动编写列表代码，这样可以更灵活地处理多行条目和样式
<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>
<ul> 类似。允许使用关闭 </li> 标签，但不是必需的。
这些中的每一个
;item: Body text
{{Define|item|Body text}}
<dl>
<dt>item
<dd>Body text
</dl>
将产生
- 项目
- 正文文本
第二个标记选项还在块周围包装了一个 <span id="item">。请注意，使用第三个选项时，您不应使用关闭 </dt> 或 </dd> 标签。
缩进
: Simply indented text (on left side only). <blockquote>This is a blockquote. It collapses whitespace, and indents on both sides.</blockquote>
将产生
- 简单缩进文本（仅在左侧）。
这是一个块引用。它会折叠空格，并在两侧缩进。
显示代码
- 行内代码
- 使用
<code>进行样式设置，并使用<nowiki>来抑制标记。如果您同时使用两者，它们必须按此顺序出现。<nowiki>转换 → 实体并折叠空格（甚至多个\n），但忽略所有 '''wiki''' 和<span style="color:green">HTML</span>[[标记]]。 - 用户输入
{{Cmd|要尝试的 a <var>命令</var>}}
这是行内 HTML 元素
<kbd>的块级等效项。请注意，wiki 标记在命令文本中仍然有效；但空格不会被折叠。请参阅下文，了解如何转义某些特殊字符。
- 命令输出；或混合提示符、用户输入和命令输出的 shell 会话；或文件段
- 使用空格缩进块或
<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>
将产生
Every line begins with a space.
Lines aren't indented with '''a space.'''
Only first line begins with '''a space'''.
所有这些都呈现为样式化的块，采用等宽字体，并且不折叠空格。它们是行内 HTML 元素
<samp>或<code>的块级等效项。所有这些标记选项都转换 → 实体。第一个还处理 '''wiki''' 和 <span style="color:green">HTML</span> [[标记]]。第二个和第三个不处理；并且它们给出等效的呈现效果。使用第三个选项时，第一行之后的行不应以空格为前缀；块将扩展到关闭
</nowiki>。 - 文件内容
{{Cat|/path/to/file|body '''text''' <br /> more Second line.}}将产生
内容：/path/to/file
正文 '''文本''' <br /> 更多 第二行。请注意，文件内容中的 wiki 和 HTML 标记不会被转换，但实体仍然会被转换。您必须按如下方式转义字符
- = 不在 [[..]] 内时使用 = 或 {{=}}
- | 不在 [[..]] 内时使用 | 或 {{!}}
- {{ 使用 { 两次或 {{lb}}
- }} 使用 } 两次或 {{rb}}
- 未匹配的 [[ 使用 [ 两次
- 未匹配的 ]] 使用 ] 两次
- # 在行首时使用 #
- * 在行首时使用 *
作为所有这些转义的替代方案，您可以将正文包装在 <nowiki> 标签中。
- 没有额外样式的块级代码
<p style="white-space:pre; font-family:monospace;">One line. Second line. </p>
将产生
第一行。第二行。
这将是 HTML 的
<pre>在没有任何样式的情况下的行为。要换行以适应屏幕宽度，请在样式属性中使用 {white-space:pre-wrap}。
表格
可以在 wiki 页面中创建表格。通常，最好避免使用表格，除非您需要表格，因为表格标记通常会使页面编辑复杂化。
简单表格
在 wikitext 编辑器中，将光标放在您要插入表格的位置。然后，在工具栏中，按“高级”，然后选择“表格”按钮。将打开一个对话框。
在对话框中，您可以选择是否启用表头行，是否使用边框样式化表格以及是否使表格可排序。将显示预览示例。您还可以设置所需的行数和列数。然后，按“插入”按钮。
{| class="wikitable"
|+ Optional Caption text
|-
! Header 1 !! Header 2 !! Header 3
|-
| 1.1 || 1.2 || 1.3
|-
| 2.1 || 2.2 || 2.3
|-
| 3.1 || 3.2 || 3.3
|}
| 标题 1 | 标题 2 | 标题 3 |
|---|---|---|
| 1.1 | 1.2 | 1.3 |
| 2.1 | 2.2 | 2.3 |
| 3.1 | 3.2 | 3.3 |
高级表格
您可以向表格添加 HTML 属性。可以使用或不使用其他 HTML 属性添加 CSS 样式属性。表格对齐是通过使用 CSS 实现的。有关更多信息，请参阅 mediawiki 官方指南，网址为 tables
{| border="1" style="width:75%; height:200px" <!-- align=right makes table float -->
|+ The table's caption
|-
! width=100px | Advanced Table !! columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1.1 || Cell 1.2 || Cell 1.3
|- style="height:100px; background:none" <!-- or style="background:transparent" -->
! align=right style="width:200px" | rowlabel2
| style="background:red; color:white" | Cell 2.1
| colspan=2 align=center | Cell 2.2 & 2.3
|- valign=top <!-- have to be applied to every row, default is valign=middle; or use style="vertical-align:top;" -->
! rowspan=2 | rowlabel 3 & 4
| Cell 3.1 || Cell 3.2 || Cell 3.3
|-
| Cell 4.1 || Cell 4.2 || Cell 4.3
|}
| 高级表格 | 列标签 1 | 列标签 2 | 列标签 3 |
|---|---|---|---|
| 行标签 1 | 单元格 1.1 | 单元格 1.2 | 单元格 1.3 |
| 行标签 2 | 单元格 2.1 | 单元格 2.2 & 2.3 | |
| 行标签 3 & 4 | 单元格 3.1 | 单元格 3.2 | 单元格 3.3 |
| 单元格 4.1 | 单元格 4.2 | 单元格 4.3 | |
图像
下面给出了基本示例。有关更多信息，请参阅 mediawiki 官方指南，网址为 Images
[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
将产生
选项可以按任何顺序出现
- 标题文本 默认为文件名；要完全禁止显示，请使用
<span title=""></span> - alt=文本
- 大小可以是 [宽度][x高度]px
- page=数字，对于 PDF 图像
- 内联渲染，标题显示为悬停文本：frameless 和/或 border
- 内联渲染，在单独的行上：none
- 内联图像的垂直对齐，默认为中间：middle|baseline|sub|super|top|text-top|bottom|text-bottom
- 可以通过在应在浮动图像下方开始的文本之前放置 {{Clear}} 来停止文本流
- link=URL|页面标题|blank，仅适用于内联图像
- 浮动渲染，默认为右对齐，标题显示在图像下方：thumb、thumb=备用文件名、frame（忽略大小选项）
- 浮动渲染，默认为 thumb：left|right|center
要改为链接到文件，您需要添加冒号：File:Alpinelinux 01.png。
签名
在讨论页中，签名并注明您帖子的日期。添加 --~~~~ 会给出签名和时间戳：--Dubiousjim 10:00, 2012年3月4日 (UTC)
其他元素
像这样创建 HR
----
----
链接
链接用于引用本 wiki 内的页面、其他阿尔派 Linux 网站或外部网站。
内部链接
有效的内部链接或 wikilink [[Kernels|Linux 内核 wiki 页面]] 将产生：Linux 内核 wiki 页面。
当您预览或保存您的更改时，您将看到一个链接，可以点击该链接跳转到目标页面。如果页面存在，则链接以蓝色显示（如上面的“Linux 内核 wiki 页面”一词）；如果页面不存在，则链接显示为红色。点击指向缺失页面的此类“红链”（无论它是否实际上是红色）通常会使用户能够创建该页面。
特殊链接
对于 仓库中的官方软件包
使用 {{Pkg|gtk+2.0}} 将产生： gtk+2.0。
对于现有的 aports 中的问题
使用 {{Issue|279}} 将产生： #279。问题的描述可以作为可选的第二个参数包含在内。
对于现有的 aports 中的合并请求
使用 {{MR|73024|描述}} 将产生： !73024. 描述。此处 MR 的描述已作为可选的第二个参数包含在内。
外部链接
链接到外部网站 [http://www.example.org/ 一个外部链接] 将产生： 一个外部链接。
如果未提供链接文本 [http://www.example.org/] 将产生： [1]。为避免这种情况，请省略括号并使用 http://www.example.org/ 以产生： http://www.example.org/。
为了显示没有超链接的外部 URL，请使用 <nowiki>http://www.example.org/</nowiki> 以产生 http://www.example.org。
分类
分类提供自动索引，这些索引可用作目录。这些标签在页面底部创建链接，将您带到该类别中所有页面的列表，这使得浏览相关文章变得容易。
每个页面都应至少分配一个分类，方法是将以下内容放在页面底部
[[Category:分类名称]]
在创建新类别之前，请始终使用本 Wiki 中的类别列表中的现有类别之一。要在您的 wiki 页面中引用现有类别，例如链接 Category:kernel，请使用 [[:Category:kernel]]
重定向
重定向页面应仅包含
#REDIRECT [[pagename]]
包含
当需要在多个页面中包含相同内容时，请使用包含。这有助于在多个文档中更新相同内容，而无需单独编辑这些文档。
要包含页面（例如“Daily driver guide”），必须在名称前添加冒号 (:)：{{:Daily driver guide}}
请参阅 wiki 中包含页面列表。
模板
模板是标准的 wiki 页面，其内容旨在包含在其他页面中。帮助:模板页面提供了有关设计模板的信息。可以将模板插入到文章中以帮助格式化内容。
请参阅本 Wiki 中定义的完整的模板列表。
以下消息框模板为读者提供了额外的强调。
以下消息框模板包含有关 Wiki 中页面或章节的特定问题的特定消息。
{{Delete|Message.}}
将产生
 消息。 (讨论) |
{{Obsolete|Alternate message.}}
将产生
 备用消息。 (讨论) |
{{Merge|Page to merge with|Additional message.}}
将产生
 |
{{Draft|Alternate message.}}
将产生
 备用消息。 |
{{Expand|Alternate message.}}
将产生
 备用消息。 |
{{Style|Alternate message.}}
将产生
 备用消息。 |