标签 Github 下的文章

现在你可以从我们的 集成件目录里面找到更多工具。这个目录目前有超过 15 个分类 — 从 API 管理应用监控, Github 的集成件可以支持您的开发周期的每一个阶段。

我们邀请了具有不同层面的专长的开发人员,来创造有助于开发者更好的工作的集成件。如果你曾经为 Github 构建过一个很棒的集成件,我们希望来让更多人知道它! GitterAppVeyorZenHub 都做到了,你也可以!

我们在寻找什么?

良好的软件开发依赖于上乘的工具,开发人员如今有了更多的选择,无论是语言、框架、工作流程,还是包含了其他因素的环境。我们正在寻找能够创造更好的整体开发体验的开发工具。

进入集成件目录清单的指南:

有帮助的资源

如果想要被列在目录里,请按照列出需求页中概述的步骤。

你也应该阅读我们的营销指南已有目录清单来更好的了解如何把它们全都放在一起。请把你的列表的内容记录在一个私密 gist 中(markdown 格式),并且通过邮件联系我们 [email protected]。 如果你有任何问题,不要犹疑,请联系 [email protected]


via: https://github.com/blog/2226-build-an-integration-for-github

作者:chobberoni 译者:Bestony 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

你可能比较熟悉如何用 Github Pages 来分享你的工作,又或许你看过一堂教你建立你的第一个 Github Pages 网站的教程。近期 Github Pages 的改进使得从不同的数据源来发布您的网站更加的方便,其中的来源之一就是你的仓库的 /docs 目录。

文档的质量是一个软件项目健康发展的标志。对于开源项目来说,维护一个可靠而不出错的知识库、详细说明所有的细节是至关重要的。精心策划的文档可以让增加项目的亲切感,提供一步步的指导并促进各种方式的合作可以推动开源软件开发的协作进程。

在 Web 上托管你的文档是一个消耗时间的挑战,而且对于它的发布和维护也没有省事的办法,然而这是并非不可避免的。面对多种不同的发布工具,又是 FTP 服务器,又是数据库,文件以各种不同的方式存放在不同的位置下,而这些都需要你手动来调整。需要说明的是,传统的 Web 发布方式提供了无与伦比的灵活性和性能,但是在许多情况下,这是以牺牲简单易用为代价的。

当作为文档使用时,麻烦更少的方式显然更容易去维护。

GitHub Pages 可以以指定的方式为你的项目创建网站,这使得它天然地适合发布和维护文档。因为 Github Pages 支持 Jekyll,所以你可以使用纯文本或 Markdown 来书写你的文档,从而降低你维护的成本、减少维护时的障碍。Jekyll 还支持许多有用的工具比如变量、模板、以及自动代码高亮等等,它会给你更多的灵活性而不会增加复杂性,这些你在一些笨重的平台是见不到的。

最重要的是,在 Github 上使用 GitHub Pages 意味着你的文档和代码可以使用诸如 Issues 和 Pull Requests 来确保它得到应有的高水平维护,而且因为 GitHub Pages 允许您发布代码库主分支上的 /docs 目录,这样您就可以在同一分支同时维护你的代码库及其文档。

现在开始!

发布你的第一个文档页面只需要短短几分钟。

  1. 在你的仓库的主分支里创建一个 /docs/index.md 文件。
  2. 把你的内容以 Jekyll 格式添加进去,并提交你的修改。

  1. 查看你的仓库的设置分支然后选择主分支 /docs 目录,将其设置为 GitHub Pages 的源 ,点击保存,你就搞定了。

GitHub Pages 将会从你的 /docs 目录中读取内容,转换 index.md 为 HTML。然后把它发布到你的 GitHub Pages 的 URL 上。

这样将会创建并输出一个最基础的 HTML ,而且你可以使用 Jekyll 的自定义模板、CSS 和其他特性。如果想要看所有的可能,你可以看看 GitHub Pages Showcase


via: https://github.com/blog/2233-publish-your-project-documentation-with-github-pages

作者:loranallensmith 译者:Bestony 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

开源正在走向胜利,虽然这一天或许会来的晚一点,但是开源终将胜利。在网络安全社区里,尽管许多公司以商业软件的方式牢牢把握着自己的代码不放,但是也有很多安全方面的开源项目可供专业的安全人员使用。

搜寻这些安全相关的开源软件最好的地方显然是 GitHub。你可以使用该网站上的搜索功能来找到这些有用的工具,但是有一个地方可以让你找到那些安全方面最流行的项目,那就是 GitHub 的展示区,可能知道它的人不多。

从 2014 年开始,GitHub 展示区就会按照分类陈列这些最流行的项目。在展示区中,项目以其所获得的 星标数 stars 排名,这个列表会不断更新当前最流行的项目。

展示区包含的“安全”分类中包含了 24 个项目,这里我们列出了在 GitHub 上排名前十的安全项目。

1. osquery - 来自 Facebook

osquery 将操作系统表示为一个高性能的关系型数据库。这可以让你通过基于 SQL 的查询来获取操作系统数据。通过 osquery,将运行中的进程、加载的内核模块、打开的网络连接、浏览器插件、硬件事件或文件哈希等抽象为 SQL 数据表。

2. Metasploit Framework - 来自 Rapid7

Metasploit Framework 是一个针对远程目标主机开发和执行漏洞利用代码的工具。

3. Infer - 来自 Facebook

Facebook Infer 是一个静态分析工具。用它来分析 Objective-C、Java 或 C 代码,可以列出其中潜在的缺陷。在代码上传到手机设备之前,可以用 Infer 来找到那些致命缺陷,可以防止出现崩溃或性能下降。

4. Brakeman - 来自 PresidentBeef

Brakeman 是一个开源的静态分析工具,它可以检查 Ruby on Rails 应用的安全漏洞。

5. Radare2 - 来自 Radare 项目

Radare 是一个取证工具,是一个可编程的命令行十六进制编辑器,可以打开磁盘文件。它也支持二进制分析、反汇编代码、调试程序、连接到远程 gdb 服务器等等功能。

6. OS X Auditor - 来自 Jean-Philippe Teissier

OS X Auditor 是一个自由的 Mac OS X 计算机取证工具,它可以解析各种类型的文件,获取其中的可疑内容。

7. BeEF - 来自 BeEF 项目

BeEF 简单的来说就是一个 浏览器利用框架 Browser Exploitation Framework 。它是一个针对浏览器的脆弱性测试工具。

8. Cuckoo - 来自 Cuckoo Sandbox 项目

Cuckoo Sandbox 是一个自动的恶意软件动态分析系统。简单的来说,就是你可以将任何可疑的文件丢给它,只需要几秒钟,Cuckoo 就可以给出在隔离的环境中执行的大致结果。

9. Scumblr - 来自 Netflix

Scumblr 是一个 Web 应用,它可以周期性地进行检查,并根据检查结果采取不同的处置方法。

10. Moloch - 来自 AOL

Moloch 是一个开源的、大规模的,抓包、索引并存储进数据库的系统。它提供了一个简单的 Web 界面,可以用来查看、检索和导出所捕获的数据包。它支持 API,可以直接下载 PCAP 数据和 JSON 格式的会话数据。Moloch 并不是用来替换 IDS 的,而是用来配合它们以标准的 PCAP 格式存储并索引所有的网络数据,从而可以快速访问。Moloch 可以跨系统部署,并可以处理高达每秒 10 Gb 的流量。

以上就是现在 GitHub 上最流行的安全相关的开源项目。你可以经常去展示区看看有无新的流行项目出现。

Git 和 Github 在 Linux 开发者中有很高的知名度。但是开发者如何看待它们呢?另外,Github 是不是真的和 Git 是一个意思?一个 Linux reddit 用户最近问到了这个问题,并且得到了很有意思的答案。

Dontwakemeup46 提问:

我正在学习 Git 和 Github。我感兴趣社区如何看待两者?据我所知,Git 和 Github 应用十分广泛。但是 Git 或 Github 有没有严重的不足?社区喜欢去改变些什么呢?更多见 Reddit

与他志同道合的 Linux reddit 用户回答了他们对于 Git 和 Github的观点:

Derenir:

“Github 并不附属于 Git。

Git 是由 Linus Torvalds 开发的。

Github 几乎不支持 Linux。

Github 是一家企图借助 Git 赚钱的公司。

https://desktop.github.com/ 并没有支持 Linux。”

Bilog78:

“一个小的补充: Linus Torvalds 已经不再维护 Git了。维护者是 Junio C Hamano,以及 在他之后的主要贡献者是 Jeff King 和 Shawn O. Pearce。”

Fearthefuture:

“我喜欢 Git,但是不明白人们为什么还要使用 Github。从我的角度,Github 比 Bitbucket 好的一点是用户统计和更大的用户基础。Bitbucket 有无限的免费私有库,更好的 UI,以及更好地集成了其他服务,比如说 Jenkins。”

Thunger:

“Gitlab.com 也很不错,特别是你可以在自己的服务器上架设自己的实例。”

Takluyver:

“很多人熟悉 Github 的 UI 以及相关联的服务,比如说 Travis 。并且很多人都有 Github 账号,所以它是存储项目的一个很好的地方。人们也使用他们的 Github 个人信息页作为一种求职用的作品选辑,所以他们很积极地将更多的项目放在这里。Github 是一个存放开源项目的事实标准。”

Tdammers:

“Git 严重问题在于 UI,它有些违反直觉,以至于很多用户只能达到使用一些容易记住的咒语的程度。

Github:最严重的问题在于它是商业托管的解决方案;你买了方便,但是代价是你的代码在别人的服务器上面,已经不在你的掌控范围之内了。另一个对于 Github 的普遍批判是它的工作流和 Git 本身的精神不符,特别是 pull requests 工作的方式。最后, Github 垄断了代码的托管环境,同时对于多样性是很不好的,这反过来对于旺盛的免费软件社区很重要。”

Dies:

“更重要的是,如果一旦是这样,按照现状来说,我猜我们会被 Github 所困,因为它们控制如此多的项目。”

Tdammers:

“代码托管在别人的服务器上,这里"别人"指的是 Github。这对于开源项目来说,并不是什么太大的问题,但是尽管如此,你无法控制它。如果你在 Github 上有私有项目,“它将保持私有”的唯一的保险只是 Github 的承诺而已。如果你决定删除东西,你不能确定东西是否被删除了,或者只是隐藏了。

Github 并不自己控制这些项目(你总是可以拿走你的代码,然后托管到别的地方,声明新位置是“官方”的),它只是有比开发者本身有更深的使用权。”

Drelos:

“我已经读了大量的关于 Github 的赞美与批评。(这里有一个例子),但是我的幼稚问题是为什么不向一个免费开源的版本努力呢?”

Twizmwazin:

“Gitlab 的源码就存在这里。”

更多见 Reddit

今日关注

在遭到 暴力破解 Brute-Force 攻击之后,GitHub 重置了所有受到攻击影响的用户的密码。“有黑客获取了其他在线服务的邮箱和密码之后,尝试作为 GitHub 的账号进行登录”,GitHub 的 Shawn Davenport 解释到。好消息是 GitHub 的工程师立马检测到了这个问题。对于所有受影响的用户,GitHub 都发送了密码重置提醒。用户需要检查下自己密码的复杂度。这次安全事件,究其原因,是 GitHub 上存放着一些私有仓库的代码,有些可能是某些企业软件的源码——用在很多至关重要的地方,这是招致了黑客的关注。

一些公司已经遭遇到了大量的数据泄露,像 Linkedin(1.17 亿账号),MySpace(3.6 亿账号),Tumblr(6千5百万账号),VK(1亿账号),Fling.com (4千万账号)等。此外,Twitter 有 3千2百万的明文用户信息由于用户自身的计算机木马被泄露了。

新闻摘要

  • Oracle VirtualBox 5.0.22 正式发布。这一版本提供了对 Linux 4.7 内核的支持,对 Red Hat Enterprise Linux 6.8 操作系统的支持,以及对更多其他系统的支持,并且修复了若干 bug。目前也已经可以下载体验了。
  • Calibre 2.59 发布。这一版本提供了对 EPUB 3更好的支持,以及对 Amazon 元数据更好的下载体验。目前已经可以进行下载体验了。
  • 代号为 “Raptor” 的 Robolinux 8.5 LTS 发布,该版本基于最新的 Debian GNU/Linux 8 "Jessie" 操作系统,搭载了 Linux 3.16 内核。已经可以从软件仓库进行下载体验了。
  • pfSense 2.3.1 的第五次更新 (2.3.1\_5) 发布。修复了web GUI 的两个安全问题和其他7个bug。
  • 开源赛车游戏 SuperTuxKart 0.9.2 即将发布。在新版本中,可以对比赛进行记录,并且可以进行死亡回放,通过人工智能实现的3次激战和足球模式,另外,还有非常漂亮的 TTF 字体。目前第一个发行候选版本已经可以下载了。
  • 期待已久的 Qt 5.7 GUI 工具套件发布。提供了对树莓派 3 设备、Qt NFC 以及 Qt Creator 4.0 的支持和对 C++11 编译器的支持,集成了Qt 3D模块。已经可以下载使用了。
  • Fedora 24 发布第四次延期之后,终于定下了最终的发布日期,6.21号。再等几天吧~
  • Linux 内核 3.16.36 和 3.2.81 发布,可以下载更新了。

大家好,今天我们要学习一下怎样在github.com提供的仓库中托管开源软件源代码。GitHub是一个基于web的Git仓库托管服务,提供基于 git 的分布式版本控制和源代码管理(SCM)功能,并加入了自身的特点。它给开源项目和私有项目提供了一个互相协作的工作区、代码预览和代码管理功能。不像Git是一个完完全全的命令行工具,GitHub提供了一个基于web的图形化界面和桌面,也整合了手机操作。GitHub同时提供了私有库付费计划和通常用来管理开源软件项目的免费账号。

github universe logo

这是一种快速灵活,基于web的托管服务,它使用方便,管理分布式版本控制系统也是相当容易,任何人都能将他们的软件源代码托管到 github,让全球各地数以百万计的人可以使用它、参与贡献、共享它、进行问题跟踪以及更多的用途。这里有一些简单快速地托管软件源代码的方法。

1. 创建一个新的Github账号

首先,打开你最喜欢的浏览器并访问github,首页页面如下所示。

Github Homepage

现在,首页打开之后,请填写一个新的github账号用于注册。

输入注册所需的有效信息之后,你会被转到计划选择的步骤。在这个页面上有5种计划,我们可以根据需要来选择,这里我们要选择免费计划。所以,我们点击选择Free计划并完成注册。如果我们接下去还打算创建一个组织,那我们需要勾选“Help me setup an organization next”。

choosing plan

2. 创建一个新的库

成功注册新账号或登录上Github之后,我们需要创建一个新的库来开始我们的征程。

点击位于顶部靠右账号id旁边的(+)按钮,然后点击“New Repository”。

Add new repository

点击创建一个新的库之后,我们进入了填写所需信息的页面。

adding repository information

填写好信息之后,我们点击绿色的“Create repository”按钮。

这些步骤都做完之后,我们将看到类似于下面这张图的页面。

repository github

3. 上传一个已有项目

如果我们想在Github上分享我们的项目,我们自然要把代码推上我们创建的库中。想要这样的话,我们首先要在我们的Linux机器上安装git。如果我在机器上运行的是Ubuntu 14.04 LTS,我需要运行apt工具来安装它。

$ sudo apt-get install git

installing git

现在git已经准备就绪,我们要上传代码了。

注意:为了避免错误,不要在初始化的新库中包含README、license或gitignore等文件,你可以在项目推送到Github上之后再添加它们。

在终端上,我们需要切换当前工作目录为你的本地项目的目录,然后将其初始化为Git库。

$ git init

接着我们添加新的本地库里中的文件,作为我们的首次提交内容。

$ git add .

现在我们就提交我们在本地库所添加的文件。

$ git commit -m 'First commit'

git commit

在终端上,添加远程库的URL地址,以便我们的本地库推送到远程。

$ git remote add origin 远程库的URL
$ git remote -v

adding remote url

注意:请确保将上述“远程库的URL”替换成了你自己的远程库的URL。

现在,要将我们的本地库的改变推送至GitHub的版本库中,我们需要运行以下命令,并且输入所需的用户名和密码。

$ git push origin master

pushing repo

克隆一个库

如果我们想用一条简单地命令从github上下载代码库至本机上,我们可以用git clone命令,该命令将会从远程库中克隆最新的目录。

$ git clone https://github.com/aruntechgeek/linspeed.git

cloning repo

请把以上这条URL地址更改成你想要克隆的地址。

推送改动

如果我们对我们的代码做了更改并想把它们推送至我们的远程库中,我们应该在该目录下运行以下命令。

$ git add .
$ git commit -m "Updating"
$ git push

结论

啊哈!我们已经成功地将我们的项目源代码托管到Github的库中了。Github是快速灵活的基于web的托管服务,分布式版本控制系统使用起来方便容易。数百万个非常棒的开源项目驻扎在github上。所以,如果你有任何问题、建议或反馈,请在评论中告诉我们。谢谢大家!好好享受吧 :-)


via: http://linoxide.com/usr-mgmt/host-open-source-code-repository-github/

作者:Arun Pyasi 译者:ZTinoZ 校对:wxy

本文由 LCTT 原创翻译,Linux中国 荣誉推出