欢迎访问Linux内核之旅开源社区网站
网站入口:
十多年前,陈老师和她的中学生康华、陈逸飞等创立了“Linux内核之旅”()网站,并撰写了电子刊物的系列文章。近些年来,有把这个网站与陌陌平台打通的心愿,多年积累,大量的资料大都洒落在各处,是时侯梳理它们,让它们回归到自己的佳苑了。
现在,在陈老师和在腾讯工作十多年的许振文师弟的指导下,我们重新对Linux内核之旅进行构建,使之完全自由和开放,我们的运作形式与国际开源社区一样,所有人都可以共建Linux内核之旅开源社区,我们都是贡献者,也是获益者。
您可以在我们开源社区网站上进行投稿,我们网站是使用hugo搭建的静态网站,您可以先配置好hugo和git这两个环境,将我们网站的git库房fork到您的github,gitpull到本地后,您可以添加您的博客文章,添加您阅读陈老师出版书的读书笔记,甚至您还可以优化我们的网站,gitpush到您的git库房后,再向我们的主库房递交pullrequests,我们的管理员听到后会review您的递交,假如没有问题的话,就可以merge到我们的git主库房啦。
Linux内核之旅开源社区网站git库房地址:
我们的许振文大师弟很贴心地贡献了参与Linux内核之旅开源社区的操作步骤,这是开源社区网站投稿的步骤,其它git库房的参与步骤都是邯郸小异,一上去来瞧瞧吧!
序言
Linux内核之旅的网站我们构建了linux开源社区,此次使用了github管理,hugo作为站点管理工具。目标是才能让更多的朋友参与进来,学习,分享,共同建设,让你们更便捷高效的走Linux内核之旅。
“Linux内核之旅”网站的大幅度改版,更是为热爱开源的Linuxer提供更广的舞台,你们的周报告,分享视频,相关代码,点点嘀嘀都将会通过Linux内核之旅网站,公众号,学堂在线,Github以及B站等平台全面的分享下来。Open,Free&Share,不仅仅是一个标语,落地生花之时,也是一个人从内而外的成长之际。--陈莉君院士。
所以这儿也欢迎你们参与分享,这篇文章主要介绍如何参与投稿。
投稿内容
我们是《Linux内核之旅》开源社区,所以一切投稿还是以Linux内核为主,另外在软件开发理论,开源代码分享,社区文化方面也可以投稿。
投稿形式
目前我们是github的库房来做管理,所以投稿的方法也是在github的库房中直接递交pr。具体递交pr的流程如下:
详尽步骤说明1.fork我们的站点项目到自己的库房
站点库房:
fork项目过程相对比较简单,在页面右上角点击fork按键即可,fork到自己的空间。
我的fork后是这样的地址,由于我的空间早已有一个website的库房了,所以这儿就加了一个后缀来区别。
2.clone主库房到本地
git clone https://github.com/linuxkerneltravel/website helightxu$ cd website
3.设置自己的库房开发代码递交上游关键
git remote add dev https://github.com/helight/website-linuxkerneltravel
4.新建分支,但是在新分支上更改递交代码4.1代码更新
在每次新建分支之前一定要执行gitpull,致使master分支保持最新。
git pull git checkout -b pr_intro
4.2编辑开发
社区站点是使用hugo搭建管理,所以你们须要在本地搭建使用hugo来预览稿件疗效。这儿有个英文帮助站点你们可以学习。()
这儿以hugo新建一个博文为例进行介绍。首先使用下边的命令新建一个markdown文件。
hugo new blog/2020/submit_pr/index.md
之后进行博文撰写,撰写格式要求:
1. 必须按照 `/blog/20xx/英文文章名称/index.md` 的路径格式创建文章。英文文章名称使用英文字母、下划线、连字符和数字,其它字符不接受。 2. 要求的内容格式一定是 markdown 的,其它格式内容暂时不接受。 3. 使用的图片一律保存在和 markdown 文件同级目录下的 imgs 文件夹中,如:`/blog/2020/submit_pr/imgs/pr.png`。 4. 图片的名称也一律使用英文命名,规则和上面一致。图片宽度不要超过900的宽度。 5. 图片大小在500k以内。
4.3编辑完成以后进行本地验证
这一步十分重要,一定要进行本地验证,防止文章有markdown句型、图片格式、文字错误等。所以一定要验证。
hugo server
看见里面信息就可以在本地浏览器中预览站点linux开源社区,看撰写的文字是否符合自己的预期。假如有问题可以更改后直接刷新看疗效。
4.4编辑本机验证没有问题然后做本地递交。
git add content/blog/2020/submit_pr git commit -m "add new blog submit_pr" -a
5.递交代码到dev上游库房
这个dev上游就是前面设置的哈:gitremoteadddev
这些设置方法是可以把本地的更改根据dev标签递交到指定的另外一个库房。我们通常是以主库房作为我们工作目录linux常用命令,并且从主库房的master分支创建下来的开发分支是不可以递交主库房的,所以个人库房就是这个分支递交的地方,递交以后在在个人库房的分支和主库房的master分支创建pr。
git push dev
接出来就可以在这儿查看代码了:。这儿pr_intro这个分支就是刚才递交的。
6.创建pr
在自己的个人库房里面可以直接看见创建pr的按键linux解压rar,直接创建就好了。
创建 pr之后,后面有修改直接提交到这个个人分支上就可以了,不用重复创建。
7.等待reviewer反馈和合并到主干
社区的管理员会对你递交的pr进行review,review后会提出更改点,或则review没有问题直接合到主干中。
另外假如提出问题,你们可以在这儿讨论,并更改达成一致,并递交到这个分支上,最后再合到主干中。
总结
以上简单说了我们社区文章投稿的过程。希望你们多多参与共建《Linux内核之旅》社区。