The following guide outlines how to setup your development environment to work with this project.
The following should work for Ubuntu, Xubuntu, or any other Debian-based Linux.
Depending on your storage engine you may need to install additional packages to your operating system. For example, you may need to install libmysqlclient to use the MySQL storage engine.
Django has documentation for database configuration available here:
Install pip
sudo apt-get install python3-pipInstall virtualenv
sudo pip3 install virtualenvOpen the directory
cd bag-of-holdingCreate your virtual environment
virtualenv envYou can name your environment whatever you wish, just remember to use your new name in future commands instead of 'env'. Be sure not to commit it to the repository by adding it to the .gitignore file. 'env' is already being ignored.
Activate the virtual environment
source ./env/bin/activateYou should see (env) $ at your prompt, letting you know that you're running under the 'env' virtualenv install. To stop using the virtual environment at any time, just type:
deactivateInstall project requirements
pip install -r requirements.txtCreate and update migrations
python manage.py makemigrationsMigrate the database to latest data model
python manage.py migrateLoad some sample data
python manage.py loaddata sample_data.jsonCreate a super user account
python manage.py createsuperuserRun the development server
python manage.py runserverConfigure your language in settings file. The base directory to translations files is project/locale.
Generate a new translation file
django-admin.py makemessages -l <YOUR_LANGUAGE>After the file has been generated, edit the po file at project/locale/<YOUR_LANGUAGE>/LC_MESSAGES/django.po and translate all messages to your language if it still doesn't exist.
Tells django to compile the translated files
django-admin.py compilemessages