内容简介:具体参与方式如下:1、Linux内核之旅开源社区网站您可以在我们开源社区网站上进行投稿,我们网站是使用hugo搭建的静态网站,您可以先配置好hugo和git这两个环境,将我们网站的git仓库fork到您的github,git pull 到本地后,您可以添加您的博客文章,添加您阅读陈老师出版书的读书笔记,甚至您还可以优化我们的网站,git push到您的git仓库后,再向我们的主仓库提交 pull requests,我们的管理员看到后会 review 您的提交,如果没有问题的话,就可以 merge 到我们的g
大家好,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仓库的参与步骤都是大同小异,一起来来看看吧!
前言
Linux 内核之旅的网站我们重构了,这次使用了 github 管理,hugo 作为站点管理工具。目标是能够让更多的同学参与进来,学习,分享,共同建设,让大家更方便高效的走 Linux 内核之旅。
“Linux内核之旅”网站的大幅度改版,更是为热爱开源的Linuxer提供更广的舞台,大家的周报告,分享视频,相关代码,点点滴滴都将会通过Linux内核之旅网站,公众号,学堂在线,Github 以及B 站等平台全面的分享出来。Open,Free&Share,不仅仅是一个口号,落地生花之时,也是一个人从内而外的成长之际。-- 陈莉君教授。
所以这里也欢迎大家参与分享,这篇文章主要介绍怎么参与投稿。
投稿内容
我们是《Linux 内核之旅》开源社区,所以一切投稿还是以 Linux 内核为主,另外在软件开发理论,开源代码分享,社区文化方面也可以投稿。
投稿方式
目前我们是 github 的仓库来做管理,所以投稿的方式也是在 github 的仓库中直接提交 pr。具体提交 pr 的流程如下:
详细步骤说明
1.fork 我们的站点项目到自己的仓库
站点仓库:https://github.com/linuxkerneltravel/website
fork 项目过程相对比较简单,在 https://github.com/linuxkerneltravel/website 页面右上角点击 fork 按钮即可, fork 到自己的空间。
我的 fork 后是这样的地址,因为我的空间已经有一个 website
的仓库了,所以这里就加了一个后缀来区别。https://github.com/helight/website-linuxkerneltravel
2.clone 主仓库到本地
https://github.com/linuxkerneltravel/website
helightxu$ git clone https://github.com/linuxkerneltravel/website helightxu$ cd website
3.设置自己的仓库开发代码提交上游关键
helightxu$ git remote add dev https://github.com/helight/website-linuxkerneltravel
4.新建分支,并且在新分支上修改提交代码
4.1 代码更新
在每次新建分支之前一定要执行 git pull,使得 master 分支保持最新。
helightxu$ git pull helightxu$ git checkout -b pr_intro Switched to a new branch 'pr_intro' helightxu$
4.2 编辑开发
社区站点是使用 hugo 搭建管理,所以大家需要在本地搭建使用 hugo 来预览稿件效果。这里有个中文帮助站点大家可以学习。(https://hugo.aiaide.com/)
这里以 hugo 新建一个博文为例进行介绍。首先使用下面的命令新建一个 markdown 文件。
helightxu$ hugo new blog/2020/submit_pr/index.md /Users/helightxu/helight_doc/website-linuxkerneltravel/content/blog/2020/submit_pr/index.md created helightxu$
然后进行博文撰写,撰写格式要求:
1. 必须按照 `/blog/20xx/英文文章名称/index.md` 的路径格式创建文章。英文文章名称使用英文字母、下划线、连字符和数字,其它字符不接受。 2. 要求的内容格式一定是 markdown 的,其它格式内容暂时不接受。 3. 使用的图片一律保存在和 markdown 文件同级目录下的 imgs 文件夹中,如:`/blog/2020/submit_pr/imgs/pr.png`。 4. 图片的名称也一律使用英文命名,规则和上面一致。图片宽度不要超过900的宽度。 5. 图片大小在500k以内。
4.3 编辑完成之后进行本地验证
这一步 非常重要 ,一定要进行本地验证,避免文章有 markdown 语法、图片格式、文字错误等。所以一定要验证。
helightxu$ hugo server | ZH -------------------+------ Pages | 18 Paginator pages | 0 Non-page files | 5 Static files | 121 Processed images | 0 Aliases | 6 Sitemaps | 1 Cleaned | 0 Built in 132 ms Watching for changes in /Users/helightxu/helight_doc/website/{archetypes,content,data,static,themes} Watching for config changes in /Users/helightxu/helight_doc/website/config.toml Environment: "development" Serving pages from memory Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender Web Server is available at http://localhost:1313/ (bind address 127.0.0.1) Press Ctrl+C to stop
看到上面信息就可以在本地浏览器中预览站点,看撰写的文字是否符合自己的预期。如果有问题可以修改后直接刷新看效果。
4.4 编辑本 机 验证没有问题之后做本地提交。
helightxu$ git add content/blog/2020/submit_pr helightxu$ git commit -m "add new blog submit_pr" -a [pr_intro 7607f03] add new blog submit_pr 2 files changed, 101 insertions(+) create mode 100644 content/blog/2020/submit_pr/imgs/pr.png create mode 100644 content/blog/2020/submit_pr/index.md helightxu$
5.提交代码到 dev 上游仓库
这个 dev 上游就是上面设置的哈:git remote add dev https://github.com/helight/website-linuxkerneltravel
这种设置方式是可以把本地的修改按照 dev
标签提交到指定的另外一个仓库。我们一般是以主仓库作为我们工作目录,但是从主仓库的 master
分支创建出来的开发分支是不可以提交主仓库的,所以个人仓库就是这个分支提交的地方,提交之后在在个人仓库的分支和主仓库的 master
分支创建 pr
。
helightxu$ git push dev Enumerating objects: 13, done. Counting objects: 100% (13/13), done. Delta compression using up to 12 threads Compressing objects: 100% (7/7), done. Writing objects: 100% (9/9), 376.97 KiB | 19.84 MiB/s, done. Total 9 (delta 2), reused 0 (delta 0) remote: Resolving deltas: 100% (2/2), completed with 2 local objects. remote: remote: Create a pull request for 'pr_intro' on GitHub by visiting: remote: https://github.com/helight/website-linuxkerneltravel/pull/new/pr_intro remote: To https://github.com/helight/website-linuxkerneltravel * [new branch] pr_intro -> pr_intro helightxu$
接下来就可以在这里查看代码了:https://github.com/helight/website-linuxkerneltravel。这里 pr_intro
这个分支就是刚刚提交的。
6.创建pr
在自己的个人仓库 https://github.com/helight/website-linuxkerneltravel 上面可以直接看到创建 pr 的按钮,直接创建就好了。
创建 pr之后,后面有修改直接提交到这个个人分支上就可以了,不用重复创建。
7.等待 reviewer 反馈和合并到主干
社区的管理员会对你提交的 pr 进行 review,review 后会提出修改点,或者 review 没有问题直接合到主干中。
另外如果提出问题,大家可以在这里讨论,并修改达成一致,并提交到这个分支上,最后再合到主干中。
总结
以上简单说了我们社区文章投稿的过程。希望大家多多参与共建《Linux 内核之旅》社区。
联系方式: liangjinrong111@163.com
感谢支持!
点击阅读原文,直达Linux内核之旅开源社区网站
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 小米 9 开源内核代码,上市即开源
- 开源中文书《TensorFlow 内核剖析》
- 微软正式开源WSL 2的内核源码
- LinuxConsole 201发布,支持最新内核预装开源游戏
- 揭秘框架的本源:开源中文书「TensorFlow内核剖析」
- 小米盒子3内核代码已开源,坐等刷机包?
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。