##0.背景
准备重新捡起博客,记录自己的生活,特别是技术生活(过于私密的东西,也不敢往博客上放不是)。个人博客有两个途径:a.使用已有的博客网站; b.搭建自己的私人网站。调研了一下国内博客网站,(CSDN、javaEye、OSCHINA等)普遍文字格式、代码编排样式不是很喜欢(太挑剔了?对,我就是一个挑剔的人),这让自己转向私人博客。可以预想到,自己搭建要稍微复杂一点,话又说回来了,作为software engineer
折腾网站也算看家本领了(我会告诉你我的目标是scientist
么)。
既然要搭自己的私人博客,那选定什么框架/方案呢?之前使用WordPress搭过,但需要购买域名和空间;现在流行在GitHub上搭,并且不需要考虑域名和空间的问题,那就他了,上GitHub,走起(其实,国内也有一个类似的地方GitCafe,不过,出于装B需要,最终选定了GitHub)。
##1.做什么?
目标:私人博客、自己搭建。
方式:GitHub Pages
##2.怎么做?
初步分析,在GitHub上搭建博客,实质是:将自己的博客内容上传到GitHub上(因为GitHub提供了空间);如果需要修改博客内容,则需要从GitHub上将download/pull下来;接下来就是让外面可以访问GitHub上的博客。总结一下,对应3个必要步骤:
- GitHub上创建工程、并且能够将GitHub上的文件/代码,下载到本地;
- 将本地的文件/代码,上传到GitHub上;
- 配置GitHub,使其对外提供私人博客的访问页面;
好了,上面是凭空想出来的(任何地方搭建博客,都是上面的逻辑步骤,而不仅限于GitHub);那实际如何操作呢?具体分为4个阶段:
- 熟悉GitHub的基本操作(创建工程、上传代码、下载代码);
- 利用GitHub Pages功能,搭建简易网站;
- 利用jekyll,增强网站功能(除了jekyll,还有其他的方式);
- 在jekyll框架下,依照个人偏好,进行定制;
##3.实际操作
###3.1GitHub的基本操作
补充:上传文件至GitHub;另外,向GitHub提交代码时,按照上面的操作方式,需要每次都输入GitHub的用户名和密码,可以采用SSH Keys
的方式来解决此问题。
###3.2如何搭建博客?
GitHub上对于个人博客的支持,实质是利用GitHub Pages功能来实现的,具体操作:GitHub Pages,认真读一遍,5mins,一步一步操作下来,简易博客就搭建成功了(一个简单的欢迎页面index.html
)。
补充:扩展阅读GitHub Pages FAQ.
###3.3Jekyll增强博客网站功能
详细阅读”3.2如何搭建博客“中提到的GitHub Pages的童鞋,在GitHub Pages页面最下端一定注意到了Blogging with Jekyll,对,就是他,读一遍,操作一下,搞定。
补充:jekyll用起来倒是用起来了,怎么发表一遍博文呢?这个…额…等到学会 “3.4 基于jekyll框架,定制博客” 再去写博客吧,现在建议把上面的操作反复看两遍,捋一捋逻辑流程。
###3.4基于jekyll框架,定制博客
先看一下两个使用jekyll框架的博客:BeiYuu & Havee,他们对应的模版在GitHub上都可以找到:BeiYuu.com Template of GitHub & Havee.me Template of GitHub。
先膜拜一下上面两个博客模板,光彩夺目,亮瞎一双狗眼,好了,我能不能也搭建一个类似的博客?途径有一个:深入学习一下Jekyll的官方文档,补充:中文版本。(基于jekyll,如何定制博客,我将写一篇详细的介绍,敬请期待)
###3.5绑定域名
几点:
- 购买域名
- GitHub上绑定域名:
- 创建CNAME
- 从GitHub Help 上搜索
custom domain
TODO:整理GitHub上域名配置的基本原理:
- 整理A、C域名的区别
- …
##4.FAQ
###4.1使用google analytics来统计网站访问情况
- 注册Google Analytics账户;
- 在账户下,添加要监控的网站信息,Google Analytics会生成跟踪信息的JS片段;
- 将上述JS片段插入到自己想要统计的页面上;
具体设置细节:请查看官方文档。
####TODO:使用百度统计,替代google analytics
TODO:单独写一篇文章,关注几点:如何配置、基本原理。
参考资料:
- http://www.williamlong.info/archives/2214.html
- http://lusongsong.com/reed/548.html
###4.2如何DISCUS作为评论插件?
- 注册DISQUS账户;
- 登录后,点击
Add Disqus to your site
按钮,操作下去,最终将获得相应的JS片段; - 将上述JS片段插入到自己想要包含评论的页面即可;
###4.3配置网站,支持LaTeX语法
配置博客,支持LaTeX公式,此次设置kramdown来解析Markdown文件。
/*
If you have sufficient control over the publishing process
(e.g. you are running Jekyll yourself), an easy solution is
to switch the markdown parser to one that supports TeX.
*/
//For example, using kramdown:
gem install kramdown
//Change the markdown line in _config.yml to
markdown: kramdown
//and add something like
<script type="text/javascript"
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
//to _layouts/default.html.
//Now you can simply mark any mathematics in your posts with $$
原文链接:Using MathJax with Jekyll
###4.4遇到的问题&解决办法?
- 执行Git命令时,出错提示:(fatal: remote origin already exists.)
- GitHub上markdown的解析引擎不同,会造成最终页面效果的差异
- jekyll serve启动出错提示:(Liquid Exception: invalid byte sequence in GBK)见下文
修改\Ruby200\lib\ruby\gems\2.0.0\gems\jekyll-1.0.3\lib\jekyll
目录下的convertible.rb
文件,将其中:
self.content =File.read(File.join(base, name))
修改为:
self.content =File.read(File.join(base, name),:encoding=>"utf-8")
如果上述修改之后,仍然提示出错,则:...\lib\jekyll\tags
目录下include.rb
文件,类似对于convertible.rb
文件的操作;
转自:
http://ningg.top/build-blog-with-github
相关推荐
Github Pages 搭建个人博客,折腾好多天整理出的文档
使用github搭建的个人博客
GitHub+hexo搭建各个博客
- 学会在Linux环境下配置安装hexo及GitHub - 学会使用hexo进行搭建网页 ...## 设计一个在GitHub上可以发布和阅读文章的个人博客网站,使用Hexo进行搭建,使其可以发布文章。并在Linux环境下实现运行
hexo-Github搭建个人博客.md
【前端技术】在github创建个人主页或技术博客1、...对于新手来说,在github搭建免费的个人主页,不失为一个很好的练手方法,以下将记录我在很久以前在github搭建个人博客的经历。 1、注册github账号 GitHub是一个面向开
博主自己使用hexo+github搭建博客的源码
GitHub + PicGo + Typora 搭建个人图床详细教程(个人博客)
1. 先到github 个人网页上建立新的 2. 进入要上传的文件夹内,右键,选择 Git Bash Here 然后,出现如下界面。输入: git clone [刚才建立的新网址] 3. 这个时候,就建立本地 git 链接文件了(红框标记),这个...
hexo+github搭建个人博客,属于自己的博客,技术文档等等
这本书采用Creative Commons协议发布,并托管在GitHub上,意味着您可以免费阅读并可以用GitHub特有的方式参与本书的维护。 如何离线阅读 项目 gotgit/gotgithub 的版本库中的 gh-pages 分支保存着本书编译后的...
由支持的GitHub页面上的个人学术网站。Google Analytics(分析)跟踪ID和版权声明已添加到原始python脚本中。
每个github用户的个人网站+博客 Gitfolio将帮助您开始一个投资组合网站,在该网站上您可以展示您的作品以及一个博客,以帮助您将想法传播到现实世界中。 观看此以查看gitfolio的运行情况。 入门 让我们安装 安装...
前言一、hexo环境搭建具体过程请参见:hexo官方文档npm install -g hexo-cli2.建站hexo init blog新建完成后,会生成如下
1.gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub 2.一个博客网站建立好之后,想让所有人
Hexo+GitHub Pages搭建个人博客( 0 基础、小白值得一看--实力软文!)- 初行?&??-附件资源
fengjinghai.github.io:建立个人博客
主要介绍了利用github搭建个人maven仓库的方法步骤,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
2014年5月,基于 & 的博客模版,改进出此博客2013年8月,基于 博客模版,在GitHub上建立个人网站2012年9月,在内网使用Wordpress搭建个人博客Mac 下, 搭建开发调试环境搭建开发环境, 参考 .详细细节:# 1.安装最新版 ...
kalebemaiaa.github.io 个人网站我只是在建立个人网站