BlackArchweb README

This is a fork of archweb

git://code.toofishes.net/dan/archweb.git

To get a pretty version of this document, run

$ markdown README > README.html

License

See LICENSE file.

Authors

See AUTHORS file.

Dependencies

• python2
• python2-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 (BlackArch) packages, you will probably want the following:

• django
• python2-psycopg2
• python2-markdown
• python2-south
• python2-memcached

Testing Installation

1. Run virtualenv2.

    $ cd /path/to/blackarchlinuxweb && virtualenv2 ./env/
   

2. Activate the virtualenv.

    $ source ./env/bin/activate
   

3. Install dependencies through pip.

    (blackarchlinuxweb-env) $ pip install -r requirements.txt
   

4. Copy local_settings.py.example to local_settings.py and modify. Make sure to uncomment the appropriate database section (either sqlite or PostgreSQL).

5. Sync the database to create it.

    (blackarchlinuxweb-env) $ ./manage.py syncdb
   

6. Migrate changes.

    (blackarchlinuxweb-env) $ ./manage.py migrate
   

7. Load the fixtures to prepopulate some data. If you don't want some of the provided data, adjust the file glob accordingly.

    (blackarchlinuxweb-env) $ ./manage.py loaddata */fixtures/*.json
   

8. Use the following commands to start a service instance

    (blackarchlinuxweb-env) $ ./manage.py runserver
   

9. To optionally populate the database with real data:

    (blackarchlinuxweb-env) $ wget ftp://ftp.archlinux.org/core/os/i686/core.db.tar.gz
    (blackarchlinuxweb-env) $ ./manage.py reporead i686 core.db.tar.gz
    (blackarchlinuxweb-env) $ ./manage.py syncisos
   

Alter architecture and repo to get x86_64 and packages from other repos if needed.

Production Installation

Ask someone who knows, or you are going to be in trouble.

vim: set syntax=markdown et: