Fix #1734: Could not translate the caption of toctree directive

1 files changed, 16 insertions, 0 deletions

diff --git a/sphinx/transforms.py b/sphinx/transforms.py
index 7b09285a4..8792d8f11 100644
--- a/sphinx/transforms.py
+++ b/sphinx/transforms.py
@@ -238,6 +238,17 @@ def publish_msgstr(app, source, source_path, source_line, config, settings):
     return doc
 
 
+class PreserveTranslatableMessages(Transform):
+    """
+    Preserve original translatable messages befor translation
+    """
+    default_priority = 10  # this MUST be invoked before Locale transform
+
+    def apply(self):
+        for node in self.document.traverse(addnodes.translatable):
+            node.preserve_original_messages()
+
+
 class Locale(Transform):
     """
     Replace translatable nodes with their translated doctree.
@@ -384,6 +395,11 @@ class Locale(Transform):
             if not msgstr or msgstr == msg:  # as-of-yet untranslated
                 continue
 
+            # update translatable nodes
+            if isinstance(node, addnodes.translatable):
+                node.apply_translated_message(msg, msgstr)
+                continue
+
             # Avoid "Literal block expected; none found." warnings.
             # If msgstr ends with '::' then it cause warning message at
             # parser.parse() processing.