refactor: prefix locales dir with underscoren-peugnet-move-locales

to separate it more clearly from the content of the docs

7 files changed, 42 insertions, 38 deletions

diff --git a/Makefile b/Makefile
index fd942d5..98ecfc7 100644
--- a/Makefile
+++ b/Makefile
@@ -3,7 +3,8 @@
 # You can set these variables from the command line.
 
 LOCALES         := en
-LOCALEFILES     := $(LOCALES:%=locales/%/LC_MESSAGES/package.po) $(LOCALES:%=locales/%/LC_MESSAGES/sphinx.po)
+LOCALEDIR       := _locales
+LOCALEFILES     := $(LOCALES:%=$(LOCALEDIR)/%/LC_MESSAGES/package.po) $(LOCALES:%=$(LOCALEDIR)/%/LC_MESSAGES/sphinx.po)
 
 export AUTHORS      := $(shell awk '{printf t $$0; t=", "}' AUTHORS)
 export PACKAGE      := CLUB1
@@ -42,11 +43,11 @@ update-po: $(LOCALEFILES);
 	msgfmt -o $@ $<
 
 .SECONDEXPANSION:
-$(LOCALEFILES): locales/%.po: locales/$$(*F).pot
+$(LOCALEFILES): $(LOCALEDIR)/%.po: $(LOCALEDIR)/$$(*F).pot
 	msgmerge -q --previous --update $@ $< --backup=none -w 79
 	@touch $@
 
-locales/package.pot locales/sphinx.pot: locales/%.pot: $(BUILDDIR)/gettext/%.pot
+$(LOCALEDIR)/package.pot $(LOCALEDIR)/sphinx.pot: $(LOCALEDIR)/%.pot: $(BUILDDIR)/gettext/%.pot
 	xgettext $< -o $@ -w 79 \
 	--copyright-holder='$(AUTHORS)' --package-name='$(PACKAGE)' \
 	--package-version='$(VERSION)' --msgid-bugs-address='$(EMAIL)'
@@ -74,7 +75,7 @@ html: $(LANGUAGES:%=html/%) $(BUILDDIR)/html/index.html
 
 # Localized Sphinx builders
 .SECONDEXPANSION:
-$(SPHINXLBUILDERS): $$(if $$(filter fr,$$(@F)),,locales/$$(@F)/LC_MESSAGES/package.mo locales/$$(@F)/LC_MESSAGES/sphinx.mo)
+$(SPHINXLBUILDERS): $$(if $$(filter fr,$$(@F)),,$(LOCALEDIR)/$$(@F)/LC_MESSAGES/package.mo $(LOCALEDIR)/$$(@F)/LC_MESSAGES/sphinx.mo)
 	LOCALE=$(@F) $(SPHINXBUILD) -b $(@D) -d $(BUILDDIR)/doctrees/$(@F) $(SOURCEDIR) $(BUILDDIR)/$(@D)/$(@F) $(SPHINXOPTS) $O
 
 # Other Sphinx commands for autocompletion
@@ -82,7 +83,7 @@ $(SPHINXCMDS):
 	$(SPHINXBUILD) -M $@ $(SOURCEDIR) $(BUILDDIR) $(SPHINXOPTS) $O
 
 clean:
-	rm -f locales/*/LC_MESSAGES/*.mo
+	rm -f $(LOCALEDIR)/*/LC_MESSAGES/*.mo
 	rm -rf $(BUILDDIR)/*
 
 .PHONY: .FORCE
diff --git a/README.md b/README.md
index 3f5523c..a992883 100644
--- a/README.md
+++ b/README.md
@@ -29,25 +29,25 @@ de la documentation de CLUB1.
 
     ./
     ├── _build/
-    ├── _static/
-    ├── _templates/
-    ├── locales/
+    ├── _locales/
     │   ├── en/
     │   │   └── LC_MESSAGES/
     │   │       └── package.po
     │   └── package.pot
+    ├── _static/
+    ├── _templates/
     ├── ***/
     │   └── ***.md
     ├── AUTHORS
     └── index.md
 
 - `_build/` : dossier contenant l'ensemble des fichiers générés par Sphinx.
-- `_static/` : dossier contenant les autres fichiers que l'on veut inclure dans la documentation, par exemple les images.
-- `_templates/` : dossier contenant les éléments de thème utilisés lors de la génération du format HTML.
-- `locales/` : dossier contenant les fichiers de traductions.
+- `_locales/` : dossier contenant les fichiers de traductions.
   Il comporte un dossier par langue avec des fichiers `.po` contenant les
   traductions et des fichiers `.pot` générés automatiquement à partir des
   fichiers source en markdown.
+- `_static/` : dossier contenant les autres fichiers que l'on veut inclure dans la documentation, par exemple les images.
+- `_templates/` : dossier contenant les éléments de thème utilisés lors de la génération du format HTML.
 - `AUTHORS` : fichier contenant la liste des auteurs.
 - `index.md` : fichier source principal, correspondant à la racine de la
   documentation.
diff --git a/locales/en/LC_MESSAGES/package.po b/_locales/en/LC_MESSAGES/package.po
index a067518..e2d1c94 100644
--- a/locales/en/LC_MESSAGES/package.po
+++ b/_locales/en/LC_MESSAGES/package.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Hébergement CLUB1 main\n"
 "Report-Msgid-Bugs-To: nicolas@club1.fr\n"
-"POT-Creation-Date: 2022-04-23 00:16+0200\n"
+"POT-Creation-Date: 2022-05-02 15:15+0200\n"
 "PO-Revision-Date: 2022-04-19 10:07+0000\n"
 "Last-Translator: Nicolas Peugnet <n.peugnet@free.fr>\n"
 "Language-Team: English <https://hosted.weblate.org/projects/club-1/docs/en/>"
@@ -92,13 +92,24 @@ msgstr "`_build`: folder that contains all the files generated by Sphinx."
 
 #: ../../README.md:45
 msgid ""
+"`_locales/` : dossier contenant les fichiers de traductions. Il comporte un "
+"dossier par langue avec des fichiers `.po` contenant les traductions et des "
+"fichiers `.pot` générés automatiquement à partir des fichiers source en "
+"markdown."
+msgstr ""
+"`_locales/`: folder that contains the translation files. It is composed of "
+"one folder per language with `.po` files that contains the translations and "
+"`.pot` files automatically generated from the markdown source files."
+
+#: ../../README.md:49
+msgid ""
 "`_static/` : dossier contenant les autres fichiers que l'on veut inclure "
 "dans la documentation, par exemple les images."
 msgstr ""
 "`_static/`: folder that contains the other files to include in the "
 "documentation, for instance images."
 
-#: ../../README.md:46
+#: ../../README.md:50
 msgid ""
 "`_templates/` : dossier contenant les éléments de thème utilisés lors de la "
 "génération du format HTML."
@@ -106,17 +117,6 @@ msgstr ""
 "`_templates/`: folder that contains the theme elements used for HTML format "
 "generation."
 
-#: ../../README.md:47
-msgid ""
-"`locales/` : dossier contenant les fichiers de traductions. Il comporte un "
-"dossier par langue avec des fichiers `.po` contenant les traductions et des "
-"fichiers `.pot` générés automatiquement à partir des fichiers source en "
-"markdown."
-msgstr ""
-"`locales/`: folder that contains the translation files. It is composed of "
-"one folder per language with `.po` files that contains the translations and "
-"`.pot` files automatically generated from the markdown source files."
-
 #: ../../README.md:51
 msgid "`AUTHORS` : fichier contenant la liste des auteurs."
 msgstr "`AUTHORS`: file that contains the list of authors."
@@ -1474,7 +1474,7 @@ msgid ""
 msgstr ""
 
 #: ../../tutos/webdav-android.md:12
-msgid "[F droid](https://f-droid.org/fr/packages/at.bitfire.davdroid/)"
+msgid "[F-Droid](https://f-droid.org/fr/packages/at.bitfire.davdroid/)"
 msgstr ""
 
 #: ../../tutos/webdav-android.md:13
@@ -1516,7 +1516,7 @@ msgstr ""
 #: ../../tutos/webdav-android.md:27
 msgid ""
 "Enfin, pour plus de confort, il est conseillé d'activer la synchro à "
-"intervals réguliers."
+"intervalles réguliers."
 msgstr ""
 
 #: ../../tutos/webdav-android.md:29
diff --git a/locales/en/LC_MESSAGES/sphinx.po b/_locales/en/LC_MESSAGES/sphinx.po
index 34fbc9b..34fbc9b 100644
--- a/locales/en/LC_MESSAGES/sphinx.po
+++ b/_locales/en/LC_MESSAGES/sphinx.po
diff --git a/locales/package.pot b/_locales/package.pot
index be0a33f..f95f514 100644
--- a/locales/package.pot
+++ b/_locales/package.pot
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: CLUB1 main\n"
 "Report-Msgid-Bugs-To: nicolas@club1.fr\n"
-"POT-Creation-Date: 2022-04-23 00:16+0200\n"
+"POT-Creation-Date: 2022-05-02 15:15+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -73,24 +73,24 @@ msgstr ""
 
 #: ../../README.md:45
 msgid ""
+"`_locales/` : dossier contenant les fichiers de traductions. Il comporte un "
+"dossier par langue avec des fichiers `.po` contenant les traductions et des "
+"fichiers `.pot` générés automatiquement à partir des fichiers source en "
+"markdown."
+msgstr ""
+
+#: ../../README.md:49
+msgid ""
 "`_static/` : dossier contenant les autres fichiers que l'on veut inclure "
 "dans la documentation, par exemple les images."
 msgstr ""
 
-#: ../../README.md:46
+#: ../../README.md:50
 msgid ""
 "`_templates/` : dossier contenant les éléments de thème utilisés lors de la "
 "génération du format HTML."
 msgstr ""
 
-#: ../../README.md:47
-msgid ""
-"`locales/` : dossier contenant les fichiers de traductions. Il comporte un "
-"dossier par langue avec des fichiers `.po` contenant les traductions et des "
-"fichiers `.pot` générés automatiquement à partir des fichiers source en "
-"markdown."
-msgstr ""
-
 #: ../../README.md:51
 msgid "`AUTHORS` : fichier contenant la liste des auteurs."
 msgstr ""
@@ -1220,7 +1220,7 @@ msgid ""
 msgstr ""
 
 #: ../../tutos/webdav-android.md:12
-msgid "[F droid](https://f-droid.org/fr/packages/at.bitfire.davdroid/)"
+msgid "[F-Droid](https://f-droid.org/fr/packages/at.bitfire.davdroid/)"
 msgstr ""
 
 #: ../../tutos/webdav-android.md:13
@@ -1262,7 +1262,7 @@ msgstr ""
 #: ../../tutos/webdav-android.md:27
 msgid ""
 "Enfin, pour plus de confort, il est conseillé d'activer la synchro à "
-"intervals réguliers."
+"intervalles réguliers."
 msgstr ""
 
 #: ../../tutos/webdav-android.md:29
diff --git a/locales/sphinx.pot b/_locales/sphinx.pot
index 2b39c40..2b39c40 100644
--- a/locales/sphinx.pot
+++ b/_locales/sphinx.pot
diff --git a/conf.py b/conf.py
index 9649ba3..5122b28 100644
--- a/conf.py
+++ b/conf.py
@@ -58,6 +58,9 @@ language = os.environ['LOCALE']
 # Set by make.
 languages = os.environ['LANGUAGES'].split(' ')
 
+# Directory that contains the translated messages
+locale_dirs = ['_locales']
+
 # Managed by make and gettext.
 gettext_auto_build = False