This repository hosts the code for the Nairobi GNU/Linux Users Group website. We wanted a fun, nerdy and democratic way to give our community an online presence, so here we are.

The website is powered by Pelican — a static site generator written in Python — and uses a theme called Alchemy.

The easiest way to do this is in a Python virtual environment. We recommend using pyenv with pyenv-virtualenv to set one up. Luckily, pyenv has an automatic installer, pyenv-installer.

Once you have pyenv installed, create a virtual environment to hold Pelican and its dependencies:

$ pyenv virtualenv nairobilug
$ pyenv activate nairobilug

This creates a virtual environment and then activates it.

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

$ git clone --recurse-submodules [email protected]:nairobilug/nairobilug.or.ke.git

Use pip to install the list of dependencies (including Pelican) into your virtual environment:

$ pip install -r requirements.txt

Now that the dependencies exists, we can build:

$ make html

This takes the markdown files from the content/ directory and generates static HTML pages inside the output/ directory. That's it. No MySQL, no PHP, etc...

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

$ make serve

And you should see the website if you visit http://localhost:8000.

If you're interested in writing an article for the website, you need to:

• Fork the nairobilug/nairobilug.or.ke repository
• Write an article using markdown in the content directory
• Push the changes to a topic branch, like why-i-love-linux, on your fork of the repository
• Make a pull request against the master branch

Happy blogging!

If you're having trouble with your setup, you can get help by creating an issue.