Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
zh:wiki:wikirules [2018/02/08 12:04] – [准则] xfy9326zh:wiki:wikirules [2018/08/08 07:38] – ↷ Links adapted because of a move operation tmomas
Line 1: Line 1:
 ====== 维基贡献指南====== ====== 维基贡献指南======
  
 +下面的准则将有助于保持wiki的一致性,对于新手通俗易懂,同时便于偶然贡献者编辑。
  
- +某些情况下可能有例外情况,除非您有一个充分的理由。
-下面的标准应该有助于保持wiki的一致性,易于理解新手,易于编辑。 +
- +
-某些情况下可能有例外情况,但你应该有一个很好的理由。+
  
 ===== 准则 ===== ===== 准则 =====
-  - **文章必须易于阅读和易于编辑,越简单越好** 应仅使用编辑器GUI中的基本功能对文章进行格式化,并在必要时加上代码标记和表格结构。\\ 为什么? 更高级的格式可以使这个维基更“专业”一些,但是对于临时用户和贡献者来说,阅读和编辑也更困难。 带有标签和按钮的更高级布局更加紧凑,但通常比简单的布局比如一个列表的操作链接供读者滚动和点击更容易让人头疼。 还应该有一个简单的非交互式布局可以轻松打印。 例如,看这个教程[[docs:guide-quick-start:factory_installation | 工厂安装:首次在设备上安装LEDE]].\\ \\ +  - **文章必须易于阅读和编辑,越简单越好**应仅使用编辑器GUI中的基本功能对文章进行格式化,并在必要时加上代码标记和表格结构。\\ 为什么?更高级的格式可以维基看起来更“专业”一些,但是对于临时用户和贡献者来说,阅读和编辑也更困难。 使用标签和按钮的更高级布局可以让页面更加紧凑,但通常比只提供一个操作列表和供读者滚动和点击的链接这样的简洁布局更容易让人头疼。除此之外,一个简单的非交互式布局可以方便的打印。[[docs:guide-quick-start:factory_installation | 工厂安装:首次在设备上安装]] 这个教程就是一个很好的范例。\\ \\ 
-  - **避免在这个wiki中复信息** 关于同一主题的信息只会出现在维基上** //一次// **。如果需要在别的地方显示同的内容,我们建议使用一下链接!\\ 如,如果您正在编写教程,并且其中一个步骤是“配置USB存储器”,您应该链接到 [[docs:user-guide:usb-drives|使用存储设备]]不要在新的教程中写下或复制粘贴相同的程序!\\ \\ +  - **避免在维基出现重复信息** 关于同一主题的信息只在维基上出现** //一次// **。如果需要在其他地方显示同的内容,我们建议使用链接!\\ 如,如果您编写教程其中一个步骤是“配置USB存储器”,您应该链接到 [[docs:guide-user:storage:usb-drives|使用存储设备]]不要在新的教程中写下或复制粘贴相同的步骤!\\ \\ 
-  - **避免重复上级文件** 考虑提供文档的更通用的部分** //上级// **, 并链接到您的文章中。例如,这个维基就存在于OpenWrt相关的文档中 [[docs:user-guide:basic-ipv4-configuration | 基本-IPv4的配置]]。上级维基的一些例子,比如:[[https://wireless.wiki.kernel.org/|Linux WiFi驱动维基]],[[https://community.openvpn.net/openvpn/wiki|OpenVPN维基]] 等等。不是所有的人都使用维基,也不是都接受第三方的贡献。 如果上级的贡献无法获得的,那么在OpenWrt wiki中获得这些信息也是很好的。\\ \\ +  - **避免重复上级文件** : 考虑提供文档的更通用的部分** //上级// **, 并链接到您的文章中。例如,这个维基就存在于OpenWrt相关的文档中 [[docs:guide-user:network:ipv4:start| 基本-IPv4的配置]]。上级维基的一些例子,比如:[[https://wireless.wiki.kernel.org/|Linux WiFi驱动维基]],[[https://community.openvpn.net/openvpn/wiki|OpenVPN维基]] 等等。不是所有的人都使用维基,也不是都接受第三方的贡献。 如果上级的贡献无法获得的,那么在OpenWrt wiki中获得这些信息也是很好的。\\ \\ 
-  - **版本信息**文章中的信息应该是针对 **//目前的稳定版本//** 有效的 。旧版本相关的信息应被标记为这样: **仅适用于较旧版本或快照版本(不推荐使用或非常新功能)**。\\ \\+  - **版本信息** : 文章中的信息应该是针对 **//目前的稳定版本//** 有效的 。旧版本相关的信息应被标记为这样: **仅适用于较旧版本或快照版本(不推荐使用或非常新功能)**。\\ \\
   - **文章应该很容易找到** 大多数人会用他们选择的搜索引擎搜索信息,或者用wiki自己的内部搜索。 使用简短的描述性标题和介绍,其中包含正确的关键字。 你可以尝试用你最喜欢的搜索引擎来搜索你的文章(几天后再搜索你发布文章,因为搜索引擎需要时间来更新他们的索引)。 如果你不能找到自己的内容,其他人可能也不会那么容易找到!\\ 比如:**在 安装点 以外的 地方 安装 opkg 软件包 ** 是一个很长的标题,可以用// opkg - 安装位置 //来代替,但是当没有人浏览wiki时,后者不会像第一个那样容易找到,而是使用搜索引擎。\\ \\   - **文章应该很容易找到** 大多数人会用他们选择的搜索引擎搜索信息,或者用wiki自己的内部搜索。 使用简短的描述性标题和介绍,其中包含正确的关键字。 你可以尝试用你最喜欢的搜索引擎来搜索你的文章(几天后再搜索你发布文章,因为搜索引擎需要时间来更新他们的索引)。 如果你不能找到自己的内容,其他人可能也不会那么容易找到!\\ 比如:**在 安装点 以外的 地方 安装 opkg 软件包 ** 是一个很长的标题,可以用// opkg - 安装位置 //来代替,但是当没有人浏览wiki时,后者不会像第一个那样容易找到,而是使用搜索引擎。\\ \\
-  - **文章应该解释他们为什么存在,他们的目的是什么**。 请在说明您正在配置的功能的情况下添加“介绍”一段或两段,并按照说明来满足需求。 它不需要非常冗长。 例如,这里的第一段: [[docs:user-guide:imagebuilder|使用固件生成器(ImageBuilder)]] \\ \\ +  - **文章应该解释他们为什么存在,他们的目的是什么**。 请在说明您正在配置的功能的情况下添加“介绍”一段或两段,并按照说明来满足需求。 它不需要非常冗长。 例如,这里的第一段: [[docs:guide-user:additional-software:imagebuilder|使用固件生成器(ImageBuilder)]] \\ \\ 
-  - **文章应该包含“可验证”的信息,推测应明确标注**。 真的,这在任何wiki中都是非常重要的。 引用不常用的语句来源,或者编写足够的信息以便于谷歌搜索源代码。 例如:[[zh:docs:user-guide:usb3.0-wifi-issues|USB 3.0和WiFi问题]] \\ \\+  - **文章应该包含“可验证”的信息,推测应明确标注**。 真的,这在任何wiki中都是非常重要的。 引用不常用的语句来源,或者编写足够的信息以便于谷歌搜索源代码。 例如:[[zh:docs:guide-user:network:wifi:usb3.0-wifi-issues|USB 3.0和WiFi问题]] \\ \\
   - **你写的所有教程都必须亲自测试,否则必须警告** 声明该教程没有经过测试(并且在成功测试的时候去掉警告)。 \\ \\   - **你写的所有教程都必须亲自测试,否则必须警告** 声明该教程没有经过测试(并且在成功测试的时候去掉警告)。 \\ \\
   - **每篇文章有一个主题**。文章应该集中在单一的,重点突出的主题上,例如“**安装和配置Adblock **”。 一般性文章涵盖了许多不同的主题,例如“**过滤网页流量**”(您可以谈论Adblock,代理服务器,也可能是Tor和VPN)。\\ \\   - **每篇文章有一个主题**。文章应该集中在单一的,重点突出的主题上,例如“**安装和配置Adblock **”。 一般性文章涵盖了许多不同的主题,例如“**过滤网页流量**”(您可以谈论Adblock,代理服务器,也可能是Tor和VPN)。\\ \\
