用github + jekyll创建个人博客

施辉
2023-12-01

记录用github + jekyll创建个人博客的过程。

参考文档
Windows 上安装 Jekyll
使用 github + jekyll 搭建个人博客
jekyll 官网的帮助文档(很重要!)

安装jekyll,首先需要安装Ruby、Python。

Ruby安装
在官网:http://rubyinstaller.org/downloads/下载Ruby安装程序。
需要下载:
1、Ruby 2.3.3 (x64)
2、DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe
正确选择32位或者64位版本。

1.安装路径最好保持默认路径C:\Ruby23-x64。
2.安装时注意勾选 “Add Ruby executables to your PATH”选项。
3.安装完成后在命令窗口执行:

ruby -v

如果输出相应版本,则安装成功。
例如:

ruby 2.3.3p222 (2016-11-21 revision 56859) [x64-mingw32]

安装DevKit
1、运行刚才下载的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe,按照提示解压到相应文件夹下。例如: C:\DevKit
2、打开命令窗口,执行:

cd “C:\DevKit”
ruby dk.rb init
notepad config.yml

3、查看config.yml文件最后一行是否有- C:\Ruby23-x64(Ruby安装目录),如果没有则添加。
4、审查安装,在命令窗口执行:

ruby dk.rb review
ruby dk.rb install

安装 Jekyll
1、执行gem -v查看是否安装成功
2、安装Jekyll,命令窗口执行:
gem install jekyll

安装 Python
1、前往Python官网http://www.python.org/download/下载,这里推荐使用Python 2版本。
2、安装
3、添加环境变量,PATH里添加Python 根路径(例如:C:\Python27)
4、查看Python是否安装成功。
python -V
输出:
Python 2.7.13

安装 ‘Easy Install’
1、下载 ez_setup.py 保存到C盘(其他位置应该也行),ez_setup.py这个是在CSDN下载的。
2、命令行运行:python “C:\ez_setup.py”
3、在环境变量PATH里添加 C:\Python27\Scripts。

安装 Pygments
1、查看easy_install是否安装成功,命令行运行:
easy_install --version
输出:
setuptools 28.8.0 from c:\python27\lib\site-packages (Python 2.7)。
2、使用 “easy_install” 来安装 Pygments,命令行运行:easy_install Pygments。

启动 Jekyll
1、安装jekyll bundler插件,命令行执行:
gem install jekyll bundler
2、~ $ jekyll new myblog
3、~ $ cd myblog
4、~ $ bundle exec jekyll serve
在浏览器打开http://localhost:4000,验证是否创建成功。

登录GitHub创建仓库
创建一个名字为xxx.github.io的仓库,xxx自己命名,这个以后会作为博客的登录域名。

提交到GitHub
进入myblog目录,右键打开Git Bash Here,依次运行:

$ git init
$ git add .
$ git commit -m "init blog"
$ git remote add origin xxxxxxx(拷贝github的地址)xxxxxxx.git
$ git push origin master

完成,访问xxx.github.io.git查看是否成功。

 类似资料: