aboutsummaryrefslogtreecommitdiff
path: root/doc/developer/localize.rst
diff options
context:
space:
mode:
authorDaniel Schadt <kingdread@gmx.de>2022-12-03 18:56:32 +0100
committerDaniel Schadt <kingdread@gmx.de>2022-12-06 18:39:20 +0100
commitacce7c38d3833b59c4eb2e99dbe7f0393b6a9cbd (patch)
tree2b07366e650feeee94ae77fa1d74ed36bb5a4f7b /doc/developer/localize.rst
parentb9628678de72793e1bf0ad10f8c842c5bcb7dc10 (diff)
downloadfietsboek-acce7c38d3833b59c4eb2e99dbe7f0393b6a9cbd.tar.gz
fietsboek-acce7c38d3833b59c4eb2e99dbe7f0393b6a9cbd.tar.bz2
fietsboek-acce7c38d3833b59c4eb2e99dbe7f0393b6a9cbd.zip
replace Makefile targets with justfile
We might re-introduce Makefiles, but for different purposes (SASS or TypeScript compilation).
Diffstat (limited to 'doc/developer/localize.rst')
-rw-r--r--doc/developer/localize.rst22
1 files changed, 12 insertions, 10 deletions
diff --git a/doc/developer/localize.rst b/doc/developer/localize.rst
index c345c3e..91a51eb 100644
--- a/doc/developer/localize.rst
+++ b/doc/developer/localize.rst
@@ -43,11 +43,11 @@ In order to do so, use the :program:`pybabel` binary:
.venv/bin/pybabel extract -F babel.cfg -o fietsboek/locale/fietslog.pot --input-dirs=fietsboek
-The :file:`Makefile` contains a shortcut for this command:
+The :file:`justfile` (requires just_) contains a shortcut for this command:
.. code:: bash
- make babel-extract
+ just extract-messages
Creating a New Language
-----------------------
@@ -60,12 +60,6 @@ generate the ``.po`` file containing the messages using :program:`pybabel`:
# Replace LOCALE with the locale name, for example "nl" or "fr"
.venv/bin/pybabel init -d fietsboek/locale -l LOCALE -i fietsboek/locale/fietslog.pot
-Again, there is a shortcut in the :file:`Makefile`:
-
-.. code:: bash
-
- make babel-init LOCALE=nl
-
This will create the directory :file:`fietsboek/locale/{language}`.
Finally, you need to copy the non-gettext messages. This is best done by
@@ -76,6 +70,12 @@ copying over the english original texts:
# Replace nl with the locale that you just generated
cp -r fietsboek/locale/en/html fietsboek/locale/nl/
+Again, there is a shortcut in the :file:`justfile` that does both steps:
+
+.. code:: bash
+
+ just init-language nl
+
Updating a Language
-------------------
@@ -94,7 +94,7 @@ Alternatively, you can also use the shortcut again:
.. code:: bash
- make babel-update LOCALE=nl
+ just update-language nl
Translating
-----------
@@ -125,10 +125,12 @@ Or using the shortcut:
.. code:: bash
- make babel-compile LOCALE=nl
+ just compile-language nl
Further Reading
---------------
* The Pyramid documentation: `Internationalization and Localization
<https://docs.pylonsproject.org/projects/pyramid/en/latest/narr/i18n.html>`__
+
+.. _just: https://github.com/casey/just