| 作者：梁金荣
| 转载自：Linux 内核之旅
| 编辑：王玥敏
| 设计：朱亿钦
开源社引言
开源社向来是支持本土的开源 Community 的发展的，非常欣喜的看到西安邮电大学的陈莉君教授迈出了校门之外，打破界限，以 Community 的方式来让更多的同学、社会人员参与进来，共同学习 Linux Kernel 的相关技术，Linux Kernel 是目前世界上最大的 Community 之一，但是学习的门槛是出奇的高，Linux 内核之旅 Community 将会以更有效的方式完成这一难题，尤其是汉语为母语的同学，将大大提高培养 Linux Kernel 相关的高级人才效率。
开源社也会大大支持和推广 ”Linux 内核之旅 Community“，与开源人才共成长！欢迎大家参与、贡献、提升！
—— 适兕
大家好，Linux 内核之旅开源社区已经上线，想必大家对如何参与开源社区比较感兴趣吧。下面小编就来详细介绍一下，开源社区的参与方式。
Linux 内核之旅开源社区是一个完全自由和开放的平台，甚至我们的网站都是开源的，开源社区的建设是在西邮陈莉君教授和在腾讯工作十多年的许振文师兄的指导下完成的，我们的运作方式与国际开源社区一样，所有人都可以共建 Linux 内核之旅开源社区，我们都是贡献者，也是受益者。
具体参与方式如下：
1、Linux 内核之旅开源社区网站
您可以在我们开源社区网站上进行投稿，我们网站是使用 hugo 搭建的静态网站，您可以先配置好 hugo 和 git 这两个环境，将我们网站的 git 仓库 fork 到您的 github，git pull 到本地后，您可以添加您的博客文章，添加您阅读陈老师出版书的读书笔记，甚至您还可以优化我们的网站，git push 到您的 git 仓库后，再向我们的主仓库提交 pull requests，我们的管理员看到后会 review 您的提交，如果没有问题的话，就可以 merge 到我们的 git 主仓库啦。
Linux 内核之旅开源社区网站 git 仓库地址：
https://github.com/linuxkerneltravel/website
2、内核学习实验代码
您可以学习和分享开源社区中的内核试验代码，提交 Issues，可以将我们内核试验代码的 git 仓库 fork 到您的github，git pull 到本地后，您可以修改我们的内核试验代码，或者添加您的内核试验代码，需要按分类提交内核实验代码，也请给出对代码的简要说明，然后 git push 到您的 git 仓库后，再向我们的 git 主仓库提交 pull requests，我们的管理员看到后会 review 您的提交，如果没有问题的话，就可以 merge 到我们的 git 主仓库。
Linux 内核之旅开源社区内核试验代码仓库地址：
https://github.com/linuxkerneltravel/xyLinuxer
3、Linux 内核之旅微信公众号
您可以向我们的微信公众号 “Linux 内核之旅”进行投稿，或者申请转载我们的文章。
4、内核慕课
您可以免费报名学习陈莉君教授的课程《Linux 内核分析与应用》，您还可以在讨论区抛出您的疑问，有机会获得陈老师的亲自答疑哦。报名方式如下：
手机扫描下方二维码，或电脑访问下方链接，开始Linux内核之旅吧！
https://next.xuetangx.com/course/XIYOU08091001441/1516763
5、Linux 内核之旅开源社区建设
Linux 内核之旅开源社区刚刚上线，很多制度和规则都不是很完善，您也可以参与我们的社区管理，给我们提一些建议，或帮助我们完善开源社区的文档，您可以提交任何改善开源社区的 patch ，贡献者也有机会成为开源社区管理员哦，感谢大家的关注和参与。
Linux 内核之旅开源社区管理仓库：
https://github.com/linuxkerneltravel/community
投稿秘籍
我们的许振文大师兄很贴心地贡献了参与 Linux 内核之旅开源社区的操作步骤，这是开源社区网站投稿的步骤，其他 git 仓库的参与步骤都是大同小异，一起来来看看吧！
01
前言
Linux 内核之旅的网站我们重构了，这次使用了 github 管理，hugo 作为站点管理工具。目标是能够让更多的同学参与进来，学习，分享，共同建设，让大家更方便高效的走 Linux 内核之旅。
“Linux内核之旅”网站的大幅度改版，更是为热爱开源的Linuxer提供更广的舞台，大家的周报告，分享视频，相关代码，点点滴滴都将会通过 Linux内核之旅网站，公众号，学堂在线，Github 以及 B 站等平台全面的分享出来。Open，Free&Share，不仅仅是一个口号，落地生花之时，也是一个人从内而外的成长之际。-- 陈莉君教授。
所以这里也欢迎大家参与分享，这篇文章主要介绍怎么参与投稿。
02
投稿内容
我们是《Linux 内核之旅》开源社区，所以一切投稿还是以 Linux 内核为主，另外在软件开发理论，开源代码分享，社区文化方面也可以投稿。
03
投稿方式
目前我们是 github 的仓库来做管理，所以投稿的方式也是在 github 的仓库中直接提交 pr。具体提交 pr 的流程如下：
04
详细步骤说明
01
fork 我们的站点项目到自己的仓库
站点仓库：
https://github.com/linuxkerneltravel/website
fork 项目过程相对比较简单，在
https://github.com/linuxkerneltravel/website 页面右上角点击 fork 按钮即可， fork 到自己的空间。
我的 fork 后是这样的地址，因为我的空间已经有一个 website 的仓库了，所以这里就加了一个后缀来区别。
https://github.com/helight/website-linuxkerneltravel
02
clone 主仓库到本地
https://github.com/linuxkerneltravel/website
03
设置自己的仓库开发代码提交上游关键
04
新建分支，并且在新分支上修改提交代码
4.1
代码更新
在每次新建分支之前一定要执行 git pull，使得 master 分支保持最新。
4.2
编辑开发
社区站点是使用 hugo 搭建管理，所以大家需要在本地搭建使用 hugo 来预览稿件效果。这里有个中文帮助站点大家可以学习。（https://hugo.aiaide.com/）
这里以 hugo 新建一个博文为例进行介绍。首先使用下面的命令新建一个 markdown 文件。
然后进行博文撰写，撰写格式要求：
1. 必须按照 `/blog/20xx/英文文章名称/index.md` 的路径格式创建文章。英文文章名称使用英文字母、下划线、连字符和数字，其它字符不接受。
2. 要求的内容格式一定是 markdown 的，其它格式内容暂时不接受。
3. 使用的图片一律保存在和 markdown 文件同级目录下的 imgs 文件夹中，如：`/blog/2020/submit_pr/imgs/pr.png`。
4. 图片的名称也一律使用英文命名，规则和上面一致。图片宽度不要超过900的宽度。
5. 图片大小在500k以内。
4.3
编辑完成之后进行本地验证
这一步非常重要，一定要进行本地验证，避免文章有 markdown 语法、图片格式、文字错误等。所以一定要验证。
看到上面信息就可以在本地浏览器中预览站点，看撰写的文字是否符合自己的预期。如果有问题可以修改后直接刷新看效果。
4.4
编辑本机验证没有问题之后做本地提交
05
提交代码到 dev 上游仓库
这个 dev 上游就是上面设置的哈：git remote add dev https://github.com/helight/website-
linuxkerneltravel
这种设置方式是可以把本地的修改按照 dev 标签提交到指定的另外一个仓库。我们一般是以主仓库作为我们工作目录，但是从主仓库的 master 分支创建出来的开发分支是不可以提交主仓库的，所以个人仓库就是这个分支提交的地方，提交之后在在个人仓库的分支和主仓库的 master 分支创建pr。
接下来就可以在这里查看代码了：
https://github.com/helight/website-linuxkerneltravel。这里 pr_intro 这个分支就是刚刚提交的。
06
创建 pr
在自己的个人仓库
https://github.com/helight/website-linuxkerneltravel 上面可以直接看到创建 pr 的按钮，直接创建就好了。
创建 pr 之后，后面有修改直接提交到这个个人分支上就可以了，不用重复创建。
07
等待 reviewer 反馈和合并到主干
社区的管理员会对你提交的 pr 进行 review，review 后会提出修改点，或者 review 没有问题直接合到主干中。
另外如果提出问题，大家可以在这里讨论，并修改达成一致，并提交到这个分支上，最后再合到主干中。
05
总结
以上简单说了我们社区文章投稿的过程。希望大家多多参与共建《Linux 内核之旅》社区。
网友评论