Skip to content

Lint translation files #382

Description

@StanFromIreland

There are currently 342 lint warnings when polint is ran, there are also a few build warnings.

transifex-automations has test building and linting workflows, they are simple to add, just the branch matrix's need to be updated.

Activity

  1. Dumeng commented on May 18, 2025

    @Dumeng
    Collaborator

    Will these lint issues block the doc buildings?

  2. StanFromIreland commented on May 18, 2025

    @StanFromIreland
    MemberAuthor

    The lint issues do not block anything, they have been around for a while ;-) They sometimes cause issues with how the translation renders, other times they are just quality issues. At pl, we keep the errors at 0.

  3. silkriver commented on May 23, 2025

    @silkriver

    build warnings are fixed now but some lint warnings are hard to locate like "clones/rebased_translations/python/python-docs-zh-cn/reference/compound_stmts.po:2642: trailing whitespace (trailing-whitespace)", seems the ref number is not correct.

  4. StanFromIreland commented on May 23, 2025

    @StanFromIreland
    MemberAuthor

    The warnings on the dashboard may be slightly out of date.

    transifex-automations has test building and linting workflows, they are simple to add, just the branch matrix's need to be updated, I highly suggest you add them. You can combine the two my merging the jobs.

  5. silkriver commented on May 9, 2026

    @silkriver

    please check the current build warnings:

    library/urllib.parse.rst:479: WARNING: inconsistent references in translated message. original: ['`WHATWG\nspec`_'], translated: ['`WHATWG spec`_'] [i18n.inconsistent_references]
    library/re.rst:287: WARNING: inconsistent references in translated message. original: ['`Unicode Technical\nStandard #18`_'], translated: ['`Unicode Technical Standard #18`_'] [i18n.inconsistent_references]
    library/shutil.rst:848: WARNING: inconsistent references in translated message. original: ['`one above <shutil-archiving-example_>`_'], translated: ['`上面的例子 <shutil-archiving-example_>`_'] [i18n.inconsistent_references]
    

    document seems no problems, check script may need adjusting?

  6. StanFromIreland commented on May 9, 2026

    @StanFromIreland
    MemberAuthor

    It’s a bug in Sphinx IIRC.

  7. silkriver commented on May 22, 2026

    @silkriver

    Lint warnings all fixed, now build warnings are more triky

  8. silkriver commented on May 30, 2026

    @silkriver

    Eliminated the buggy build warnings by temporarily remove corresponding translation texts, but I can't find these last two lines

    whatsnew/changelog.rst:18781:<translated>:1: WARNING: Inline emphasis start-string without end-string. [docutils]
    whatsnew/changelog.rst:27356:<translated>:1: WARNING: Inline emphasis start-string without end-string. [docutils]
    
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions