用 Jekyll 搭建个人博客

使用理由

  1. 使用 Markdown, 专心写博客,无样式排版烦恼
  2. 使用自己喜欢的本地编辑器,本地随时写博客,可以本地预览,方便自己使用
  3. 并使用 Git 管理博客,内容永不丢失
  4. 可以部署在 github 上,不用自己购买管理 VPS,甚至域名也可以不买,对学生来说很适合
  5. 没有第三方博客系统的广告,限制,随心而写

如何搭建

  1. 由于 Jekyll 是用 Ruby 写的,因此首先要搭建 Ruby 执行环境,同时安装 git 版本控制工具
  2. 在 Github 上创建一个仓库,仓库名为 github 账户名.github.com 或者 github 账户名.github.io
  3. 克隆仓库到本地,并初始化仓库。然后发布博客,第一次发布后大约需要 十分钟 就可以通过 yourname.github.com 访问博客了

    git clone https://github.com/yourname/yourname.github.com blog
    cd blog
    touch {README.md,index.html} # 在 README.md 和 index.html 中加入内容
    git add .
    git commit -m “初始化提交”
    git push origin master

  4. 安装 Jekyll 规则搭建个人博客框架,具体参考 Jekyll官方文档

Markdown 语法简记

  • 1--6 级标题 在行首使用 1-6 个 # 号
  • 块引用 在一段的第一行前面加上 > 表示一个区块引用, > 可以嵌套
  • 列表 无序列表 使用 *、 + 或是 - 作为列表标记,有序列表 则使用 数字接着一个英文句点
  • 代码 缩进 4 个空格 表示一个代码块, 使用 反引号(`) 标记一小段行内代码
  • 强调 用一个 或 _ 包围转成 \ 标签,用两个 或 _ 包围转成 \ 标签,
  • 分割线 用三个以上的 *、 -、 _ 来建立一个分隔线,行内不能有其他东西
  • 超链接和图片链接 图片链接和超链接基本相同,图片链接多一个 !。都有两种样式:行内式 和 参考式

    行内式:
        [唐久军的博客](http://tangjiujun.github.io "唐久军的博客")
    
    参考式:
        [唐久军的博客][tangjiujun]
        [tangjiujun]: http://tangjiujun.github.io "唐久军的博客"        # 此行可以放在文章的任意位置
    
  • 反斜杠和自动链接 特殊字符可用 \ 转义; 把 网址 或 电子邮件信箱 用 <> 包起来,会自动链接

  • 表格 不是 Markdown 的标准语法

    |     用户名     |     年龄     |
    | ------------- | ----------- |
    |     唐久军     |     21      |
    |     成婉君     |     21      |
    

emacs 插件

从 github 上找了一个 emacs jekyll 插件,并稍做修改(修改快捷键绑定,取消大小写转换,支持中文)。这里是修改后的插件

  1. 配置插件:

    (setq jekyll-directory “/home/tangjiujun/Dropbox/Yunio/blog/“) # 设置博客根目录
    (require ‘jekyll)
    (jekyll-init-keybindings)

  2. 插件使用:

    C-c j n # 新建草稿
    C-c j p # 发布当前编辑的草稿

    C-c j d # 列出所有的草稿
    C-c j l # 列出所有发布的文章