I finally updated the blog theme! I moved from "minima" to minimal-mistakes. The new theme has pagination and search built-in!

Why change?

I am using Jekyll for my site but don't understand it very well. I like that it generates a static site and that I don't need to know much about how that happens! :-)

Probably the fanciest thing I've done, basically copying from others, is on the wiki index page: 

<ul>
{% assign sorted_pages = site.pages | sort: 'title' %}
{% for site_page in sorted_pages %}
  {% if site_page.layout == 'wiki' and site_page.name != 'index.html' %}
  <li><a href="{{ site_page.url }}">{{ site_page.title }}</a></li>
  {% endif %}
{% endfor %}
</ul>

(This lists all the wiki pages in alphabetical order by title.)

With the minima theme, I had started to investigate pagination but needed to figure it out myself.

Additionally, I installed minima many years ago and figured I'd need to upgrade the whole stack, including Jekyll. It seemed like a good time to try a new theme that might have more "batteries included."

Workflow

My workflow continues to be:

  1. Write a post in org-mode
  2. Compile the post into HTML via org-mode exporting. The destination directory is Jekyll
  3. Run jekyll to build the HTML for the site
  4. rsync that site to my hosting provider

This workflow works pretty OK, except that relative linking between pages is a bit weird. (Ideally links would be org-mode links that get converted appropriately into jekyll relative links.)

Structure

The structure is:

  • jb.com folder
    • .git: version control for site
    • _site: target HTML site
    • jekyll: Jekyll version of site
    • org: org-mode version of site (the directory where I add content)
    • Makefile

The Makefile has: 

site:
	JEKYLL_ENV=production cd jekyll && bundle exec jekyll build -d ../_site

clean:
	find org/wiki -name '*.html' -exec rm "{}" \;

upload: site
	rsync -avz --delete _site/ FIXME/

Updated: