Template:Interprogetto/man
Da Wikiquote, aforismi e citazioni in libertà.
Indice |
[modifica] Descrizione
Il template Interprogetto permette di inserire uno o più collegamenti a pagine di altri progetti Wikimedia: si tratta dell'equivalente dell'interwiki per effettuare il collegamento ad altri progetti anziché ad altre lingue. Il collegamento viene aggiunto sia nella barra di sinistra (in un nuovo menu chiamato "altri progetti"), che nel testo della voce (opzionale).
I progetti Wikimedia a cui è possibile inserire collegamenti sono: Meta, Wiktionary/Wikizionario, Wikibooks, Wikisource, Wikipedia, Wikinews/Wikinotizie, Commons e Wikispecies. È possibile inserire un collegamento ad un progetto in un'altra lingua (per esempio al Wikisource inglese). Non è permesso inserire collegamenti a siti non Wikimedia (per questo usare la sezione "Collegamenti esterni" della voce).
È possibile inserire soltanto un template interprogetto per pagina (ma questo può collegare a più progetti, come spiegato in seguito). Il template va inserito nella sezione "Altri progetti" della voce.
[modifica] Esempio visivo
Wikipedia contiene una voce riguardante Interprogetto/man
Meta-Wiki contiene informazioni su Interprogetto/man
Wikibooks contiene testi o manuali su Interprogetto/man
Wikisource contiene opere originali di o su Interprogetto/man
Wikizionario contiene la voce di dizionario «Interprogetto/man»
Commons contiene file multimediali su Interprogetto/man
Wikispecies contiene informazioni su Interprogetto/man
Wikinotizie contiene notizie di attualità su Interprogetto/man
Wikiversità contiene informazioni su Interprogetto/man
[modifica] Uso
- Nota: se usate per la prima volta il template, leggete prima la guida dettagliata.
- Stesso nome pagina: {{interprogetto|prefisso1|prefisso2|prefisso3|...}}
- Nome pagina diverso: {{interprogetto|prefisso1=nomepagina1|prefisso2=nomepagina2|...}}
- Stesso nome pagina ma progetto in altra lingua: {{interprogetto|prefisso1=lingua1:nomepagina1|...}}
- Combinato: {{interprogetto|prefisso1=lingua1:nomepagina1|prefisso2|prefisso3=nomepagina3|...}}
- Senza inserire il collegamento nel testo: {{interprogetto|nolink|prefisso1=nomepagina1|...}}
- Con un'etichetta particolare nel collegamento nel testo:{{interprogetto|etichetta=questo testo|prefisso1=nomepagina1|...}}
- Con personalizzazione del testo inserito:{{interprogetto|prefisso1_oggetto=oggetto|prefisso1_preposizione=preposizione|...}}
- Prefissi brevi (progetti in italiano o multilingua):
- Nota: la lingua di default si può comunque cambiare indicando il prefisso della lingua prima del collegamento (xx:)
- |commons| (commons)
- |s| (wikisource italiano)
- |testo| per un testo completo su Wikisource
- |b| (wikibooks italiano)
- |ricetta| per il wikibook libro di cucina
- |n| (wikinotizie)
- |q| (wikiquote italiano)
- |m| e |meta| (meta)
- |wikt| (wikizionario)
- |wikispecies| (wikispecies)
- |v| (wikiversità)
- |incubator| (incubator)
[modifica] Parametri avanzati
[modifica] Personalizzazioni del testo inserito
[modifica] Cambiare la preposizione
In alcuni casi il testo inserito da interprogetto nella voce suona male per via della preposizione che collega la frase standard con il nome della voce. Per esempio: "Wikisource contiene il testo completo di Inferno" (inserito con il paramentro |testo=...) sarebbe più elegante se la preposizione prima di Inferno fosse cambiata in "dell'". Nessun problema: in questo caso aggiungere un parametro con il nome del prefisso più "_preposizione" e dargli come valore la preposizione da usare. Nell'esempio visto: |s_preposizione=dell'.
[modifica] Specificare l'etichetta
Il testo che viene inserito da Interprogetto nella voce è per esempio: "Wikisource contiene opere originali di o su " + nome della voce. Se al posto del nome della voce si vuole visualizzare qualcosa di differente, si può specificare il testo desiderato usando il parametro etichetta.
Consideriamo la pagina w:Biella (BI): per chi sta leggendo la pagina risulta poco elegante il fatto che nel testo del collegamento agli altri progetti appaia sempre il "(BI)". Si può quindi decidere di cambiare l'"etichetta" del collegamento inserendo il parametro |etichetta=Biella. In questo modo qualsiasi progetto venga collegato con il template avrà come testo standard del collegamento "Biella" e non il nome della pagina "Biella (BI)". Usando |etichetta cambia l'etichetta di default per tutti i progetti. Per personalizzare un singolo progetto, vedi la sezione successiva.
[modifica] Etichette specifiche per ogni progetto
In alcuni casi si desidera un'etichetta diversa a secondo di quale progetto venga collegato. Ciò si ottiene inserendo un parametro opzionale il cui nome è il prefisso usato, per esempio "b", più "_etichetta". Il valore del parametro è l'etichetta da usare per quel progetto specifico. Per esempio in w:Microprocessore per collegare il libro su Wikibooks "Architetture dei processori", è stato inserito il template interprogetto con il paramentro aggiuntivo: |b_etichetta=Architetture dei processori. In questo modo il testo inserito risulta: Wikibooks contiene un libro su "Architetture dei processori" e non su "Microprocessore" come sarebbe stato senza specificare l'etichetta.
Specificando l'etichetta per un singolo progetto, l'etichetta di default non cambia (rimane il nome della voce o l'etichetta esplicitamente definita tramite il parametro |etichetta).
[modifica] I parametri "_oggetto"=
Oltre a personalizzare l'etichetta e la preposizione di collegamento tra la frase e l'etichetta, è a volte utile poter cambiare l'oggetto della frase. Per esempio la frase "Wikisource contiene opere originali..." può essere cambiata, specificando al posto del generico opere originali qualcosa di più specifico, per esempio l'autobiografia. Questo è possibile usando il parametro "_oggetto", a cui prima di _ va inserito il prefisso del progetto, per esempio s_oggetto=... per wikisource. Dopo il segno = inserire il testo che si desidera far apparire.
[modifica] Eliminare il testo inserito - il parametro nolink
Se si desidera evitare che il template interprogetto inserisca i collegamenti anche nel testo della voce (per esempio è così nel bar o nelle pagine utente) aggiungere come primo parametro nolink. Per esempio il testo:
{{interprogetto |nolink |commons=Commons:Bar_italiano |s=Wikisource:Bar |n=Wikinotizie:Bar |q=Wikiquote:Bar |wikt=Wikizionario:Bar |m=Meta:Babel |b=Wikibooks:Bar |wikispecies=Wikispecies:Village Pump}}
fa apparire nella barra di sinistra i collegamenti ai bar italiani degli altri progetti ma non li inserisce nel testo del bar.
[modifica] I prefissi speciali
In alcuni casi (per ora: libro di ricette su Wikibooks e testi completi su Wikisource) sono stati definiti dei prefissi che non funzionano normalmente in Mediawiki, ma che sono stati creati appositamente per Interprogetto. Per esempio scrivendo [[ricetta:Pizza]] non ottengo alcun collegamento, invece {{interprogetto|ricetta}} inserito in pizza collega al libro di cucina di wikibooks e personalizza il testo del collegamento in modo automatico.
[modifica] Le pagine utente
Spesso si possiedono pagine utente su molti dei progetti Wikimedia. Per collegare le pagine utente di Wikipedia nelle varie lingue è possibile aggiungere un interwiki, come per qualsiasi altra voce. Ma come collegare anche la pagina di Commons e quella di Wikisource per esempio?
Se si usa lo stesso nome utente sarà necessario aggiungere nella propria pagina utente:
-
- {{interprogetto|nolink|commons|s}}.
Se si usa un nome utente diverso in uno dei progetti il codice da usare è leggermente più complicato. Per esempio se ci chiamiamo Utente:NomeDiProva in Wikipedia e Wikinews, ma Utente:FotografoProvetto in Commons sarà necessario aggiungere alla propria pagina utente:
-
- {{interprogetto|nolink|commons=Utente:FotografoProvetto|n}}.
Si noti che inserendo come primo parametro nolink non apparirà nulla nel testo della pagina, ma soltanto nella barra di sinistra.
[modifica] Guida progetto per progetto
Apri il cassetto relativo al progetto che desideri collegare. Ricorda che se è già presente un template interprogetto nella voce, non se ne deve aggiungere un secondo: aggiungi invece i parametri al template già presente.
Qui si trovano anche le guide alla conversione dei vecchi template nel template unificato interprogetto.
[modifica] Wikipedia
[modifica] Collegare la voce dell'opera di Wikipedia
In Wikiquote le opere sono generalmente incluse nelle voci dei loro autori: come i libri, così gli album. È opportuno rimandare dalla nostra voce direttamente alla voce specifica sull'opera in Wikipedia, se esiste, e viceversa (per come fare in Wikipedia, si veda la pagina di aiuto relativa). Per questo si usa il {{Pedia}}.
[modifica] Wikipedia interlingua
Per il collegamento verso wikipedia nelle varie lingue, è stato introdotto un parametro che permette la visualizzazione della notazione della lingua accanto all'immagine. In questo modo è possibile evidenziare la presenza di una pagina enciclopedica in un'altra lingua quando non presente su quella italiana.
{{interprogetto|w=Robinson Crusoe|w_site=en}}
Il parametro non funziona se non si specifica il titolo di destinazione.
Considera, comunque, la possibilità di creare un abbozzo nella Wikipedia in italiano (anche solo traducendo qualche frase dalla voce in un'altra lingua), che può essere l'inizio di una buona voce oltre che un utile snodo per raggiungere le altre Wikipedie.
[modifica] Wikisource
- Prefissi standard per il collegamento a wikisource
- "s" (lingua di default: italiano); una pagina qualunque (autori, singoli testi, categorie, template ecc.)
- "wikisource" (lingua di default: inglese).
- In interprogetto esiste in più il prefisso "testo" per collegare al testo completo di un'opera.
| Esempio d'uso | Risultato |
|---|---|
| {{interprogetto|s}} | Collega alla pagina con lo stesso nome e stesso namespace in Wikisource versione italiana |
| {{interprogetto|s=Autore:Giacomo Leopardi}} | Questo e il seguente sono gli usi più comuni del template. Collega la pagina Giacomo Leopardi alla pagina Giacomo Leopardi nel namespace Autore: di it.wikisource. |
| {{interprogetto|testo=I promessi sposi}} | Collega la pagina di Wikiquote a quella del testo su Wikisource: si noti che spesso i nomi non coincidono tra progetti. |
| {{interprogetto|wikisource}} | Collega alla pagina con lo stesso nome e stesso namespace in Wikisource versione inglese |
| {{interprogetto|wikisource=it:Autore:Giacomo Leopardi}} | Identico al primo esempio, ma inutilmente più complicato |
| {{interprogetto|wikisource=Author:Daniel Defoe}} {{interprogetto|s=en:Author:Daniel Defoe}} |
Collega alla pagina su Daniel Defoe nel wikisource inglese |
| {{interprogetto|s=Autore:Giacomo Leopardi|s_oggetto=poesie}} | Al posto di "opere originali di o su Giacomo Leopardi" scrive "poesie di o su Giacomo Leopardi" |
| {{interprogetto|s=Autore:Giacomo Leopardi|s_preposizione=di}} | Al posto di "opere originali di o su Giacomo Leopardi" scrive "opere originali di Giacomo Leopardi" |
| {{interprogetto|s=Autore:Giacomo Leopardi|s_etichetta=Leopardi, Giacomo}} | Al posto di "opere originali di o su Giacomo Leopardi" scrive "opere originali di o su Leopardi, Giacomo" |
| {{interprogetto|testo=I promessi sposi|testo_oggetto=una porzione del testo}} | Al posto di "il testo completo di I promessi sposi" scrive "una porzione del testo di I promessi sposi" |
| {{interprogetto|testo=I promessi sposi|testo_preposizione=de}} | Al posto di "il testo completo di I promessi sposi" scrive "il testo completo de I promessi sposi" |
| {{interprogetto|testo=I promessi sposi|testo_preposizione=dei|testo_etichetta=Promessi sposi}} | Al posto di "il testo completo di I promessi sposi" scrive "il testo completo dei Promessi sposi" |
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{wikisource}} | |s |
| {{wikisource|Autore:Giacomo Leopardi}} | |s=Autore:Giacomo Leopardi |
| {{wikisource|Author:Daniel Defoe|en:}} | |s=en:Author:Daniel Defoe |
| {{wikisourcetesto|I promessi sposi}} | |testo=I promessi sposi |
| {{wikisourcetesto2|I promessi sposi}} (in una voce diversa da I promessi sposi) |
|testo=I promessi sposi|etichetta=I promessi sposi |
| {{Wikisource articolo|titolo=Puoi fidarti del tuo computer|autore=Richard Stallmann}} | |s=Puoi fidarti del tuo computer|s_oggetto=l'articolo di [[Richard Stallmann]]|s_preposizione=: |
[modifica] Commons
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{commons}} | |commons |
| {{commons|airport}} (in w:aeroporto) |
|commons=airport |
| {{commons|Biella|Biella}} (in w:Biella (BI)) |
|commons=Biella|etichetta=Biella |
[modifica] Wikibooks
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{wikibooks|titololibro/sottopagina}} | |b=titololibro/sottopagina |
| {{wikibooks|titololibro/sottopagina|della}} | |b=titololibro/sottopagina|b_preposizione=della |
| {{wikibooks|titololibro||libro}} | |b=titololibro|b_oggetto=un libro |
| {{wikibooks|titololibro|libro}} | |b=titololibro|b_etichetta=libro |
| {{ricetta}} | |ricetta |
[modifica] Wiktionary
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{wiktionary}} | |wikt |
| {{wiktionary|titolo}} | |wikt=titolo |
[modifica] Wikispecies
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{wikispecies}} | |wikispecies |
| {{wikispecies|Titolo}} | |wikispecies=Titolo |
| {{wikispecies|Titolo|Etichetta}} | |wikispecies=titolo|etichetta=Etichetta |
[modifica] Wikinews
| Vecchi template | Parametri corrispondenti in interprogetto |
|---|---|
| {{wikinews|categoria:nome categoria}} | |n=Categoria:nome categoria |
| {{wikinews|titolo notizia}} | |notizia=titolo notizia in un template separato |
| {{wikinewsmulti|titolo notizia1|titolo notizia 2}} template inutilizzato |
|notizia=titolo notizia un template per ogni notizia |
Nota: per collegare una o più notizie all'interno delle voci è fortemente consigliato utilizzare il {{Interprogetto/notizia}}, nella forma:
| {{Interprogetto/notizia|titolo della notizia|data=...}} |
dove data= è un parametro opzionale.
[modifica] Risoluzione di eventuali problemi
Se il template non funziona correttamente:
- Sono corretti i prefissi di collegamento ad altri progetti usati?
-
- Leggi sopra l'elenco dei prefissi accettati. In particolare notare che i nomi dei prefissi sono case sensitive e vanno per il template interprogetto solo in minuscolo! Per esempio Wikisource o WikiSource non sono accettati dal template, mentre wikisource lo è.
- È stato inserito un collegamento a un progetto non Wikimedia?
-
- I progetti non wikimedia (per esempio Wikitravel) non si possono collegare in questo modo.
- È stato inserito un prefisso seguito da = ma senza inserire il nome della pagina?
-
- I due modi per inserire il prefisso dei progetti sono prefisso (senza il segno "=") e prefisso=nome pagina. Nel primo caso non va usato il segno "=" e viene inserito il collegamento alla pagina con lo stesso nome e nello stesso namespace, nel secondo caso è possibile specificare il nome (+ eventualmente codice lingua e namespace) della pagina da collegare. Inserendo prefisso= (sbagliato: c'è il segno "=") si inserisce un collegamento errato.
- Si è tenuto conto dei namespace con nome diverso?
-
- A volte il nome del namespace varia a seconda del progetto. Per poter collegare ad un namespace diverso da quello della pagina di partenza, occorre usare la sintassi esplicita. Per esempio per collegare dalla voce Alessandro Manzoni di Wikipedia alla voce corrispondente su Wikisource, che si trova nel namespace "Autore", bisogna scrivere: {{interprogetto|s=Autore:Alessandro Manzoni}} al posto di {{interprogetto|s}}, che collega invece al namespace principale (nell'esempio di Manzoni funzionerebbe comunque, visto che c'è un redirect, ma non è ovviamente così in tutti i casi).
- Si è inserito nolink ma i collegamenti appaiono comunque nel testo della voce?
-
- Il parametro nolink deve essere inserito come primo parametro per essere efficace.
- Ho inserito correttamente il template ma, una volta salvata la pagina, appiono dei strani simboli tipo: #if: [[#switch:{{{1}}}]][[#switch:{{{1}}}]]
-
- Il problema è dovuto al superamento del pre-expand include size (vedi anche). Se vengono collegate più notizie cambia il richiamo da {{Interprogetto|notizia=...}} a {{Interprogetto/notizia|...}}, lasciando uguale nei collegamenti ad altri progetti. Se il problema rimane controllare gli altri template presenti nella pagina e provare ad accorparne qualcuno, se possibile; oppure, nei casi più gravi, cancellare quelli non indispensabili.
- Sono apparsi ben due collegamenti al progetto!
-
- Hai premesso alla sintassi del template un asterisco; basta toglierlo.
- Altri malfunzionamenti
-
- Descrivere il problema nella pagina di discussione del template.
[modifica] Documentazione del codice
- Nota: se modificate il codice del template, per favore modificate anche questa documentazione.
Il codice comprende:
- La funzione interProject, inserita nel monobook.js comune
-
- Il codice è stato copiato dal monobook del wikizionario tedesco e lasciato praticamento identico, a parte i nomi delle etichette e variabili che sono stati italianizzati.
- Il template Interprogetto
- Richiama la funzione interProject e stabilisce il contenuto del testo che va inserito nel menu "altri progetti" in base ai parametri passati dall'utente. Se il primo parametro non è nolink, aggiunge anche collegamenti nel testo della voce.
- Per prima cosa se esiste un parametro il cui nome è uno dei prefissi accettati per il collegamento ad altri progetti, ne usa il valore per creare un collegamento (nel menu progetti) [[nome del parametro:valore del parametro]]. Questo si ottiene con una serie di istruzioni if che richiama il template "/Collegamento" nel caso in cui il parametro esista, per esempio (per il prefisso WikiSource): {{#if: {{{WikiSource|}}} |{{Interprogetto/Collegamento|s:{{{WikiSource|}}}|Wikisource}}|}}: è inserita un'istruzione if per ogni prefisso attualmente accettato. Inoltre controlla se uno dei parametri passati senza nome esplicito (1,2,3... fino al 9) corrisponde ad uno dei prefissi accettati, richiamando il template "/leggiParametro". In caso positivo, il template leggiParametro inserisce un collegamento ad una pagina del progetto corrispondente con lo stesso nome.
- Per ognuno dei prefissi accettati viene quindi controllato che il prefisso esista e che il primo parametro non sia nolink. Se entrambe le condizioni sono avverate viene inserito un richiamo al template inteprogetto/Box che inserisce la scritta nella voce relativa al prefisso in questione. Il controllo viene fatto sia sui parametri standard da 1 a 9, sia sulla presenza di parametri che abbiano come nome un prefisso accettato. In quest'ultimo caso si usa il valore del parametro per impostare il collegamento. Nel caso sia inserito il parametro etichetta, il richiamo al template /box ne tiene conto, passando il parametro (altrimenti passa come etichetta il nome della pagina senza namespace).
- Il template {{Interprogetto/Collegamento}}
- Formatta il collegamento da inserire così: * [[prefissoProgetto:nomePaginaDaCollegare|Nome del progetto]].
- Questo è ottenuto tramite il semplice codice:* [[{{{1|}}}|{{{2|}}}]]. La necessità del template deriva dal fatto che sostituendo direttamente questo codice nel template Interprogetto, la formattazione del punto prima del collegamento risulta errata.
- Il template {{Interprogetto/leggiParametro}}.
- Controlla se un parametro corrisponde ad uno dei prefissi accettati per i progetti Wikimedia; in caso positivo usa il template Interprogetto/Collegamento per inserire un collegamento ad una pagina nell'altro progetto con lo stesso nome della pagina collegata.
- Viene usato uno switch controllando se il parametro passato al template corrisponde ad una serie di etichette (i prefissi accettati). In caso positivo usa il nome dell'etichetta per creare un collegamento tramite {{interprogetto/Collegamento|{{{1}}}:{{FULLPAGENAME}}|Nome del progetto}}. Se il parametro non corrisponde ad un prefisso accettato non inserisce alcun testo.
- Il template {{Interprogetto/Box}}.
- Inserisce nel testo della voce uno dei testi standard (dotati di relative icone) per i collegamenti ad altri progetti. Richiede tre parametri: (1) progetto specifica il nome del progetto e permette la selezione del testo e dell'icona relative; (2) collegamento specifica il nome della pagina a cui puntare il collegamento; etichettaspecifica il testo da inserire sul collegamento vero e proprio.
- Viene usato uno switch controllando se il parametro progetto passato al template corrisponde ad una serie di etichette (i prefissi accettati). A seconda del progetto viene inserito quindi un testo diverso.