帮助:迁移

跳转到:导航搜索
迁移指南描述了在迁移旧维基实例的文章时应遵循的基本步骤,以确保平稳高效的过渡。

了解与旧维基的区别

旧维基是 openSUSE 项目拥有的第一个维基。我们最初没有真正的概念,也没有对人们会如何使用工具维基的经验。在其 5 年的生命周期中,我们将其用于所有事情:作为登陆页面和营销页面、新闻发布渠道、协作空间、硬件/知识库、日历、粘贴板、团队应用程序等等。基本上,我们试图将整个 openSUSE 项目映射到维基中,并将其用于每项可能的任务。这太繁琐了,最终变成了一个简单的信息转储。

人们在浏览器中打开 https://en.opensuse.net.cn/Foobar 并添加关于 Foobar 的内容。在大多数情况下,Foobar 是关于 Foobar 的文章以及他们遇到的问题的解决方案。在某些情况下,Foobar 是关于特定主题的一组文章。在几乎没有情况下,人们会确保 Foobar 正确地与维基的其余部分集成。没有结构,没有导航方式,也没有一致的外观和感觉。

我们现在试图将这些描述的相反之处带到这个实例中。我们希望尊重维基是一种工具,并将其用于擅长的事情:每个人都可以协作编辑。我们不想将其用于 openSUSE 项目中发生的一切。所以我们有这个四支柱战略


概念概述了 openSUSE 维基的工作方式以及应如何维护它。

结构:命名空间

此维基中的内容通过所谓的 命名空间 分隔成主题。这些命名空间对应于我们访问者的兴趣。两个最重要的主题是 主页 命名空间,其中包含关于 openSUSE 发行版当前版本的页面,供我们的用户使用,以及 openSUSE 命名空间,其中包含关于我们的团队、策略和活动的页面,供我们的贡献者使用。

请参阅 帮助:命名空间,以获取关于我们所有命名空间的更精确的介绍。

导航:链接、分类和门户

导航通过与任何维基通用的方式进行,即 。还有称为 门户分类 的链接集合。分类 是关于某个主题的自动生成概述页面,门户 是关于某个主题的手动策划概述页面。我们的导航帮助读者找到他们想要的内容,无论是单个文章还是关于某个主题的概述。

请参阅 帮助:分类帮助:门户,以获取关于我们的导航的更精确的介绍。

样式:模板

此维基中内容的样式是通过 模板 完成的。有两种类型的模板:文章模板和片段模板。文章模板是用于特定类型的页面,例如门户或支持数据库文章的模板。片段模板用于对页面中重复出现的内容进行样式化,例如介绍或包含信息的框。通过这些样式模板,我们可以确保人们理解我们生成的内容。

请参阅 帮助:样式,以获取关于我们的样式的更精确的介绍。

质量保证:页面验证

此维基中的突出命名空间受质量保证 (QA) 流程约束,以确保文章符合要求的质量。此 QA 流程通过 页面验证 系统进行。页面验证意味着一组人员在其他人可见之前审核对文章的所有更改。页面验证不会限制创建新内容,但仅允许默认显示高质量内容。通过此流程,我们可以确保首次访问者被吸引到我们的维基并留下来。

请参阅 帮助:页面验证,以获取关于我们的质量保证的更精确的介绍。

翻译

我们概念的重要组成部分是维基内容必须可供不使用英语阅读或贡献文章的人访问。我们有多个 维基翻译项目 用于各种语言,并且我们还有一个 多语言维基,可用于启动新的维基翻译项目。

请参阅 帮助:翻译,以获取关于我们的翻译工作的更精确的介绍。



在一切之上,请确保您了解这个策略以及与旧维基的区别。用旧实例的思维方式在这个维基中工作是没有意义的。您只会感到困惑并让其他人感到困惑。

如何决定要迁移哪些文章

解决你的痒

开源激励“解决你的痒”是决定迁移哪些文章的好方法。您是否缺少发行版功能的描述?问题的解决方案?您团队的页面?那就迁移它吧!

热门页面

如果您没有缺少任何东西,但仍然想提供帮助,旧实例中会自动生成一个 热门页面列表,让您了解读者正在寻找什么,请查看是否有尚未迁移的内容。

如何迁移文章

首先,您应该检查要迁移的文章的内容。请勿迁移与过时技术(例如 ZMD)相关的文章、仅关于“停止维护”版本(早于 11.0)的支持数据库文章、不再活跃的团队/项目页面(例如 JackLab)或类似内容。我们只想迁移从现在开始重要的内容,并且我们希望与旧维基向后兼容。如有疑问,请在 #opensuse-wiki IRC 频道或 openSUSE-wiki 邮件列表中询问维基团队成员。

整个主题

最佳实践是选择一个主题并迁移属于该主题的每篇文章。这样可以确保以一致的方式迁移所有必需的文章。您应该从门户开始。通常,某个主题已经有一个介绍页面,但不是以 门户 格式。例如

将这些页面调整为门户格式不仅会使门户准备就绪,还会让您了解该主题的重要文章。调整样式后,门户上会有很多红色链接,请按照这些链接并迁移各个文章。如果各个文章使用 模板,而 帮助:标准模板 上没有同等模板,请尝试找到一个等效模板。在 帮助:样式 上可以找到内容样式的通用帮助。最后,确保您的门户可以从 主页 访问,无论是直接访问还是通过另一个门户访问。还要确保您已迁移的所有页面至少位于一个 分类 中。

单个文章

如果您正在迁移单个文章,因为门户或您已经可以链接到的单个文章存在,请跳过上述描述中的所有门户步骤。