mirror of https://github.com/peeringdb/peeringdb.git synced 2024-05-11 05:55:09 +00:00

Files

Matt Griswold c21130eed9 Docs 202109 (#1067 )

* module docstrings

* db schema graph

* dev docs first pass

* dev docs pass 2

* add generated notification to top of generated docs files

* linting

* regen docs

Co-authored-by: Stefan Pratter <stefan@20c.com>
Co-authored-by: Sunshine Buchholz <sunshine@20c.com>

2021-10-15 03:25:38 -05:00

1.8 KiB

Raw Blame History

Maintaining Translations

Setup

Clone the translations repository in the location that contains your peeringdb directory.

Clone the django-peeringdb repository in the location that contains your peeringdb directory.

git clone git@github.com:peeringdb/translations
git clone git@github.com:peeringdb/django-peeringdb

Running ls should show something like this:

django-peeringdb
peeringdb
translations

Edit the peeringdb docker compose config to make the translation files and django-peeringdb source available.

cd peeringdb
vim Ctl/dev/docker-compose.sh

Uncomment the mount point for locale under volumes

    volumes:
      ...
      - ../../../translations/locale:/srv/www.peeringdb.com/locale:Z
      - ../../../django-peeringdb/src/django_peeringdb:/srv/www.peeringdb.com/venv/lib/python3.9/site-packages/django_peeringdb:Z

Generate a new locale

Call makemessages and pass the locale to the -l option. In this example we are passing de for German.

Ctl/dev/run.sh /bin/sh
. venv/bin/activate
django-admin makemessages -l de -s --no-wrap -i venv
django-admin makemessages -d djangojs -l de -s --no-wrap -i venv

Updating messages in existing locale

This will add any new messages to all locale files. In other words, if there have been new features added, one wants to call this to make sure the messages exist in gettext so they can be translated.

Ctl/dev/run.sh /bin/sh
. venv/bin/activate
django-admin makemessages -a -s --no-wrap -i venv
django-admin makemessages -d djangojs -a -s --no-wrap -i venv

Compile messages

Once translation files are ready, one needs to compile them so django can use them.

Ctl/dev/run.sh /bin/sh
. venv/bin/activate
django-admin compilemessages -i venv

1.8 KiB Raw Blame History