Template:Interprogetto

Documentazione

Questa documentazione è transclusa da Template:Interprogetto/doc. (modifica | cronologia)
Questo template ha una pagina delle prove (modifica) per fare sperimentazioni.

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, Wikiquote, 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 "Voci correlate" della voce.

Uso

Nota:Se usate per la prima volta il template, leggete prima la guida dettagliata.

• Stesso nome pagina: {{interprogetto|prefisso1|prefisso2|prefisso3|...}}
• Nome pagina diversi: {{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|...}}
• Elenco dei prefissi accettati.

Guida dettagliata

Vedere anche la pagina Aiuto:Interprogetto.

Collegare una pagina con lo stesso nome

Per collegare ad una pagina con lo stesso nome è sufficente inserire: {{interprogetto|prefisso}}, sostituendo a "prefisso" uno dei prefissi accettati per il collegamento ad altri progetti (vedi questa pagina per l'elenco completo).

Per esempio per collegare a Wikisource è sufficente inserire: {{interprogetto|s}}.

Per collegare due progetti inserire più di un codice, separandolo con il carattere |. Per esempio per inserire un collegamento a Commons e Wikinotizie inserire: {{interprogetto|commons|n}}.

Collegare una pagina con un nome diverso

Per collegare ad una pagina in un altro progetto che non ha lo stesso nome della pagina in cui si inserisce il collegamento, è necessario specificare il nome della pagina in questo modo: {{interprogetto|prefisso=nome pagina}}, sostituendo a "prefisso" uno dei prefissi accettati per il collegamento ad altri progetti (vedi questa pagina per l'elenco completo) e a "nome pagina" il nome della pagina da collegare.

Per esempio per collegare alla pagina Alessandro Manzoni di Wikipedia, inserire {{interprogetto|w=Alessandro Manzoni}}.

E' utile in alcuni casi inserire anche il parametro etichetta (vedi sotto).

Anche in questo caso è possibile collegare due o più progetti. Per esempio: {{interprogetto|s=Autore:Alessandro Manzoni|q=Alessandro Manzoni}}, collega sia a Wikisource che a Wikiquote.

È anche possibile combinare le due tecniche di collegamento viste in questo paragrafo e in quello precedente. Per esempio per collegare una pagina con lo stesso nome su Wikinotizie, ma con nome diverso su Commons si può scrivere: {{interprogetto|n|commons=World Cup 2006}}.

Collegare ad un progetto in un'altra lingua

Per collegare una pagina ad un progetto in una lingua differente (per esempio Wikisource in inglese) è necessario usare la tecnica di inserimento del collegamento vista nel paragrafo precedente (cioè specificando il nome della pagina) aggiungendo il prefisso per la lingua prima del nome della pagina, in questo modo: {{interprogetto|prefisso=lingua:nome pagina}}.

Per esempio per collegare dalla pagina Robinson Crusoe la pagina con lo stesso nome della Wikisource inglese è necessario scrivere: {{interprogetto|s=en:Robinson Crusoe}}.

Anche in questo caso è possibile combinare con gli altri tipi di collegamento, per esempio inserendo {{interprogetto|s=en:Robinson Crusoe|commons|q=Daniel Defoe}} nella voce su Robinson Crusoe si ottiene il collegamento alla pagina Robinson Crusoe della Wikisource inglese, alla pagina Robinson Crusoe su Commons e alla pagina Daniel Defoe sulla Wikisource italiana.

Caso particolare - il parametro etichetta

In alcuni casi, si decide di collegare una pagina di Wikipedia ad una pagina su un altro progetto che non tratta direttamente dello stesso argomento.

Il testo che viene aggiunto 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, è necessario specificare il testo desiderato usando il parametro etichetta.

Per esempio: {{interprogetto|etichetta=questo personaggio|s=en:Robinson Crusoe}} inserisce nel testo della voce "Wikisource contiene opere originali di o su questo personaggio" anzichè "Wikisource contiene opere originali di o su Robinson Crusoe", come avviene normalmente.

Si noti che l'etichetta viene applicata a tutti i collegamenti ai vari progetti. Non è cioè possibile specificare un'etichetta diversa per ogni progetto. Se si desidera farlo è necessario disabilitare l'inserzione dei collegamenti nel testo (parametro nolink, vedi sezione successiva) e inserire i collegamenti richiamando a mano il template "inteprogetto/box" per ognuno dei progetti, inserendo ogni volta come parametro etichetta il testo desiderato (vedi documentazione del codice per maggiori informazioni).

Caso particolare - 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.

Esempio - Collegare la propria pagina 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.

Risoluzione di eventuali problemi

Se il template non funziona correttamente:

• Sono corretti i prefissi di collegamento ad altri progetti usati?

Leggi l'elenco dei prefissi accettati. In particolare notare che i nomi dei prefissi sono case sensitive. Per esempio Wikisource o wikisource non sono prefissi accettati, 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.

Documentazione del codice

Nota: se modificate il codice del template, perfavore 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.