Come utilizzare l'istruzione For
Informazioni sulla versione
- ID versione: 21502
- Data di creazione:
- Autore: Michele Rodaro
- Commento: Riscrittura. Che pizza! Fare l'immagine italiana del selettore?
- Revisionata: No
- Pronta per la localizzazione: No
Sorgente della versione
Contenuto della versione
Una delle caratteristiche speciali della Knowledge Base è la possibilità di mostrare istruzioni personalizzate per i vari sistemi operativi (Windows, Android, ecc.) e le versioni di Firefox. Si può dire, ad esempio, che una certa sezione di un articolo è "destinata" ("for") agli utenti Windows ma non deve essere visualizzabile dagli utenti Linux e Mac. La funzione è progettata per agire in modo del tutto invisibile all'utente. Quando qualcuno apre un articolo di supporto, verranno rilevati automaticamente il sistema operativo e la versione di Firefox utilizzati dall'utente e verranno mostrate le relative istruzioni. Quest'articolo spiega nel dettaglio l'utilizzo dell'istruzione {for} negli articoli della Knowledge Base.
Indice dei contenuti
Come passare alle istruzioni per i diversi sistemi operativi o versioni di Firefox
Per poter seguire gli esempi contenuti in questo articolo, è necessario cambiare il selettore "Articolo per:" selezionando i diversi sistemi operativi e le varie versioni di Firefox. Il selettore è posizionato nella parte inferiore della barra laterale alla destra dell'articolo.
Sintassi fondamentale e comportamento
Questa è la sintassi per mostrare un'immagine solo per Windows:
{for win}[[Image:vista.jpg]]{/for}
- Impostare il selettore "Articolo per:" su Windows per visualizzare l'immagine:
- Se si imposta il selettore su Mac OS X o su Linux l'immagine non verrà visualizzata perché non è "disponibile" ("for") per quei due sistemi operativi.
Versioni di Firefox
Questa è la sintassi per mostrare qualcosa di specifico per Firefox 9 e versioni superiori:
{for fx9}[[Image:Firefox Logo]]{/for}
- Impostare il selettore su Firefox 9 o versioni superiori per visualizzare l'immagine:
- Se si imposta il selettore su Firefox 3.5 - 3.6 il messaggio scomparirà perché non è "disponibile" ("for") per quelle versioni di Firefox.
Visualizzare le istruzioni esclusivamente per una specifica versione di Firefox
Per visualizzare le istruzioni solo per Firefox 9, utilizzare l'operatore "=":
{for =fx9}[[Image:Firefox Logo]]{/for}
- Ora l'immagine verrà visualizzata solo se si imposta il selettore su Firefox 9:
Firefox 3.5-3.6 funziona diversamente. Quando si specifica {for fx35} le istruzioni verranno visualizzate solo per Firefox 3.5-3.6, l'utilizzo dell'operatore "=" non è necessario:
{for fx35}[[Image:Firefox Logo]]{/for}
- Impostare il selettore su Firefox 3.5-3.6 per visualizzare l'immagine:
Combinazione di sistemi operativi e versioni di Firefox
È possibile specificare le istruzioni per un sistema operativo e una versione di Firefox separandoli con una virgola:
{for win,fx9}[[Image:vista.jpg]][[Image:Firefox Logo]]{/for}
- Impostare il selettore su Windows e Firefox 9 o versioni superiori per visualizzare le immagini:
Una condizione più complessa con un "or" implicito può essere scritta in questo modo:
{for mac, win, fx35, =fx9}[[Image:vista.jpg]][[Image:macos.jpg]][[Image:Firefox Logo]]{/for}
- Impostare il selettore su Mac o Windows e su Firefox 3.5-3.6 o Firefox9 per visualizzare le immagini:
Da un punto di vista formale il testo compreso tra {for} e {/for} verrà mostrato se una delle seguenti condizioni è verificata:
- Il {for} indica almeno un sistema operativo e comprende quello utilizzato dall'utente (o impostato manualmente mediante il selettore).
- Il {for} indica almeno una versione di Firefox e comprende quella utilizzata dall'utente (o impostata manualmente mediante il selettore).
In caso contrario, il contenuto di {for}...{/for} non viene visualizzato.
Di seguito alcune considerazioni di interesse:
- Gli spazi dopo le virgole possono essere omessi.
- La sintassi {for} funziona solo negli articoli della Knowledge Base di Firefox.
- La sintassi {for} e altri operatori wiki non funzionano nei sommari per la ricerca degli articoli.
- Le intestazioni nascoste dai blocchi {for} non compaiono nell'indice dei contenuti di una pagina. Se viene impostata manualmente la giusta combinazione di browser/sistema operativo, l'indice dei contenuti si modifica istantaneamente mostrando le instestazioni nascoste.
Abbreviazioni per i sistemi operativi e i browser
Di seguito sono elencate le abbreviazioni disponibili da utilizzare con l'istruzione {for} per i vari sistemi operativi e browser:
- win (Windows)
- mac (Mac OS X)
- linux (Linux)
- android (sistema operativo Android per dispositivi portatili)
- fx35 (versioni di Firefox dalla 3.5 alla 3.6)
- fxN dove N = la versione di Firefox, ad esempio fx8, fx9, fx10, ecc.
- mN dove N = la versione di Firefox, ad esempio m8, m9, m10, ecc. Sono le versioni di Firefox Mobile (Firefox per dispositivi portatili).
Testo e paragrafi
L'istruzione {for} può essere utilizzata sia all'interno del testo che per racchiudere paragrafi. Nel primo caso ha effetto quando è applicata ad una riga di testo:
Questo è {for win}un esempio di utilizzo nel testo dell'istruzione{/for}.
Quando è applicata ai blocchi può essere utilizzata per racchiudere paragrafi, elenchi numerati, intestazioni e così via. È necessario però prestare attenzione al fatto che, in questa forma, le notazioni {for} e {/for} devono occupare una intera riga. In caso contrario possono essere considerate parte del paragrafo successivo e provocare risultati inaspettati.
{for win}
Questo è un esempio di utilizzo in un paragrafo.
*Uno
*Due
{/for}
Il pulsante {for} nell'editor degli articoli
Durante la scrittura di un articolo della Knowledge Base è possibile utilizzare il pulsante {for} nella barra degli strumenti per inserire automaticamente la notazione nel testo.
- Selezionare il testo che si vuole racchiudere per mezzo dei tag {for}.
- Fare clic sul pulsante nella barra degli strumenti dell'editor.
- Contrassegnare le caselle relative alle versioni di Firefox e ai sistemi operativi per i quali si desidera mostrare il contenuto scelto e fare clic su . I tag {for} personalizzati verranno inseriti intorno al testo selezionato.
Consigli per un corretto utilizzo dell'istruzione {for} negli articoli
Quando si scrivono le istruzioni per diversi sistemi operativi, è buona norma scrivere frasi e paragrafi completi per ciascun sistema operativo/versione di Firefox anche se ciò significa dover scrivere più volte le istruzioni. Questo rende l'articolo più facile da comprendere, gestire e localizzare. Quando ad esempio arriva il momento di rimuovere le istruzioni specifiche per Firefox 3.5/3.6, sarà sufficiente cancellare quelle sezioni piuttosto che cercare di rintracciare le istruzioni all'interno di una sezione più vasta e complessa.
Esempio:
Non corretto
#{for win,linux}Nella parte superiore della finestra di Firefox{/for}{for mac}Sulla barra dei menu{/for}, fare clic sul {for fx35}menu {menu Strumenti}{/for}{for mac,linux,fx4}menu {menu Strumenti}{for win,fx4}pulsante {button Firefox}, selezionare {menu Cronologia} e successivamente {menu Cancella la cronologia recente...}{/for}{for not win,fx4} e selezionare {/for}{for win,fx35}{menu Cancella la cronologia recente...}{/for}{for mac,linux}{menu Cancella la cronologia recente...}{/for} {for win,fx4}<br>'''In Windows XP:''' Nella parte superiore della finestra di firefox, fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}{/for}
Corretto
{for fx4}
#{for win}Nella parte superiore della finestra di Firefox, fare clic sul pulsante {button Firefox}, selezionare il menu {menu Cronologia} e successivamente {menu Cancella la cronologia recente...} ('''In Windows XP:''' fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}).{/for}{for mac}Sulla barra dei menu, fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}{/for}{for linux}Nella parte superiore della finestra di Firefox, fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}{/for}
{/for}
{for fx35}
#{for win,linux}Nella parte superiore della finestra di Firefox, fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}{/for}{for mac}Sulla barra dei menu, fare clic sul menu {menu Strumenti} e selezionare {menu Cancella la cronologia recente...}{/for}
{/for}
Un altro esempio:
Nell'esempio riportato sopra sono stati presi in considerazione Firefox 3.6 e Firefox 4 e versioni superiori come due diversi insiemi di istruzioni. Questo è spesso il caso, ma cambiando Firefox ogni sei settimane vedremo ulteriori modifiche nelle versioni successive. Queste modifiche saranno come quelle riportate di seguito:
Corretto:
{for fx35}
#Le vecchie istruzioni.
{/for}
{for =fx8,=fx9}
#Le nuove istruzioni.
{/for}
{for fx10}
#Le nuovissime istruzioni.
{/for}