~ubuntu-za/+junk/ubuntuza-site

Getting Started

===============

 

The Ubuntu-ZA site is a static HTML site generated by the `Nikola <http://getnikola.com/>`_ site generator. Nikola is

written in Python and is in the Ubuntu repository.

 

 

Installing Nikola (Ubuntu 14.10 and higher)

-------------------------------------------

The minimum version of Nikola required is 7.0. If you're running Ubuntu 14.10 Utopic Unicorn, you'll have 7.0.1 in the

repositories and you can just install it using apt-get::

 

    $ sudo apt-get install nikola

 

 

Installing Nikola (Ubuntu 14.04 and lower)

-------------------------------------------

If you're on an earlier version of Ubuntu, you'll need to install the latest version of Nikola. The best way to do this

is to create a virtual environment and install it in there.

 

First, install ``python-virtualenv`` and a number of other packages you will need::

 

    $ sudo apt-get install python-virtualenv python-dev libxml2-dev libxslt1-dev zlib1g-dev

 

Then you need to create a virtual environment. Navigate to a root folder for your virtual environment, and then create

your virtual environment::

 

    $ cd ~/Projects

    $ virtualenv --system-site-packages venv

 

Once that is done, you need to install Nikola itself::

 

    $ ./venv/bin/pip install --upgrade nikola

 

You may want to create a symlink for ease-of-use::

 

    $ ln -s /path/to/venv/bin/nikola /path/to/ubuntuza-site/nikola

 

 

Building the Site

-----------------

Once you have Nikola installed, you probably want to see the site. First we need to build it::

 

    $ nikola build

 

If you've created the symlink, you'll want to use it like this::

 

    $ ./nikola build

 

 

Running the Site

----------------

To preview the site, it's as easy as running a local web server::

 

    $ nikola serve