Pelican

Pelican is a static site generator, meaning that it takes content (in the form of reStuctredText or Markdown usually) and templates (Python based Jinja2 usually) and combines them to produce static HTML and CSS.

While there are many tutorials that explain how to install and configure Pelican, this page is mainly to serve as a reminder for me on how add content.

  1. Add content to content folder. The subfolder determines the category with pages being a special category for more permanent, non-blog type content.
  2. In main folder, type source bin/activate
  3. Type pelican
  4. cd output; python -m pelican.server
  5. Browse to localhost:8000 to preview changes
  6. In main folder, ghp-import output
  7. git push git@github.com:sheridp/sheridp.github.io.git gh-pages:master
  8. Verify changes at sheridp.github.io