Typographical Guidelines/fr: Difference between revisions

From KDE Wiki Sandbox
(Created page with "Si vous avez besoin d'un saut de lgne au milieu d'une section, la meilleure manière d'y parvenir sans créer d'autres unités est d'utiliser <nowiki><br /></nowiki> à la fin...")
No edit summary
 
(63 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages />
<languages />


''D'autres pages expliquent [[Special:myLanguage/PageLayout|Mise en page]] et [[Special:myLanguage/Toolbox|Boîte à outils]] avec des exemples de code.''
''D'autres pages expliquent la [[Special:myLanguage/PageLayout|Mise en page]] et la [[Special:myLanguage/Toolbox|syntaxe]] avec des exemples de code.''


<span class="mw-translate-fuzzy">
{{Remember/fr|2=Important|1=Adhérer à ces règles typograhiques assurera que votre documentation puisse être exportée précisement et facilement afin d'être traduite. Certaines règles peuvent ne pas être applicables pour d'autres langues. Elles sont donc notées sur des pages spécifiques par langue,  voir [[Special:myLanguage/Translation_Workflow|Processus de Traduction]].  Si cette page n'existe pas dans votre langue, veuillez l'ajouter et y écrire les règles.}}
{{Remember|3=Important|1=Adhérer à ces règles typograhiques assurera que votre documentation puisse être exportée précisement et facilement afin d'être traduite. Certaines règles peuvent ne pas être applicables pour d'autres langues. Elles sont donc notées sur des pages spécifiques par langue,  voir [[Special:myLanguage/Translation_Workflow|Processus de Traduction]].  Si cette page n'existe pas dans votre langue, veuillez l'ajouter et y écrire les règles.}}
</span>


==Texte en Gras==
==Texte en Gras==
Line 31: Line 29:
* Les manuels de KDE sont au format ''Docbook''.
* Les manuels de KDE sont au format ''Docbook''.


{{Tip|1=Les ''Programmes'' sont lancés par les utilisateurs, les ''composants'' sont utilisés par les programmes}}
{{Tip/fr|1=Les ''Programmes'' sont lancés par les utilisateurs, les ''composants'' sont utilisés par les programmes}}


==Texte en Gras et Italique Combiné==
==Texte en Gras et Italique Combiné==
Line 43: Line 41:
==Texte mono-espacé==
==Texte mono-espacé==


Le code devrait être présenté sous la forme de texte mono-espacé, en général dans une boîte, comme ci-dessous. Le texte saisi sera sur un fond jaune pale, le texte affiché sera sur un fond gris-violet.   
Le code devrait être présenté sous la forme de texte mono-espacé, en général dans une boîte, comme ci-dessous. Le texte représentant des données d'entrée sera sur un fond jaune pale, le texte représentant des données de sortie sera sur un fond gris-violet.   


* Le code, que ce soit des lignes simples ou des blocs, utilise des modèles pour assurer son uniformité
* Le code, que ce soit des lignes simples ou des blocs, utilise des modèles pour assurer son uniformité


  * Utilisez le modèle Input comme ceci: {{Input|1=<nowiki>{{Input|1=<nowiki>
  * Utilisez le modèle Input comme ceci: {{Input/fr|1=<nowiki>{{Input/fr|1=<nowiki>
qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
rm -r ~/.kde/share/apps/nepomuk
rm -r ~/.kde/share/apps/nepomuk
rm -r ~/.kde4/share/apps/nepomuk
rm -r ~/.kde4/share/apps/nepomuk
nepomukserver&lt;/nowiki>}}</nowiki>}} Il s'affichera comme cela: {{Input|1=<nowiki>
nepomukserver&lt;/nowiki>}}</nowiki>}} Il s'affichera comme cela: {{Input/fr|1=<nowiki>
qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
rm -r ~/.kde/share/apps/nepomuk
rm -r ~/.kde/share/apps/nepomuk
Line 58: Line 56:




* Output fonctionne de la même manière : {{Output|1=<nowiki>{{Output|1=<nowiki>l'affichage du terminal est aussi affiché comme du code, mais sur fond gris&lt;/nowiki>}}</nowiki>}} qui s'affichera ainsi {{Output|1=<nowiki>l'affichage du terminal est aussi affiché comme du code, mais sur fond gris</nowiki>}}
* Output fonctionne de la même manière : {{Output/fr|1=<nowiki>{{Output/fr|1=<nowiki>l'affichage du terminal est aussi affiché comme du code, mais sur fond gris&lt;/nowiki>}}</nowiki>}} qui s'affichera ainsi {{Output/fr|1=<nowiki>l'affichage du terminal est aussi affiché comme du code, mais sur fond gris</nowiki>}}


{{Note|1=Notez l'utilisation de <code><nowiki>1=<nowiki> du texte &lt;/nowiki></nowiki></code> pour éviter les situations qui rompent le format d'affichage}}
{{Note/fr|1=Notez l'utilisation de <code><nowiki>1=<nowiki> du texte &lt;/nowiki></nowiki></code>. Parfois, des parties d'affichage peuvent déranger l'analyseur wiki.
Le bloc <code><nowiki><nowiki>...</nowiki></nowiki></code> vous protège contre cet effet. Également si quelque chose comme <tt>n=</tt> apparaît dans le corps du texte, l'analyseur du modèle peut être perturbé. Le <code>1=</code> initial protège contre cet effet. Sinon ce marquage n'a pas d'effet. En résumé : il ne peut pas faire de mal, et il protège contre l'éventualité de dommages collatéraux.}}


* Utiliser les modèles Input ou Output sur une nouvelle ligne rompra le format d'affichage à l'intérieur des listes. Continuez simplement sur la même ligne si vous avez besoin de corriger cela.
* Utiliser les modèles Input ou Output sur une nouvelle ligne rompra le format d'affichage à l'intérieur des listes. Continuez simplement sur la même ligne si vous avez besoin de corriger cela.


* Vous pouvez aussi combiner les zones de saisie/et d'affichage avec [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi syntaxhiglighting]. Une zone de saisie comme celle-là  {{Input/fr|1=<nowiki>{{Input/fr|<syntaxhighlight lang="php" line>
* Vous pouvez aussi combiner les zones de saisie/et d'affichage avec [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi syntaxhiglighting]. An input area like this {{Input|1=<nowiki>{{Input|<syntaxhighlight lang="php" line>
# Initialisation du code commun
# Initialisation du code commun
$preIP = dirname( __FILE__ );
$preIP = dirname( __FILE__ );
Line 76: Line 74:
</syntaxhighlight>}}
</syntaxhighlight>}}


* Les extraits de code très courts peuvent être conservés dans la ligne en utilisant  {{Input|1=<nowiki><code></code></nowiki>}}  Le code It will <code>s'affichera</code> comme cela. Notez que si la balise <nowiki><code></nowiki> est immédiatement précédée d'un retour à la ligne, elle ne s'affichera pas correctement.
* Les extraits de code très courts peuvent être conservés dans la ligne en utilisant  {{Input/fr|1=<nowiki><code></code></nowiki>}}  Le code <code>s'affichera</code> comme cela. Notez que si la balise <nowiki><code></nowiki> est immédiatement précédée d'un retour à la ligne, elle ne s'affichera pas correctement.


* {{Input|1=<nowiki>&lt;tt> &lt;/tt></nowiki>}} est utile pour afficher les noms de fichiers et les chemins, de la manière suivante <tt>  un/chemin/vers/ici </tt>
* Les noms de fichiers et les chemins doivent utiliser le modèle de chemin Path (voir ci-dessous).


{{Warning|1=Le code en ligne devrait être court ! Cela fait bizarre, et moche, si une ligne de code est séparée en deux lignes. Et rappelez-vous : même si cela à l'air bon dans votre navigateur, tout le monde n'a pas la même taille d'écran. Et même si votre texte à l'air bon sur toutes les tailles d'écran, les traductions peuvent toujours en souffrir. Il est recommandé d'utiliser le modèle Input pour le code à moins que celui-ci ne soit vraiment ourt.}}
{{Warning/fr|1=Le code en ligne devrait être court ! Cela fait bizarre, et moche, si une ligne de code est séparée en deux lignes. Et rappelez-vous : même si cela à l'air bon dans votre navigateur, tout le monde n'a pas la même taille d'écran. Et même si votre texte à l'air bon sur toutes les tailles d'écran, les traductions peuvent toujours en souffrir. Il est recommandé d'utiliser le modèle « Input » pour le code à moins que celui-ci ne soit vraiment court.}}


{{Note|1=Veuiller éviter d'utiliser les commands shell ou d'autres mots-clefs de programmation comme des verbes. Ils ne se traduisent pas très bien. Traitez toujours les mots-clefs comme des noms propres.}}
{{Note/fr|1=Veuiller éviter d'utiliser les commands shell ou d'autres mots-clefs de programmation comme des verbes. Ils ne se traduisent pas très bien. Traitez toujours les mots-clefs comme des noms propres.}}


==Citations==
== Citations ==


Les tags <nowiki><blockquote></nowiki> et <nowiki></blockquote></nowiki> doivent être utilisés lorsque d'autres travaux ou d'autres pages sont cités. Ils produisent une police italique proportionelle, avec un espacement.
Les balises <nowiki><blockquote></nowiki> et <nowiki></blockquote></nowiki> doivent être utilisées lorsque d'autres travaux ou d'autres pages sont cités. Ils produisent une police italique proportionelle, avec un espacement.


<blockquote>Voici un exemple de ce que vous obtenez en utilisant les balises blockquote.</blockquote>
<blockquote>Voici un exemple de ce que vous obtenez en utilisant les balises blockquote.</blockquote>
Line 97: Line 95:


Le texte en gras devrait être évité dans le texte contenu dans ces modèles. Le texte en italique pour mettre en valeur un passage peut toujours être utilisé, mais avec parcimonie afin de maximiser son effet.
Le texte en gras devrait être évité dans le texte contenu dans ces modèles. Le texte en italique pour mettre en valeur un passage peut toujours être utilisé, mais avec parcimonie afin de maximiser son effet.
 
<span id="Lists"></span>
==Listes==
==Listes==


De nombreuses listes sont disponibles pour vos pages &mdash; à puces, numérotées ou détaillées. Vous pouvez touver tous les détails sur la [[Special:myLanguage/Toolbox#Bulleted Lists|Boîte à Outils]].
De nombreuses listes sont disponibles pour vos pages &mdash; à puces, numérotées ou détaillées. Vous pouvez touver tous les détails sur la page de  la [[Special:myLanguage/Toolbox#Bulleted Lists|Boîte à Outils]].
 
<span id="Keeping things together"></span>
==Garder les contenus ensemble==
==Garder les contenus ensemble==


Après que votre texte ait été écrit, une balise est automatiquement aajoutée par le système de traduction. Cela signifie que chaque fois qu'il rencontre une ligne vide, il démarre une nouvelle unité. quand votre texte est présenté aux traducteurs, ils examinent habituellement une unité à la fois, aussi il est important de ne pas laisser de ligne vide au milieu d'un contenu qui doit être traité comme un tout. Normalement un paragraphe entier doit être conservé dans une unité simple ; et jamais une phrase ne doit être coupée entre deux unités !
Après que votre texte ait été écrit, une balise est automatiquement ajoutée par le système de traduction. Cela signifie que chaque fois qu'il rencontre une ligne vide, il démarre une nouvelle unité. quand votre texte est présenté aux traducteurs, ils examinent habituellement une unité à la fois, aussi il est important de ne pas laisser de ligne vide au milieu d'un contenu qui doit être traité comme un tout. Normalement un paragraphe entier doit être conservé dans une unité simple ; et jamais une phrase ne doit continuer dans l'unité qui suit !
 
Si vous avez besoin d'un saut de lgne au milieu d'une section, la meilleure manière d'y parvenir sans créer d'autres unités est d'utiliser <nowiki><br /></nowiki> à la fin de la ligne où vous souhaitez placer un saut (pas une nouvelle linge). si un espace est nécessaire entre les lignes ajoutez <nowiki><br /><br /></nowiki>.


==Parenthèses non-équilibrées==
Si vous avez besoin d'un saut de ligne au milieu d'une section, la meilleure manière d'y parvenir sans créer d'autres unités est d'utiliser <nowiki><br /></nowiki> à la fin de la ligne où vous souhaitez placer un saut (pas une nouvelle ligne). Si un espace est nécessaire entre les lignes ajoutez <nowiki><br /><br /></nowiki>.
<span id="Unbalanced brackets"></span>
== Parenthèses non-appairées ==


<!--}}-->Le système de traduction marque une unité traduite comme non traduitesi elle contient n'importe quelle sorte de parenthèses non-équilibrées. Si vous avez besoin d'avoir des parenthèses non-équilibrées dans votre texte, veuillez ajouter une parenthèse d'quilibre dans une balise de commentaire, comme ceci : <br />
<!--}}-->Le système de traduction marque une unité traduite comme non traduite si elle contient n'importe quelle sorte de parenthèses non-équilibrées. Si vous avez besoin d'avoir des parenthèses non-équilibrées dans votre texte, veuillez ajouter une parenthèse d'équilibre dans une balise de commentaire, comme ceci : <br />
{{Input|1=
{{Input/fr|1=
<nowiki><!-- }} -->{{ Une ligne  
<nowiki><!-- }} -->{{ Une ligne  


Une autre ligne}}<!-- {{ --></nowiki>
Une autre ligne}}<!-- {{ --></nowiki>
}}<!--{{-->
}}<!--{{-->
Cela vaut pour toutes sortes de parenthèses, même pour les parenthèses ordinaires. (bien entendu, il est préférable d'aviter les lignes vides à l'intérieur d'une balise d'unité - voir [[Special:myLanguage/Typographical_Guidelines#Keeping things together|Garder les contenus ensembles]].)
Cela vaut pour toutes sortes de parenthèses, même pour les parenthèses ordinaires (bien entendu, il est préférable d'éviter les lignes vides à l'intérieur d'une d'unité déja balisée - voir [[Special:myLanguage/Typographical_Guidelines#Keeping things together|Garder les contenus ensembles]]) .


==Balises spéciales==
== Balises spéciales ==
 
=== Raccourcis clavier et sélection de menu ===


* <nowiki> <keycap></nowiki> et <nowiki> </keycap> </nowiki> montre les noms principaux des touches (du clavier) comme <keycap>Entrée</keycap>
* <nowiki> <keycap></nowiki> et <nowiki> </keycap> </nowiki> montre les noms principaux des touches (du clavier) comme <keycap>Entrée</keycap>
* <nowiki><keycap></keycap></nowiki> peut être utilisée avec un groupe de touches en parallèle, comme <keycap>Ctrl + Alt + F1</keycap> pour lancer un terminal virtuel. (Notez que "(space)+(space)" est utilisé pour ier les touches devant être pressées en parallèle).
* <nowiki><keycap></keycap></nowiki> peut être utilisé avec un groupe de touches en parallèle, comme <keycap>Ctrl + Alt + F1</keycap> pour lancer un terminal virtuel. (Notez que "(space)+(space)" est utilisé pour ier les touches devant être pressées en parallèle).
* Les séquences de choix de menu doivent être utilisées ainsi <nowiki> <menuchoice> </nowiki>et <nowiki> </menuchoice> </nowiki> par exemple <menuchoice> Vue -> Liste des messages -> Agrégation -> Liste de courrier standard </menuchoice>
* Les séquences de choix de menu doivent être utilisées ainsi <nowiki> <menuchoice> </nowiki>et <nowiki> </menuchoice> </nowiki> par exemple <menuchoice> Vue -> Liste des messages -> Agrégation -> Liste de courrier standard </menuchoice>
* En général, si l'utilisateur a besoin de choisir un élément, même s'il n'est pas dans un menu, la balise <nowiki><menuchoice></menuchoiсe></nowiki> doit être utilisée.
* En général, si l'utilisateur a besoin de choisir un élément, même s'il n'est pas dans un menu, la balise <nowiki><menuchoice></menuchoiсe></nowiki> doit être utilisée.
* Si vous contribuez à une page du manuel, vous devez toujours utiliser le balisage ci-dessus. Pour les autres pages au contraire, il existe un modèle pour entrer les sélections de menu : <nowiki>{{Menu|Top|sub|...}}</nowiki>. Fx, <nowiki>{{Menu | View | Message List | Aggregation | Standard Mailing List}}</nowiki> fournissant {{Menu | View | Message List | Aggregation | Standard Mailing List}}
* Si vous voulez utiliser <nowiki><menuchoice></nowiki> et avoir &rarr; au lieu de ->, vous écrirez <code>& rarr;</code> (mais sans espace entre '&' et r!) comme dans <nowiki><menuchoice> View</menuchoice> & rarr; <menuchoice>Message List</menuchoice></nowiki> qui génèrera <menuchoice> View</menuchoice> &rarr; <menuchoice>Message List</menuchoice>.  Notez, que le caractère &rarr; doit être en dehors des balises menuchoice pour s'afficher correctement.
=== Chemin de fichier et fichiers ===
Traditionnellement, on a écrit les noms des fichiers et des chemins en utilisant les balises <nowiki><tt>...</tt></nowiki> .
{{Input|1=<nowiki><tt>~/.kde/share</tt></nowiki>}}
donne
{{output|1=<tt>~/.kde/share</tt>}}
Il existe désomais un modèle pour faire cela, qui doit être utilisé pour le nouveau contenu des pages ordinaires de UserBase (mais non pas pour les pages des manuels, par pitié !) :
{{Input|1=<nowiki>{{Path | ~/.kde/share }}</nowiki>}}
génère :
{{Output|1={{Path | ~/.kde/share }} }}


== le Pipe problématique ==
== Le pipe '|' problématique ==


Dans certaines situations le symbole pipe ne peut pas être utilisé - par exemple quand on ajoute des paraamètres dans un modèle. Dans de tels cas, veuillez utiliser <nowiki>{{!}}</nowiki> qui s'affichera comme un symbole pipe. Par exemple, ssi vous voulez afficher une ligne de commande contenant le caractère pipe en utilisant le modèle <nowiki>{{Input|...}}</nowiki>, la manière la plus simple de le faire est celle-ci : <code><nowiki>{{Input|1=cmd1 {{!}} cmd2}}</nowiki></code> qui affice {{Input|1=cmd1 {{!}} cmd2}}
Dans certaines situations le symbole pipe ne peut pas être utilisé - par exemple quand on ajoute des paramètres à un modèle. Dans de tels cas, veuillez utiliser <nowiki>{{!}}</nowiki> qui s'affichera comme un symbole pipe. Par exemple, si vous voulez afficher une ligne de commande contenant le caractère pipe en utilisant le modèle <nowiki>{{Input/fr|...}}</nowiki>, la manière la plus simple de le faire est celle-ci :
<code><nowiki>{{Input/fr|1=cmd1 {{!}} cmd2}}</nowiki></code>
qui affiche : 
{{Input/fr|1=cmd1 {{!}} cmd2}}


<br />si vous écrivez juste <code><nowiki>{{Input|cmd1 | cmd2}}</nowiki></code> vous obtiendrez à la place {{Input|cmd1 | cmd2}}
<br />Si vous écrivez juste <code><nowiki>{{Input/fr|cmd1 | cmd2}}</nowiki></code> vous obtiendrez à la place {{Input/fr|cmd1 | cmd2}}
car le problème est que <code>cmd2</code> est considéré comme un second paramètre pour le modèle, qui dans ce cas n'est pas utilisé.
car le problème est que <code>cmd2</code> est considéré comme un second paramètre pour le modèle, qui dans ce cas n'est pas utilisé.


Dans baucoup de cas, vous pouvez aussi entourer le texte contenant le caractère pipe entre des balises <nowiki><nowiki>...</nowiki> </nowiki>, comme ceci <code><nowiki>{{Input|1=<nowiki>cmd1 | cmd2</nowiki></nowiki><nowiki>}}</nowiki></code>, ce qui affichera également {{Input|1=<nowiki>cmd1 | cmd2</nowiki>}}
Dans beaucoup de cas, vous pouvez aussi entourer le texte contenant le caractère pipe entre des balises <nowiki><nowiki>...</nowiki> </nowiki>, comme ceci <code><nowiki>{{Input/fr|1=<nowiki>cmd1 | cmd2</nowiki></nowiki><nowiki>}}</nowiki></code>, ce qui affichera également {{Input/fr|1=<nowiki>cmd1 | cmd2</nowiki>}}


==Contenu traduisible==
==Contenu traduisible==


tout ce qui est traduisible est contenu entre les balises <nowiki><translate> et </translate></nowiki> . Dans beaucoup de cas, des images peuvent être contenues dans la partie traduisible, car il est parfois nécessaire d'utiliser des versions localisées des images pour expliquer un point. La règle des vignettes est "Ien cas de doute, inclus là !".
Tout ce qui est traduisible est contenu entre les balises <nowiki>&lt;translate> et &lt;/translate></nowiki> . Dans beaucoup de cas, des images peuvent être contenues dans la partie traduisible, car il est parfois nécessaire d'utiliser des versions localisées des images pour expliquer un point. La règle de précaution est "En cas de doute, incluez-les ! " .


[[Catégorie:Contribuer/fr]]
[[Category:Contribuer/fr]]

Latest revision as of 20:00, 20 May 2019

D'autres pages expliquent la Mise en page et la syntaxe avec des exemples de code.

Important
Adhérer à ces règles typograhiques assurera que votre documentation puisse être exportée précisement et facilement afin d'être traduite. Certaines règles peuvent ne pas être applicables pour d'autres langues. Elles sont donc notées sur des pages spécifiques par langue, voir Processus de Traduction. Si cette page n'existe pas dans votre langue, veuillez l'ajouter et y écrire les règles.


Texte en Gras

Utilisez le gras pour mettre en valeur

  • Les titres de fenêtres
  • Les textes fixes communs qui ne sont pas modifiables par l'utilisateur
  • Les légendes d'icônes
  • Les noms de programmes

Par exemple :

  • Surligner une sélection de texte le copiera dans Klipper.

Texte en Italique

Utilisez le texte en italique pour mettre en valeur :

  • Les mots ou phrases comme en écriture normale.
  • Les titres lorsque vous référencez d'autres travaux.
  • La première utilisation d'un mot inhabituel.

Quelques exemples :

  • Enregistrez votre travail à cet instant.
  • Les détails peuvent être trouvés dans Samba 3 par l'Exemple....
  • Les manuels de KDE sont au format Docbook.
Astuce
Les Programmes sont lancés par les utilisateurs, les composants sont utilisés par les programmes


Texte en Gras et Italique Combiné

Utilisez cette combinaison pour le texte remplaçable ou variable.

Quelques exemples :

  • Pour vous connecter à votre serveur distant, saisissez ssh nom-d'utilisateur@domaine.nom dans Konsole.
  • Dans les distributions basées sur rpm, la commande rpm -q nom_du_paquet renverra paquet-version-release.

Texte mono-espacé

Le code devrait être présenté sous la forme de texte mono-espacé, en général dans une boîte, comme ci-dessous. Le texte représentant des données d'entrée sera sur un fond jaune pale, le texte représentant des données de sortie sera sur un fond gris-violet.

  • Le code, que ce soit des lignes simples ou des blocs, utilise des modèles pour assurer son uniformité

* Utilisez le modèle Input comme ceci:

{{Input/fr|1=<nowiki>
qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
rm -r ~/.kde/share/apps/nepomuk
rm -r ~/.kde4/share/apps/nepomuk
nepomukserver</nowiki>}}

Il s'affichera comme cela:

qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit
rm -r ~/.kde/share/apps/nepomuk
rm -r ~/.kde4/share/apps/nepomuk
nepomukserver


  • Output fonctionne de la même manière :
    {{Output/fr|1=<nowiki>l'affichage du terminal est aussi affiché comme du code, mais sur fond gris</nowiki>}}
    qui s'affichera ainsi
    l'affichage du terminal est aussi affiché comme du code, mais sur fond gris
Remarque
Notez l'utilisation de 1=<nowiki> du texte </nowiki>. Parfois, des parties d'affichage peuvent déranger l'analyseur wiki. Le bloc <nowiki>...</nowiki> vous protège contre cet effet. Également si quelque chose comme n= apparaît dans le corps du texte, l'analyseur du modèle peut être perturbé. Le 1= initial protège contre cet effet. Sinon ce marquage n'a pas d'effet. En résumé : il ne peut pas faire de mal, et il protège contre l'éventualité de dommages collatéraux.


  • Utiliser les modèles Input ou Output sur une nouvelle ligne rompra le format d'affichage à l'intérieur des listes. Continuez simplement sur la même ligne si vous avez besoin de corriger cela.
  • Vous pouvez aussi combiner les zones de saisie/et d'affichage avec GeSHi syntaxhiglighting. Une zone de saisie comme celle-là
    {{Input/fr|<syntaxhighlight lang="php" line>
    # Initialisation du code commun
    $preIP = dirname( __FILE__ );
    require_once( "$preIP/includes/WebStart.php" );
    </syntaxhighlight>}}
    affichera
    # Initialisation du code commun
    $preIP = dirname( __FILE__ );
    require_once( "$preIP/includes/WebStart.php" );
    
  • Les extraits de code très courts peuvent être conservés dans la ligne en utilisant
    <code></code>
    Le code s'affichera comme cela. Notez que si la balise <code> est immédiatement précédée d'un retour à la ligne, elle ne s'affichera pas correctement.
  • Les noms de fichiers et les chemins doivent utiliser le modèle de chemin Path (voir ci-dessous).
Attention
Le code en ligne devrait être court ! Cela fait bizarre, et moche, si une ligne de code est séparée en deux lignes. Et rappelez-vous : même si cela à l'air bon dans votre navigateur, tout le monde n'a pas la même taille d'écran. Et même si votre texte à l'air bon sur toutes les tailles d'écran, les traductions peuvent toujours en souffrir. Il est recommandé d'utiliser le modèle « Input » pour le code à moins que celui-ci ne soit vraiment court.


Remarque
Veuiller éviter d'utiliser les commands shell ou d'autres mots-clefs de programmation comme des verbes. Ils ne se traduisent pas très bien. Traitez toujours les mots-clefs comme des noms propres.


Citations

Les balises <blockquote> et </blockquote> doivent être utilisées lorsque d'autres travaux ou d'autres pages sont cités. Ils produisent une police italique proportionelle, avec un espacement.

Voici un exemple de ce que vous obtenez en utilisant les balises blockquote.

Texte dans les En-têtes de Section

Même si un des critères ci-dessus peut être atteint, n'utilisez pas de texte en gras dans les en-têtes de section ou dans les liens.

Texte dans les Modèles Information, Note, Tip ou Warning

Le texte en gras devrait être évité dans le texte contenu dans ces modèles. Le texte en italique pour mettre en valeur un passage peut toujours être utilisé, mais avec parcimonie afin de maximiser son effet.

Listes

De nombreuses listes sont disponibles pour vos pages — à puces, numérotées ou détaillées. Vous pouvez touver tous les détails sur la page de la Boîte à Outils.

Garder les contenus ensemble

Après que votre texte ait été écrit, une balise est automatiquement ajoutée par le système de traduction. Cela signifie que chaque fois qu'il rencontre une ligne vide, il démarre une nouvelle unité. quand votre texte est présenté aux traducteurs, ils examinent habituellement une unité à la fois, aussi il est important de ne pas laisser de ligne vide au milieu d'un contenu qui doit être traité comme un tout. Normalement un paragraphe entier doit être conservé dans une unité simple ; et jamais une phrase ne doit continuer dans l'unité qui suit !

Si vous avez besoin d'un saut de ligne au milieu d'une section, la meilleure manière d'y parvenir sans créer d'autres unités est d'utiliser <br /> à la fin de la ligne où vous souhaitez placer un saut (pas une nouvelle ligne). Si un espace est nécessaire entre les lignes ajoutez <br /><br />.

Parenthèses non-appairées

Le système de traduction marque une unité traduite comme non traduite si elle contient n'importe quelle sorte de parenthèses non-équilibrées. Si vous avez besoin d'avoir des parenthèses non-équilibrées dans votre texte, veuillez ajouter une parenthèse d'équilibre dans une balise de commentaire, comme ceci :

<!-- }} -->{{ Une ligne 

Une autre ligne}}<!-- {{ -->

Cela vaut pour toutes sortes de parenthèses, même pour les parenthèses ordinaires (bien entendu, il est préférable d'éviter les lignes vides à l'intérieur d'une d'unité déja balisée - voir Garder les contenus ensembles) .

Balises spéciales

Raccourcis clavier et sélection de menu

  • <keycap> et </keycap> montre les noms principaux des touches (du clavier) comme Entrée
  • <keycap></keycap> peut être utilisé avec un groupe de touches en parallèle, comme Ctrl + Alt + F1 pour lancer un terminal virtuel. (Notez que "(space)+(space)" est utilisé pour ier les touches devant être pressées en parallèle).
  • Les séquences de choix de menu doivent être utilisées ainsi <menuchoice> et </menuchoice> par exemple Vue -> Liste des messages -> Agrégation -> Liste de courrier standard
  • En général, si l'utilisateur a besoin de choisir un élément, même s'il n'est pas dans un menu, la balise <menuchoice></menuchoiсe> doit être utilisée.
  • Si vous contribuez à une page du manuel, vous devez toujours utiliser le balisage ci-dessus. Pour les autres pages au contraire, il existe un modèle pour entrer les sélections de menu : {{Menu|Top|sub|...}}. Fx, {{Menu | View | Message List | Aggregation | Standard Mailing List}} fournissant View Message List Aggregation Standard Mailing List
  • Si vous voulez utiliser <menuchoice> et avoir → au lieu de ->, vous écrirez & rarr; (mais sans espace entre '&' et r!) comme dans <menuchoice> View</menuchoice> & rarr; <menuchoice>Message List</menuchoice> qui génèrera ViewMessage List. Notez, que le caractère → doit être en dehors des balises menuchoice pour s'afficher correctement.

Chemin de fichier et fichiers

Traditionnellement, on a écrit les noms des fichiers et des chemins en utilisant les balises <tt>...</tt> .

<tt>~/.kde/share</tt>

donne

~/.kde/share

Il existe désomais un modèle pour faire cela, qui doit être utilisé pour le nouveau contenu des pages ordinaires de UserBase (mais non pas pour les pages des manuels, par pitié !) :

{{Path | ~/.kde/share }}

génère :

 ~/.kde/share 

Le pipe '|' problématique

Dans certaines situations le symbole pipe ne peut pas être utilisé - par exemple quand on ajoute des paramètres à un modèle. Dans de tels cas, veuillez utiliser {{!}} qui s'affichera comme un symbole pipe. Par exemple, si vous voulez afficher une ligne de commande contenant le caractère pipe en utilisant le modèle {{Input/fr|...}}, la manière la plus simple de le faire est celle-ci : {{Input/fr|1=cmd1 {{!}} cmd2}} qui affiche :

cmd1 | cmd2


Si vous écrivez juste {{Input/fr|cmd1 | cmd2}} vous obtiendrez à la place

cmd1 

car le problème est que cmd2 est considéré comme un second paramètre pour le modèle, qui dans ce cas n'est pas utilisé.

Dans beaucoup de cas, vous pouvez aussi entourer le texte contenant le caractère pipe entre des balises <nowiki>... </nowiki>, comme ceci {{Input/fr|1=<nowiki>cmd1 | cmd2</nowiki>}}, ce qui affichera également

cmd1 | cmd2

Contenu traduisible

Tout ce qui est traduisible est contenu entre les balises <translate> et </translate> . Dans beaucoup de cas, des images peuvent être contenues dans la partie traduisible, car il est parfois nécessaire d'utiliser des versions localisées des images pour expliquer un point. La règle de précaution est "En cas de doute, incluez-les ! " .