/pythonkc.github.io-nikola

pythonkc.github.io using Nikola static site generator

Primary LanguagePython

pythonkc.github.io-nikola

This is an attempt to generate pythonkc.github.io using Nikola.

How to use

  • Clone this repository to your local computer.
  • Create a virtual environment. I recommend using Python 3.6.x, as that is the version I used.
  • Activate the virtual environment and install the requirements: pip install -r requirements.txt
  • Run nikola build to generate the site.
  • Run nikola server --browser to open locally generated site in your default browser.

Why?

After working with Julie Stark, we discovered Pelican on Microsoft Windows was problematic at best. Reading the Nikola documentation suggested it has better support for Microsoft Windows. We'll see.

Caveat Emptor!

Currently, this site generates using the default Nikola theme, which is built upon Mako templates. The only customization I've done is to make posts and pages written in Markdown (named *.markdown) be detected and processed by Nikola. For some reason, pages (as opposed to posts) do not appear on the generated site. I'm absolutely certain this is completely my fault and a closer reading of the documentation will illuminate the error of my ways.