Add script to handle Sphinx and Weblate files

update.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+
+# Defines
+SOURCE_DIR="docs"
+SPHINX_TEMPLATES_DIR="sphinx/templates"
+SPHINX_TEMPLATES=$(find $SPHINX_TEMPLATES_DIR -type f -name "*.pot")
+SPHINX_PO_DIR="sphinx/po"
+
+WEBLATE_DIR="weblate"
+WEBLATE_TEMPLATE="$WEBLATE_DIR/docs.pot"
+WEBLATE_POFILES=$(find $WEBLATE_DIR -type f -name "*.po")
+
+# Options
+update_sphinx_pot=false
+update_sphinx_po=false
+update_weblate_pot=false
+update_weblate_po=false
+
+# Command line arguments
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --sphinx-pot|-st)
+      update_sphinx_pot=true
+      ;;
+    --sphinx-po|-so)
+      update_sphinx_po=true
+      ;;
+    --sphinx|-s)
+      update_sphinx_pot=true
+      update_sphinx_po=true
+      ;;
+    --weblate-pot|-wt)
+      update_weblate_pot=true
+      ;;
+    --weblate-po|-wo)
+      update_weblate_po=true
+      ;;
+    --weblate|-w)
+      update_weblate_pot=true
+      update_weblate_po=true
+      ;;
+    --all|-a)
+      update_sphinx_pot=true
+      update_sphinx_po=true
+      update_weblate_pot=true
+      update_weblate_po=true
+      ;;
+    *)
+      echo "Invalid argument."
+  esac
+  shift
+done
+
+# Generate/Update Sphinx template from rst files
+if [ "$update_sphinx_pot" = true ]; then
+  echo "=== Updating Sphinx templates from source rst files ==="
+  rm -rf $SPHINX_TEMPLATES_DIR
+  make -C $SOURCE_DIR gettext
+  SPHINX_TEMPLATES=$(find $SPHINX_TEMPLATES_DIR -type f -name "*.pot")
+fi
+
+# Generate/Update Weblate monolithic template from Sphinx template
+if [ "$update_weblate_pot" = true ]; then
+  echo "=== Updating Weblate monolithic template from Sphinx templates ==="
+  if [ ! -d "$SPHINX_TEMPLATES_DIR" ]; then
+    echo "Sphinx templates are missing, please run with --sphinx-pot."
+  fi
+  if [ ! -d "$WEBLATE_DIR" ]; then
+    mkdir $WEBLATE_DIR
+  fi
+  msgcat -o $WEBLATE_TEMPLATE $SPHINX_TEMPLATES
+  sed -i 's@Report-Msgid-Bugs-To: [^"]*@Report-Msgid-Bugs-To: https://github.com/godotengine/godot-docs-l10n\\n@' $WEBLATE_TEMPLATE
+fi
+
+# Merge Weblate PO files with Weblate template
+if [ "$update_weblate_po" = true ]; then
+  echo "=== Merging Weblate PO files with Weblate template ==="
+  for po in $WEBLATE_POFILES; do
+    echo "Merging $po..."
+    msgmerge -w 79 -i $WEBLATE_TEMPLATE -C $po $po > "$po".new
+    mv -f "$po".new $po
+  done
+fi
+
+# Generate/Merge Sphinx PO files from Weblate PO file
+if [ "$update_sphinx_po" = true ]; then
+  echo "=== Merging Sphinx PO files with their template and Weblate PO file ==="
+  # First clean previous folder to take into account potentially removed files
+  rm -rf $SPHINX_PO_DIR
+  mkdir $SPHINX_PO_DIR
+  for po in $WEBLATE_POFILES; do
+    lang=$(basename "$po" .po)
+    langdir="$SPHINX_PO_DIR/$lang/LC_MESSAGES"
+    mkdir -p "$langdir"
+    for template in $SPHINX_TEMPLATES; do
+      page=$(basename "$template" .pot)
+      dirpath=$(dirname "$template" | sed -e 's@'$SPHINX_TEMPLATES_DIR'@'$langdir'@')
+      mkdir -p "$dirpath"
+      output="$dirpath/$page.po"
+      msgmerge --lang=$lang -C "$po" "$template" "$template" -o "$output"
+    done
+  done
+fi