pelican-alchemy

pelican-alchemy demo website!

Fork / Clone the repo

If you haven't already, clone this repo (or your version of it), and:

$ git submodule init
$ git submodule update

Makefile provides a recipe to do the exact same thing: make submodule

Generate the website

All dependencies are intalled automatically when you invoke Pelican via Makefile recipes. New virtual environment is automatically created in .venv directory.

To build demo pages execute:

$ make html

This takes the Markdown files from the content/ directory and generates static HTML pages inside the output/ directory.

Preview the website

You can serve the generated site so it can be previewed in your browser:

$ make serve

Publish updated demo to GitHub pages

The process is completely automated via Makefile recipe:

$ make github

Required tools will be installed into .venv if missing.