-  - **大篇幅的教程应该分开**。每个步骤很长的大型教程应该分成不同的文章,每个文章都包含一部分步骤。 如果教程包含条件步骤或可选步骤(例如:“如果执行步骤 ** A **,那么您可以执行** B **或** C **,然后执行** D **“)。 例如[[docs:guide-quick-start:factory_installation | 工厂模式安装:首次在设备上安装LEDE]] 或者[[docs:guide-developer:helloworld:start | "Hello, world!"LEDE编写第一个程序]] \\ \\+  - **大篇幅的教程应该分开**。每个步骤很长的大型教程应该分成不同的文章,每个文章都包含一部分步骤。 如果教程包含条件步骤或可选步骤(例如:“如果执行步骤 ** A **,那么您可以执行** B **或** C **,然后执行** D **“)。 例如[[docs:guide-quick-start:factory_installation | 工厂模式安装:首次在设备上安装]] 或者[[docs:guide-developer:helloworld:start | "Hello, world!"OpenWrt编写第一个程序]] \\ \\
   - **文章应该可以从维基内访问** 如果是某种教程,请确保您的文章在其中一个主要类别页面(下面的链接)中有链接。 如果某些文章是多篇文章教程的一部分,则可能不需要这篇文章在类别页面有链接,但要确保所有文章都可以从主要类别页面或多篇文章教程的其他页面中获得。 非常受欢迎的文章也可以链接到其他教程,如解释 **避免重复信息在此维基百科上面** 的口头禅。 点击右侧工具面板上的“**链**”图标(位于 **时钟** 图标下方),就可以方便的获取当前页面的链接。\\ \\   - **文章应该可以从维基内访问** 如果是某种教程,请确保您的文章在其中一个主要类别页面(下面的链接)中有链接。 如果某些文章是多篇文章教程的一部分,则可能不需要这篇文章在类别页面有链接,但要确保所有文章都可以从主要类别页面或多篇文章教程的其他页面中获得。 非常受欢迎的文章也可以链接到其他教程,如解释 **避免重复信息在此维基百科上面** 的口头禅。 点击右侧工具面板上的“**链**”图标(位于 **时钟** 图标下方),就可以方便的获取当前页面的链接。\\ \\
  
Line 23: Line 21:
 为了给Wiki提供更好的结构,我们使用“命名空间”和“类别”(和“标签”): 为了给Wiki提供更好的结构,我们使用“命名空间”和“类别”(和“标签”):
   * **命名空间** 是最上层的。 在每个上层命名空间中,最多有三(3)个子层。   * **命名空间** 是最上层的。 在每个上层命名空间中,最多有三(3)个子层。
-    * //[[about:|关于]]// 关于一般的OpenWrt项目+    * //[[zh:about:|关于]]// 关于一般的OpenWrt项目
     * //[[zh:toh:|TOH]]// 有关支持的设备的文档,称为“硬件表”     * //[[zh:toh:|TOH]]// 有关支持的设备的文档,称为“硬件表”
     * //[[zh:packages:|软件包]]// 关于可用软件包的文档     * //[[zh:packages:|软件包]]// 关于可用软件包的文档
  • Last modified: 2023/12/23 06:58
  • by heybrowhatsup