Een van de geweldige functies van onze Kennisbank is de mogelijkheid om instructies te tonen die zijn aangepast voor besturingssystemen (Windows, macOS, Linux) en Firefox-versies. We kunnen bijvoorbeeld zeggen dat een bepaald gedeelte van een hulp-artikel ‘voor’ Windows-gebruikers is en dat Mac- en Linux-gebruikers dit niet te zien krijgen. De functie is ontworpen om onzichtbaar te werken. Wanneer iemand een hulp-artikel opent, detecteren we automatisch welk besturingssysteem en welke versie van Firefox ze gebruiken en tonen we de toepasselijke instructies. Dit artikel behandelt de details van het gebruik van {for}-opmaak in Kennisbank-artikelen.

Instructies wisselen naar verschillende besturingssystemen of Firefox-versies

Om het voorbeeld in dit artikel te volgen, dient u de artikelselector te wisselen naar verschillende besturingssystemen en Firefox-versies. Deze bevindt zich in het rechterpaneel van het artikel, onder Bewerkhulpmiddelen.

Basissyntaxis en -gedrag

Besturingssystemen

Hier is de syntaxis om een afbeelding voor Windows 11 te tonen:

{for win11}[[Image:Windows Logo]]{/for}

• Wijzig de selector naar Windows 11 om de afbeelding te zien:

  

Hoewel de Windows-selector niet bestaat, kunt u instructies schrijven die voor alle Windows-versies gelden:

{for win}[[Image:Image:vista.jpg]]{/for}

• Wijzig de selector naar Windows XP, Windows 7/Vista, Windows 8, Windows 10 of Windows 11 om de afbeelding te zien:

  

Firefox-versies

Hier is de syntaxis om iets te tonen voor Firefox 153 en hoger:

{for fx153}[[Image:Firefox Quantum Logo]]{/for}

• Wijzig de selector naar Firefox 153 of hoger om de afbeelding te zien:

  

Instructies voor slechts één versie van Firefox tonen

Gebruik de operator ‘=’ om instructies alleen voor Firefox 153 te tonen:

{for =fx153}[[Image:Firefox Quantum Logo]]{/for}

• De afbeelding wordt nu alleen getoond als u de selector wijzigt naar Firefox 153:

  

Besturingssystemen en Firefox-versies combineren

U kunt een besturingssysteem en een Firefox-versie specificeren door ze met een komma te scheiden:

{for win,fx153}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}

• Wijzig de selector naar Windows en Firefox 153 of hoger om afbeeldingen te zien:

  

Een complexere situatie met een impliciete ‘for’ kan als volgt worden geschreven:

{for mac, win10, win11, =fx150, fx153}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}

• Wijzig de selector naar Mac of Windows 10 of Windows 11 en Firefox 150 of Firefox 153 en hoger om afbeeldingen te zien:

  

Voorwaarden negeren

U kunt een voorwaarde negeren door deze vooraf te laten gaan door het woord not. Een genegeerde voorwaarde is waar als en alleen als de voorwaarde onwaar is. De voorwaarde

not fx153

is bijvoorbeeld waar als de Firefox-versie lager is dan 153.

{for}-tags gebruiken voor geavanceerd versiebeheer

Met frequente updates en functiereleases in Firefox spelen for-tags een sleutelrol bij het gericht samenstellen van inhoud, waardoor we relevante informatie kunnen leveren aan gebruikers op basis van hun specifieke versie van Firefox. Belangrijke toepassingen van deze tags zijn:

• Vroege toegang voor Nightly- en Beta-gebruikers: hiermee kunnen we aanstaande functies of wijzigingen presenteren aan gebruikers die de Nightly- en Beta-kanalen gebruiken, waardoor ze een voorproefje krijgen van wat ze kunnen verwachten. Dit zorgt ervoor dat onze meest betrokken en technische gebruikers nieuwe functionaliteiten kunnen gaan verkennen vóór de bredere gemeenschap.
• Lokalisatie vóór de lancering: met for-tags kunnen we inhoud voor aanstaande versies publiceren vóór hun openbare release. Hierdoor kan onze lokalisatiegemeenschap vertalingen vroegtijdig voorbereiden, waardoor meertalige ondersteuning wordt gegarandeerd op het moment dat een nieuwe versie live gaat in het productie-kanaal.
• Verwarring bij het algemene publiek voorkomen: door for-tags te gebruiken, voorkomen we strategisch dat ons algemene publiek wordt blootgesteld aan voorbarige informatie, waardoor verwarring wordt voorkomen over wat er momenteel beschikbaar is in hun huidige versie van Firefox.

Wanneer de inhoud wordt getoond

Formeel wordt de opmaak tussen {for} en {/for} getoond als aan beide van deze voorwaarden wordt voldaan:

• De {for} heeft geen besturingssysteem (OS)-voorwaarde, of heeft ten minste één OS-voorwaarde die waar is met betrekking tot het OS dat de gebruiker gebruikt (of handmatig heeft geselecteerd).
• De {for} heeft geen Firefox-versievoorwaarde, of heeft ten minste één Firefox-versievoorwaarde die waar is met betrekking tot de Firefox-versie die de gebruiker gebruikt (of handmatig heeft geselecteerd).

Anders wordt de inhoud van de {for}…{/for} niet getoond.

Een paar andere dingen om op te merken:

• Spaties na de komma’s zijn optioneel.
• {for} en andere wiki-opmaak werken niet in samenvattingen van zoekresultaten van artikelen.
• Koppen die door {for}-blokken worden verborgen, verschijnen niet in de inhoudsopgave van de pagina. Als de gebruiker ze laat verschijnen door handmatig de juiste combinatie van besturingssysteem/browser te selecteren, verschijnen de vermeldingen in de inhoudsopgave onmiddellijk.

Afkortingen voor besturingssystemen en producten

Dit zijn de afkortingen voor besturingssystemen en producten die beschikbaar zijn voor gebruik met {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)
• win11 (Windows 11)
• mac (macOS)
• linux (Linux)
• fxN waarbij N = de Firefox (desktop) versie, bijvoorbeeld fx151, fx152, fx153, etc.
• mN waarbij N = de Firefox for Android (mobiele) versie, bijvoorbeeld m151, m152, m1153, etc.
• tbN waarbij N = de Thunderbird-versie, bijvoorbeeld tb151, tb152, tb153, etc.

U dient fxN te gebruiken in ondersteuningsartikelen voor Firefox, mN in ondersteuningsartikelen voor Firefox for Android en tbN in ondersteuningsartikelen voor Thunderbird.

Inline- en blokniveaucontexten

{for} kan zowel in inline- als in blokniveaucontexten (in de HTML-zin) worden gebruikt. De inline-vorm wordt van kracht wanneer u binnen een tekstregel werkt:

Dit is {for win}inline-gebruik{/for}.

De blokvorm wordt gebruikt om hele alinea’s, geordende lijsten, koppen, enzovoort te omvatten. De enige voorwaarde is dat, bij gebruik van de blokvorm, de {for} en {/for} elk op een eigen regel moeten staan. Anders kan het worden beschouwd als onderdeel van een naburige alinea en verrassende resultaten opleveren.

{for win}

Dit is blokniveau.

*Eén

*Twee

{/for}

Beste praktijken voor het gebruik van {for} in artikelen

Wanneer u instructies voor verschillende besturingssystemen schrijft, kunt u het beste volledige zinnen en alinea’s voor elke OS/Firefox-versie schrijven, zelfs als dit betekent dat u dingen moet dupliceren. Dit maakt het artikel gemakkelijker te begrijpen, te onderhouden en te lokaliseren. Wanneer het bijvoorbeeld tijd is om specifieke instructies voor Firefox 152 en lager te verwijderen, kunnen die secties gewoon worden verwijderd in plaats van te proberen ze uit een grotere sectie te halen.

• De verkeerde manier om {for} te gebruiken:

  #{for not fx153}{for win,linux}Bovenin het Firefox-venster{/for}{for mac}Op de menubalk{/for}, klik op het {/for}{for fx153}Klik op de menuknop, ga naar het {menu History}-menu{/for}{for winxp,mac,linux,not fx153}{menu Tools}-menu{/for}{for win10,win11,not fx153}{menu Firefox}-menu, ga naar het {menu History}-menu{/for} en selecteer {menu Clear Recent History…}

• De juiste manier om {for} te gebruiken:

  {for not fx153}

  #{for win10,win11}Klik bovenin het Firefox-venster op het {menu Firefox}-menu, ga naar het {menu History}-menu en selecteer {menu Clear Recent History…}{/for}{for mac}Klik op de menubalk op het {menu Tools}-menu en selecteer {menu Clear Recent History…}{/for}{for winxp,linux}Klik bovenin het Firefox-venster op het {menu Tools}-menu en selecteer {menu Clear Recent History…}{/for}

  {/for}

  {for fx153}

  #Klik op de menuknop, ga naar het {menu History}-menu en selecteer {menu Clear Recent History…}

  {/for}

• In het volgende voorbeeld behandelen we Firefox 152 en lager, Firefox 153/154 en Firefox 155 en hoger als drie verschillende sets instructies. Dat is vaak het geval, maar naarmate we Firefox elke vier weken wijzigen, zullen we steeds meer wijzigingen in latere versies zien. Ze zullen er als volgt uitzien:

  {for not fx153}

  #De oude instructies.

  {/for}

  {for =fx153,=fx154}

  #De nieuwe instructies.

  {/for}

  {for fx155}

  #De NIEUWE nieuwe instructies.

  {/for}

Volledige richtlijnen voor de Kennisbank

Zie meer richtlijnen over bijdragen aan de Kennisbank.