From 2c72fc9cde3dc3bb66605b6cbd98c45273690560 Mon Sep 17 00:00:00 2001
From: jack1142 <6032823+jack1142@users.noreply.github.com>
Date: Sun, 20 Feb 2022 15:33:05 +0100
Subject: [PATCH] [docs] Suppress inconsistent references in translated message
 warning

---
 docs/conf.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 03f69c195..0302647a7 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -11,6 +11,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import logging
 import sys
 import os
 import re
@@ -150,6 +151,21 @@ nitpick_ignore_files = [
   "whats_new",
 ]
 
+
+# Ignore warnings about inconsistent order and/or count of references in translated messages.
+# This makes no sense, different languages can have different word order...
+def _i18n_warning_filter(record: logging.LogRecord) -> bool:
+  return not record.msg.startswith(
+    (
+      'inconsistent references in translated message',
+      'inconsistent term references in translated message',
+    )
+  )
+
+
+_i18n_logger = logging.getLogger('sphinx')
+_i18n_logger.addFilter(_i18n_warning_filter)
+
 # -- Options for HTML output ----------------------------------------------
 
 html_experimental_html5_writer = True