tripu / devoinc.github.io

Devo engineering blog

How to customize the template

This blog is configured to use the minimal-mistakes template, which is quite customizable.

To know more about the customizations that can be done, go to:

• General instructions.
• Override the theme defaults. Default templates have already been copied on this repository at /includes.
• Play with SASS. This repository already includes a copy of assets/css/main.scss that can be modified.

How to build the static site

bundle exec jekyll build

The resulting static site will be under docs/.

How to run locally

Using Docker

docker run -it --rm --volume="$PWD:/srv/jekyll" --env JEKYLL_ENV=development -p 4000:4000 jekyll/jekyll:3.8 jekyll serve

Without Docker

These two steps only the first time:

1. Follow the instructions listed here. (To install it on Mac, follow this instructions.)
2. On this folder, run bundle add webrick. In fact this is only needed if using Ruby 3, but shouldn't hurt in other cases.

Run jekyll serve (or perhaps bundle exec jekyll serve).

After a while, the console will said something like:

Server address: http://0.0.0.0:4000/   
Server running... press ctrl-c to stop.

Open the local version

Then you can open your browser and navigate to localhost:4000 to open your local version of the blog.