Install jekyll

  1. apt install ruby ruby-dev
  2. gem install jekyll bundler

Create site

  1. mkdir mysite
  2. jekyll new --skip-bundle .
  3. edit Gemfile, comment out gem "jekyll", uncomment gem "github-pages"

Configure site

_config.yml

defaults:
  - scope:
      path: "" # an empty string here means all files in the project
      type: "posts" # previously `post` in Jekyll 2.2.
    values:
      layout: "post" # use `post` layout for all posts
      comments: true # show disqus comment for all posts
disqus:
  shortname: xxxx # where is it used: minima-theme post template
url: "https://xxx" # disqus `this.page.url` prefix

Update dependency

  1. rm Gemfile.lock
  2. bundle update

Run locally

bundle exec jekyll serve -P 8080

Create post

  1. cd _post
  2. emacs `date -I`-post-name.md

  3. M-x auto-insert

    where front matter template is defined as:

    (define-auto-insert (rx (seq (= 4 digit) ?- (= 2 digit) ?- (= 2 digit) (one-or-more any) ".md"))
  (lambda ()
    (insert "---\ntitle: ")
    (insert (substring (file-name-base (buffer-name)) 11))
    (insert "\ndate: ")
    (insert (format-time-string "%Y-%m-%d %H:%M:%S %z\n---"))))

Reference