使用 Emacs org-modeJekyll 编写并搭建个人博客.

参考:

总体思路是:

  • org-mode 负责导出内容为网页的 body 部分;
  • Jekyll 负责网页的样式, 及最终的 host;

org 编写

Using org to Blog with Jekyll 中, 部分内容由于 Emacs 版本更新而过时了.

  • Front Matter

    原文中使用 #+BEGIN_HTML #+END_HTML 导出, 该方式在当前 org 版本(9.3.2)下不是 literally, 需改用 #+BEGIN_EXPORT html #+END_EXPORT:

    #+BEGIN_EXPORT html
    ---
    layout: default
    title:
    ---
    #+END_EXPORT
    

目录结构

site.org/
`-- org/
|   `-- posts/
|   |   `-- 2020-02-07-using-org-to-blog-with-jekyll.org
|   `-- about.org
|   `-- index.org
|
`-- jekyll/
    `-- _includes/
    `-- _layouts/
    `-- _posts/
    `-- _config.yml

测试

  • 安装 Jekyll 及 bundler
    • 配置 gem 环境变量
      echo 'gem: --user-install --bindir ~/your/local/bin/path' >> ~/.gemrc
      

      执行 gem environment 检查环境变量, 确认是否生效.

    • 安装 Jekyll 及 bundler
      gem install jekyll bundler
      
    • 配置 bundler
      bundle config set --global bin  ~/your/local/bin/path
      bundle config set --global path ~/.gem/ruby
      

      执行 bundle env 检查环境变量, 确认是否生效.

  • 配置并 host 本项目
    cd ~/your/local/repo/path
    make
    cd jekyll && bundle exec jekyll serve
    

    打开浏览器, 访问 http://localhost:4000 进行检查.

    : 更新 org 下内容后需要重新执行 make.