Comment utiliser les balises « for »

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 (OS) 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. Cet article décrit les détails sur la manière d'utiliser <nowiki>{</nowiki>for<nowiki>}</nowiki> dans les articles de la base de connaissances. __TOC__ == Syntaxe et comportement de base == Voici la syntaxe pour afficher quelque chose pour une condition : '''<code><nowiki>{</nowiki>for mac<nowiki>}</nowiki>Bonjour !<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Changez le sélecteur "Aide pour :" en Mac pour voir un message => {for mac}'''Bonjour !'''{/for} Vous pouvez définir deux conditions comme ceci : '''<code><nowiki>{</nowiki>for mac,fx4<nowiki>}</nowiki>Bonjour !<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Changez le sélecteur "Aide pour :" en Mac et Firefox 4 pour voir un message => {for mac,fx4}'''Bonjour !'''{/for} Une condition plus complexe avec un « ou » impliqué peut être écrite comme ceci :<br> '''<code><nowiki>{</nowiki>for mac, win, fx35, fx4<nowiki>}</nowiki>Vous exécutez Mac ou Windows et utilisez Firefox 3.5-3.6 ou 4.<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Changez le sélecteur "Aide pour :" en Mac ou Windows et Firefox 3.5-3.6 ou Firefox4 pour voir un message =>{for mac,win,fx35,fx4}'''Vous exécutez Mac ou Windows et utilisez Firefox 3.5-3.6 ou 4.'''{/for} Formellement, le texte entre <nowiki>{</nowiki>for<nowiki>}</nowiki> et <nowiki>{</nowiki>/for<nowiki>}</nowiki> sera ''affiché'' si une des ces conditions est remplie : * Le <nowiki>{</nowiki>for<nowiki>}</nowiki> liste au moins un OS et inclut celui que l'utilisateur exécute (ou a sélectionné manuellement). * Le <nowiki>{</nowiki>for<nowiki>}</nowiki> liste au moins une version de Firefox et inclut celle que l'utilisateur exécute (ou a sélectionné manuellement). Autrement, le contenu de <nowiki>{</nowiki>for<nowiki>}</nowiki>...<nowiki>{</nowiki>/for<nowiki>}</nowiki> n'est pas affiché. D'autres choses sont à noter : * Les espaces après les virgules sont facultatives. * La syntaxe <nowiki>{</nowiki>for<nowiki>}</nowiki> est toujours activée. * Les titres de rubrique qui sont masqués par les blocs de <nowiki>{</nowiki>for<nowiki>}</nowiki> n'apparaissent pas dans la table des matières de la page. Si l'utilisateur les fait afficher en sélectionnant manuellement la bonne combinaison d'OS/navigateur, les entrées de la table des matières apparaissent instantanément. == Abréviations de système d'exploitation et de navigateur == Ce sont les abréviations de système d'exploitation et de navigateur disponibles pour l'utilisation avec <nowiki>{</nowiki>for<nowiki>}</nowiki> : * win (Windows) * mac (Mac OS X) * linux (Linux) * maemo (OS mobile Maemo) * android (OS mobile Android) * fx4 (Firefox 4.0 jusqu'à 5, 5 non inclus (pourra être affiné plus tard)) * fx35 (Firefox 3.5 jusqu'à 4, 4 non inclus) * fx3 (3.0 jusqu'à 3.5, 3.5 non inclus) * m4 (toute version de Firefox pour mobile jusqu'à 5, 5 non inclus (pourra être affiné plus tard)) == Contextes ligne et bloc de lignes == <nowiki>{</nowiki>for<nowiki>}</nowiki> peut être utilisé aussi bien sur une ligne ou sur un bloc de lignes (au sens HTML). La forme ligne prend effet en travaillant dans une ligne de texte : '''C'est <nowiki>{</nowiki>for fx35, fx4<nowiki>}</nowiki>l'utilisation par ligne<nowiki>{</nowiki>/for<nowiki>}</nowiki>.''' La forme bloc est utilisée pour entourer des paragraphes entiers, des listes ordonnées, des titres de rubrique, et ainsi de suite. La seule restriction est que, en utilisation la forme bloc, le <nowiki>{</nowiki>for<nowiki>}</nowiki> et <nowiki>{</nowiki>/for<nowiki>}</nowiki> doivent être chacun sur une ligne. Autrement, il pourrait être considéré comme une partie d'un paragraphe voisin et produire des résultats surprenants. '''<nowiki>{</nowiki>for fx35, fx4<nowiki>}</nowiki><br>''' '''C'est un bloc.<br>''' '''<nowiki>*</nowiki>Un<br>''' '''<nowiki>*</nowiki>Deux<br>''' '''<nowiki>{</nowiki>/for<nowiki>}</nowiki>''' ==Utiliser le bouton <nowiki>{</nowiki>for<nowiki>}</nowiki> dans l'éditeur d'article== Quand vous modifiez un article de la base de connaissances, vous pouvez utiliser le bouton <nowiki>{</nowiki>for<nowiki>}</nowiki> dans la barre d'outils pour écrire la balise souhaitée. #Surlignez le texte que vous voulez mettre entre les balises <nowiki>{</nowiki>for<nowiki>}</nowiki>. #Cliquez sur {button Afficher pour...} dans la barre d'outils d'édition. #Cochez les cases des versions de Firefox et des système d'exploitation qui seront vus pour ce contenu, puis cliquez sur {button Ajouter une règle}. Les balises personnalisées <nowiki>{</nowiki>for<nowiki>}</nowiki> seront placées autour de la section que vous avez surlignée. == Comment utiliser l'opérateur « not » == Comme la base de connaissances verra de nouvelles versions d'OS et de navigateur dans le futur, nous avons un moyen à l'épreuve du futur de dire, par exemple, "tout OS sauf ceux-ci". C'est le rôle de la syntaxe <nowiki>{</nowiki>for not<nowiki>}</nowiki>. Dans un article sur les mobiles, nous pourrions dire '''<nowiki>{</nowiki>for not maemo<nowiki>}</nowiki>vous pouvez utiliser le pincement pour les gestes de zoom...<nowiki>{</nowiki>/for<nowiki>}</nowiki>''' et si jamais nous ajoutions, par exemple, iOS à nos systèmes d'exploitation supportés, la syntaxe fonctionnerait sans besoin d'être mise à jour avec une nouvelle version d'OS. L'ajout du mot « not » provoque l'affichage du contenu <nowiki>{</nowiki>for<nowiki>}</nowiki> quand il aurait été masqué autrement et vice versa.

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 (OS) 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. Cet article décrit les détails sur la manière d'utiliser {for} dans les articles de la base de connaissances.

Syntaxe et comportement de base

Voici la syntaxe pour afficher quelque chose pour une condition : {for mac}Bonjour !{/for}
Changez le sélecteur "Aide pour :" en Mac pour voir un message => Bonjour !

Vous pouvez définir deux conditions comme ceci : {for mac,fx4}Bonjour !{/for}
Changez le sélecteur "Aide pour :" en Mac et Firefox 4 pour voir un message => Bonjour !

Une condition plus complexe avec un « ou » impliqué peut être écrite comme ceci :
{for mac, win, fx35, fx4}Vous exécutez Mac ou Windows et utilisez Firefox 3.5-3.6 ou 4.{/for}
Changez le sélecteur "Aide pour :" en Mac ou Windows et Firefox 3.5-3.6 ou Firefox4 pour voir un message =>Vous exécutez Mac ou Windows et utilisez Firefox 3.5-3.6 ou 4.

Formellement, le texte entre {for} et {/for} sera affiché si une des ces conditions est remplie :

• Le {for} liste au moins un OS et inclut celui que l'utilisateur exécute (ou a sélectionné manuellement).
• Le {for} liste au moins une version de Firefox et inclut celle que l'utilisateur exécute (ou a sélectionné manuellement).

Autrement, le contenu de {for}...{/for} n'est pas affiché.

D'autres choses sont à noter :

• Les espaces après les virgules sont facultatives.
• La syntaxe {for} est toujours activée.
• Les titres de rubrique qui sont masqués par les blocs de {for} n'apparaissent pas dans la table des matières de la page. Si l'utilisateur les fait afficher en sélectionnant manuellement la bonne combinaison d'OS/navigateur, les entrées de la table des matières apparaissent instantanément.

Abréviations de système d'exploitation et de navigateur

Ce sont les abréviations de système d'exploitation et de navigateur disponibles pour l'utilisation avec {for} :

• win (Windows)
• mac (Mac OS X)
• linux (Linux)
• maemo (OS mobile Maemo)
• android (OS mobile Android)
• fx4 (Firefox 4.0 jusqu'à 5, 5 non inclus (pourra être affiné plus tard))
• fx35 (Firefox 3.5 jusqu'à 4, 4 non inclus)
• fx3 (3.0 jusqu'à 3.5, 3.5 non inclus)
• m4 (toute version de Firefox pour mobile jusqu'à 5, 5 non inclus (pourra être affiné plus tard))

Contextes ligne et bloc de lignes

{for} peut être utilisé aussi bien sur une ligne ou sur un bloc de lignes (au sens HTML). La forme ligne prend effet en travaillant dans une ligne de texte :

C'est {for fx35, fx4}l'utilisation par ligne{/for}.

La forme bloc est utilisée pour entourer des paragraphes entiers, des listes ordonnées, des titres de rubrique, et ainsi de suite. La seule restriction est que, en utilisation la forme bloc, le {for} et {/for} doivent être chacun sur une ligne. Autrement, il pourrait être considéré comme une partie d'un paragraphe voisin et produire des résultats surprenants.

{for fx35, fx4}
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.

1. Surlignez le texte que vous voulez mettre entre les balises {for}.
2. Cliquez sur Afficher pour... dans la barre d'outils d'édition.
3. Cochez les cases des versions de Firefox et des système d'exploitation qui seront vus pour ce contenu, puis cliquez sur Ajouter une règle. Les balises personnalisées {for} seront placées autour de la section que vous avez surlignée.

Comment utiliser l'opérateur « not »

Comme la base de connaissances verra de nouvelles versions d'OS et de navigateur dans le futur, nous avons un moyen à l'épreuve du futur de dire, par exemple, "tout OS sauf ceux-ci". C'est le rôle de la syntaxe {for not}.

Dans un article sur les mobiles, nous pourrions dire {for not maemo}vous pouvez utiliser le pincement pour les gestes de zoom...{/for} et si jamais nous ajoutions, par exemple, iOS à nos systèmes d'exploitation supportés, la syntaxe fonctionnerait sans besoin d'être mise à jour avec une nouvelle version d'OS.

L'ajout du mot « not » provoque l'affichage du contenu {for} quand il aurait été masqué autrement et vice versa.