Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Build Status Docker Build Status

Please log any issues.

Contributing new content and updates

  • Fork the code to your own git repository.
  • Make your changes in /content/pages or directly in GitHub.
  • When you are happy with your updates, submit a pull request describing the changes.
  • IMPORTANT :- Before sending a Pull Request make sure that your forked repo is in sync with the base repo.
  • The updates will be reviewed and merged in.

Communication forum

Please use for discussions about the site, content, generation etc.

Site generation

Software Requirements

  • Pelican 3.3
  • ghp-import
  • Markdown 2.3.1

Gentle introduction to Pelican

Pelican's QUICKSTART page is a good place to learn about the basics of Pelican (installation, project skeleton, development cycle, etc.).

Installation instructions

Two types of installations are documented: a regular one, and one that creates a virtual environment via Vagrant.

Regular installation

To run a development server on your local computer, follow these basic steps:

git clone ssh://
# install Pelican and dependencies

Running the server in development mode:

make serve

If you want the server to autoreload whenever a file change, you can instead do:

make devserver

View at http://localhost:8000

Docker-based installation

The Makefile will build the website completely by running make -f MakefileDocker. It'll do the following:

  • Create a build Docker image (make builder) which is a development environment with a complete set of dependencies ready.

  • Run this docker image on the directory locally. This directory is presumed to contain a checked out repository for the website. (make site)

  • From the newly created static files in deploy/output, it will then create a minimalist docker image to actually serve the website. (make deployer)

For development convenience, you can run the website on port 8080 by make -f MakefileDocker serve

Vagrant-based installation

For your convenience, this repository ships with a basic Vagrantfile, which allows you to create virtual machine with all the dependencies required for local development.

Assuming your computer has Vagrant installed, the following will get you a running server:

git clone ssh://
vagrant up
vagrant ssh
cd /vagrant/
make devserver

Now, the wesite should be available at http://localhost:8000


  Makefile (development configuration) (production configuration)
    <generated files - published to gh-pages branch>
      <website page files>
    <website theme>

Site generation

To just generate a new version (without starting up a local webserver) just do:

make html

Theme development

You can modify the theme (layout and styling) in the directory.

Make changes to Sass files, not compiled CSS.

npm i then run grunt to compile Sass.

You can’t perform that action at this time.