1.4 KB

Personal-site README

To get a pretty version of this document, run

$ markdown README > README.html


See LICENSE file.


See AUTHORS file.


  • python
  • python-virtualenv

Python dependencies

More detail in requirements.txt and requirements_prod.txt; it is best to use virtualenv and pip to handle these. But if you insist on (Arch GNU/Linux) packages, you will probably want the following:

  • django
  • python-markdown
  • python-memcached

Testing Installation

  1. Clone personal-site

    git clone
  2. Run virtualenv.

    cd personal-site && virtualenv ./venv/
  3. Activate the virtualenv.

    source ./venv/bin/activate
  4. Install dependencies through pip.

    pip install -r requirements.txt
  5. Copy to and modify. Make sure to uncomment the appropriate database section (either sqlite or PostgreSQL).

    cp -v personalsite/ personalsite/
  6. Check syntax.

    python check --deploy
  7. Migrate changes.

    python migrate
  8. Create superUSER

    python createsuperuser
  9. Use the following commands to start a service instance

    python runserver

Production Installation

The file helps the deployment in production