36,076
edits
Authoring guidelines/fr: Difference between revisions
Jump to navigation
Jump to search
Updating to match new version of source page
No edit summary |
(Updating to match new version of source page) |
||
| Line 89: | Line 89: | ||
#Vérifiez que la langue prioritaire est sélectionnée; il s'agit de la langue cible. | #Vérifiez que la langue prioritaire est sélectionnée; il s'agit de la langue cible. | ||
#Cliquez sur ''Marquer cette page pour la traduction''. | #Cliquez sur ''Marquer cette page pour la traduction''. | ||
== Code blocks are not translated == | |||
Our professional human translator is not a programmer. | |||
They cannot distinguish between code and comments in every possible language, | |||
so the documentation team has instructed the translator to exclude code blocks from translation. | |||
Putting explanatory comments in code is excellent programming practice which we wish to encourage, | |||
but the value of the comments is decreased if the comments aren't translated. | |||
The documentation team has not found a solution for this that works in every case. | |||
Here are some suggestions: | |||
# Move the information contained in the comments outside the code block, into the surrounding text (which will then be translated). | |||
# Leave an index comment (e.g. "NOTE 1", "NOTE 2") to connect the external text to the relevant line of code. | |||
# If you're sufficiently bilingual, and familiar with the translation apparatus, you may translate the code block yourself. | |||
Please ''do not'' leave example code uncommented, but please ''do'' remember that | |||
comments will not normally be translated, and consider how this will affect the understanding | |||
of the user reading the page in translation. | |||
= Page des logiciels disponibles = | = Page des logiciels disponibles = | ||