参与deepin社区贡献的方式有很多,除了大众所熟知的开发人员 贡献代码 途径外,给社区提供可靠的开发文档和使用者指南,也是给开源社区做贡献的方式之一。
目前deepin社区主要的文档平台有3个:
编辑文档请遵守deepin品牌专有名词指导方针
https://wiki.deepin.org 是 deepin 社区官方的百科网站,用于分享 deepin 与 Linux 相关的知识。
页面的移动和重命名可能会导致其它位置对页面的引用失效,故请尽可能在页面创建时拟定合适的标题并放置于恰当的位置。若确实需要移动和重命名,则请将其移动到恰当的位置,以尽可能避免再次移动/重命名页面。
目前deepin Wiki面向全网公开,所有致力于为deepin操作系统使用提供文档贡献的有志人士均可申请。wiki编辑人员申请
账号申请须知:
目前deepin社区博客平台使用了HUGO作为文章平台工具,进行博客文章的静态生成,并最终利用 GitHub Pages 呈现网页。故整个过程你只需按照 HUGO 的正常使用方式进行使用即可。
关于如何配置和使用HUGO,可以参考HUGO官方 Quick Start教程
HUGO安装完成后,常用的命令如下(在此源码仓库的根目录下执行):
$ hugo server # 启动一个本地服务器,预览目前状态下的网站内容
$ hugo new posts/my-post.md # 创建一篇新文章,以便进行编辑
$ hugo server -D # 启用本地服务器,并且能够预览状态为草稿(`draft: true`)的文章
$ hugo -D # 生成静态页面(如果需要),生成的文件将位于 public 目录下
创建文章时,创建格式为 <分类>/<文件名>.<格式>,上面给出的例子中,分类为 posts,文件名为 my-post,格式为 md (markdown)。创建文章后,默认会使用 YAML front-matter 标记文章的一些元信息,请留意 draft 草稿状态的文章最终不会显示。
向本博客平台投递文章需要经过相关人员的 review,合入后即代表投递完成。需要注意的是,投递的文章必须是与 deepin社区发展所相关的文章。对于与 deepin社区贡献相关的个人感想或随笔等博客,可以考虑发布到 planet.deepin.org 聚合平台,本博客平台的文章也会出现 planet.deepin.org 之中。
在发布您的文章时,建议使用标签来标记您文章所相关的主题,以便读者更方便的查阅您的文章。例如 tags: ["持续集成"] 或 tags: ["指南文档", "CMake"]。另外也建议在文章的元信息中附带作者信息,例如 authors: ["张三"](可为多人)。