Minimalistic Jekyll theme using mini.css.


Minimalistic Jekyll theme using mini.css.

jekyll-mini is focused on

  1. efficiently presenting large blocks of text; and
  2. affording the separation of content from metadata.

See for an example website.


  • Separate Markdown files from YAML metadata -- Markdown files may be symlinks to a dependent submodule.

  • Automatic titles from Markdown H1 headings.

  • File-specific assets -- files may be placed in a directory alongside the post to preserve any relative links used in the Markdown file.

  • Automatic relative URL conversion in RSS feeds --

    ![Some Image](assets/foo.jpg)
    [some reference](#anchor)

    will be converted into

    <img src="" />
    <a href="">some reference</a>

    in the RSS feed.


git clone [email protected]:downflux/blog.git
git submodule update --init --recursive

# Update all submodules
git submodule update --remote --recursive


# Add submodule
git submodule add -b ${BRANCH} ${REPO} third_party/${LOCAL_DIR_PATH}

# Remove submodule
# See
git submodule deinit ${MODULE}
git rm ${MODULE}

Local Build

Sometimes we should install the environment locally to help debug development.


# Copy files instead of symlinks when JEKYLL_ENV == production.
JEKYLL_ENV=production; bundle exec jekyll clean && bundle exec jekyll serve