Aiuto:Parole magiche
Da Memory Alpha.
Contenuti → Parole magicheUna parola magica "magic word" è un termine di astrazione di una certa funzione del software MediaWiki, che inserita nel testo di un articolo restituisce una particolare funzionalità spesso molto utile. Il risultato nel testo visualizzato può essere di diversi tipi, e sono contraddistinte da alcune peculiarità:
- una parola maiuscola, preceduta e seguita da due "underscore" ("__"), es. __NOTOC__
- un oggetto XML, codificato in modo simile al linguaggio HTML, preceduto da "<" e seguito da ">", es. <nowiki>
- una funzione di analisi (parser function): simile ad un template, una parola preceduta dalle due graffe "{{" e seguita da "}}", e opzionalmente le definizioni dei parametri incluse nei caratteri "pipe" ( | ), eccetto la parte che precede il primo "pipe" (oppure senza "pipe", il testo tra le graffe) che deve contenere un carattere "due punti"(":"), es. {{ns:3}} e {{#ifexpr:{{{1}}}>3|large|small}}
- una variabile: simile ad un template senza parametri, una parola preceduta dai simboli "{{" e seguita da "}}", tranne che per il fatto che è tutta in maiuscolo, es. {{CURRENTDAY}}
- un modificatore di template
- un modificatore di immagine
Se una pagina nel namespace dei template, ha lo stesso nome di una parola magica, verrà richiamata la parola magica e non il template. Se scopri di dover assolutamente nominare un template con lo stesso nome di una parola magica, aggiungi il prefisso "msg:" al nome del template, o il nome completo del namespace ("Template:"). Vedi oltre per ulteriori dettagli se hai bisogno di questa caratteristica.
Indice |
[modifica] Parole magiche tra due "underscore"
[modifica] Indice dei contenuti (Table of contents)
- Per dettagli vedi Aiuto: Sezione.
| Parola magica | Descrizione |
|---|---|
| __NOTOC__ | Nasconde l'indice nella pagina corrente. |
| __FORCETOC__ | Forza la comparsa dell'indice anche quando ci sono meno di due paragrafi. |
| __TOC__ | Inserisce un indice nella posizione in cui viene posto (con prevalenza rispetto a __NOTOC__). |
[modifica] Altro
| Parola magica | Descrizione |
|---|---|
| __NOEDITSECTION__ | Nasconde i link di modifica a destra, accanto ai titoli. |
| __NEWSECTIONLINK__ | Restituisce un link "+" in prossimità del pulsante modifica (edit-tab) per creare una nuova sezione su una pagina diversa dalle pagine discussione. |
| __NOCONTENTCONVERT__ __NOCC__ | Non converte alcuni caratteri specifici di un linguaggio nella visualizzazione di un articolo; per esempio in cinese zh con zh_cn, zh_tw, zh_sg, zh_hk. |
| __NOGALLERY__ | Permette la visualizzazione delle immagini nelle pagine categoria come link interni al testo, e non come una galleria di immagini. |
| __NOTITLECONVERT__ __NOTC__ | Come __NOCONTENTCONVERT__ ma limitato al titolo. |
| __END__ | Consente l'inserimento di righe vuote nella pagina salvata. |
[modifica] Variabili
- Per dettagli vedi Aiuto: Variabili.
[modifica] Tempo
Il tempo in "Tempo coordinato universale" UTC. Nota che se la pagina è visualizzata dallo stesso utente e non è stata modificata dell'ultima visualizzazione, è possibile che possa essere memorizzata dal browser dell'utente (cached) e l'ora o la data visualizzata potrebbe non cambiare. Inoltre questo capita anche a pagine frequentate spesso (come la pagina principale di Wikipedia) e l'orario non cambia dall'ultima visita effettuata. Vedi anche avvisi per i browser.
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{CURRENTDAY}} | 11
| Visualizza il giorno corrente in formato numerico. |
| {{CURRENTDAY2}} | 11
| Come {{CURRENTDAY}}, ma forzando le due cifre (01 .. 31). |
| {{CURRENTDAYNAME}} | mercoledì
| Nome del giorno nel linguaggio del progetto o in inglese. |
| {{CURRENTDOW}} | 3
| Come {{CURRENTDAYNAME}}, ma in formato numerico (0=Domenica, 1=Lunedì...). |
| {{CURRENTMONTH}} | 11
| Il numero del mese (01 .. 12). |
| {{CURRENTMONTHABBREV}} | nov
| Come {{CURRENTMONTH}}, ma in forma abbreviata (Gen .. Dic). |
| {{CURRENTMONTHNAME}} | novembre
| Come {{CURRENTMONTH}}, ma in formato esteso (Gennaio .. Dicembre). |
| {{CURRENTTIME}} | 20:22
| L'ora corrente UTC (00:00 .. 23:59). |
| {{CURRENTHOUR}} | 20
| L'ora corrente UTC (00 .. 23). |
| {{CURRENTMINUTE}} | 22
| Il minuto corrente (00 .. 59). |
| {{CURRENTWEEK}} | 46
| Il numero della settimana corrente (1-53) in accordo a ISO 8601 senza lo zero anteposto. |
| {{CURRENTYEAR}} | 2009
| L'anno corrente. |
| {{CURRENTTIMESTAMP}} | 20091111202251
| ISO 8601 data e ora formalizzata (time stamp). |
[modifica] Tempo locale
Il tempo dipendente dalla zona locale della wiki (non dipendente dalla zona selezionata nelle preferenze utente). Non è chiara la differenza di un'ora (in meno) rispetto all'ora italiana. Vedi funzioni di analisi per una "patch" che visualizza l'ora effettiva.
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{LOCALDAY}} | 11
| Visualizza il giorno del mese in formato numerico. |
| {{LOCALDAY2}} | 11
| Come {{LOCALDAY}}, ma forzando due cifre (01 .. 31). |
| {{LOCALDAYNAME}} | mercoledì
| Nome del giorno nel linguaggio del progetto o in inglese. |
| {{LOCALDOW}} | 3
| Come {{LOCALDAYNAME}}, ma in formato numerico (0=Domenica, 1=Lunedì...). |
| {{LOCALMONTH}} | 11
| Il numero del mese (01 .. 12). |
| {{LOCALMONTHABBREV}} | nov
| Come {{LOCALMONTH}}, ma in forma abbreviata (Gen .. Dic). |
| {{LOCALMONTHNAME}} | novembre
| Come {{LOCALMONTH}}, ma in formato esteso (Gennaio .. Dicembre). |
| {{LOCALTIME}} | 20:22
| L'orario locale (00:00 .. 23:59). |
| {{LOCALHOUR}} | 20
| L'ora locale (00 .. 23). |
| {{LOCALWEEK}} | 46
| Il numero della settimana corrente (1-53) in accordo a ISO 8601 senza lo zero anteposto. |
| {{LOCALYEAR}} | 2009
| L'anno corrente. |
| {{LOCALTIMESTAMP}} | 20091111202251
| ISO 8601 data e ora formalizzata (time stamp). |
[modifica] Statistiche
Le variabili statistiche restituiscono risultati con il separatore delle migliaia, a meno che non sia integrato con ":R" cioè "raw" (in pratica, risultano come funzioni di analisi).
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{CURRENTVERSION}} | 1.15.1
| Restituisce la versione corrente del software MediaWiki installato nel server di Memory Alpha. [1] |
| {{NUMBEROFEDITS}} {{NUMBEROFEDITS:R}} | 18.23218232
| Restituisce il numero totale di pagine modificate da quando è stato installato il software MediaWiki. |
| {{NUMBEROFARTICLES}} {{NUMBEROFARTICLES:R}} | 1.9191919
| Restituisce il numero totale di articoli presenti su Memory Alpha. |
| {{NUMBEROFPAGES}} {{NUMBEROFPAGES:R}} | 4.1264126
| Restituisce il numero totale di pagine di Memory Alpha. [2] |
| {{NUMBEROFFILES}} {{NUMBEROFFILES:R}} | 162162
| Restituisce il numero di file caricati in Memory Alpha (righe nella tabella delle immagini). |
| {{NUMBEROFUSERS}} {{NUMBEROFUSERS:R}} | 1.679.1201679120
| Restituisce il numero di utenti registrati (righe nella tabella degli utenti). |
| {{NUMBEROFADMINS}} {{NUMBEROFADMINS:R}} | 55
| Restituisce il numero di amministratori (sysop, burocrati, steward e checkuser) di Memory Alpha. |
[modifica] Nomi di pagina e informazioni correlate
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{PAGENAME}} | Parole magiche
| Restituisce il nome della pagina corrente, inclusi tutti i livelli (Titoli/Sottotitoli). |
| {{PAGENAMEE}} | Parole_magiche
| Restituisce il nome della pagina con "underscore" al posto degli spazi (più URL-friendly, da usare per un nome di articolo in un link esterno). |
| {{SUBPAGENAME}} {{SUBPAGENAMEE}} | Parole magiche
| Nome della pagina corrente, escluse le dipendenze, ("Sottotitolo" su "Titolo/Altro/Sottotitolo") nei namespace che supportano sottopagine. |
| {{BASEPAGENAME}} {{BASEPAGENAMEE}} | Parole magiche
| Il nome di base di una sottopagina ("Titolo/Altro" su "Titolo/Altro/Sottotitolo"). |
| {{NAMESPACE}} {{NAMESPACEE}} | Aiuto
| Restituisce il nome del namespace in cui risiede la pagina corrente. |
| {{FULLPAGENAME}} {{FULLPAGENAMEE}} | Aiuto:Parole magiche
| Scorciatoia per NAMESPACE+PAGENAME |
| {{TALKSPACE}} {{TALKSPACEE}} | Discussioni aiuto
| Nome del prossimo namespace dispari (es. 4 → 5) |
| {{SUBJECTSPACE}} {{SUBJECTSPACEE}} | Aiuto
| Nome dell'ultimo namespace pari (es. 5 → 4) |
| {{ARTICLESPACE}} {{ARTICLESPACEE}} | Aiuto
| Un alias per SUBJECTSPACE(E) |
| {{TALKPAGENAME}} {{TALKPAGENAMEE}} | Discussioni aiuto:Parole magiche
| FULLPAGENAME nel suo TALKSPACE |
| {{SUBJECTPAGENAME}} {{SUBJECTPAGENAMEE}} | Aiuto:Parole magiche
| FULLPAGENAME nel suo SUBJECTSPACE |
| {{ARTICLEPAGENAME}} {{ARTICLEPAGENAMEE}} | Aiuto:Parole magiche
| Un alias per SUBJECTPAGENAME(E) |
| {{REVISIONID}} | 5070
| L'identificativo unico per il numero di una pagina, da utilizzare per confrontare due versioni della stessa pagina, come la visualizzazione della cronologia. Nota che in fase di modifica, questo valore è nullo. |
| {{REVISIONDAY}} | 2
| Il giorno dell'ultima modifica della pagina. |
| {{REVISIONDAY2}} | 02
| Il giorno dell'ultima modifica della pagina, forzato a due cifre (01 .. 31). |
| {{REVISIONMONTH}} | 11
| Il mese dell'ultima modifica. |
| {{REVISIONYEAR}} | 2008
| L'anno dell'ultima modifica. |
| {{REVISIONTIMESTAMP}} | 20081102222851
| ISO 8601 data e ora dell'ultima modifica. |
| {{SITENAME}} | Memory Alpha
| Il nome del sito ($wgSitename). |
| {{SERVER}} | http://memory-alpha.org | La base URL del server ($wgServer). |
| {{SCRIPTPATH}} | /it
| Il percorso base dell'URL ($wgScriptPath). |
| {{SERVERNAME}} | memory-alpha.org
| Il nome del server senza protocollo ($wgServerName). |
[modifica] Funzioni di analisi (parser functions)
- Per dettagli vedi Meta: Parser function.
[modifica] Namespace e URLs
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{#time:H:i|+1 hours}} | 21:22 | Patch per visualizzare l'ora corrente in Italia. |
| {{ns:}} | {{ns:4}} = Memory Alpha{{ns:project}} = Memory Alpha
| Restituisce il nome di un dato numero del namespace. |
| {{localurl:x y @}} {{localurle:x y @}} {{localurl:a|b=c}} | /it/wiki/X_y_@
| Restituisce l'URL locale di una pagina (anche inesistente). Opzionalmente, può essere usato il parametro query, vedi variabile. |
| {{urlencode:x y @}} | x+y+%40
| Codifica valori di variabile per l'utilizzo in link esterni. [3] |
| {{anchorencode:x #y @}} | x_.23y_.40
| Codifica valori di variabile per l'utilizzo in sezioni bloccate (section anchors). [4] |
| {{fullurl:x y @}} {{fullurle:x y @}} {{fullurl:m:a|b=c}} | http://memory-alpha.org/it/wiki/X_y_@ http://memory-alpha.org/it/wiki/X_y_@ http://meta.wikimedia.org/wiki/a?b=c | Restituisce l'intero URL di una data pagina. Opzionalmente il parametro query come per localurl:. |
[modifica] Formattazione
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{#language:}} | {{#language:it}} = Italiano
| Il nome del linguaggio del codice nativo. |
| {{lc:}} | {{lc:AbC dEf}} = abc def
| Rende minuscoli tutti i caratteri di una stringa. |
| {{lcfirst:}} | {{lcfirst:Ab Cd}} = ab Cd
| Rende minuscolo il primo carattere di una stringa |
| {{uc:}} | {{uc:aBc DeF}} = ABC DEF
| Rende maiuscoli tutti i caratteri di una stringa. |
| {{ucfirst:}} | {{ucfirst:aB cD}} = AB cD
| Rende maiuscolo il primo carattere di una stringa. |
| {{formatnum:}} | {{formatnum:-299792458.56789}} = -299.792.458,56789
| Aggiunge un separatore decimale ad un numero. Sono riconosciuti anche i simboli più e meno (+, -). |
| {{padleft:}} {{padright:}} |
{{padleft:7|3|0}} = | Trasforma una stringa nel formato specificato. Nota che esiste un piccolo bug che interpreta i caratteri non US-ASCII come due, al posto di un carattere (vedi la differenza tra café e cafe negli esempi).
Sembra che non sia possibile usare "padleft" e "padright" per caratteri con codice multicarattere, come |
| {{#tag:}} | {{#tag:myextension | attr=val | attr2=val2 | content}} = <myextension attr=val attr2=val2>content</myextension>
| Passa attributi e contenuto interno ad un parser tag stile XML, analizzando le variabili del template nel passaggio. Vedi Extension:TagParser. |
[modifica] Modificatori di template
| Uso | Descrizione |
|---|---|
| {{:xyz}} | Il carattere "due punti" ( : ), non è un modificatore di template, è il prefisso per il namespace principale. Prova ad es. l'articolo {{:UTC}} vs. il template {{UTC}}. Utilizzando questa sintassi, includi il testo dell'articolo xyz del namespace principale in un altro articolo. |
| {{int:xyz}} | Scorciatoia per {{MediaWiki:xyz}}, visualizzata come <xyz> se MediaWiki:xyz non esiste. Vedi anche messaggi di sistema. |
| {{msg:xyz}} | Anche se esiste una parola magica chiamata "xyz", usa template:xyz a meno che il template non esista (equivalente a {{template:xyz}}). Normalmente le parole magiche hanno priorità in caso di conflitti. |
| {{msgnw:xyz}} | Il wikitext non valutato è visualizzato. Vedi msgnw. |
| {{raw:xyz}} | Equivalente a {{msg:xyz}} sopra [1].
|
| {{subst:xyz}} | Nel wikitext, il tag è sostituito dal contenuto (solo il singolo livello di valutazione); vedi Meta: Substitution. |
[modifica] Modificatori di immagine
- Per dettagli vedi anche Wikipedia: Extended image syntax.
Questi sono modificatori di immagine usati in collegamenti [[Immagine:titolo.ext|modificatore|...|modificatore]]. Alcuni si escludono a vicenda, vale l'ultimo specificato.
[modifica] Dimensione
L'ultimo modificatore non riconosciuto viene usato come titolo per parti (frame) di immagini o insieme con thumbnail. Viene anche usato come descrizione, ad es. alt=testo.
| Parola magica | Uso | Descrizione |
|---|---|---|
| framed frame enframed | [[Image:Mediawiki.png|framed]] | Posiziona un immagine in un frame con una descrizione. Usa la dimensione dell'immagine originale. |
| border | [[Image:Mediawiki.png|border]] | Visualizza un bordo di 1 pixel attorno all'immagine. |
| thumbnail thumb | [[Image:Mediawiki.png|thumbnail]] | Modifica la dimensione dell'immagine, impostandola secondo le preferenze utente. |
| thumb=xyz | [[Image:Mediawiki.png|thumb=Wiki.png]] | Manualthumb: anziché visualizzare un'immagine auto-ridimensionata per Mediawiki.png, mostra l'immagine Wiki.png. |
| width px n1xn2 px | [[Image:Mediawiki.png|40px]] [[Image:Mediawiki.png|100x200px]] | Ridimensiona l'immagine secondo la larghezza data in pixels. Ridimensiona l'immagine a non più di n1 pixels di larghezza e non più di n2 in altezza, ma l'immagine conserva la sua proporzione entro i confini specificati. |
[modifica] Posizione
- Per dettagli vedi anche Meta: Images and other uploaded files.
Le posizioni si escludono a vicenda; vale l'ultimo specificato. <br clear="all" /> può fermare il floating. Per immagini nel testo (inline), solo il modificatore px (vedi oltre) è supportato.
| Parola magica | Uso | Descrizione |
|---|---|---|
| right | [[Image:Mediawiki.png|right]] | Modifica la posizione, sposta l'immagine a destra. |
| left | [[Image:Mediawiki.png|left]] | Modifica la posizione, sposta l'immagine a sinistra. |
| none | [[Image:Mediawiki.png|none]] | Imposta esplicitamente che l'immagine non si sposti. |
| center centre | [[Image:Mediawiki.png|center]] | Modifica la posizione, come none ma centrato. |
[modifica] Miscellaneous
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{DISPLAYTITLE:xyz}} | {{DISPLAYTITLE:five}}
| Imposta il titolo della pagina a xyz. Nota che il numero di caratteri deve essere lo stesso del titolo attuale, altrimenti non avrà effetto. |
| {{DIRMARK}} {{DIRECTIONMARK}} |
| u+200E marca (da sinistra a destra) o u+200D (da destra a sinistra). |
| {{CONTENTLANGUAGE}} | it
| Codice del linguaggio dell'interfaccia di default ($wgLanguageCode). |
| {{DEFAULTSORT:xyz}} | {{DEFAULTSORT:Kim, Harry}}
| Imposta una predefinita chiave di ordinamento categoria per l'intera pagina corrente (quindi si applica anche ai tags di categoria prima di questa "parola magica")[2]. |
| #REDIRECT | #REDIRECT [[target]]all'inizio della pagina sorgente | Crea una redirezione ad un'altra pagina. |
[modifica] Conversioni di parole caratteristiche di un linguaggio
| Parola magica | Esempio | Descrizione |
|---|---|---|
| {{CURRENTMONTHNAMEGEN}} | novembre
| Forma genitiva del nome del mese; usata per Czech, Polish, Ukrainian, etc. [5] |
| {{grammar:case | word}} | {{grammar:7sg|Wikipedie}} su cs: è Wikipedií.
| Forme di parole derivate in inflessioni di linguaggi come Czech. [6] |
| {{plural:count | form1 | form2}} | {{plural: 2 | is | are}} visualizza are{{plural: 0 | this | these}} visualizza these
| count uguale a 1 produce form1 (singolare), tutti gli altri valori per count producno form2 (plurale); plural le trasformazioni sono usate per linguaggi come Russian [7] basati su "count mod 10". |
"Grammar" e "Plural" sono funzioni dipendenti dal linguaggio, definite in [8], [9], etc. (nota che in PHP, l'operatore modulo è il segno %).
"Grammar" può anche essere applicato solo a parole predefinite, o a parole arbitrarie, a seconda di quale definizione è un array2D array, o implica la manipolazione di stringhe. Vedi anche Wikipedia:cs:Šablona:Wikivar/GRAMMAR.
[modifica] Vedi anche
- ParserFunctions #expr:, #if:, #ifeq:, etc.
- Magic words at MediaWiki
- Source for Language.php
- Source for MagicWord.php
[modifica] Riferimenti
- ↑ Wikimedia SVN revision 12925
- ↑ "Technology report", en-Wikipedia Signpost, January 2007
