Add multilanguage configurations for multilanguage support

ros2 · Aug 14, 2023 · c30c451 · c30c451
1 parent 3358c49
commit c30c451
Show file tree

Hide file tree

Showing 4 changed files with 14 additions and 4 deletions.
diff --git a/.gitignore b/.gitignore
@@ -3,3 +3,4 @@ plugins/__pycache__
 _build/
 .idea/
 .vscode/
+*.mo
diff --git a/Makefile b/Makefile
@@ -4,15 +4,16 @@ SOURCE     = source
 OUT        = build
 LINKCHECKDIR  = $(OUT)/linkcheck
 BUILD      = python3 -m sphinx
-OPTS       =-c .
+LANG 	   = en
+OPTS       = -c . -D language=$(LANG)
 
 help:
 	@$(BUILD) -M help "$(SOURCE)" "$(OUT)" $(OPTS)
 	@echo "  multiversion to build documentation for all branches"
 
 multiversion: Makefile
-	sphinx-multiversion $(OPTS) "$(SOURCE)" build/html
-	@echo "<html><head><meta http-equiv=\"refresh\" content=\"0; url=iron/index.html\" /></head></html>" > build/html/index.html
+	sphinx-multiversion $(OPTS) "$(SOURCE)" build/html/$(LANG)
+	@echo "<html><head><meta http-equiv=\"refresh\" content=\"0; url=iron/index.html\" /></head></html>" > build/html/$(LANG)/index.html
 	python3 make_sitemapindex.py
 
 %: Makefile
@@ -26,4 +27,10 @@ linkcheck:
 	@echo
 	@echo "Check finished. Report is in $(LINKCHECKDIR)."
 
+updatepo:
+	sphinx-intl update -p "$(OUT)/gettext" -d "locale" -l $(LANG)
+
+html:
+	$(BUILD) -b html $(OPTS) $(SOURCE) $(OUT)/html/$(LANG);
+
 .PHONY: help Makefile multiversion test linkcheck
diff --git a/conf.py b/conf.py
@@ -62,7 +62,8 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = 'en'
+# language = 'en'
+locale_dirs = ['../locale/'] # Path from the source directory to the locale directory.
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

diff --git a/requirements.txt b/requirements.txt
@@ -6,3 +6,4 @@ sphinx-copybutton==0.4.0
 sphinx-multiversion==0.2.4
 sphinx-rtd-theme==1.0.0
 sphinx-tabs==3.2.0
+sphinx-intl