创建存储库者为项目的拥有者,可添加他人为合作者,对项目所有信息和审查具有所有权力。类似于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入门》