Ayuda:Transclusión


Transclusión significa la inclusión del contenido de un documento dentro de otro documento por referencia . En la transclusión de Wikipedia, el software MediaWiki se referirá al contenido de una página, la plantilla , para incluirlo en el contenido de cualquier otra página, la página de destino. Similar a la forma en que cualquier nombre de página puede convertirse en un enlace colocando su nombre entre corchetes dobles, cualquier nombre de página puede convertirse en una plantilla colocándolo entre llaves dobles, . Los cambios realizados en la plantilla se reflejan automáticamente en todas las páginas en las que se ha transcluido esa página (aunque a veces puede ser necesaria una purga ).{{Namespace:Pagename}}

Si el nombre de la página de la plantilla no comienza con un espacio de nombres, se supone que está en el espacio de nombres de la plantilla. Para hacer referencia a una página en el espacio de nombres "Principal" (artículo), es necesario anteponer dos puntos ( : ). Ejemplos:

Lo que se transcluirá de una página se puede controlar con las etiquetas <noinclude>, <onlyinclude> y <includeonly> colocadas en el wikitexto de la página de origen. (Consulte marcado , a continuación). El uso de etiquetas permite que la plantilla se transcluya parcialmente; de ​​lo contrario, las llaves dobles siempre transcluirán todo el contenido. Para la transclusión selectiva , se nombran las partes <includeonly> de la plantilla (con la ayuda de las funciones del analizador ) y luego se llama a esa plantilla con el parámetro .transcludesection=name

Los eventos de transclusión ocurren cada vez que se carga la página , cuando se representa la plantilla. Otro uso del mismo mecanismo es una sustitución única de la llamada de plantilla por su página de origen transcluida. Una llamada de plantilla con el prefijo "subst:" se transcluye una vez, pero nunca más, porque el wikitexto de esa llamada se reemplaza (sustituye) cuando se guarda su página . Lo que era una llamada de plantilla única se convierte en el wikitexto real de la plantilla en el momento de su llamada.{{fullpagename}}{{subst:fullpagename}}

Para transcluir cualquier página de origen (dentro de un solo proyecto de MediaWiki, como en:Wikipedia), use el siguiente código en la página de destino :

Cada vez que escribe el código ( {{SOURCEPAGE}}) en una página de destino, le está diciendo al software de Wikipedia que coloque todo el contenido SOURCEPAGEen la página de destino.