Since I learn best from examples I’ve referencing the existing plancat.el package. The following retrieves my current .plan from the site and puts the contents into a new buffer to edit. Next is to figure out how to take the contents of that buffer and send back to plan.cat.

(defun my/plan.cat ()
  "Retrieve and edit my current plan at plan.cat."
  (interactive)
  (let* ((host "plan.cat")
      (entry (car (auth-source-search :host host)))
      (user (plist-get entry :user))
      (url (format "https://%s/~%s" host user))
      (buf (get-buffer-create host))
      (cur
       (with-current-buffer (url-retrieve-synchronously url)
           (buffer-substring-no-properties (point-min) (point-max)))))

  (with-current-buffer buf
    (erase-buffer)
    (insert
     (replace-regexp-in-string
      (rx bos (+? anything) "\n\n")
      ""
      cur))
    (goto-char (point-min))
    (text-mode))

  (switch-to-buffer-other-window buf)))

Initial Post….

Jekyll requires blog post files to be named according to the following format:

YEAR-MONTH-DAY-title.MARKUP

Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.