github 存储库的创建和配置

创建存储库者为项目的拥有者，可添加他人为合作者，对项目所有信息和审查具有所有权力。类似于QQ群主和管理员的概念。

1 创建一个存储库

点击右上角的 + 符号，选择 New repository ，可进入到上图界面。

在 Owner处可选择创建自己账户的存储库或某个组织下的存储库。存储库可在以后想转移项目的时候转移该项目。

Repository name 处可以给存储库命名，名字应该由字母、数字、连字符，以及 / 或下划线组成。任何其他字符都将被替换为一个连字符。

输入名称后，选择库是私有的还是公共的。公共存储库可以被任何人看到，私有存储库只能被特邀的合作者浏览。两者情况下项目都只能被添加为合作者的人修改。

若代码是商业敏感的，可以每月支付一些钱来保持其私有状态。否则可使用免费的公共存储库。

若没有看到使库变为私有的选项，需要升级创建项目时所属的用户或组织，以允许它拥有私有存储库。

创建新的存储库时需要做的最后决定是，是否勾选复选框来初始化一个有README文件的存储库。

最后点击 Create repository 按钮，将创建新的存储库。

2 添加合作者

如果创建的是公共存储库，可能不需要添加合作者。在偶尔合作的时候只需要请求他们fork你的库，并在做出贡献时发送pull请求。

如果创建了私有的库，或有一些定期工作在这个项目的人，应该将其添加为合作者。

单击屏幕右上角的Settings链接来添加合作者，然后单击 Collaborators 选项卡，需要你输入密码。

在框内输入用户名，单击 Add Collaborator 按钮。

3 配置存储库

单击 Settings 选择 Option，可以进行高级设置的配置。

第一个选项可进行重命名，若进行修改，合作者的项目名也将被重定向为新的项目名。

还可修改默认分支 Default branch，从其他分支合并到默认分支时其他分支将自动关闭，但是一般情况下都使用主分支为默认分支。

还可配置Wiki和问题，默认情况下新项目的WIKI和问题都是启用的。只需要勾选复选框来禁用它们。如果想限制公共项目的wiki，以至于只有合作者可以编辑其内容，请勾选必要的复选框。

如果想为项目添加一个网站，单击 Automatic page generator。

在 Danger zone 危险地带，可以让你将项目的可访问性在私有和公共之间切换，还可将项目的所有权转移给另一个用户或组织，还可删除库。

4 与其他系统的集成

第一种方法是使用GitHub API。进入 http://developer.github.com ,单击项目页面顶部的API链接。

它允许开发者在一个库中进行查询和更改几乎任何想做的事情。

若想每当有人添加一个新的问题或推送到GitHub时，自己的程序能得到通知，可进入 Settings => webhooks。

如上图所示，每次当发生一个特定类型的事件时，该界面允许你告诉 GitHub向你的定制软件发送一个通知。你需要提供你的软件将监听的URL，你想要表达的内容，一个可选的秘密和发生什么样的事情时你希望软件被通知到。如果你的开发人员正在实现一个定制的集成，他们会具体告知你他们希望如何配置 webhooks。

如果使用的是预先写好集成的流行软件，在 Filter services 过滤文本框开始输入软件的名称。单击该名称会现实一个屏幕，告诉你需要做什么来完成与该软件的集成。

5 个人与组织

如果正在创建一个个人项目，可能仅想将它创建在你的个人GitHub账户下。

然而如果希望项目由一个实体而不是你自己拥有，应该首先创建一个组织，将项目创建在该组织下，之后可以轻松转移项目的所有权。

6 创建一个组织

与创建库一样，首先点击右上角的 + 号，单击 New organization 选项。

将看到图上画面，首先进行组织的命名，输入账单联系人的电子邮件地址，然后选择一个计划。

如果项目可以公开访问，可以创建一个免费开源组织。

如果想拥有私有存储库，将需要至少一个青铜计划，将允许你拥有最多10个私有存储库，一个月25美元。

如果选择创建能拥有私有存储库的组织，将要求输入信用卡或PayPal信息来支付每月的费用。

7 管理团队

如果创建了一个存储库，可以在项目中直接添加合作者。

如果在一个组织下创建了一个库，并想允许其他人来访问它，那么需要创建一个团队。

创建团队需要在组织的主页单击右侧的Teams链接，再点击 + New Team。

首先给团队命名，可以是企业功能或项目团队的名称。

如果团队的意图对组织成员来说不是很明显，可添加一个可选择的描述，然后为团队提供阅读、写作或管理权限。

如果提供了读权限，他们将只能浏览、复制并使用该软件。

如果提供了写权限，他们还能推送都存储库。

如果提供了管理员权限，他们还能为项目添加额外的合作者，这些合作者拥有访问项目的权限。

最后点击 Create team 的按钮。

一旦创建了一个团队，下一步是将成员添加到团队。

若想删除某成员，只需点击想要删除的用户名右侧的 Remove 按钮。

如果需要删除一个团队，单击想要删除的团队，点击 Delete this team 按钮。

参考：

《GitHub入门》