OBS Books 项目
2011年1月18日 | 新闻团队 | 无许可
openSUSE 构建服务 (OBS) 有一个问题。它非常强大,但鲜为人知。或者说,没有人知道如何简短地利用它。
我们的文档目前只存在于 wiki 中。虽然 wiki 仍然并将继续作为文档资源,但我们中的一些 OBS 用户和开发者认为我们需要一些更结构化和编辑过的东西。简而言之,一本你可以阅读以获得完整概述的书。
因此,我们开始创建编写此类书籍的基础设施,它是 openSUSE 文档项目的一部分。这意味着文档是用 docbook 编写的,并托管在 svn 中。
docbook 代码目前每天生成一次 HTML。目前设置了两本书,一本作为 参考指南,另一本作为 最佳实践指南。
docbook 的优点在于,我们还可以将特定于实例的内容包含在其中,例如仅对 build.opensuse.org 或 build.meego.com 有效的章节或段落。之后,我们可以从这个通用源代码生成特定的书籍。
到目前为止,这两本书中唯一真正存在的文章是关于如何参与书籍编写的文章。所以来吧,提供补丁或在 berlios 上创建一个帐户以获得直接提交权限。目前你不需要完全了解 OBS,了解某个领域的知识就足够了。我们稍后会改进它。
目前也不要太在意当前的结构。一旦我们有更多内容,我们会重新考虑它。
请阅读当前的 序言,它定义了这些书的目标。
这些书的许可也与 openSUSE wiki 中文本的许可相同 (GFDL)。这意味着我们可以将 wiki 中的所有文本部分复制到书中,反之亦然。
当然,请加入 opensuse-buildservice 邮件列表,讨论任何文章、目标或建议。没有什么是不变的 :)
分类: 构建服务
标签