summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README81
1 files changed, 59 insertions, 22 deletions
diff --git a/README b/README
index ec0829e..fd493b6 100644
--- a/README
+++ b/README
@@ -1,35 +1,72 @@
+# Archweb README
+
+To get a pretty version of this document, run
+
+ $ markdown README > README.html
+
# License
- See LICENSE file.
+
+See LICENSE file.
# Authors
- See AUTHORS file.
+
+See AUTHORS file.
# Dependencies
- - python
- - mysql-python or python-pysqlite
- - Django >= 1.2.X
-# Installation
-For a simple testing installation:
+- python
+- python-virtualenv
+
+# Python dependencies
+
+More detail in `requirements.txt` and `requirements_prod.txt`; it is best to
+use virtualenv to handle these. But if you insist on (Arch Linux) packages, you
+will probably want the following:
+
+- mysql-python or python-pysqlite
+- django
+- python-markdown
+- python-south
+- python-memcached
+
+# Testing Installation
+
+1. Run `virtualenv`.
+
+ $ cd /path/to/archweb && virtualenv ../archweb
- 1. Install dependencies.
- $ pacman -S django python-pysqlite sqlite3
-
- 2. Copy local_settings.py.example to local_settings.py and modify.
- Make sure to uncomment the appropriate db section (either sqlite or mysql).
+2. Install dependencies through `pip`.
- 3. Sync the database to create it.
- $ python manage.py syncdb
+ $ pip -r requirements.txt
- 4. Load the fixtures to prepopulate some data.
- $ python manage.py loaddata arches.json repos.json
+3. Copy `local_settings.py.example` to `local_settings.py` and modify.
+ Make sure to uncomment the appropriate db section (either sqlite or mysql).
+
+4. Sync the database to create it.
+
+ $ python manage.py syncdb
+
+5. Migrate changes.
+
+ $ python manage.py migrate
+
+6. Load the fixtures to prepopulate some data.
+
+ $ python manage.py loaddata main/fixtures/arches.json main/fixtures/repos.json
- 5. Use the following commands to start a service instance
- $ python manage.py runserver
+7. Use the following commands to start a service instance
+
+ $ python manage.py runserver
+
+8. To optionally populate the database with real data:
+
+ $ wget ftp://ftp.archlinux.org/core/os/i686/core.db.tar.gz
+ $ ./manage.py reporead i686 core.db.tar.gz
+
+Alter architecture and repo to get x86\_64 and packages from other repos if needed.
- 6. To optionally populate the database with real data:
- $ wget ftp://ftp.archlinux.org/core/os/i686/core.db.tar.gz
- $ ./manage.py reporead i686 core.db.tar.gz
+# Production Installation
- (alter architecture and repo to get x86_64 and extra packages if needed)
+Ask someone who knows, or you are going to be in trouble.
+vim: set syntax=markdown et: