Merge branch 'main' into 15949_user_profile_API

Author: nijel

docs/changes.rst

@@ -10,6 +10,7 @@ Weblate 2026.8
 * :doc:`Translation reports </devel/reporting>` are now generated in the background, stored for later download, available at workspace scope, and include translator work analysis.
 * Added :guilabel:`Use keywords exclusively` option to :ref:`addon-weblate.gettext.xgettext`, allowing projects to disable xgettext default keywords and rely only on a custom keyword.
 * Added API support for reading and updating :ref:`user-profile` preferences. See :ref:`api-users` endpoint.
+* Added :ref:`check-asciidoc-markup` quality check for AsciiDoc strings.
 * Added support for legacy Qt Linguist TS version 1 files. See :ref:`qtling`.
 
 .. rubric:: Improvements

docs/snippets/check-flags-autogenerated.rst

@@ -50,6 +50,9 @@
 ``accelerator``
     Specify the single punctuation accelerator marker, for example ``accelerator:&``, ``accelerator:_``, or ``accelerator:~``.
     Enables the :ref:`check-accelerator` quality check.
+``asciidoc-text``
+    Treat a text as an AsciiDoc document, affects :ref:`check-same`.
+    Enables the :ref:`check-asciidoc-markup` quality check.
 ``bbcode-text``
     Treat a text as an Bulletin Board Code (BBCode) document, affects :ref:`check-same`.
     Enables the :ref:`check-bbcode` quality check.
@@ -157,6 +160,8 @@
 
 ``ignore-accelerator``
     Skip the :ref:`check-accelerator` quality check.
+``ignore-asciidoc-markup``
+    Skip the :ref:`check-asciidoc-markup` quality check.
 ``ignore-bbcode``
     Skip the :ref:`check-bbcode` quality check.
 ``ignore-xml-chars-around-tags``

docs/snippets/checks-autogenerated.rst

@@ -40,6 +40,37 @@ of accelerator keys, and that the translation does not contain more than one.
     ampersand and trigger a false positive. Use the ``ignore-accelerator``
     flag to skip the check for such strings.
 
+.. AUTOGENERATED START: check-asciidoc-markup
+.. This section is automatically generated by `./manage.py list_checks`. Do not edit manually.
+
+.. _check-asciidoc-markup:
+
+AsciiDoc markup
+~~~~~~~~~~~~~~~
+
+.. versionadded:: 2026.8
+
+:Summary: AsciiDoc markup does not match source.
+:Scope: translated strings
+:Check class: ``weblate.checks.markup.AsciiDocMarkupCheck``
+:Check identifier: ``asciidoc-markup``
+:Trigger: This check needs to be enabled using a flag.
+:File formats automatically enabling this check: :ref:`asciidoc`
+:Flag to enable: ``asciidoc-text``
+:Flag to ignore: ``ignore-asciidoc-markup``
+
+.. AUTOGENERATED END: check-asciidoc-markup
+
+This check compares the markups found in the source with the markups found in the translation.
+It includes:
+
+- inline and block macros (e.g. ``link:`` and ``image::``)
+- cross-references (``<<id>>``)
+- passthroughs (e.g. ``+++...+++``, ``$$...$$``)
+
+Macro attribute text and cross-reference labels may be translated; the
+macro name, target, and reference identifier must stay the same in both the source and the translation.
+
 .. AUTOGENERATED START: check-bbcode
 .. This section is automatically generated by `./manage.py list_checks`. Do not edit manually.
 

docs/snippets/format-features/asciidoc-features.rst

@@ -27,6 +27,6 @@
    * - Supports removing obsolete strings :ref:`ⓘ <obsolete-strings>`
      - ``No``
    * - Check flags added by this format :ref:`ⓘ <custom-checks>`
-     - :ref:`check-safe-html`, ``strict-same``
+     - :ref:`check-safe-html`, ``strict-same``, ``asciidoc-text``
 
 .. AUTOGENERATED END: format-features asciidoc

weblate/checks/base.py

@@ -446,6 +446,44 @@ def format_result(self, result: MissingExtraDict) -> Iterable[StrOrPromise]:
             yield self.get_errors_text(set(errors))
 
 
+class PluralResultDescriptionMixin(TargetCheck):
+    """
+    Build check descriptions by merging MissingExtraDict results across plurals.
+
+    For checks whose ``check_single`` returns a ``MissingExtraDict`` (missing,
+    extra, and/or errors), this merges those results from every plural form and
+    formats them into the check description.
+    """
+
+    def get_description(self, check_obj: Check) -> StrOrPromise:
+        unit = check_obj.unit
+
+        errors: list[StrOrPromise] = []
+
+        # Merge plurals
+        results: MissingExtraDict = {}
+        for result in self.check_target_generator(
+            unit.get_source_plurals(), unit.get_target_plurals(), unit
+        ):
+            if not isinstance(result, dict):
+                continue
+            if missing := result.get("missing"):
+                results.setdefault("missing", []).extend(missing)
+            if extra := result.get("extra"):
+                results.setdefault("extra", []).extend(extra)
+            if result_errors := result.get("errors"):
+                results.setdefault("errors", []).extend(result_errors)
+        if any(results.values()):
+            errors.extend(self.format_result(results))
+        if errors:
+            return format_html_join(
+                mark_safe("<br />"),
+                "{}",
+                ((error,) for error in errors),
+            )
+        return super().get_description(check_obj)
+
+
 class SourceCheck(BaseCheck):
     """Basic class for source checks."""
 

weblate/checks/defaults.py

@@ -70,6 +70,7 @@
     "weblate.checks.markup.SafeHTMLCheck",
     "weblate.checks.markup.RSTReferencesCheck",
     "weblate.checks.markup.RSTSyntaxCheck",
+    "weblate.checks.markup.AsciiDocMarkupCheck",
     "weblate.checks.mdx.SafeMDXCheck",
     "weblate.checks.placeholders.PlaceholderCheck",
     "weblate.checks.placeholders.RegexCheck",

weblate/checks/management/commands/list_checks.py

@@ -58,6 +58,7 @@ def get_scope(check: BaseCheck) -> str | None:
     ),
     "rst-text": "Treat a text as an reStructuredText document, affects :ref:`check-same`.",
     "bbcode-text": "Treat a text as an Bulletin Board Code (BBCode) document, affects :ref:`check-same`.",
+    "asciidoc-text": "Treat a text as an AsciiDoc document, affects :ref:`check-same`.",
     "md-text": "Treat a text as a Markdown document, and provide Markdown syntax highlighting on the translation text area.",
     "auto-java-messageformat": "Treat a text as conditional Java MessageFormat, enabling :ref:`check-java-format` only when the source contains Java MessageFormat placeholders.",
     "auto-safe-html": "Treat a text as conditional HTML, enabling :ref:`check-safe-html` only for plain text or source strings that contain standard HTML markup or valid custom elements. This is useful for extended Markdown variants such as MDX, where angle-bracket syntax may not be HTML.",

weblate/checks/markup.py

@@ -6,7 +6,7 @@
 
 import re
 import threading
-from collections import Counter, defaultdict
+from collections import Counter
 from functools import cache, lru_cache
 from itertools import chain
 from types import SimpleNamespace
@@ -16,8 +16,6 @@
 from django.core.exceptions import ValidationError
 from django.core.validators import URLValidator
 from django.utils.functional import cached_property
-from django.utils.html import format_html_join
-from django.utils.safestring import mark_safe
 from django.utils.translation import gettext, gettext_lazy
 from docutils import utils
 from docutils.core import Publisher
@@ -39,7 +37,7 @@
 from docutils.readers.standalone import Reader
 from docutils.writers.null import Writer
 
