【GitHub】超实用技巧

姓名:孙宾

学号:17011210280

学院:通信工程学院

转自:微信公众号程序人生

【嵌牛导读】本文介绍嵌入式学习中关于GitHub的应用技巧

【嵌牛鼻子】GitHub

【嵌牛提问】如何快速掌握GitHub

【嵌牛正文】

#1 在GitHub.com上编辑代码

先从一个大多数人都知道的开始吧~

在GitHub上打开一个文件(任何仓库的任何文件),在页面的右上角有一个像小铅笔的按钮。点击它,你就可以编辑文件了。当你编辑完成,点击Propose file change,GitHub将为你fork这个仓库,然后创建pull request

你不再需要fork这个仓库,pull文件到本地,修改文件后再提交到GitHub创建一个pull request。

你不再需要fork这个仓库,pull文件到本地,修改文件后再提交到GitHub创建一个pull request

#2 粘贴图片

你可以不仅限于用文字来评论或者bug描述。你可以直接复制一个图片到剪贴板,当你粘贴的时候,你的图片将会自动上传到云,然后展示在页面上。

#3 美化代码

如果你想编写一个代码块,以三个反引号开头,GitHub会尝试猜测你用的什么语言。

但是如果你直接粘贴一个段Vue,Typescript或者JSX代码,你可以指定出来以得到正确的语法高亮。

注意第一行的```jsx:

意味着这段代码可以正确的显示:

(顺便说下,在gist中,如果你的gist文件后缀名是.jsx, 将自动获得JSX语法高亮)

下方链接是所有支持的语法列表:

https://github.com/github/linguist/blob/fc1404985abb95d5bc33a0eba518724f1c3c252e/vendor/README.md

#4 在PRs中巧妙关闭issues

如果你创建了一个pull request来修复问题单 #234. 你可以在PR的描述中写fixes #234

当合并PR的时候,会自动关闭那个issue。是不是很方便:)

了解更多:

https://help.github.com/articles/closing-issues-using-keywords/

#5 链接到评论

是否想要链接到某个特定的评论?

点击评论框用户名旁边的时间,就可以得到链接了。

#6 链接到代码

是否想要链接到一行特定代码?

打开一个文件,点击代码左边的行号,或者按住shift选择多行。

分享这个URL,可以链接到这些代码。如果文件被修改了,会发生变化吗?不会,因为这是永久链接。

#7 灵活使用GitHub地址栏

GitHub的页面导航已经做的很好了,但是有些时候直接在导航栏中输入会更快。比如你想跳转到一个分支,看下它与主干的区别,就可以直接在你仓库的后面输入/compare/branch-name:

与主干对比,两个分支对比,输入/compare/**integration-branch...**my-branch

对于快捷键的话,ctrl+L或者cmd+L` 光标将跳转到地址栏,这使得在两个分支切换变得很方便。

#8 创建复选框列表

你是否想在你提交的issue中看到复选框列表?

以及在issue列表中,看到“2/5”的进度条?

交互式复选框语法如下:

-[ ]Screenwidth(integer)

-[x]Service worker support

-[x]Fetch support

-[ ]CSS flexbox support

-[ ]Custom elements

项目管理界面使用也一样:

如果你不知道项目管理是什么,我接下来就讲。

#9 在GitHub中进行项目管理

我在大项目中通常使用Jira来管理项目,对于单人项目我一般用Trello

就在几周前我了解到GitHub也提供项目管理。就在你的仓库中找到Projects,我都有点想把我在Trello的工作项移植过来了。

在GitHub中一模一样的项目管理:

