diff --git a/About Releases 关于发布包.md b/About Releases 关于发布包.md new file mode 100644 index 0000000..d04b873 --- /dev/null +++ b/About Releases 关于发布包.md @@ -0,0 +1,23 @@ +About Releases 关于发布包 +=========== + +发布包是 Github 打包盒提供软件给用户的方式。可以想象成下载软件的替代品。 + +![](https://help.github.com/assets/images/help/releases/overview.png) + +发布包提供下载链接和变更说明。 + +发布基于 [Git 标签](http://git-scm.com/book/en/v2/Git-Basics-Tagging)。标签标明了项目的历史，所以用于发布很不错。发布是通过以下方式标记的日期排列： + +* 如果这是一个[注释标签](http://git-scm.com/book/en/Git-Basics-Tagging#Annotated-Tags)，使用标签对象的日期。 +* 如果它是一个[轻量级的标签](http://git-scm.com/book/en/Git-Basics-Tagging#Lightweight-Tags)，使用对象提交的日期。 + +更多信息可以查看你的标签，详见["和标签工作"]() + +##Limitations on binary files 二进制文件的限制 + +暂时没有对二进制文件的大小和上传带宽做限制。 + + + +*参考*：[https://help.github.com/articles/about-releases/](https://help.github.com/articles/about-releases/) diff --git a/Creating Releases 创建发布包.md b/Creating Releases 创建发布包.md new file mode 100644 index 0000000..386936d --- /dev/null +++ b/Creating Releases 创建发布包.md @@ -0,0 +1,59 @@ +Creating Releases 创建发布包 +=========== + +发布包是让用户接触项目不错的方式： + +1.页面顶端，点击你的用户名 + +![](https://help.github.com/assets/images/help/profile/top_right_avatar.png) + +2.在你的 profile 页面，点击 Repositories 窗口，接着点击你的库的名称 + +![](https://help.github.com/assets/images/help/profile/profile_repositories_tab.png) + +3.顶端，点击 releases + +![](https://help.github.com/assets/images/help/releases/releases-header-menu.png) + +4.点击 Draft a new release + +![](https://help.github.com/assets/images/help/releases/draft_release_button.png) + +5.输入发布包的版本号。版本号基于 [Git 标签](http://git-scm.com/book/en/Git-Basics-Tagging),我们建议标签命名，符合[语义版本](http://semver.org/)。 + +![](https://help.github.com/assets/images/help/releases/releases_tag_version.png) + +6.选择一个分支来包含你想发布的项目。通常，你会想发布在你的主分支，除非你发布测试软件。 + +![](https://help.github.com/assets/images/help/releases/releases_tag_branch.png) + +7.在你的发布包中输入标题和描述 + +![](https://help.github.com/assets/images/help/releases/releases_description.png) + +8.如果发布中包含二进制文件，托文件进二进制框中 + +![](https://help.github.com/assets/images/help/releases/releases_adding_binary.gif) + + +9.如果，发布包不稳定，选择`This is a pre-release` 来提醒用户这个是不能用于生产环境的 + +![](https://help.github.com/assets/images/help/releases/prerelease_checkbox.png) + + +10.如果准备好了发布了，点击 Publish release。另外 点击 Save draft 用于保存在草稿箱中。只有你和[你的合作者]()可以看到到草稿箱。 + +![](https://help.github.com/assets/images/help/releases/release_buttons.png) + + +##Automatically creating releases 自动创建发布 + + 自动创建发布（支持命令行或者脚本），详见[Releases API documentation.](https://developer.github.com/v3/repos/releases/#create-a-release) + +##Further reading 扩展阅读 + +* [链接到发布包]() + + + +参考：[https://help.github.com/articles/creating-releases/](https://help.github.com/articles/creating-releases/) diff --git a/Distributing large binaries 分发大型二进制文件.md b/Distributing large binaries 分发大型二进制文件.md new file mode 100644 index 0000000..57b0bea --- /dev/null +++ b/Distributing large binaries 分发大型二进制文件.md @@ -0,0 +1,21 @@ +Distributing large binaries 分发大型二进制文件. +=========== + +当项目需要分发大型的文件，比如 二进制文件或者安装包时，有几种廉价方式提供大容量存储和分发大型文件。 + +我们推荐在 Github 上 创建[项目的发布包]()。发布包允许包括二进制文件，比如编译后的程序。更多信息，参阅[创建发布包]()。 + +暂时，我们没有在二进制文件的大小和上传带宽做任何限制。 + +##Using Amazon S3 使用 AS3 + +或者，您可以使用 [Amazon S3](http://aws.amazon.com/s3/)存储服务，搭配通过 CloudFront 的 CDN 。亚马逊有一个不错的用户指南 [ Getting started with S3 ](http://docs.amazonwebservices.com/AmazonS3/latest/gsg/GetStartedWithS3.html)，介绍了如何上传文件。 + +如果你是 OS X 操作系统， [Transmit](http://panic.com/transmit/) 和 [3hub](http://www.3hubapp.com/) 是两个流行的客户端 。 + +如果你是 Windows 操作系统, [S3 Browser](http://s3browser.com/) 是个不错的管理 AS3 文件的免费应用。 + +当你上传完成后，可以插入链接到 `README` 或者库的描述文档中。 + + +参考：[https://help.github.com/articles/distributing-large-binaries/](https://help.github.com/articles/distributing-large-binaries/) diff --git a/Linking to releases 链接到发布包.md b/Linking to releases 链接到发布包.md new file mode 100644 index 0000000..1683f27 --- /dev/null +++ b/Linking to releases 链接到发布包.md @@ -0,0 +1,6 @@ +Linking to releases 链接到发布包 +=========== + + + +*参考*：[https://help.github.com/articles/linking-to-releases/](https://help.github.com/articles/linking-to-releases/) diff --git a/Permission levels for a user account repository 用户库的权限级别.md b/Permission levels for a user account repository 用户库的权限级别.md new file mode 100644 index 0000000..99d37e2 --- /dev/null +++ b/Permission levels for a user account repository 用户库的权限级别.md @@ -0,0 +1,33 @@ +Permission levels for a user account repository 用户库的权限级别 +=========== + +用户账号的库有2种权限级别 ：库拥有者和合作者： + +*提示：如果你想要更多的读写权限，可以考虑将库转成[组织]()。更多信息参阅[如何转换库]()* + + +Owner access on a repository owned by a user account + +The repository owner has full control of the repository. In addition to all the permissions allowed by repository collaborators, the repository owner can: + +Add collaborators +Change the visibility of the repository (from public to private, or from private to public) +Delete the repository +There is only one owner of a repository owned by a user account; this permission cannot be shared with another user account. To transfer ownership of a repository to another user, see "How to transfer a repository." + +Collaborator access on a repository owned by a user account + +Collaborators on a private repository can: + +Push to (write), pull from (read), and fork (copy) the repository +Apply labels and milestones +Open, close, re-open, and assign issues +Edit and delete comments on commits, pull requests, and issues +Merge and close pull requests +Send pull requests from forks of the repository +Create and edit Wikis +Create and edit Releases +Remove themselves as collaborators on the repository + + +*参考*：[https://help.github.com/articles/permission-levels-for-a-user-account-repository/](https://help.github.com/articles/permission-levels-for-a-user-account-repository/) diff --git a/Transferring a repository 转换库.md b/Transferring a repository 转换库.md new file mode 100644 index 0000000..6f07e6a --- /dev/null +++ b/Transferring a repository 转换库.md @@ -0,0 +1,6 @@ +Transferring a repository 转换库 +=========== + + + +*参考*：[https://help.github.com/articles/transferring-a-repository/](https://help.github.com/articles/transferring-a-repository/) diff --git a/Working with Tags 和标签工作.md b/Working with Tags 和标签工作.md new file mode 100644 index 0000000..4176484 --- /dev/null +++ b/Working with Tags 和标签工作.md @@ -0,0 +1,6 @@ +Working with Tags 和标签工作 +=========== + + + +*参考*：[https://help.github.com/articles/working-with-tags/](https://help.github.com/articles/working-with-tags/)