Linux.中国 - 开源社区

 找回密码
 骑士注册

QQ登录

微博登录


GitHub 秘籍

2014-11-15 20:36    收藏: 2 分享: 1    

用commit信息关闭Issue

如果某个提交修复了一个Issue,当提交到master分支时,提交信息里可以使用fix/fixes/fixed,close/closes/closed 或者 resolve/resolves/resolved等关键词,后面再跟上Issue号,这样就会关闭这个Issue。

$ git commit -m "Fix screwup, fixes #12" 

这将会关闭Issue #12,并且在Issue讨论列表里关联引用这次提交。

Closing Repo

进一步了解通过提交信息关闭Issue.

链接其他仓库的Issue

如果你想引用到同一个仓库中的一个Issue,只需使用井号 # 加上Issue号,这样就会自动创建到此Issue的链接。

要链接到其他仓库的Issue,就使用user_name/repo_name#ISSUE_NUMBER的方式,例如tiimgreen/toc#12。

Cross-Link Issues

设置CI对每条Pull Request都进行构建

如果配置正确,Travis CI会为每个你收到的Pull Request执行构建,就像每次提交也会触发构建一样。想了解更多关于Travis CI的信息,请看 Travis CI入门

Travis CI status

进一步了解 Commit status API.

Markdown文件高亮语法

例如,可以像下面这样在你的Markdown文件里为Ruby代码添加语法高亮:

```ruby
require 'tabbit'
table = Tabbit.new('Name', 'Email')
table.add_row('Tim Green', 'tiimgreen@gmail.com')
puts table.to_s
```

效果像下面这样:

require 'tabbit'
table = Tabbit.new('Name', 'Email')
table.add_row('Tim Green', 'tiimgreen@gmail.com')
puts table.to_s

Github使用 Linguist 做语言识别和语法高亮。你可以仔细阅读 languages YAML file,了解有哪些可用的关键字。

进一步了解 GitHub Flavored Markdown.

表情符

可以在Pull Requests, Issues, 提交消息, Markdown文件里加入表情符。使用方法:name_of_emoji:

:smile:

将输出一个笑脸:

:smile:

Github支持的完整表情符号列表详见emoji-cheat-sheet.com 或 scotch-io/All-Github-Emoji-Icons

Github上使用最多的5个表情符号是:

:shipit:
:sparkles:
:-1:
:+1:
:clap:

静态与动态图片

注释和README等文件里也可以使用图片和GIF动画:

![Alt Text](https://dn-linuxcn.qbox.me/data/attachment/album/201411/15/203640okhjjvqu1ktlkqz1.gif)

Peter don't care

所有图片都缓存在Gitub,不用担心你的站点不能访问时就看不到图片了。

在GitHub Wiki中嵌入图片

有多种方法可以在Wiki页面里嵌入图片。既可以像上一条里那样使用标准的Markdown语法,也可以像下面这样指定图片的高度或宽度:

[[ https://dn-linuxcn.qbox.me/data/attachment/album/201411/15/203640okhjjvqu1ktlkqz1.gif | height = 100px ]]

结果:

Just a screenshot

快速引用

在注释话题里引用之前某个人所说的,只需选中文本,然后按 r键,想要的就会以引用的形式复制到你的输入框里。

Quick Quote

进一步了解快速引用.

快速添加许可证

创建一个仓库时,Github会为你提供一个预置的软件许可列表:

License

对于已有的仓库,可以通过web界面创建文件来添加软件许可。输入LICENSE作为文件名后,同样可以从预置的列表中选择一个作为模板。

License

这个技巧也适用于 .gitignore 文件。

进一步了解 open source licensing.

任务列表

Issues和Pull requests里可以添加复选框,语法如下(注意空白符):

- [ ] Be awesome
- [ ] Prepare dinner
  - [ ] Research recipe
  - [ ] Buy ingredients
  - [ ] Cook recipe
- [ ] Sleep

Task List

当项目被选中时,它对应的Markdown源码也被更新了:

- [x] Be awesome
- [ ] Prepare dinner
  - [x] Research recipe
  - [x] Buy ingredients
  - [ ] Cook recipe
- [ ] Sleep

进一步了解任务列表.

Markdown文件中的任务列表

在完全适配Markdown语法的文件中可以使用以下语法加入一个只读的任务列表

- [ ] Mercury
- [x] Venus
- [x] Earth
  - [x] Moon
- [x] Mars
  - [ ] Deimos
  - [ ] Phobos

进一步了解Markdown文件中的任务列表

查看其它分页:

发表评论


最新评论

我也要发表评论

运维世界大会
返回顶部

分享到微信朋友圈

打开微信,点击底部的“发现”,
使用“扫一扫”将网页分享至朋友圈。