如果你想把你的issues添加到你的项目管理中来,你可以在页面右上方点击Add Cards搜索你想添加的,这里的搜索有特殊的语法(https://help.github.com/articles/searching-issues-and-pull-requests/),比如输入is:pr is:open,意味着你可以找到所有打开的PRs,如果你想修复bugs,输入label:bug。

你可以把存在的notes转换成issues。

或者在issues界面,把issue添加到项目管理中。

先在项目管理中把类别分好,再确定你把issues放入那个类目中。

缺点

我在最近的三周开始使用GitHub来替代Jira来进行管理项目(一个小项目)。越用越喜欢。

但是我不敢想象用它来进行敏捷开发,因为我想要正确的评估和计算所有事物。

好消息是,GitHub的项目管理功能很清爽简洁,不需要太大的学习成本,就可以轻松上手。

ZenHub(https://www.zenhub.com/)弥补了GitHub不足,可以评估自己的issues,创建依赖,还有速度和燃尽图。看起来很牛逼。

了解更多:

https://help.github.com/articles/tracking-the-progress-of-your-work-with-project-boards/

#10 GitHub wiki

非结构化网页集合,也就是说你所有的网页没有从属关系,没有上一段下一段按钮,也没有面包屑导航。

我先创建一个GitHub wiki,我从NodeJS文档找了几个页面作为wiki的页面,然后创建一个侧边导航来模拟实际的结构。侧边栏一直存在,不会对当前页面高亮。

链接需要手动维护,但总的来说已经满足需求了。 查看Demo (https://github.com/davidgilbertson/about-github/wiki)。

我的建议:如果你的README.md文件太大了,而且你需要几个页面来更详细的描述你的文档,那么GitHub wiki是很适合你的。如果你的页面需要导航或者结构化,那么你需要想其他办法了。

#11 静态博客

你可能已经知道你可以使用GitHub部署静态网页,这个部分我将告诉你用Jekyll(简单博客静态网站生成器)生成静态网页

非常简单,Jekyll会用漂亮的主题去渲染你的README.md文件。比如这个README页面(https://github.com/davidgilbertson/about-github):

点击设置,选择Jekyll主题。

我将得到一个Jekyll主题的页面(https://davidgilbertson.github.io/about-github/):

我们通过一个markdown文件就创建一个静态网站,编辑修改非常方便,所以GitHub基本上可以当内容管理系统来用了。

ReactBootstrap的网站已经怎么做了。

#12 用GitHub作为CMS(内容管理系统)

你有一个网站需要展示一些文本,但是你又不想把文本存成HTML

您想将文本块存储在某个地方,而且可以很方便的编辑,且不需要开发。

我的建议是文本写在markdown文件中,然后存到你的仓库。接着在前端写一个组件来请求文件然后渲染。

我用喜欢用React,所以这是一个React组件的例子:得到markdown文件路径,然后请求,解析,最后渲染成HTML。

classMarkdownextendsReact.Component{

constructor(props) {

super(props);

// 这里需要替换成你的url

this.baseUrl  ='https://raw.githubusercontent.com/davidgilbertson/about-github/master/text-snippets';

this.state  = {

markdown:'',

};

}

componentDidMount() {

fetch(`${this.baseUrl}/${this.props.url}`)

.then(response=>response.text())

.then((markdown) =>{

this.setState({markdown});

});

}

render() {

return(

);

}

}

我用的是marked(https://www.npmjs.com/package/marked) 插件来解析markdown,然后你可以这样使用组件:

const Page = () => (

A very important disclaimer:

);

至此,你可以把GitHub当成你的CMS了。

GitHub 谷歌插件

我只用这个 octobox谷歌插件(https://chrome.google.com/webstore/detail/octotree/bkhaagjahfmjljalopjnoealnfndnagc?hl=en-US)一段时间了,现在我推荐给你。

它在左侧生成一个面板,通过树形结构来浏览你的仓库。

说到颜色,我怎么容忍一个苍白的GitHub呢?

插件组合: Stylish 这个插件允许你把主题应用到任何一个网站:(https://chrome.google.com/webstore/detail/stylish-custom-themes-for/fjnbnpbmkenffdnngjfgmeleoegfcffe/related?hl=en) 和  GitHub 黑色主题(https://userstyles.org/styles/37035/github-dark)。 为了看上去统一,把谷歌开发工具换成黑色(这个是内置的,在设置中打开),然后换成Atom One Dark 黑色主题 (https://chrome.google.com/webstore/detail/atom-one-dark-theme/obfjhhknlilnfgfakanjeimidgocmkim?hl=en)。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容

  • afinalAfinal是一个android的ioc,orm框架 https://github.com/yangf...
    passiontim阅读 15,396评论 2 45
  • 鲜红的圆珠们堆成小山它们都多了一个绿把儿二十年前它们结在我家菜园的树上在风中抖擞今天它们被老大爷卖给出入高楼的小青...
    小者阅读 126评论 0 0
  • 我叫徐振军,受猫猫果儿小学一年级魏央同学的父亲魏黎明邀请,担任魏央的期末考试观察员。过去几年,我和魏央见过2-3次...
    振军_57f1阅读 398评论 0 0
  • 阴 再读当年明月 一本能让你屡屡感同身受的 不见得是一本了不起的书 但至少是一本值得你花时间去细细品味的书 无关名...
    人生且呵呵阅读 290评论 0 0
  • 莫殢春光花下游,便须准备落花愁。百年雨打风吹却,万事三平二满休。 将扰扰,付悠悠,此生于世百无忧。新愁次第...
    一杯寂寥阅读 1,205评论 12 5