用户:Prabuanand/编辑
一次编辑可以贡献全新的段落或页面信息，也可以简单到修复一个排印错误或拼写错误。请确保您的目标始终是做一些改进 wiki 内容的事情。
在编辑或创建页面之前，请参考Wiki 礼仪、帮助:阅读和帮助:样式页面，以了解 Alpine Linux wiki 中遵循的通用约定。
如需更多参考，请使用 MediaWiki 和 Wikipedia 的帮助页面，因为此 wiki 也由 MediaWiki 驱动。
编辑 Wiki 的步骤
- 点击页面顶部的
编辑页面标签。对文本进行更改。当您需要使用某种类型的格式，例如新标题或文本加粗时，您可以使用 wiki 语法或编辑区上方编辑工具栏中的按钮来完成。 - 在保存更改之前，您必须在
摘要框中输入一个简短的注释来描述您的更改。 - 如果编辑是修复排印错误或拼写错误，请选中
这是一个小编辑框，将编辑标记为小修改。 - 最好在保存之前使用
显示预览按钮查看您的更改效果。养成在保存前使用预览来消除自己工作中错误的习惯是很好的，而不是保存后不得不进行另一次编辑来做一次或多次小的更正。 - 另一个选项是
显示更改按钮，它允许您查看当前版本和编辑版本之间的差异。 - 点击
保存更改按钮保存更改。如果不满意，请点击取消并重新操作。
创建页面
开始页面
有两种方法可以开始一个新页面
- 在现有页面上创建一个
[[新页面标题]]链接，然后点击保存。再次打开该页面，然后点击红色 新页面标题 链接，即可转到新页面的编辑页面。（推荐） - 在地址栏中输入新页面的 URL，并带有正确的
[[新页面标题]]。例如：https://wiki.alpinelinux.cn/wiki/新页面标题。
在以上两种情况下，只需在新页面中输入您的文本，保存即可创建新页面。新页面应至少分配一个分类。教程还应添加到教程和指南，或者如果它涉及 Alpine 开发，则添加到开发者文档。
临时页面
如果您希望创建一个临时页面，请使用您用户命名空间的子页面。例如：User:用户名/临时页面。这有助于保持主命名空间的整洁，并防止页面在正常搜索中出现（默认情况下不搜索用户命名空间）。
移动或重命名页面
- 如果移动可能存在争议，请先提出建议，并尝试在讨论页面上解决任何分歧。
- 新名称必须是不存在的页面，或者是以重定向页面形式存在，且其页面历史记录中只有 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/path/name}}
- {{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|尝试的 <var>command</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 属性。CSS 样式属性可以与其他 HTML 属性一起添加或不一起添加。表格对齐是通过使用 CSS 实现的。有关更多信息，请参阅 mediawiki 官方指南，网址为 表格
{| 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 官方指南，网址为 图片
[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
将产生
选项可以以任何顺序出现
- 标题文本 默认为文件名；要完全抑制标题，请使用
<span title=""></span> - alt=文本
- 大小可以是 [宽度][x高度]px
- page=数字，用于 PDF 图片
- 行内渲染，标题显示为悬停文本：无框架，和/或 边框
- 行内渲染，在单独的行上：无
- 行内图片的垂直对齐方式，默认为居中：middle|baseline|sub|super|top|text-top|bottom|text-bottom
- 可以通过在应在浮动图像下方开始的文本之前放置 {{Clear}} 来停止文本流
- link=URL|页面标题|blank，仅适用于行内图片
- 浮动渲染，默认为右对齐，标题显示在图像下方：缩略图，thumb=备用文件名，框架（忽略大小选项）
- 浮动渲染，默认为缩略图：左|右|居中
要改为链接到文件，您需要添加一个冒号：File:Alpinelinux 01.png。
签名
在讨论页中，签名并注明您的帖子日期。添加 --~~~~ 会给出签名和时间戳：--Dubiousjim 10:00, 2012 年 3 月 4 日 (UTC)
其他元素
像这样创建水平线
----
----
链接
链接用于引用此 wiki 中的页面、其他 Alpine Linux 网站或外部网站。
内部链接
有效的内部链接或 wikilink [[Kernels|Linux Kernel wiki 页面]] 将产生：Linux Kernel wiki 页面。
当您预览或保存更改时，您将看到一个链接，可以跟随该链接到达目标页面。如果页面存在，则链接以蓝色显示（如上面的“Linux Kernel wiki 页面”一词）；如果页面不存在，则链接显示为红色。点击指向缺失页面的“红链”（无论它是否实际上是红色）通常会使用户能够创建该页面。
特殊链接
对于 仓库中的官方软件包
使用 {{Pkg|gtk+2.0}} 将产生：gtk+2.0。
使用 {{Issue|279}} 将产生：#279。问题描述可以作为可选的第二个参数包含在内。
使用 {{MR|73024|Description}} 将产生：!73024. Description。此处，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.}}
将产生
 备用消息。 |