From 0a734e9f0249c6525f95f05fba298b3caf76f6af Mon Sep 17 00:00:00 2001 From: Dmitri Gribenko Date: Sat, 27 Sep 2025 11:13:16 +0200 Subject: [PATCH] docs(style): Document mdbook-xgettext skip comment (#2929) --- STYLE.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/STYLE.md b/STYLE.md index c5844288..a9943ff7 100644 --- a/STYLE.md +++ b/STYLE.md @@ -159,6 +159,10 @@ preprocessor, `mdbook-course`. The following conventions are mandatory: **must** use the `{{%session outline%}}` or `{{%segment outline%}}` helpers. - **File Includes:** Code for exercises and their solutions **must** be included from external files using the standard `mdbook` `{{#include ...}}` helper. +- **Translation Directives:** To prevent an element (such as a paragraph, code + block, or list item) from being translated, place a + `` comment on a line by itself, followed by a + blank line, immediately before the element. For a complete explanation of the custom helpers and all available frontmatter fields, please refer to the [`mdbook-course` README](mdbook-course/README.md).