-from weblate.checks.base import Highlight, TargetCheck
+from weblate.checks.base import Highlight, PluralResultDescriptionMixin, TargetCheck
 from weblate.checks.format import (
     ES_TEMPLATE_MATCH,
     FLAG_RULES,
@@ -73,7 +71,6 @@
     from weblate.trans.models import Unit
 
     from .base import FixupType
-    from .models import Check
 
 DOCUTILS_PARSER_LOCK = threading.Lock()
 BBCODE_MATCH = re.compile(
@@ -902,7 +899,7 @@ def extract_rst_references(
     return dict(result), Counter(item[0] for item in result), tuple(highlights)
 
 
-class RSTReferencesCheck(RSTBaseCheck):
+class RSTReferencesCheck(PluralResultDescriptionMixin, RSTBaseCheck):
     check_id = "rst-references"
     name = gettext_lazy("Inconsistent reStructuredText")
     description = gettext_lazy(
@@ -947,29 +944,6 @@ def check_single(
             }
         return False
 
-    def get_description(self, check_obj: Check) -> StrOrPromise:
-        unit = check_obj.unit
-
-        errors: list[StrOrPromise] = []
-        results: MissingExtraDict = cast("MissingExtraDict", defaultdict(list))
-
-        # Merge plurals
-        for result in self.check_target_generator(
-            unit.get_source_plurals(), unit.get_target_plurals(), unit
-        ):
-            if isinstance(result, dict):
-                for key, value in result.items():
-                    results[key].extend(value)
-        if results:
-            errors.extend(self.format_result(results))
-        if errors:
-            return format_html_join(
-                mark_safe("<br />"),
-                "{}",
-                ((error,) for error in errors),
-            )
-        return super().get_description(check_obj)
-
     def check_highlight(self, source: str, unit: Unit):
         if self.should_skip(unit):
             return
@@ -1060,7 +1034,7 @@ def error_collector(data: system_message) -> None:
     return tuple(errors), tuple(roles)
 
 
-class RSTSyntaxCheck(RSTBaseCheck):
+class RSTSyntaxCheck(PluralResultDescriptionMixin, RSTBaseCheck):
     check_id = "rst-syntax"
     name = gettext_lazy("reStructuredText syntax error")
     description = gettext_lazy("reStructuredText syntax error in the translation.")
@@ -1092,25 +1066,122 @@ def check_single(
             return {"errors": errors}
         return False
 
-    def get_description(self, check_obj: Check) -> StrOrPromise:
-        unit = check_obj.unit
 
-        errors: list[StrOrPromise] = []
-        results: MissingExtraDict = cast("MissingExtraDict", defaultdict(list))
+# inline (`name:target[attrs]`) and block (`name::target[attrs]`) macros.
+ASCIIDOC_MACRO = re.compile(
+    r"(?P<name>[a-z][a-z0-9]*)(?P<sep>::?)(?P<target>[^\s\[]*)\[(?P<attrs>(?:\\.|[^\]])*)\]"
+)
+# cross references: <<id>> or <<id,text>>.
+ASCIIDOC_XREF = re.compile(r"<<(?P<id>[^,>]+)(?:,(?P<text>[^>]*))?>>")
+# inline anchors: [[id]] or [[id,label]].
+ASCIIDOC_INLINE_ANCHOR = re.compile(r"\[\[(?P<id>[^,\]]+)(?:,(?P<label>[^\]]*))?\]\]")
+# passthroughs. Bare single-plus `+...+` is excluded to avoid false positives.
+ASCIIDOC_PASSTHROUGH = re.compile(
+    r"\+\+\+.+?\+\+\+|\+\+.+?\+\+|`\+.+?\+`|\$\$.+?\$\$",
+    re.DOTALL,
+)
+
 
-        # Merge plurals
-        for result in self.check_target_generator(
-            unit.get_source_plurals(), unit.get_target_plurals(), unit
-        ):
-            if isinstance(result, dict):
-                for key, value in result.items():
-                    results[key].extend(value)
-        if results:
-            errors.extend(self.format_result(results))
-        if errors:
-            return format_html_join(
-                mark_safe("<br />"),
-                "{}",
-                ((error,) for error in errors),
+def is_preceded_by_asciidoc_escape(text: str, start: int) -> bool:
+    """Return whether markup at ``start`` is escaped and renders as literal text."""
+    backslashes = 0
+    pos = start - 1
+    while pos >= 0 and text[pos] == "\\":
+        backslashes += 1
+        pos -= 1
+    return backslashes % 2 == 1
+
+
+class AsciiDocMarkupCheck(PluralResultDescriptionMixin, TargetCheck):
+    """Check that AsciiDoc macros, xrefs, and passthroughs match the source."""
+
+    check_id = "asciidoc-markup"
+    name = gettext_lazy("AsciiDoc markup")
+    description = gettext_lazy("AsciiDoc markup does not match source.")
+    version_added = "2026.8"
+    default_disabled = True
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.enable_string = "asciidoc-text"
+
+    def get_missing_text(self, values: Iterable[str]) -> StrOrPromise:
+        return self.get_values_text(
+            gettext("The following AsciiDoc markup is missing: {}"), values
+        )
+
+    def get_extra_text(self, values: Iterable[str]) -> StrOrPromise:
+        return self.get_values_text(
+            gettext("The following AsciiDoc markup is extra: {}"), values
+        )
+
+    def check_single(
+        self, source: str, target: str, unit: Unit
+    ) -> bool | MissingExtraDict:
+        src_set = extract_asciidoc_markup(source)
+        tgt_set = extract_asciidoc_markup(target)
+
+        missing = src_set - tgt_set
+        extra = tgt_set - src_set
+
+        if missing or extra:
+            return {
+                "missing": list(missing.elements()),
+                "extra": list(extra.elements()),
+                "errors": [],
+            }
+        return False
+
+    def check_highlight(self, source: str, unit: Unit):
+        if self.should_skip(unit):
+            return
+        yield from iter_asciidoc_highlights(source)
+
+
+def extract_asciidoc_markup(text: str) -> Counter[str]:
+    tokens: list[str] = []
+    for match in ASCIIDOC_MACRO.finditer(text):
+        if is_preceded_by_asciidoc_escape(text, match.start()):
+            continue
+        if match.group("name") == "pass":
+            # special case for passthrough macros, the content is not translatable and must be preserved
+            tokens.append(match.group())
+        else:
+            tokens.append(
+                f"{match.group('name')}{match.group('sep')}{match.group('target')}[]"
             )
-        return super().get_description(check_obj)
+    tokens.extend(
+        f"<<{match.group('id')}>>"
+        for match in ASCIIDOC_XREF.finditer(text)
+        if not is_preceded_by_asciidoc_escape(text, match.start())
+    )
+    tokens.extend(
+        f"[[{match.group('id')}]]"
+        for match in ASCIIDOC_INLINE_ANCHOR.finditer(text)
+        if not is_preceded_by_asciidoc_escape(text, match.start())
+    )
+    tokens.extend(
+        match.group()
+        for match in ASCIIDOC_PASSTHROUGH.finditer(text)
+        if not is_preceded_by_asciidoc_escape(text, match.start())
+    )
+    return Counter(tokens)
+
+
+def iter_asciidoc_highlights(text: str) -> Iterable[Highlight]:
+    for match in ASCIIDOC_MACRO.finditer(text):
+        if is_preceded_by_asciidoc_escape(text, match.start()):
+            continue
+        yield Highlight(match.start(), match.end(), match.group(), kind="syntax")
+    for match in ASCIIDOC_XREF.finditer(text):
+        if is_preceded_by_asciidoc_escape(text, match.start()):
+            continue
+        yield Highlight(match.start(), match.end(), match.group(), kind="syntax")
+    for match in ASCIIDOC_INLINE_ANCHOR.finditer(text):
+        if is_preceded_by_asciidoc_escape(text, match.start()):
+            continue
+        yield Highlight(match.start(), match.end(), match.group(), kind="syntax")
+    for match in ASCIIDOC_PASSTHROUGH.finditer(text):
+        if is_preceded_by_asciidoc_escape(text, match.start()):
+            continue
+        yield Highlight(match.start(), match.end(), match.group(), kind="syntax")