Opened 11 years ago
Closed 11 years ago
#20515 closed Cleanup/optimization (fixed)
Clarification in release notes of location of translator comments
Reported by: | 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).
Note:
See TracTickets
for help on using tickets.
In f513764e72faf6bd4be1f063d2842cd4e5d76f7d: