Tudásbázisunk egyik nagyszerű funkciója, hogy képes az operációs rendszerek (Windows, macOS, Linux) és a Firefox verzióihoz igazított utasításokat megjeleníteni. Mondhatjuk például, hogy egy súgócikk egy bizonyos szakasza a Windows-felhasználóknak „szól”, és a Mac- és Linux-felhasználók nem fogják látni. A funkciót úgy tervezték, hogy láthatatlanul működjön. Amikor valaki megnyit egy súgócikket, automatikusan felismerjük, hogy milyen operációs rendszert és Firefox-verziót használ, és a megfelelő utasításokat jelenítjük meg. Ez a cikk a {for} jelölés Tudásbázis-cikkekben való használatának részleteit mutatja be.
Tartalomjegyzék
- 1 Hogyan váltson utasításokat a különböző operációs rendszerek vagy Firefox-verziók között
- 2 Alapvető szintaxis és viselkedés
- 3 A {for} használatának legjobb gyakorlatai a cikkekben
- 4 Teljes Tudásbázis irányelvek
Hogyan váltson utasításokat a különböző operációs rendszerek vagy Firefox-verziók között
Ahhoz, hogy követni tudja a példát ebben a cikkben, át kell váltania a cikkválasztót a különböző operációs rendszerekre és Firefox-verziókra. Ez a cikk jobb oldali paneljén található, a Szerkesztőeszközök alatt.
Alapvető szintaxis és viselkedés
Operációs rendszerek
Itt a szintaxis egy kép megjelenítéséhez Windows 11 esetén:
{for win11}[[Image:Windows Logo]]{/for}
- Váltson a választóval Windows 11-re a kép megtekintéséhez:
- Ha a választót Windows XP-re, Windows 7-re, Windows 8-ra, Windows 10-re, Mac-re vagy Linuxra váltja, a fenti kép nem jelenik meg, mert nem nekik „szól”.
Bár a Windows-választó nem létezik, írhat olyan utasításokat, amelyek minden Windows-verzióra érvényesek:
{for win}[[Image:Image:vista.jpg]]{/for}
- Váltson a választóval Windows XP-re, Windows 7/Vista-ra, Windows 8-ra, Windows 10-re vagy Windows 11-re a kép megtekintéséhez:
- Ha a választót Mac-re vagy Linuxra váltja, a fenti kép nem jelenik meg, mert nem nekik „szól”.
Firefox-verziók
Itt a szintaxis valaminek a megjelenítéséhez a Firefox 153 és újabb verziók esetén:
{for fx153}[[Image:Firefox Quantum Logo]]{/for}
- Váltson a választóval Firefox 153-as vagy újabb verzióra a kép megtekintéséhez:
- Ha a választót Firefox 152-es vagy régebbi verzióra váltja, a fenti kép eltűnik, mert nem azoknak a verzióknak „szól”.
Utasítások megjelenítése csak egy Firefox-verzióhoz
Az utasítások megjelenítéséhez csak a Firefox 153-as verziójához, használja a „=” operátort:
{for =fx153}[[Image:Firefox Quantum Logo]]{/for}
- Most a kép csak akkor jelenik meg, ha a választót Firefox 153-ra váltja:
Operációs rendszerek és Firefox-verziók kombinálása
Megadhat egy operációs rendszert és egy Firefox-verziót, vesszővel elválasztva őket:
{for win,fx153}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}
- Váltson a választóval Windowsra és Firefox 153-as vagy újabb verzióra a képek megtekintéséhez:
Egy bonyolultabb helyzet egy implicit „for”-ral így írható le:
{for mac, win10, win11, =fx150, fx153}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}
- Váltson a választóval Mac-re vagy Windows 10-re vagy Windows 11-re és Firefox 150-re vagy Firefox 153 és újabb verzióra a képek megtekintéséhez:
Feltételek tagadása
Egy feltételt tagadhat a not szóval megelőzve. Egy tagadott feltétel akkor és csak akkor igaz, ha a feltétel hamis. Például a feltétel
not fx153
igaz, ha a Firefox verziója kisebb, mint 153.
A {for} címkék kihasználása a fejlett verziókezeléshez
A Firefox gyakori frissítései és funkciókiadásai mellett a for címkék kulcsszerepet játszanak a célzott tartalomkezelésben, lehetővé téve számunkra, hogy releváns információkat juttassunk el a felhasználókhoz a Firefox adott verziója alapján. Ezeknek a címkéknek a legfontosabb alkalmazásai a következők:
- Korai hozzáférés a Nightly és Beta felhasználók számára: Lehetővé teszi számunkra, hogy a közelgő funkciókat vagy változásokat bemutassuk a Nightly és Beta csatornákon lévő felhasználóknak, előre jelezve nekik, hogy mire számíthatnak. Ez biztosítja, hogy a legelkötelezettebb és legtechnikásabb felhasználóink a szélesebb közösség előtt kezdhessék meg az új funkciók felfedezését.
- Lokalizáció a bevezetés előtt: A for címkék lehetővé teszik, hogy a közelgő verziókhoz tartozó tartalmakat még a nyilvános kiadásuk előtt közzétegyük. Ez lehetővé teszi lokalizációs közösségünk számára, hogy korán elkészítse a fordításokat, garantálva a többnyelvű támogatást abban a pillanatban, amikor egy új verzió élesedik a Production csatornán.
- A zűrzavar elkerülése a nagyközönség körében: A for címkék használatával stratégiailag elkerüljük, hogy a nagyközönséget idő előtti információknak tegyük ki, megelőzve ezzel a zűrzavart azzal kapcsolatban, hogy mi érhető el jelenleg a Firefox aktuális verziójában.
Mikor jelenik meg a tartalom
Formálisan a {for} és {/for} közötti jelölés akkor jelenik meg, ha mindkét feltétel teljesül:
- A {for} nem tartalmaz operációs rendszer (OS) feltételt, vagy tartalmaz legalább egy olyan OS feltételt, amely igaz a felhasználó által futtatott (vagy manuálisan kiválasztott) operációs rendszerre.
- A {for} nem tartalmaz Firefox-verzió feltételt, vagy tartalmaz legalább egy olyan Firefox-verzió feltételt, amely igaz a felhasználó által futtatott (vagy manuálisan kiválasztott) Firefox-verzióra.
Ellenkező esetben a {for}…{/for} tartalma nem jelenik meg.
Néhány további megjegyzés:
- A vesszők utáni szóközök nem kötelezőek.
- A {for} és más wiki jelölések nem működnek a cikkek keresési összefoglalóiban.
- A {for} blokkok által elrejtett címsorok nem jelennek meg az oldal tartalomjegyzékében. Ha a felhasználó a megfelelő operációs rendszer/böngésző kombináció manuális kiválasztásával megjeleníti őket, a tartalomjegyzék bejegyzései azonnal megjelennek.
Operációs rendszer és termék rövidítések
Ezek az operációs rendszer és termék rövidítések használhatók a {for} címkével:
- 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, ahol N = a Firefox (asztali) verziója, például fx151, fx152, fx153, stb.
- mN, ahol N = a Firefox for Android (mobil) verziója, például m151, m152, m1153, stb.
- tbN, ahol N = a Thunderbird verziója, például tb151, tb152, tb153, stb.
Az fxN-t a Firefox támogatási cikkeiben, az mN-t a Firefox for Android támogatási cikkeiben, a tbN-t pedig a Thunderbird támogatási cikkeiben kell használni.
Soron belüli és blokkszintű kontextusok
A {for} használható soron belüli és blokkszintű kontextusban is (HTML értelemben). A soron belüli forma akkor lép érvénybe, ha egy szövegsoron belül dolgozunk:
Ez {for win}soron belüli használat{/for}.
A blokk formát egész bekezdések, rendezett listák, címsorok és így tovább becsomagolására használják. Az egyetlen kikötés, hogy a blokk forma használatakor a {for} és a {/for} mindegyikének külön sorban kell lennie. Ellenkező esetben egy szomszédos bekezdés részének tekinthető, és meglepő eredményeket produkálhat.
- {for win}
- Ez blokkszintű.
- *Egy
- *Kettő
- {/for}
A {for} használatának legjobb gyakorlatai a cikkekben
Amikor különböző operációs rendszerekhez ír utasításokat, a legjobb, ha minden operációs rendszerhez/Firefox-verzióhoz teljes mondatokat és bekezdéseket ír, még ha ez duplikációt is jelent. Ez megkönnyíti a cikk megértését, karbantartását és lokalizálását. Amikor eljön az ideje például a Firefox 152-es és régebbi verziókra vonatkozó specifikus utasítások eltávolításának, ezek a szakaszok egyszerűen törölhetők, ahelyett, hogy egy nagyobb szakaszból próbálnánk kivágni őket.
- A {for} használatának rossz módja:
- #{for not fx153}{for win,linux}A Firefox ablak tetején{/for}{for mac}A menüsoron{/for}, kattintson a {/for}{for fx153}Kattintson a menügombra, majd lépjen a {menu History} menübe{/for}{for winxp,mac,linux,not fx153}{menu Tools} menübe{/for}{for win10,win11,not fx153}{menu Firefox} menübe, majd lépjen a {menu History} menübe{/for} és válassza ki a {menu Clear Recent History…} lehetőséget
- A {for} használatának helyes módja:
- {for not fx153}
- #{for win10,win11}A Firefox ablak tetején kattintson a {menu Firefox} menüre, lépjen a {menu History} menübe, és válassza ki a {menu Clear Recent History…} lehetőséget{/for}{for mac}A menüsoron kattintson a {menu Tools} menüre, és válassza ki a {menu Clear Recent History…} lehetőséget{/for}{for winxp,linux}A Firefox ablak tetején kattintson a {menu Tools} menüre, és válassza ki a {menu Clear Recent History…} lehetőséget{/for}
- {/for}
- {for fx153}
- #Kattintson a menügombra, lépjen a {menu History} menübe, és válassza ki a {menu Clear Recent History…} lehetőséget
- {/for}
- A következő példában a Firefox 152 és régebbi, a Firefox 153/154, valamint a Firefox 155 és újabb verziókat három különböző utasításkészletként kezeljük. Ez gyakran előfordul, de ahogy a Firefoxot négyhetente változtatjuk, egyre több változást fogunk látni a későbbi verziókban. Ezek így fognak kinézni:
- {for not fx153}
- #A régi utasítások.
- {/for}
- {for =fx153,=fx154}
- #Az új utasítások.
- {/for}
- {for fx155}
- #Az ÚJ új utasítások.
- {/for}
Teljes Tudásbázis irányelvek
Lásd: további irányelvek a Tudásbázishoz való hozzájárulásról.