Generated HTML

Clone an offline copy (HTML, not Markdown) at git@github.com:afnog/afnog.github.io.git.

Presentations

Presentations use a special format to invoke remark
on the Markdown source files:

The Markdown source is called presentation.md (so there can be only one
per directory).

In the same directory is a file called index.md, which tells Jekyll to
use a specific layout (template file) to generate the HTML:
_layouts/presentation.html.

This file is generic and the same for all presentations. It loads the Remark
source code, and then loads the presentation.md file from the same
directory using AJAX. So the URL that you use to load it is very important
in locating the correct presentation.md file.

Generating the HTML

Warning: This command by default will overwrite ../afnog.github.io/sse,
since it assumes that you have both https://github.com/afnog/sse/ and
https://github.com/afnog/afnog.github.io/ checked out side-by-side (for example
in SparkleShare).

If you want it to overwrite a different directory (where it will write the
generated HTML files), you can specify it as a command-line argument to Make:

make DST_DIR=/tmp/site

You will need to install Jekyll to generate the HTML files:

sudo gem install jekyll execjs therubyracer

Then run make to build them once, in the destination directory:

make

Or run make watch to tell Jekyll to stay running, watch for source files
changing, and generate a new HTML file when they do (ideal for modifying
presentations on the fly):

make watch

Publishing the HTML

You can use make sync to run lsyncd (which you must have installed) to
automatically rsync the content to the workshop server, http://www.ws.afnog.org.
You will need to check the SYNC_HOST and SYNC_DIR in the Makefile,
which must point to the destination host and directory which will be overwritten.