django-musician/README.md

1.8 KiB

django musician

Python code is written following PEP 8 sytle guide and it is based on Django framework.

Quickstart development

Start development environment based on docker compose by running:

docker-compose up

How do I get set up?

  1. Install Python and its packet manager (pip)
# on a Debian based environment:
apt=(
    git
    python3-pip
    python3-setuptools
)
sudo apt-get install --no-install-recommends -y ${apt[@]}

  1. Install virtualenv (isolate app python related requirements)
sudo pip3 install virtualenv
  1. Clone this repository
git clone https://github.pangea.org/slamora/django-musician.git
  1. Prepare env and install requirements
cd django-musician
virtualenv env
source env/bin/activate
pip3 install -r requirements.txt
  1. Start django devel server (check everything is ok)
python manage.py migrate
python manage.py runserver
  1. Open http://127.0.0.1:8000/ in your browser.

  2. If everything works, follow Django deployment instructions.

How to generate/update translations

  1. Go to musician folder and run:
cd django-musician/musician
../manage.py makemessages
processing locale ca
processing locale es
  1. Edit generated .po files and save it when you have finished.
musician/locale/ca/LC_MESSAGES/django.po  # catalan
musician/locale/es/LC_MESSAGES/django.po  # spanish
  1. To able to use a .po file in an application, it needs to be compiled to the binary .mo file format.
../manage.py compilemessages

More detailed instrucions on Django Translation docs