1 Git简介html
2 为何使用Github Pagesgit
3 建立Github Pagesgithub
3.1 安装git工具.bootstrap
3.2 两种pages模式windows
3.3 建立步骤ruby
3.4 经常使用命令服务器
4 使用Jekyll搭建博客markdown
4.1 什么是jekyll并发
4.2 jekyll本地环境搭建框架
4.3 jekyll目录结构
4.4 Jekyll-Bootstrap建立博客
4.5 Jekyll 写博过程
4.6 个性化博客
5 使用Markdown
5.1 简介
5.2 基本语法
5.3 Notepad++支持Markdown语法高亮
1 Git简介
Git是一个开源的分布式版本控制系统,用以有效、高速的处理从很小到很是大的项目版本管理。
GitHub能够托管各类git库的站点。
GitHub Pages免费的静态站点,三个特色:免费托管、自带主题、支持自制页面和Jekyll。
2 为何使用Github Pages
搭建简单并且免费;
支持静态脚本;
能够绑定你的域名;
DIY自由发挥,动手实践一些有意思的东西git,markdown,bootstrap,jekyll;
理想写博环境,git+github+markdown+jekyll;
3 建立Github Pages
3.1 安装git工具
http://windows.github.com/
http://mac.github.com/
3.2 两种pages模式
1) 使用本身的用户名,每一个用户名下面只能创建一个;
2) 资源命名必须符合这样的规则username/username.github.com;
3) 主干上内容被用来构建和发布页面
1) gh-pages分支用于构建和发布;
2) 若是user/org pages使用了独立域名,那么托管在帐户下的全部project pages将使用相同的域名进行重定向,除非project pages使用了本身的独立域名;
3) 若是没有使用独立域名,project pages将经过子路径的形式提供服务username.github.com/projectname;
4) 自定义404页面只能在独立域名下使用,不然会使用User Pages 404;
5) 建立项目站点步骤:
$ git clone https://github.com/USERNAME/PROJECT.git PROJECT $ git checkout --orphan gh-pages $ git rm -rf . $ git add . $ git commit -a -m "First pages commit" $ git push origin gh-pages
第一步:建立我的站点
第二步:设置站点主题
进入资源-setting
更新你的站点
选择主题并发布
3.4 经常使用命令
$ git clone git@github.com:username/username.github.com.git //本地若是无远程代码,先作这步,否则就忽略 $ cd .ssh/username.github.com //定位到你blog的目录下 $ git pull origin master //先同步远程文件,后面的参数会自动链接你远程的文件 $ git status //查看本地本身修改了多少文件 $ git add . //添加远程不存在的git文件 $ git commit * -m "what I want told to someone" $ git push origin master //更新到远程服务器上
4 使用Jekyll搭建博客
4.1 什么是jekyll
Jekyll是一种简单的、适用于博客的、静态网站生成引擎。它使用一个模板目录做为网站布局的基础框架,支持Markdown、Textile等标记语言的解析,提供了模板、变量、插件等功能,最终生成一个完整的静态Web站点。说白了就是,只要安装Jekyll的规范和结构,不用写html,就能够生成网站。[jekyll介绍][jekyll on github][jekyllbootstrap]。
Jekyll使用Liquid模板语言,{{page.title}}表示文章标题,{{content}}表示文章内容。咱们能够用两种Liquid标记语言:输出标记(output markup)和标签标记 (tag markup)。输出标记会输出文本(若是被引用的变量存在),而标签标记不会。输出标记是用双花括号分隔,而标签标记是用花括号-百分号对分隔。[Liquid模板语言] [Liquid模板变量参考]。
jekyll与github的关系:GitHub Pages一个由 GitHub 提供的用于托管项目主页或博客的服务,jekyll是后台所运行的引擎。
4.2 jekyll本地环境搭建
下载最新的RubyInstaller并安装(我下载的是rubyinstaller-1.9.3-p194.exe),设置环境变量,path中配置C:\Ruby193\bin目录,而后在命令行终端下输入gem update --system来升级gem;
下载最新的DevKit,DevKit是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。可是这个方法目前仅支持经过RubyInstaller安装的Ruby,并双击运行解压到C:\DevKit。而后打开终端cmd,输入下列命令进行安装:
cd C:\DevKit
ruby dk.rb init
ruby dk.rb install
完成上面的准备就能够安装Jekyll了,由于Jekyll是用Ruby编写的,最好的安装方式是经过RubyGems(gem):
gem install Jekyll
并使用命令检验是否安装成功
jekyll --version
安装Rdiscount,这个用来解析Markdown标记的包,使用以下命令:
gem install rdiscount
运行本地工程:
cd 到工程目录,启动服务:
jekyll --server
4.3 jekyll目录结构
_posts: _posts中的数据文档,经过注入_layouts定义的模板,经过jekyll --server最终生成的静态页面在_sites目录。目录是用来存放你的文章的,通常以日期的形式书写标题。 _layouts:_layouts中的模板通常指向了_includes/themes中的模板。目录是用来存放模板的,在这里你能够定义页面中不一样的头部和底部。 _includes: 1) _includes/JB中有一些经常使用的工具,用于列表显示、评论等; 2) _includes/themes中可参看主题的相关html文档。 3) _includes/themes中的主题通常包含default.html、post.html和page.html三个文档。default.html定义了网站的最上层框架(模板),post.html和page.html是其子框架(模板)。 4) 生成好的html子页面经过default.html的{{ content }}变量调用,生成整个页面。 assets 渲染页面的CSS和JS文档在assets/themes中 _config.yml 站点生成须要用到_config.yml配置文件,站点的全局变量在_config.yml中定义,用site.访问;页面的变量在YAML Front Matter中定义,用page.访问,更多的模板变量可参考模板数据。 index.html是你的页面首页。
4.4 Jekyll-Bootstrap建立博客
建立我的站点,即建立一个新资源,格式为username.github.com;
安装Jekyll-Bootstrap:
$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
$ cd USERNAME.github.com
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
$ git push origin master
访问建立好的我的站点:username.github.com
在本地测试查看效果:
cd USERNAME.github.com
jekyll --server
4.5 Jekyll 写博过程
一、 配置_config.yml:
1) 修改标题:title : My Blog =)
2) 修改我的信息:
author : name : Name Lastname email : blah@email.test github : username twitter : username feedburner : feedname
3) 引用:_config.yml中的键值均引用到其余页面{{ site.title }};
二、 写文章
按照_config.yml的格式permalink: /:categories/:year/:month/:day/:title,能够修改格式,建立markdown格式文件,就能够当初博客发布了。
三、 发布
本地预览修改:运行jekyll –server,预览http:127.0.0.1:4000。
发布到github上:经过命令提交或者客户端提交。
4.6 个性化博客
Github Page完成了博客的主要功能,写做、发布、修改,这些都是相对静态的东西,就是你本身能够控制的事情,还有一些动态的东西Github Pages没法支持,好比说文章浏览次数、文章的评论等,还有一些个性化的东西,像个性化页头页尾、代码高亮能够把博客整的更漂亮一点,其实这写均可以经过第三方应用来实现,个性化本身的博客。
加上Disqus云评论:
注册http://disqus.com/
修改_config.yml: comments : provider : disqus disqus : short_name : tiansj
5 使用Markdown
5.1 简介
Markdown 的宗旨是实现「易读易写」。可读性,不管如何,都是最重要的。
Markdown 的语法全由一些符号所组成,这些符号通过精挑细选,其做用一目了然。格式撰写的文件能够直接以纯文本发布,而且看起来不会像是由许多标签或是格式指令所构成。
资料:[搭建环境]
5.2 基本语法
使用一个或多个空行分隔内容段来生成段落 <p>。 标题(h1~h6)格式为使用相应个数的“#”做前缀,好比如下代码表示 h3:
使用“>”做为段落前缀来标识引用文字段落。这实际上是 email 中标记引用文字的标准方式:
引用的内容
这个记号直接借鉴的邮件标准
使用“*”“+”“-”来表示无序列表;使用数字加“.”表示有序列表。如:
I am ordered list item 1...
So I should be item 2!?
使用 4 个以上 空格或 1 个以上 的 tab 来标记代码段落,它们将被
和 包裹,这意味着代码段内的字体会是 monospace家族的,而且特殊符号不会被转义。
使用 test 来标记普通连接。
使用来标记图片。
引号内的 title 文字是可选的,连接也可使用相对路径。
使用 * 或 _ 包裹文本产生 strong 效果:
语气很重的文本 以及 语气更重的文本
5.3 Notepad++支持Markdown语法高亮
下载userDefineLang.xml
将 userDefineLang.xml 放置到此目录:C:\Users\Administrator\AppData\Roaming\Notepad++
重启 Notepad++,在语言菜单下能够看到自定义的 Markdown 高亮规则