标签 GitHub Pages 下的文章 - 泰丽康健科技
标签 GitHub Pages 下的文章

GitHub Pages快速构建指南


Git

Git 是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目。最初由林纳斯·托瓦兹创作,于2005年以GPL发布。最初目的是为更好地管理Linux内核开发而设计。

Git 没有中心服务器。目前我们使用到的 Git 命令都是在本地执行,如果你想通过 Git 分享你的代码或者与其他开发人员合作。 你就需要将数据放到一台其他开发人员能够连接的服务器上。

Git 简明指南:http://rogerdudler.github.io/git-guide/index.zh.html
Git 深入指南:https://github.com/progit/progit
《Git权威指南》:https://github.com/gotgit/gotgit/

GitHub

GitHub成为Git远程仓库托管首选。

GitHub(2008年4月10日)是通过Git进行版本控制和协作的软件源代码托管服务平台,它可以让您和其他人在任何地方协同工作。

GitHub官方文档:http://help.github.com/
GotGitHub:http://www.worldhello.net/gotgithub/index.html

GitHub Pages

GitHub Pages是GitHub提供的一个网页寄存服务,于2008年推出。可以用于存放静态网页,包括博客、项目文档甚至整本书。Github Pages允许用户自定义项目首页,用来替代默认的源码列表。Github提供模板,允许站内生成网页;也允许用户自己编写网页,然后上传。

Jekyll、Hexo、Hugo等软件可以用于将文档转换成静态网页,一些框架还提供了将网页上传到GitHub Pages的功能。

通常认为,Hugo使用的go语言是一种编译型语言,速度非常快,而Jekyll使用ruby编写,hexo使用nodejs编写,ruby与nodejs都是面向对象的高级解释型语言,执行效率比编译型语言要低。同时,Hugo可以很轻松的被编译成二进制文件安装、运行,而不需要依赖项。

好处:

  * 免费,无限流量。
  * 享受git的版本管理功能,不用担心文章遗失。
  * 你只要用自己喜欢的编辑器写文章就可以了,其他事情一概不用操心,都由github处理。

缺点:

  * 有一定技术门槛,你必须要懂一点git和网页开发。
  * 它生成的是静态网页,添加动态功能必须使用外部服务,比如评论功能就只能用disqus。
  * 它不适合大型网站,因为没有用到数据库,每运行一次都必须遍历全部的文本文件,网站越大,生成时间越长。

分配域名:

启用GitHub Pages,新建存储库名称为uid.github.io时,GitHub存储库托管页面(User/Organization Pages)地址为uid.github.io;新建存储库名称为其他名称时,GitHub存储库托管页面将其作为一个项目站点(Project Pages),地址为uid.github.io/projectname。

自定义域名:

Settings > GitHub Pages > Custom domain 更改域名
域名平台 > 解析 > 添加继续记录 ;类型为CNAME

GitHub托管网站的应用工具:git+github+markdown+jekyll

Jekyll是一种简单的、适用于博客的、静态网站生成引擎。它使用一个模板目录作为网站布局的基础框架,支持Markdown、Textile等标记语言的解析,提供了模板、变量、插件等功能,最终生成一个完整的静态Web站点。

jekyll与github的关系:GitHub Pages是一个由 GitHub 提供的用于托管项目主页或博客的服务,jekyll是后台所运行的引擎。

使用Markdown格式发布GitHub Pages的基本目录结构:
  /project
    |-- _config.yml -设置文件
    |-- _layouts -模板目录
    |   |-- default.html -模板文件
    |-- _posts -文章目录
    |   |-- 2012-08-25-hello-world.md --文章
    |-- index.html --主页

可以使用Disqus这一第三方社会化评论系统为网站提供评论托管服务。加载 Disqus 的通用评论系统,使得静态页面组成的博客网站也可以嵌入评论等动态内容。