How To Use The Wiki
目录
如何创建新的 Wiki 页面
请参阅 MediaWiki 帮助内容,了解有关使用 MediaWiki 的文档。对于 OpenStack wiki,请始终考虑向页面添加一个分类,遵循下面描述的分类法。
Wiki 技术文档
此 wiki 使用 MediaWiki 技术,并使用 MediaWiki 语法和标记,请在 http://www.mediawiki.org/wiki/Help:Formatting 了解更多信息。
OpenStack 发展迅速,因此尽管我们尽了最大的努力,但此 wiki 上仍会出现过时的内容。本文概述了您可以协助保持我们的 wiki 清洁的一些方法。
Wiki 分类法
为了使 wiki 的 350 多个页面更易于导航,已经建立了一个 分类法。添加分类法和模板(即将推出)可以帮助新手发现相关内容并更轻松地在 wiki 上找到信息。
如何使用 Wiki 分类法
在此分类法中,OpenStack Wiki 分为 5 个主要类别:Connect(连接)、Contribute(贡献)、Programs(项目)、Releases(发布)、Resources(资源)。您可以在特殊页面 Category:Home 上查看完整的树状结构。
各种 wiki 页面链接到这些主要类别,并依赖于这些主要类别。创建 wiki 上的新页面时,您可以检查分类法,以查看您的页面确切地适合哪个类别,并使其更易于查找。
要将页面链接到某个类别,只需将以下文本添加到页面的底部:[[Category:CategoryX]]
将“CategoryX”替换为您要链接到的类别的名称。
Wiki 维护
查找旧页面
MediaWiki 有一些有用的工具来查找需要关注的页面。
在“工具箱”菜单中的“特殊页面”下,您可以找到许多维护报告,包括 最旧的页面 列表。
只需遍历您选择的列表,并在进行操作时进行修复:)
旧设计页面
wiki 经常用于完善功能的設計,这些功能通常从 Launchpad 蓝图 开始。这些早期的原型设计在实施期间非常有用,但在下一个开发周期开始后发布后不久可能会过时。为了协助处理此问题,我们有两个模板可以使用。只需将代码包含在 wiki 页面的顶部,即可添加横幅。
{{ImplementedFeature}}
| |
旧设计页面
此页面用于帮助设计已实现的功能。因此,此页面可能不会更新,并且可能包含过时的信息。上次更新时间为 2018-03-21 |
{{OldDesignPage}}
| |
旧设计页面
此页面用于帮助设计 OpenStack 的先前版本的功能。它可能已实现,也可能未实现。因此,此页面可能不会更新,并且可能包含过时的信息。上次更新时间为 2018-03-21 |
已过时页面
通常,如果您看到过时的页面,最好尝试改进它。但是,有些页面由于各种原因(例如,它们过时到无法修复,并且其出现在搜索结果中会导致大规模混淆)应强烈标记为如此。
为此,我们有 Obsolete 命名空间。
要将页面移动到此墓地,请在顶部菜单中单击“操作”、“移动”,然后在以下表格中选择“Obsolete”命名空间。
注意:wiki 上的“移动”命令是管理员操作;请联系 wiki 管理员以执行更改。恢复错误的移动比删除页面更容易。
但是,仅仅因为页面很旧,并不一定意味着应该将其移动出去 - 有时我们需要参考旧的蓝图计划来查看历史记录,并且回顾奥斯汀峰会的情况也很好,因此请谨慎使用。
您可以在此处查看 Obsolete 命名空间中的页面列表 此处
帮助真实用户避免 CAPTCHA (需要管理员权限)
由于此 wiki 上存在大量垃圾邮件问题,因此默认情况下,用户必须填写 CAPTCHA 才能编辑帖子。
这可能会让频繁用户感到烦恼,因此有一个名为“autopatrol”的群组可以避免这种情况。“autopatrol”群组包含一个经过人工验证的“真实”用户列表。除了避免 CAPTCHA 之外,这些用户的帖子也会自动标记为“已巡逻”,这有助于隔离垃圾邮件。
查找应具有该状态的用户
- 打开最近更改列表,隐藏“已巡逻”编辑:https://wiki.openstack.org/w/index.php?title=Special:RecentChanges&hidepatrolled=1&limit=500
- 单击用户名旁边的“贡献”,这将带您到该用户的贡献列表
- 评估贡献,可以选择单击以查看多个编辑的“差异”
- 如果用户进行了许多建设性的编辑,或者以其他方式是 OpenStack 社区的已知成员,请继续“添加该状态”
或者
- 如果 OpenStack 社区的已知成员联系了 wiki 管理员,并提供了指向其 wiki 用户页面的链接,请继续“添加该状态”
添加该状态
- 从用户页面,单击“用户权限管理”
- 选中“已验证用户”
- 添加理由,例如“已验证用户(这意味着您的帖子被视为“非垃圾邮件”,您无需进行 CAPTCHA”
- 单击“保存用户组”