Aiuto:Interprogetto

Da Wikipedia, l'enciclopedia libera.

	«Per collegare nel menu di sinistra ad una pagina in un'altra lingua si usa un interwiki, così: [[codice lingua:nome pagina]]. È possibile farlo anche per collegare un altro progetto?»

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). Il template va inserito in un nuovo paragrafo dal titolo Altri progetti posto dopo le Voci correlate e prima dei Collegamenti esterni.

I progetti Wikimedia a cui è possibile inserire collegamenti sono: Meta, Wiktionary/Wikizionario, Wikibooks, Wikiquote, Wikisource, 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).

Inserire soltanto un template interprogetto per pagina (ma questo può collegare a più progetti, come spiegato in seguito); eccezione: se si usa il template con il parametro "notizia". Se si inseriscono più template bisogna tener conto del fatto che solo il primo (il primo senza parametro "notizia") produce anche i collegamenti nel menu di sinistra.

Per capire come usare il template bisogna sapere che:

• va usato un solo template per pagina (con l'eccezione del collegamento a notizie su wikinews)
• inserisce un collegamento in alto a sinistra ad una pagina di un altro progetto
• ogni progetto ha un prefisso di collegamento (es: wininotizie ha il prefisso "n")
• inserisce una nota nel testo della voce in cui è usato
• il testo della nota è: "PROGETTO" contiene "OGGETTO" "PREPOSIZIONE" [[COLLEGAMENTO|ETICHETTA]]. Il Progetto si specifica tramite il prefisso usato. Oggetto, Preposizione, Collegamento, Etichetta sono inseriti automaticamente, ma possono essere modificati a piacere con parametri opzionali.

Guida rapida

• Uso: {{interprogetto|parametro1|parametro2|...}}
  • Stesso nome pagina: |prefisso del progetto| esempio: {{Interprogetto|wikt}}
  • Nome pagina diverso: |prefisso=nome pagina| esempio: {{Interprogetto|n=Prova}}
  • Altra lingua: |progetto=lingua:nome pagina| esempio: {{Interprogetto|b=fr:Tentatif}}

• 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)

Altri prefissi

• Prefissi lunghi (progetti in inglese):
  • Nota: la lingua di default si può comunque cambiare indicando il prefisso della lingua prima del collegamento (xx:)
  • |wikisource| (wikisource inglese)
  • |wikibooks| (wikibooks inglese)
  • |wikinews| (wikinews inglese)
  • |wikiquote| (wikiquote inglese)
  • |wiktionary| (wiktionary inglese)

• Collegare una notizia
  • |notizia=titolo| titolo notizia obbligatorio; usare un template interprogetto a parte per questo parametro
  • |notizia=...|data=...| per aggiungere anche la data alla notizia

• Non inserire il collegamento nel testo: |nolink| come primo parametro
• Solo il primo template interprogetto nella pagina produce collegamenti a sinistra.
• Etichetta particolare nel collegamento nel testo (per tutti i progetti):|etichetta=questo testo|
• Etichetta particolare nel collegamento nel testo (per un progetto):|(progetto)_etichetta=questo testo|
  • Diversa descrizione contenuto del progetto (libro, ricetta...):|(progetto)_oggetto= testo da usare|
• Preposizione diversa prima del collegamento (del, della, degli...): |(progetto)_preposizione = preposizione da usare|}}

Guida dettagliata

Il caso più semplice - collegare una pagina con lo stesso nome

Per collegare ad una pagina con lo stesso nome è sufficiente inserire: {{interprogetto|prefisso}}, sostituendo a "prefisso" uno dei prefissi accettati per il collegamento ad altri progetti (scritti in minuscolo, vedi sopra l'elenco completo). Per esempio per collegare a Wikisource è sufficiente inserire: {{interprogetto|s}}.

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

Non usare più richiami al template per collegare a più progetti, ma, come visto, un solo richiamo a cui vengano aggiunti più parametri. In caso contrario i richiami successivi al primo non produrranno alcun collegamento in alto a sinistra.

Collegare una pagina con un nome diverso

Se la pagina sul progetto da collegare ha un nome o namespace diverso (per esempio dalla voce di wikipedia Pavia collegare la Categoria:Pavia su Wikinews) è necessario specificare il nome della pagina da collegare: {{interprogetto|prefisso=nome pagina}} (nell'esempio di Pavia occorre inserire: {{interprogetto|n=Categoria:Pavia}}).

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 e specifica esplicitamente a quali pagine collegare. È 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 specificare esplicitamente il prefisso della lingua + il nome della pagina (anche se questo dovesse essere uguale): {{interprogetto|prefisso=lingua:nome pagina}}. Si noti che attualmente in mediawiki (e anche in interprogetto) alcuni prefissi collegano di default ai progetti in lingua italiana, altri in lingua inglese: per esempio "s" a it.wikisource, "wikisource" a en.wikisource. Per collegare alle pagine inglesi basta quindi spesso usare la forma più lunga del prefisso.

Wikinews

L'uso del template interprogetto per collegare ad una categoria di wikinotizie avviene esattamente come indicato finora. Per esempio inserendo {{interprogetto|n=Categoria:Pavia}} in Pavia si collega alla categoria:Pavia di wikinotizie. Se si vuole invece inserire un collegamento ad una singola notizia, è necessario usare un richiamo separato del template. Il template va cioè richiamato una seconda volta anche se già presente nella pagina e questa volta va usato come parametro |notizia=... dove dopo il segno = è inserito il titolo della notizia. Anche in questo caso esiste un parametro opzionale che è |data=... per inserire la data della notizia. Il template {{interprogetto|notizia=...}} si comporta in pratica come un template indipendente dall'inteprogetto inserito con tutti gli altri parametri. Esso inoltre non inserisce alcun collegamento nel menu della barra di sinistra ed è posizionabile ovunque nella voce.

Parametri avanzati

Personalizzazioni del testo inserito

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'.

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

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 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).

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.

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.

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.

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.

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.

Wikisource

• Prefissi standard per il collegamento a wikisource "s" (lingua di default: italiano); "wikisource" (lingua di default: inglese). * In interprogetto esiste in più il prefisso "testo" per collegare il testo completo di un'opera.

Esempio d'uso	Risultato
{{interprogetto|s=Autore:Giacomo Leopardi}}	Questo e il seguente sono gli usi più comuni del template. Collega alla pagina Giacomo Leopardi del namespace Autore: di it.wikisource.
{{interprogetto|testo=I promessi sposi}}	Collega un testo su Wikisource
{{interprogetto|s}}	Collega alla pagina con lo stesso nome e stesso namespace in Wikisource versione italiana
{{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}}	Collega alla pagina su Daniel Defoe nel wikisource inglese
{{interprogetto|s=en:Author:Daniel Defoe}}	Identico al precedente
{{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=:

Commons

Vecchi template	Parametri corrispondenti in interprogetto
{{commons}}	|commons
{{commons|airport}} (in aeroporto)	|commons=airport
{{commons|Biella|Biella}} (in Biella (BI))	|commons=Biella|etichetta=Biella

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

Wikiquote

Vecchi template	Parametri corrispondenti in interprogetto
{{wikiquote}}	|q
{{wikiquote|Titolo}}	|q=Titolo
{{wikiquote|Titolo|xx:}}	|q=xx:Titolo

Wiktionary

Vecchi template	Parametri corrispondenti in interprogetto
{{wiktionary}}	|wikt
{{wiktionary|titolo}}	|wikt=titolo

Wikispecies

Vecchi template	Parametri corrispondenti in interprogetto
{{wikispecies}}	|wikispecies
{{wikispecies|Titolo}}	|wikispecies=Titolo
{{wikispecies|Titolo|Etichetta}}	|wikispecies=titolo|etichetta=Etichetta

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

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.

• Altri malfunzionamenti

Descrivere il problema nella pagina di discussione del template.

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.