Nov 19, 2014 Tags: Sphinx, Ablog, Howto

Basic Installation of Sphinx and Ablog

With Sphinx and Ablog you can generate static files for your weblog from reStructuredText. This post explains the basics of the installation.


The following steps should work independently of what system you have. On Linux it may be necessary to prepend “sudo”.

  1. Go to the commandline an verify that you have Python available:

    $ python --version
    Python 2.7.7

    You should see a 2.7 or 2.6 version or maybe a 3.x. All of those are fine.

  2. If Python is missing, see and install it! That should be very easy and should not harm your system at all.

  3. Verify that the Python packet manager “pip” is available:

    $ pip --help
      pip <command> [options]
  4. If “pip” is missing, install it. See for this. You are advised to get pip which means that you securely download the file

    Run that file with Python:

    $ python
  5. Play with “pip”:

    $ pip --help
    $ pip list
    $ pip show sphinx
    $ pip search sphinx
    $ pip show ablog
    $ pip search ablog

    Further you can uninstall or update packages with “pip”:

    $ pip uninstall <package-name>
    $ pip update <package-name>
  6. Install Sphinx:

    $ pip install -U sphinx

    See for what you get. To launch a new Sphinx documentation project go to a new, empty folder and run sphinx-quickstart.

  7. Install Ablog:

    $ pip install -U alabaster # I'm not sure this necessary
    $ pip install -U werkzeug  # I'm not sure this necessary
    $ pip install -U ablog

    See for what you get.

  8. To start a blog:

    Download the /docs folder from as a complete blog example. See for what you get! Run “make” or “make.bat” to generate output in _build/html.

  9. Start “_build/html/index.html” in your browser to see your blog.


Previous topic

Using Rsync

Next topic

Extend an Extbase Domain Model "On the Fly"




Recent Posts

This Page