在github搭建个人网站

标签：github

---

[TOC]

---

先搜篇中文博客了解下流程，再根据下面的官方文档按顺序看一遍就差不多了。

这里不得不吐槽windows太垃圾了，linux下三行指令解决的问题，windows还要一个个安装、改配置文件。

参考教程

• GitHub Help
• GitHub Pages
• Jekyll（附上中文版)
• Run Jekyll on Windows

流程

首先默认你已经拥有了自己github账号，并会基本的git操作。

1. 新建一个和github用户名(username)同名的仓库，username.github.io
2. 在本地电脑安装
   • Ruby和devkit
   • python
   • jekyll
3. 找一个好的模板
4. 修改模板，导入自己的文章

具体步骤懒得写了，不定期完善。

感想

主要是我完全不懂ruby和python,前端也只有少的可怜的一点常识。搭建环境不复杂，基本安装好了后jekyll new myblog就有个基础模板了，不过很难看。所以我主要花了一整天时间去找主题、P图、了解jekyll的目录结构和用法、测试显示效果。总算搞定了，不过markdown的语法高亮我还是不满意，比较喜欢SegmentFault的高亮。有空再说这部分。

遇到的问题

1.windows下安装ruby的devkit遇到问题

Invalid configuration or no Rubies listed. Please fix 'config.yml'
and rerun 'ruby dk.rb install'

解决：How do I configure config.yml so that I can install devkit?

2.kunka主题jekyll build问题

Deprecation: You appear to have pagination turned on, but you haven't included the `jekyll-paginate` gem. Ensure you have `gems: [jekyll-paginate]` in your configuration fil e.

解决：jekyll-paginate gem

2.markdown显示问题 这里很蛋疼，我写markdown的习惯是代码都是前后各三个反单引号包起来的。使用kramdown解析markdown不能对含三个反单引号的代码块进行识别，默认按单行代码处理，缩进都没了；使用redcarpet能识别代码块，但没高亮，rouge又提示什么要下1.3版本，反正神烦。

解决：

• Syntax highlighting markdown code blocks in Jekyll (without using liquid tags)
• Jekyll kramdown配置

3.jekyll build失败报错 解决：Jekyll/Ruby Kramdown Missing Dependency

主题

好多主题太闪，我跑不通，或者怕不好改，挑了几个简单的，我跑通的主题(不要吐槽我的审美)

• so-simple-theme
• 陈俊的网：浮生志
• kunka

作者更多文章：@brianway