Comment utiliser les balises « for »
Informations de la révision
- Identifiant de la révision : 219819
- Date de création :
- Créateur : Mozinet
- Commentaire :
- Vérifiée : Non
- Prêt pour la localisation : Non
Source de la révision
Contenu de la révision
Une des plus importantes fonctionnalités de notre base de connaissances est la capacité d'afficher les instructions personnalisées pour les systèmes d'exploitation (Windows, Android…) et les versions de Firefox. Nous pouvons dire, par exemple, qu'une certaine section d'un article d'aide est pour (for en anglais) les utilisateurs de Windows, et les utilisateurs de Mac et Linux ne le verront pas. Lorsque quelqu'un accède à un article d'aide, nous détectons automatiquement le système d'exploitation et la version de Firefox qu'il utilise et nous mettons à disposition les instructions appropriées. Cet article décrit les détails sur la manière d'utiliser {for} dans les articles de la base de connaissances.
Localisation : lors de la localisation d’articles en utilisant {for} ou {/for} dans le contenu, il ne faut rien traduire qui se trouve entre les accolades { et } ! Gardez le texte original. C’est important pour que l'élément fonctionne correctement.
Table des matières
- 1 Comment changer les instructions en fonction des différents systèmes d'exploitation ou versions de Firefox
- 2 Syntaxe et comportement de base
- 2.1 Systèmes d'exploitation
- 2.2 Versions de Firefox
- 2.3 Combiner les systèmes d'exploitation et versions de Firefox
- 2.4 Conditions négatives
- 2.5 Quand le contenu est affiché
- 2.6 Abréviations de système d'exploitation et de produit
- 2.7 Contextes en ligne et bloc
- 2.8 Utiliser le bouton {for} dans l'éditeur d'article
- 3 Meilleurs pratiques pour l'utilisation de {for} dans les articles
Comment changer les instructions en fonction des différents systèmes d'exploitation ou versions de Firefox
Afin de suivre l'exemple de cet article, vous devez définir le système d'exploitation et la version de Firefox. Le sélecteur se trouve dans le panneau de droite de l’article sous Outils de modification.
Syntaxe et comportement de base
Systèmes d'exploitation
Voici la syntaxe pour afficher une image pour Windows 7/Vista :
{for win7}[[Image:vista.jpg]]{/for}
- Réglez le sélecteur sur Windows 7/Vista pour voir l'image :
- Si vous réglez le sélecteur sur Windows XP, Windows 8, Windows 10, Mac ou Linux, l'image ci-dessus ne s'affichera pas car elle n'est pas prévue pour eux.
Bien que le sélecteur Windows n'existe pas, vous pouvez écrire des instructions qui s'appliquent à toutes les versions de Windows :
{for win}[[Image:Windows Logo]]{/for}
- Réglez le sélecteur sur Windows XP, Windows 7/Vista, Windows 8 ou Windows 10 pour afficher l’image :
- Si vous réglez le sélecteur sur Mac ou Linux, l'image ci-dessus ne s'affichera pas car elle n'est pas prévue pour eux.
Versions de Firefox
Voici la syntaxe pour afficher quelque chose pour Firefox 63 et supérieur :
{for fx63}[[Image:Firefox Quantum Logo]]{/for}
- Réglez le sélecteur sur Firefox 63 ou supérieur pour voir l'image :
- Si vous réglez le sélecteur sur Firefox 62 ou inférieur, le message ci-dessus disparaît car il n'est pas prévu pour ces versions.
Afficher les instructions pour une seule version de Firefox
Pour afficher les instructions uniquement pour Firefox 63, utilisez l'opérateur « = » :
{for =fx63}[[Image:Firefox Quantum Logo]]{/for}
- L'image ne s'affiche désormais que lorsque vous réglez le sélecteur sur Firefox 63 :
Combiner les systèmes d'exploitation et versions de Firefox
Vous pouvez spécifier un système d'exploitation et une version de Firefox en les séparant par une virgule :
{for win,fx63}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}
- Réglez le sélecteur sur Windows et Firefox 63 ou supérieur pour afficher les images :
Une situation plus complexe avec un « ou » implicite peut être écrite de cette façon :
{for mac, winxp, win7, =fx61, fx63}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}
- Réglez le sélecteur sur Mac, Windows XP ou Windows 7/Vista et sur Firefox 61 ou Firefox 63 pour afficher les images :
Conditions négatives
Vous pouvez inverser une condition en la faisant précéder du mot not
. Une condition négative est vraie si et seulement si la condition est fausse. Par exemple, la condition
not fx63
est verte si la version de Firefox est inférieure à 63.
Quand le contenu est affiché
Formellement, la balise entre {for} et {/for} est affiché si ces deux conditions sont remplies :
- Le {for} n’a pas de condition pour le système d'exploitation (OS) ou a au moins une condition relative à l’OS qui soit vraie du point de vue de l’OS utilisé (ou manuellement sélectionné).
- Le {for} n'a pas de condition pour la version de Firefox ou a au moins une condition pour la version de Firefox qui soit vraie du point de vue de la version de Firefox utilisée (ou manuellement sélectionnée).
Sinon, le contenu de {for}…{/for} n'est pas affiché.
D'autres choses sont à noter :
- Les espaces après les virgules sont facultatives.
- {for} et les autres balises wiki ne fonctionnent pas dans les résumés des résultats de recherche.
- Les titres qui sont masqués par des blocs {for} n'apparaissent pas dans la table des matières de la page. Si l'utilisateur ou l'utilisatrice les fait afficher en sélectionnant manuellement la bonne combinaison d'OS et de navigateur, les entrées de la table des matières apparaissent instantanément.
Abréviations de système d'exploitation et de produit
Voici les abréviations de système d'exploitation et de produit qui peuvent être utilisées dans {for} :
- win (Windows)
- winxp (Windows XP/2000/Server 2003)
- win7 (Windows 7/Vista/Server 2008)
- win8 (Windows 8/8.1/Server 2012)
- win10 (Windows 10)
- mac (macOS)
- linux (Linux)
- fxN où N = la version de Firefox, p. ex. fx62, fx63, fx64, etc.
- mN où N = la version d’Android, p. ex. m22, m23, m24, etc.
- tbN où N = la version de Thunderbird, p. ex. tb24, tb31, tb38, etc.
Vous devez utiliser fxN dans les articles d’assistance pour Firefox, mN dans les articles d’assistance pour Android, fxosN dans les articles d’assistance pour Firefox OS et tdN dans les articles d’assistance pour Thunderbird.
Contextes en ligne et bloc
{for} peut être utilisé aussi bien dans un contexte de type en ligne ou que dans un de type bloc (au sens du HTML). La mise en forme en ligne prend effet en travaillant dans une ligne de texte :
C'est {for win}l'utilisation en ligne{/for}.
La mise en forme de type bloc est utilisée pour envelopper des paragraphes entiers, des listes ordonnées, des titres et ainsi de suite. La seule restriction est que, en utilisant la mise en forme de type bloc, le {for} et {/for} doivent être chacun sur une ligne. Autrement, ils pourraient être considéré comme une partie d'un paragraphe voisin et produire des résultats surprenants.
{for win}
C'est un bloc.
*Un
*Deux
{/for}
Utiliser le bouton {for} dans l'éditeur d'article
Quand vous modifiez un article de la base de connaissances, vous pouvez utiliser le bouton {for} dans la barre d'outils pour écrire la balise souhaitée.
- Surlignez le texte que vous voulez mettre entre les balises {for}.
- Cliquez sur dans la barre d'outils d'édition.f
- Cochez les cases des versions de Firefox et des système d'exploitation qui seront vus pour ce contenu, puis cliquez sur . Les balises personnalisées {for} seront placées autour de la section que vous avez surlignée.
Meilleurs pratiques pour l'utilisation de {for} dans les articles
Lors de la rédaction d'instructions pour différents systèmes d'exploitation, le mieux est d'écrire des phrases et paragraphes entiers pour chaque OS et version de Firefox même si cela implique de dupliquer des choses. Cela rend l'article plus facile à comprendre, à maintenir et à localiser. En temps voulu, par exemple, pour supprimer les instructions spécifiques à Firefox 3.5/3.6, ces sections pourront simplement être effacées plutôt que d'essayer de les exciser d'une section plus grande.
Exemple :
Mauvais
#{for win,linux}En haut de la fenêtre de Firefox{/for}{for mac}Sur la barre de menus{/for}, cliquez sur le {for fx35}menu {menu Outils}{/for}{for mac,linux,fx4}menu {menu Outils}{/for}{for win,fx4}bouton {button Firefox}, survolez le menu {menu Historique}, puis sélectionnez le menu {menu Supprimer l'historique récent...}{/for}{for not win,fx4}, puis sélectionnez le menu {/for}{for win,fx35}{menu Supprimer l'historique récent...}{/for}{for mac,linux}{menu Supprimer l'historique récent...}{/for} {for win,fx4}<br>'''Pour Windows XP :''' En haut de la fenêtre de Firefox, cliquez sur le menu {menu Outils}, puis sélectionnez {menu Supprimer l'historique récent....}{/for}
Bon
{for fx4}
#{for win}En haut de la fenêtre de Firefox, cliquez sur le bouton {button Firefox}, survolez le menu {menu Historique}, puis sélectionnez {menu Supprimer l'historique récent...} ('''Windows XP :''' cliquez sur le menu {menu Outils}, puis sélectionnez {menu Supprimer l'historique récent...}).{/for}{for mac}Sur la barre de menus, cliquez sur le menu {menu Outils}, puis sélectionnez {menu Supprimer l'historique récent...}{/for}{for linux}En haut de la fenêtre de Firefox, cliquez sur le menu {menu Outils}, puis sléectionnez {menu Supprimer l'historique récent...}{/for}
{/for}
{for fx35}
#{for win,linux}En haut de la fenêtre de Firefox, cliquez sur le menu {menu Outils}, puis sélectionnez {menu Supprimer l'historique récent...}{/for}{for mac}Sur la barre de menus, cliquez sur le menu {menu Outils}, puis sélectionnez {menu Supprimer l'historique récent...}{/for}
{/for}
Un autre exemple :
Dans l'exemple ci-dessus, nous traitons de Firefox 3.6, et Firefox 4 et supérieur, comme deux jeux d'instructions différents. C'est souvent le cas, mais au fur et à mesure que nous changerons Firefox toutes les six semaines, nous verrons davantage de modifications dans les dernières versions. Elles ressembleront à ceci :
Bon :
{for fx35}
#Les anciennes instructions.
{/for}
{for =fx8,=fx9}
#Les nouvelles instructions.
{/for}
{for fx10}
#Les toutes nouvelles instructions.
{/for}