Aiuto:Transclusione: differenze tra le versioni

Contenuto cancellato Contenuto aggiunto
Aubrey (discussione | contributi)
Nessun oggetto della modifica
Riga 10:
}}
{{TOCright Aiuto}}
La '''transclusione''' è un processo attraverso il quale è possibile incorporare il contenuto di una pagina in un'altra. In altre parole, due o più documenti indipendenti vengono usati per generare un terzo nuovo e diverso: la terza pagina visualizza il contenuto delle prime due, e se in queste il testo viene modificato, viene modificato il risultato anche nella terza pagina.
 
Questo meccanismo viene utilizzato per modificare i dati in un solo posto, ed avere poi automaticamente le modifiche disponibili in tutte le altre pagine dove i dati sono visualizzati.
Questo processo è tipico delle pagine del [[aiuto:namespace template|namespace template]], vale a dire che un template è una pagina che si prevede sia incorporata in molte altre pagine di altri namespace. Ma in effetti tale procedimento è applicabile anche con qualunque altra pagina.
 
L'esempio più comune è la differenza, nei testi con scansione a fronte, fra namespace Pagina e namespace Principale: il testo viene modificato, pagina per pagina, nel namespace Pagina, che permette la visualizzazione dell'immagine. Viene poi, successivamente, ''transcluso'' (tramite gli appositi comandi) nel namespace Principale, dove viene visualizzato come un semplice testo.
Questo meccanismo complicato permette però di avere sempre un testo "originale", suscettibile di correzioni, grazie alla possibilità di confrontarlo con le scansioni delle pagine cartacee. Il testo "transcluso" verrà automaticamente aggiornato, senza inutili e dispendiosi copia-.incolla e correzioni manuali.
 
== Esempio ==
===Con un template===
Prima viene visualizzato il risultato dell'uso del template, quindi nel riquadro il codice da usare. Se vuoi fare degli esperimenti ricordati che c'è a tua disposizione la [[Wikisource:Pagina delle prove|pagina delle prove]] dove potrai incollare ciò che è contenuto in ogni riquadro.
 
===Con una pagina o sottopagina del namespace Principale===
Il template '''[[Template:Esempio di transclusione|Esempio di transclusione]]''' contiene un testo che vogliamo inserire in questa pagina, ovvero:
Se vogliamo transcludere il contenuto di una pagina o sottopagina del namespace principale, occorre anteporre al suo nome due punti. Volendo transcludere, ad esempio, il contenuto di questa sottopagina: [[Il cavallarizzo/Test]], la sintassi normale:
 
{{Esempio di transclusione}}
 
basterà scrivere in questa pagina
 
{{Ambox
Line 28 ⟶ 26:
| immagine = nessuna
| testo =
<nowiki>{{EsempioIl di transclusionecavallarizzo/Test}}</nowiki>
}}
===Con un'altra pagina===
Se vogliamo inserire in questa pagina il testo della pagina '''[[Progetto:Testi scientifici/Obiettivi]]''', come nell'esempio precedente basterà racchiudere il nome della pagina tra doppie graffe come se fosse un template: il risultato qui sotto:
 
dà un errore:
 
{{Il cavallarizzo/Test}}
 
mentre questo codice:
{{Progetto:Testi scientifici/Obiettivi}}
 
 
 
si ottiene scrivendo in questa pagina
 
{{Ambox
Line 45 ⟶ 39:
| immagine = nessuna
| testo =
<nowiki>{{Progetto:TestiIl scientificicavallarizzo/ObiettiviTest}}</nowiki>
}}
 
dà il risultato corretto:
===Con una pagina o sottopagina del namespace Principale===
 
Se vogliamo transcludere il contenuto di una pagina o sottopagina del namespace principale, occorre anteporre al suo nome due punti. Volendo transcludere, ad esempio, il contenuto di questa sottopagina: [[Il cavallarizzo/Test]], la sintassi normale:
{{:Il cavallarizzo/Test}}
 
 
===Con un template===
QuestoLa processotransclusione è un processo tipico delle pagine del [[aiuto:namespace template|namespace template]], vale a dire che un template è una pagina che si prevede sia incorporata in molte altre pagine di altri namespace. Ma in effetti tale procedimento è applicabile anche con qualunque altra pagina.
 
Prima viene visualizzato il risultato dell'uso del template, quindi nel riquadro il codice da usare. Se vuoi fare degli esperimenti ricordati che c'è a tua disposizione la [[Wikisource:Pagina delle prove|pagina delle prove]] dove potrai incollare ciò che è contenuto in ogni riquadro.
 
Il template '''[[Template:Esempio di transclusione|Esempio di transclusione]]''' contiene un testo che vogliamo inserire in questa pagina, ovvero:
 
{{Esempio di transclusione}}
 
basterà scrivere in questa pagina
 
{{Ambox
Line 55 ⟶ 62:
| immagine = nessuna
| testo =
<nowiki>{{IlEsempio cavallarizzo/Testdi transclusione}}</nowiki>
}}
===Con un'altra pagina===
Se vogliamo inserire in questa pagina il testo della pagina '''[[Progetto:Testi scientifici/Obiettivi]]''', come nell'esempio precedente basterà racchiudere il nome della pagina tra doppie graffe come se fosse un template: il risultato qui sotto:
 
{{Progetto:Testi scientifici/Obiettivi}}
dà un errore:
 
si ottiene scrivendo in questa pagina
{{Il cavallarizzo/Test}}
 
mentre questo codice:
 
{{Ambox
Line 68 ⟶ 75:
| immagine = nessuna
| testo =
<nowiki>{{Progetto:IlTesti cavallarizzoscientifici/TestObiettivi}}</nowiki>
}}
 
dà il risultato corretto:
 
{{:Il cavallarizzo/Test}}
 
==Transclusione selettiva==