姓名:闫伟 学号:15020150038
转载自:https://www.zhihu.com/question/21248859/answer/512649181
【嵌牛导读】:gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。
【嵌牛鼻子】:Github Git
【嵌牛提问】:如何有效地使用 GitHub?
【嵌牛正文】:
在 GitHub.com上编辑代码
我(作者David Gilbertson——译者注)先说一个大部分人都知道的事儿(虽然我是直到一个星期前才知道的)。
你在 GitHub 上查看一个文件(任何文本文件或仓库)时,在右上角会发现一个很小的铅笔图标。如果你点击它,就可以编辑该文件。等你完成后,在页面上点击“Propose File Change”, GitHub 就会为你 fork 这个仓库,创建一个 pull request。
很酷吧?GitHub 为你创建了一个分支!
不需要在本地 fork,pull,修改,push 以及创建一个 PR。
这样做能很好地帮你修改排版错误,以及防止别人恶意编辑代码。
粘贴图像
其实你在 comment 和 issue 描述里不仅仅能编辑文本,还能直接从剪贴板直接粘贴图片。在你粘贴图片的时候,你会发现图片上传到了云端,显示为 Markdown 格式。
既整洁又干净。
格式化代码
如果你想写一个代码块,可以首先写三个反引号——就跟你在 GitHub 的 Mastering Markdown 页面学到的那样,然后 GitHub 就会猜出来你要写哪种语言。
但是如果你写的是 Vue、Typescript 和 JSX 这样的语言脚本,可以明确地写出了,获得正确的高亮显示。
注意这里第一行用了```jsx :
意味着正确渲染了脚本:
顺便说一下,这个也能扩展到 gists。如果你给 gist 扩展 .jsx,会得到 JSX 语法的高亮显示。
这里是全部支持的语法列表。
使用“咒语”关闭 PR 中的 issue
比方说,你正在创建一个 Pull request 来修复 issue#234,你可以将“fixes#234”这段文本放在你的 PR 描述里(或者 PR 上的任何 comment 里)。
然后合并 PR 就会自动关闭这个 issue,是不是很酷?
想学习更多“咒语”?看这里。
链接到 comment
有没有想过链接到某个具体的 comment,但有不知道怎么弄?我来告诉你,点击名字旁边的日期/时间就能链接到 comment 了。
链接到代码
想链接到代码的具体一行?我懂了。
试试这个操作:查看该文件时,点击该代码旁边的行数。
然后你就会发现 URL 被行数更新了!如果你按住 shift,点击另一个行数,会惊讶地看到 URL 再次随之更新,而且这两行之间的代码都被高亮显示了。
分享该 URL 就会链接到这个文件和这些代码行。但是等等,这只能指向当前分支,如果文件改变了呢?那得需要链到文件当前状态的永久链接。
我这人很懒,所以我把上述操作用一张截图展示出来算了:
说到URL···
像代码行一样使用GitHub URL
使用 GitHub 的用户操作界面在上面逛来逛去当然也很好,不过有时想抵达目标位置的最快方法还是使用 URL。比如,我想跳到我正在处理的一个分支,看看和 master 的差异,那么我就可以在 URL 中的仓库名字后面输入 //compare/branch-name.
然后就会跳转到该分支与 master 的差异页面:
不过这是和 master 的差异,如果我是在集成分支上工作,就输入 /compare/integration-branch...my-branch
这里也有快捷键操作,Ctrl+L 或 cmd+L 会让光标直接跳到 URL 里(至少在 Chrome 上可以)。这样以来,再搭配上你的浏览器做一些自动完成的工作,可以让你很方便地在分支之间切换。
小提示:使用键盘上的方向键选择 Chrome 的自动完成建议,按 shift+delete 从网页记录中移除某一项(比如合并了一个分支后)。
在issue中创建列表
想在你的 issue 里看到一列选框吗?
当你查看排成列的 issue 时,想不想让它们展示为“2 of 5”这样的整洁形式?
那么用下面的语法就能创建出交互式的选框:
- [ ] Screen width (integer)
- [x] Service worker support
- [x] Fetch support
- [ ] CSS flexbox support
- [ ] Custom elements
然后勾选这些选框就OK了。
GitHub 上的 Project board
我之前在大项目上一直使用 Jira,对于单个项目一直使用 Trello,相当喜欢它们。
但是最近我才知道 GitHub 也有类似的功能,就在仓库中的 Project 选项卡上。下面是 Trello 上的:
这是 GitHub 上的:
我个人出于方便考虑,把这些都添加为了“notes”——意思是它们不是实际的 GitHub issue。
而 GitHub 上管理任务的一个大好处就是它和其余的仓库整合在了一起,所以可以将当前 issue 从仓库添加到 Project Board 上。
你可以点击右上角的“Add Cards”,找到你想添加的东西。这里有个非常方便的搜索语法,比如输入 is:pr is:open,就可以把任何公开的 PR 拖到 Project Board 上,再比如想修复某些 bug,就输入 label:bug。
更多搜索语法查看这里。
你也可以将当前 notes 转换为 issues:
或者从当前 issue 页面中将其添加到右侧窗格中的 project 里。
让仓库中的‘任务’定义和实现该任务的代码中的定义一致有着巨大的好处,这意味着每行代码分配以及分析代码的成因都可以在 Project Board 上完成,不用去 Jira/Trello 上了。
当然它也有缺点,就是功能比较少。你可以试试Zenhub,它有效地扩展了 GitHub。
GitHub Wiki
和维基百科类似,GitHub 也有个 GitHub Wiki 功能,处理非结构化的页面集合。
对于非结构化页面集合,比如你的文档,是没有“下一节”“前一节”这样的方便按钮的。
这时就可以用 GitHub Wiki 功能,我自己的 NodeJS 就弄成了类似维基页面的样子,创建了一个自定义工具栏,参考这里。
我的建议:如果你觉得单单一个README.md文件不够用,想多几个不同的页面展示用户指南或更详细的文档,那么 GitHub Wiki 就是你的菜。
GitHub Pages(配合Jekyll)
你可能知道可以用 GitHub Pages 托管一个静态网站。如果不知道,那就赶紧去学习一个。
不过在这里我具体讲讲怎么用 Jekyll 配合 GitHub 创建一个静态网站。
以最简单的方式,GitHub Pages+Jekyll 能将你的README.md渲染为非常美观的主题。比如,我的 readme 页面是这样:
如果点击 GitHub 上“my site”的“设置”选项卡,打开 GitHub Pages,选一个 Jekyll 主题:
我就会得到一个漂亮的 Jekyll 主题页面:
从这里再往下我就能根据易于编辑的 Markdown 文件创建一个静态网站,把 GitHub 变成一个 CMS。注意,需要用 Ruby 在本地运行,Mac 自带,Windows 需另行安装。
将 GitHub 当 CMS 用
比方说,你有个网站,上面有一些文本内容,但你不想将文本放在 HTML 标记里面,而是将文本块放在其它地方,这样好让不懂编程的人也能编辑文本。可能还想再来点某种形式的视觉操作。
我的建议是:用存储在仓库中的 Markdown 文件来保存这些文本。然后在前端用一个组件抓取这些文本,把它们呈现在页面上。
我是用 React 的,所以这里举个 <Markdown> 组件示例,用来抓取、解析文本并将其渲染为 HTML。
class Markdown extends React.Component {
constructor(props) {
super(props); // replace with your URL, obviously
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 ( );
}
}
这会指向我的示例仓库,它在 in/text-snippets 上有一些 Markdown 文件。
你可以使用如下所示的组件:
const Page = () => ( A very important disclaimer:);
那么现在我们就将 GitHub 变成了 CMS,无论处理多大的文本内容都可以。
上面的示例仅在浏览器安装了组件后才抓取 Markdown 文件,如果你想有个静态网站,还需要用服务器渲染。
最后推荐两个实用的 GitHub 工具
我墙裂推荐一个叫Octotree的 Chrome 扩展程序。
它能在页面左侧提供一个面板,以树状图的形式呈现你正在查看的仓库。
还有 Stylish 的 GitHub Dark 插件,能让你的 GitHub 变身为暗黑主题:
地址:
https://userstyles.org/styles/37035/github-dark
就这些,希望这 12 个操作能帮你更高效的使用 GitHub。