README.md

NBLUG.org

This is the nblug.org web site.
It's static HTML, built from Markdown files in the content/ directory using Pelican.

Getting Started

To make it easy to reproduce the site exactly, we install pinned versions of all of the tools used to build it in a Python "virtual environment".
Bootstrap requires this tool in the host system.
On a Debian-like system:

sudo apt-get install python-virtualenv

(On Debian Jessie the package has been renamed to virtualenv.)

Next create and initialize the virtualenv:

make init

Building the Site

You can build and view the site locally with these commands:

make devserver
make regenerate

This will launch a web server in the background and monitor the Pelican site contents and configuration, automatically rebuilding when changes occur.
You can view this local site at http://localhost:8000/.
When you're done you can stop it with make stopserver.

When you're ready to publish to the real site, run these commands:

make publish
make rsync_upload

For the second command to work you will need shell access to enigma.wiredgoats.com (and your username must be set in ~/.ssh/config if it differs from your local username).

Don't forget to commit your changes to the git repo!

Adding Events

TL;DR run ./add-talk.py.

All of the events are stored as text Markdown files incontent/news/.
These files start with a metadata header in which we place some NBLUG-specific data about the speaker time of the presentation.
A blank line follows this header, then the talk description in Markdown format (which may include embedded HTML if necessary).
For example, content/news/2016-11-20-strfry.md: