Opened 11 years ago

Closed 11 years ago

#20515 closed Cleanup/optimization (fixed)

Clarification in release notes of location of translator comments

Reported by: wim@… Owned by: nobody
Component: Documentation Version: 1.6-alpha-1
Severity: Normal Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Hi all,

I find the following sentences extremely difficult to comprehend. Maybe we can reword them in order to clarify a bit.

Original text:

Validation of the placement of Comments for translators in templates specified using {# / #} is now stricter. All translator comments not located at the end of their respective lines in a template are ignored and a warning is generated by makemessages when it finds them. E.g.:

{# Translators: This is ignored #}{% trans "Translate me" %}
{{ title }}{# Translators: Extracted and associated with 'Welcome' below #}
<h1>{% trans "Welcome" %}</h1>

Proposal:
Translator comments in templates need to be at the end of a line. If not, a warning is generated by makemessages when it finds them in the wrong place. For example, this raises an error.

(Actually, I am not sure about whether I interpreted the text correctly so my text may be plain wrong).

Change History (1)

comment:1 by Tim Graham <timograham@…>, 11 years ago

Resolution: fixed
Status: newclosed

In f513764e72faf6bd4be1f063d2842cd4e5d76f7d:

Fixed #20515 - Clarified note regarding translator comments.

Thanks wim@ for the suggestion.

Note: See TracTickets for help on using tickets.
Back to Top