bornhack-website/README.md

56 lines
1.1 KiB
Markdown
Raw Normal View History

2015-10-03 01:07:05 +00:00
# Bornhack
Django project to power Bornhack. Features include news, villages, webshop, and more.
2015-10-03 01:07:05 +00:00
## Quickstart
### Virtualenv
Create a Python 2.7 virtual environment and activate it:
2017-01-20 16:47:10 +00:00
```
$ virtualenv venv
$ source venv/bin/activate
```
2016-07-03 12:27:31 +00:00
### System libraries
Install system dependencies (method depends on OS):
2017-01-28 16:06:46 +00:00
- postgresql headers (for psycopg2):
- Debian: libpq-dev
2017-01-20 16:47:10 +00:00
- FreeBSD: ?
- libjpeg (for pdf generation)
2017-01-20 16:47:10 +00:00
- Debian: libjpeg-dev
- FreeBSD: ?
2016-07-03 12:27:31 +00:00
### Python packages
2017-01-20 16:47:10 +00:00
Install pip packages:
```
(venv) $ pip install -r requirements.txt
```
2016-07-03 12:27:31 +00:00
### Configuration file
2017-01-20 16:47:10 +00:00
Copy environment file template and change settings as needed:
```
2016-07-03 12:27:31 +00:00
(venv) $ cp bornhack/settings/env.dist bornhack/settings/.env
2017-01-20 16:47:10 +00:00
```
2016-07-03 12:27:31 +00:00
### Database
Is this a new installation? Initialize the database:
2017-01-20 16:47:10 +00:00
```
(venv) $ ./manage.py migrate
```
Is this for local development? Bootstrap the database with dummy data and users:
```
(venv) $ ./manage.py bootstrap-devsite
```
### Done
Is this for local development? Start the Django devserver:
2017-01-20 16:47:10 +00:00
```
(venv) $ ./manage.py runserver
```
Otherwise start uwsgi or similar to serve the application.
2017-01-20 16:47:10 +00:00
Enjoy!