Edit Markup/fr: Difference between revisions

From KDE TechBase
(Created page with "* Vérifiez que chaque titre de section ou de sous-section est suivi d'une ligne vide.")
No edit summary
 
(49 intermediate revisions by 2 users not shown)
Line 2: Line 2:
== Outils disponibles ==
== Outils disponibles ==


* [[Special:myLanguage/Typographical_Guidelines|Typographical guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. Please refer to this frequently, as markup will be refined to match translators' needs.
* [[Special:myLanguage/Typographical_Guidelines|Règles typographiques]] normalise le balisage pour une utilisation en traduction, soit vers les manuels officiels (DocBook), soit vers d'autres langues. Veuillez vous y référer fréquemment, car le balisage sera affiné pour correspondre aux besoins des traducteurs.


== Etape 1 du travail ==
== Etape 1 du travail ==
Line 10: Line 10:
* Vérifiez que chaque titre de section ou de sous-section est suivi d'une ligne vide.
* Vérifiez que chaque titre de section ou de sous-section est suivi d'une ligne vide.


* Many pages have multiple indents set. This was included in earlier mediawiki documentation, but is not longer acceptable as it causes problems for exporting to other formats, so please re-arrange, using single indents only. Bullets can continue to be used nested.
* De nombreuses pages comportent des indentations. Ceci a été introduit dans les documents antérieurs de mediawiki, mais n'est plus acceptable car cela pose des problèmes pour l'exportation vers d'autres formats, veuillez donc réorganiser, en utilisant uniquement des retraits simples. Les puces peuvent continuer à être utilisées imbriquées.


* ASCII smilies cause problems and must be removedThey can be replaced by oxygen icons in a small size (11px?). Many more are available from Wikimedia Commons - details to be added here.
* Les smiley ASCII génèrent des problèmes et doivent être supprimésIls peuvent être remplacés par des icônes Oxygen en petite taille (11pixels ?). Mais on en trouve beaucoup plus sur Wikimedia Commons - ajouter ici des précisions.


* Internal links in the form <nowiki>[[Translation Workflow]]</nowiki> should be edited to the complete form, showing link, then visible text such as <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>
* Les liens internes du type <nowiki>[[Translation Workflow]]</nowiki> doivent être modifiés en totalité, en montrant le lien, puis le texte visible de la manière suivante <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>


* Many styles have been used to display input text, including <nowiki><code>, <pre></nowiki> and tables and boxes. Text intended to be input by the user should use the Input template, <nowiki>{{Input|1=input text (can be multi-line or single)}}</nowiki>. You can still use <nowiki><code></nowiki> for very short input, if you don't want the text to appear on a separate line.  
* Plusieurs styles ont été utilisés pour afficher le texte fourni en entrée, en incluant <nowiki><code>, <pre></nowiki> ainsi que les tableaux et les boîtes. Le texte rentré par l'utilisateur doit utiliser le modèle Input, <nowiki>{{Input|1=texte à saisir (sur une ou plusieurs lignes)}}</nowiki>. Vous pouvez encore utiliser <nowiki><code></nowiki> pour toutes les entrées courtes, si vous ne voulez pas voir le texte appraître sur une ligne séparée.  


* Output from terminal and error messages have been similarly marked with a variety of methods. These should be replaced with the Output template, <nowiki>{{Output|1=terminal output}}</nowiki>
* Les sorties sur terminal et les messages d'erreur ont été marqués d'une manière similaire avec des méthodes diverses. Elles doivent être remplacées par le modèle Output , <nowiki>{{Output|1=sortie terminal}}</nowiki>


* Every page should end with a Category statementThese must be standardized categoriesA current list of categories can be found on any of the translators' pages linked from [[Translation_Help_Needed|this language page]]
* Chaque page doit se terminer par une ligne CatégorieIl s'agit de catégories standardiséesLa liste courante des catégories peut être trouvée sur toute page du traducteur liée à [[Translation_Help_Needed|cette page de langue]]


* Make sure that there are no unbalanced brackets in any section. If you find unbalanced brackets then add the missing bracket(s) &mdash; possibly in a comment like this: {{Input|1=<nowiki><!--(--> a)</nowiki>}}
* Assurez-vous que dans toutes les sections, il n'y ait pas de parenthèses ouvertes et non fermées. Si vous trouvez des parenthèses ouvertes non fermées, ajoutez la ou les parenthèses fermantes correspondantes &mdash; ce qui peut se faire à l'iade d'un commentaire comme dans : {{Input|1=<nowiki><!--(--> a)</nowiki>}}


* There should be a blank line between bullets in lists. See the sections on lists beginning with  [[Special:myLanguage/Toolbox#Bulleted Lists|Bulleted Lists]].
* Il doit y avoir une ligne blanche entre chaque puces des listes. Voir les sections concernant les listes commençant par [[Special:myLanguage/Toolbox#Bulleted Lists|Listes à puces]].


* Tables should be split in a similar manner, so that there is a blank line between each row. The first and last items will need to have curly braces balanced.
* Les tableaux doivent être segmentés de la même manière, de sorte qu'il y ait une ligne vide entre chaque rangée. Le premier et le dernier élément devront avoir des accolades appairées.


== Stage 2 - Guide to new markup ==
== Etape 2 - Guide du nouveau marquage ==


=== Marking Links for Translation ===
=== Liens de marquage pour les traductions ===


* A stand-alone link, such as the application-names in Applications/Internet, should use the form <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark &lt;/translate>]]</nowiki>
* Un lien indépendant, tel les noms d'application dans Applications/Internet, doivent utiliser la forme <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark &lt;/translate>]]</nowiki>
* Where the link is within a sentence the whole of the link should be kept within the translatable message.
* Là où le lien est inclus une phrase;  la totalité du lien doit faire partie du message à traduire.


=== Special Tags ===
=== Balises spéciales ===


* Identify all keyboard key-names, and tag, e.g. <nowiki><keycap>Enter</keycap></nowiki>
* identifiez tous les noms des touches du clavier, et leur label, par exemple <nowiki><keycap>Entrée</keycap></nowiki>
* Include concurrent keypresses in the <nowiki><keycap></nowiki> tag, e.g. <keycap>Ctrl + Alt + F1</keycap>. Note that the separator is (space)+(space)
* incluez les touches actuellement pressées dans le <nowiki><keycap></nowiki> label, par exemple <keycap>Ctrl + Alt + F1</keycap>. Remarquez que le séparateur est (espace)+(espace)
* Treat menu sequences in a similar manner, using the <nowiki><menuchoice></nowiki> tag, e.g.<menuchoice>System Settings -> Account Details -> Social Desktop</menuchoice>.  Note that the separator is (space)->(space)
* traitez les séquences de menu de manière similaire, en utilisant le <nowiki><menuchoice></nowiki> label, c'est à dire <menuchoice>Configuration du système -> Détails du compte -> Bureau social</menuchoice>.  Remarquez que le séparateur est (espace)->(espace)


{{Warning|1=<span style="color:red">NEVER</span> add translate section tags (the ones that look like <nowiki>< !--T:18-- ></nowiki>).  The software will do any handling of tags that is required, and manually changing them will break the system.}}
{{Warning/fr|1=<span style="color:red">NE JAMAIS</span> ajouter de balises de section de traduction (celles qui ressemblent à <nowiki>< !--T:18-- ></nowiki>).  Le logiciel se charge lui-même de gérer les balises nécessaires, et le fait de les modifier manuellement risque de désynchroniser le système.}}


=== Bold type ===
=== Type gras ===


* Identify program names and mark them as bold type, e.g. '''Klipper'''
* identifiez les noms de programme et marquez-les en gras, par exemple '''Klipper'''
* Identify labels and names that cannot be changed by the user, and mark them as bold type.
* identifiez les étiquettes et les noms qui ne doivent pas être changés par l'utilisateur, et écrivez-les en gras.
* Remove any bold type marking that were previously entered, but do not match this guideline.  (See below for emphasizing a word or phrase.)
* enlevez toute mise en gras entrée précédemment, et qui ne satisferait pas ces règles (voir ci-dessous pour mettre en valeur un mot ou une phrase).
* Window captions and Icon labels are also marked as bold type.
* les légendes des fenêtres et les étiquettes des icônes sont aussi marquées en gras.


=== Italics ===
=== Italliques ===


* Italics can be used to give emphasis as you might in non-technical writing
* Vous pouvez utiliser l'italique pour insister sur un terme, comme vous le feriez dans un texte non-technique
* Use italics on the first appearance of an unfamiliar word or phrase, and if possible link it to #Glossary or a dictionary entry.
* Utilisez l'italique la première fois qu'un mot ou qu'une phrase à définir apparaissent, ajoutez si possible un lien vers le #Glossaire ou une entrée du dictionnaire.
* When referencing other (external) works, titles are italicized.
* Si vous faites référence à d'autres travaux (externes), les titres sont également mis en italique.


=== Combined Bold and Italics ===
=== Gras et italliques combinés ===


* This should only be used in the context of an example where the user has to substitute text, e.g. "Your new addressbook records are in <tt>/home/</tt>'''''user'''''<tt>/share/contacts</tt>"
* Ceci ne devrait être utilisé que dans le contexte d'un exemple où l'utilisateur doit substituer du texte, par exemple "Vos nouveaux enregistrements du carnet d'adresses sont dans <tt>/home/</tt>'''''user'''''<tt>/share/contacts</tt>"


{{Tip|1=Simplified definitions - ''Programs'' are launched by users, ''components'' are used by programs}}
{{Tip/fr|1=Définitions simplifiées - les ''programmes'' sont lancés par les utilisateurs, les ''composants'' sont utilisés par les programmes}}


== Issues that cause Translate problems ==
== Sujets posant des problèmes de traduction ==


Several issues have been identified and discussed, and solutions proposed in the following sections:
Plusieurs problèmes ont été identifiés et discutés; les solutions sont proposées dans les sections suivantes :


* [[Typographical_Guidelines#Lists|Splitting lists for readability]]
* [[Typographical_Guidelines#Lists|Découpe des listes pour améliorer la lisibilité]]
* [[Typographical_Guidelines#Keeping_things_together|Other "readability" breaks]]
* [[Typographical_Guidelines#Keeping_things_together|Autres points concernant la "lisibilité"]]
* [[Typographical_Guidelines#Unbalanced_brackets|Brackets split across sections]]
* [[Typographical_Guidelines#Unbalanced_brackets|Parenthèses couvrant plusieurs sections]]


These are usually noticed after the first markup, and it may be necessary to re-arrange spacing and/or structure to avoid the problems.
Ceux-ci sont généralement remarqués après le premier balisage, et il peut être nécessaire de réarranger l'espacement et/ou la structure pour éviter les problèmes.


== Almost finished ==
== Presque la fin ==


* In the summary field at the bottom, enter that you are doing a markup edit.
* dans le champ résumé, en bas, indiquez que vous avez fait des modifications concernant le marquaget.
* Use <menuchoice>Preview</menuchoice> and read through the whole of your workIf you are satisfied, save the page.
* utilisez <menuchoice>Aperçu</menuchoice> et relisez l'ensemble de votre travailSi cela vous convient, enregistrez la page.
* Use [[Special:myLanguage/ReadyForTranslation|this page]] to request release - you can add the URL of the page you have editedPasting your link there tells us that you believe the page to be ready for translators to work with. We will scan it, and if satisfied we will enable it for translation.
* utilisez [[Special:myLanguage/ReadyForTranslation|cette page]] pour demander la publication - vous pouvez ajouter l'URL de la page que vous avez modifiéEn insérant le lien à cet endroit vous nous confirmerez que cette page est prête à être passée aux traducteurs. Nous l'analyserons et si elle est correcte nous l'activerons pour la traduction.


[[Category:Translator_Help]]
[[Category:Translator_Help]]

Latest revision as of 22:45, 18 August 2019

Outils disponibles

  • Règles typographiques normalise le balisage pour une utilisation en traduction, soit vers les manuels officiels (DocBook), soit vers d'autres langues. Veuillez vous y référer fréquemment, car le balisage sera affiné pour correspondre aux besoins des traducteurs.

Etape 1 du travail

Corriger l'ancien marquage

  • Vérifiez que chaque titre de section ou de sous-section est suivi d'une ligne vide.
  • De nombreuses pages comportent des indentations. Ceci a été introduit dans les documents antérieurs de mediawiki, mais n'est plus acceptable car cela pose des problèmes pour l'exportation vers d'autres formats, veuillez donc réorganiser, en utilisant uniquement des retraits simples. Les puces peuvent continuer à être utilisées imbriquées.
  • Les smiley ASCII génèrent des problèmes et doivent être supprimés. Ils peuvent être remplacés par des icônes Oxygen en petite taille (11pixels ?). Mais on en trouve beaucoup plus sur Wikimedia Commons - ajouter ici des précisions.
  • Les liens internes du type [[Translation Workflow]] doivent être modifiés en totalité, en montrant le lien, puis le texte visible de la manière suivante [[Special:myLanguage/Translation_Workflow|Translation Workflow]]
  • Plusieurs styles ont été utilisés pour afficher le texte fourni en entrée, en incluant <code>, <pre> ainsi que les tableaux et les boîtes. Le texte rentré par l'utilisateur doit utiliser le modèle Input, {{Input|1=texte à saisir (sur une ou plusieurs lignes)}}. Vous pouvez encore utiliser <code> pour toutes les entrées courtes, si vous ne voulez pas voir le texte appraître sur une ligne séparée.
  • Les sorties sur terminal et les messages d'erreur ont été marqués d'une manière similaire avec des méthodes diverses. Elles doivent être remplacées par le modèle Output , {{Output|1=sortie terminal}}
  • Chaque page doit se terminer par une ligne Catégorie. Il s'agit de catégories standardisées. La liste courante des catégories peut être trouvée sur toute page du traducteur liée à cette page de langue
  • Assurez-vous que dans toutes les sections, il n'y ait pas de parenthèses ouvertes et non fermées. Si vous trouvez des parenthèses ouvertes non fermées, ajoutez la ou les parenthèses fermantes correspondantes — ce qui peut se faire à l'iade d'un commentaire comme dans :
    <!--(--> a)
  • Il doit y avoir une ligne blanche entre chaque puces des listes. Voir les sections concernant les listes commençant par Listes à puces.
  • Les tableaux doivent être segmentés de la même manière, de sorte qu'il y ait une ligne vide entre chaque rangée. Le premier et le dernier élément devront avoir des accolades appairées.

Etape 2 - Guide du nouveau marquage

Liens de marquage pour les traductions

  • Un lien indépendant, tel les noms d'application dans Applications/Internet, doivent utiliser la forme [[Special:myLanguage/Ark|<translate>Ark </translate>]]
  • Là où le lien est inclus une phrase; la totalité du lien doit faire partie du message à traduire.

Balises spéciales

  • identifiez tous les noms des touches du clavier, et leur label, par exemple <keycap>Entrée</keycap>
  • incluez les touches actuellement pressées dans le <keycap> label, par exemple Ctrl + Alt + F1. Remarquez que le séparateur est (espace)+(espace)
  • traitez les séquences de menu de manière similaire, en utilisant le <menuchoice> label, c'est à dire Configuration du système -> Détails du compte -> Bureau social. Remarquez que le séparateur est (espace)->(espace)
Attention
NE JAMAIS ajouter de balises de section de traduction (celles qui ressemblent à < !--T:18-- >). Le logiciel se charge lui-même de gérer les balises nécessaires, et le fait de les modifier manuellement risque de désynchroniser le système.


Type gras

  • identifiez les noms de programme et marquez-les en gras, par exemple Klipper
  • identifiez les étiquettes et les noms qui ne doivent pas être changés par l'utilisateur, et écrivez-les en gras.
  • enlevez toute mise en gras entrée précédemment, et qui ne satisferait pas ces règles (voir ci-dessous pour mettre en valeur un mot ou une phrase).
  • les légendes des fenêtres et les étiquettes des icônes sont aussi marquées en gras.

Italliques

  • Vous pouvez utiliser l'italique pour insister sur un terme, comme vous le feriez dans un texte non-technique
  • Utilisez l'italique la première fois qu'un mot ou qu'une phrase à définir apparaissent, ajoutez si possible un lien vers le #Glossaire ou une entrée du dictionnaire.
  • Si vous faites référence à d'autres travaux (externes), les titres sont également mis en italique.

Gras et italliques combinés

  • Ceci ne devrait être utilisé que dans le contexte d'un exemple où l'utilisateur doit substituer du texte, par exemple "Vos nouveaux enregistrements du carnet d'adresses sont dans /home/user/share/contacts"
Astuce
Définitions simplifiées - les programmes sont lancés par les utilisateurs, les composants sont utilisés par les programmes


Sujets posant des problèmes de traduction

Plusieurs problèmes ont été identifiés et discutés; les solutions sont proposées dans les sections suivantes :

Ceux-ci sont généralement remarqués après le premier balisage, et il peut être nécessaire de réarranger l'espacement et/ou la structure pour éviter les problèmes.

Presque la fin

  • dans le champ résumé, en bas, indiquez que vous avez fait des modifications concernant le marquaget.
  • utilisez Aperçu et relisez l'ensemble de votre travail. Si cela vous convient, enregistrez la page.
  • utilisez cette page pour demander la publication - vous pouvez ajouter l'URL de la page que vous avez modifié. En insérant le lien à cet endroit vous nous confirmerez que cette page est prête à être passée aux traducteurs. Nous l'analyserons et si elle est correcte nous l'activerons pour la traduction.