Skip to content

window-maker/window-maker.github.io

Repository files navigation

Window Maker webpage source

This is a web page source files. All of the files should be proper markdown files accepted by Jekyll static site generator.

Build/serve

In order to build the site, you'll need Jekyll framework installed and jekyll-rst plugin. Easiest way to achieve it, is to install it from system repositories.

If your distribution doesn't contain it (even in external ones, like PPA for Ubuntu, AUR for Arch or some portage overlay from Gentoo), that it might be installed locally using Bundler.

Manual installation would be as follows:

$ git clone --recurse-submodules https://github.com/window-maker/window-maker.github.io
$ cd window-maker.github.io
$ bundler install
$ # install docutils and pygments from your distribution repository, or use
$ # following command to install them from PyPI for the current user:
$ pip install docutils pygments

To build and serve webpage in development mode, you just issue the following command:

$ bundler exec jekyll serve

Consult jekyll-rst plugin documentation for requirements. Other options for installing dependencies are also possible - they might be installed from distribution repositories.

Last line will initialize gemfile, add jekyll to it, and then perform jekyll serve which underneath will build the site and than run simple http server on http://localhost:4000 in development mode. More about jekyll you can find on it's page