Mac下搭建github+jekyll写作环境

    xiaoxiao2026-04-05  9

    之前有在公共博客或是专业的技术博客上写写文章、笔记。后来由于从事安全相关行业,转而把一些工作中的总结、笔记记录在了OneNote上,纯离线不对外开放。但这种转换导致文章产出率很低,常常半年写不了一篇文章。为了能够督促自己将技术或是生活点滴记录下来,寻找一种使用Markdown语法,干净整洁的写作环境:github+jekyll,这正是我想要的。

    升级Command Line Tools

    由于刚升级了"优圣美地",需要安装一下Command Line Tools,安装jekyll需要。

    $ xcode-select --install

    更新RubyGems到最新版本

    安装jekyll需要RubyGems。https://rubygems.org/pages/download

    $ gem update --system # may need to be administrator or root $ gem install rubygems-update # again, might need to be admin/root $ update_rubygems # ... here too

    安装jekyll

    jekyll是纯静态blog,无需数据库支持,将markdown转为页面。 $ gem install jekyll # may need to be administrator or root

    Clone jekyll-bootstrap

    这是一个快捷搭建jekyll+github pages的工具。 $ git clone https://github.com/plusjade/jekyll-bootstrap.git $ cd jekyll-bootstrap $ jekyll serve

    在Github上创建帐号,并创建一个USERNAME.github.io的仓库,这个就是你的个人主页的空间了。 然后将jekyll-bootstrap的目录结构导入到此仓库,jekyll的环境准备就绪。

    替换jquery链接

    由于默认theme里jquery使用了googleapis的连接,导致访问会很慢或挂掉,所以这里替换为本地的jquery。

    下载一个jquery压缩版放入/assets/javascript/jquery-1.11.1.min.js 然后将_includes/themes/bootstrap-3/default.html中的

    https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js

    替换为:

    /assets/javascript/jquery-1.11.1.min.js

    中文支持

    将jekyll默认的markdown解析引擎maruku 更换为RDiscount

    sudo gem install rdiscount

    然后在_config.yml中highlighter: pygments之后加一行markdown: rdiscount,这样再次生成网站的时候就使用RDiscount来解析md文件了。

    个性化域名

    USERNAME.github.io文件夹下新建一个CNAME文件,里面的内容就是你的域名,比如USERNAME.me

    然后按照GitHub所说将你的域名指向204.232.175.78这个ip(最新地址:192.30.252.153、192.30.252.154),这样当再次访问你的域名的时候,就会指向GitHub Pages了(可能DNS更新会需要一段时间)。

    安装&更换theme

    安装一个jekyll模板,然后使用它来变更blog界面。

    rake theme:install git="https://github.com/jekyllbootstrap/theme-the-program.git" rake theme:switch name="the-program"

    调整首页

    页面可以适当做一些调整,比如菜单名称等等。

    开始写作...

    rake post title="Hello World"

    使用jekyll命令行创建文章,然后去_post目录下用markdown编辑器或vim编辑文章。

    最新回复(0)