Changes

8,135 bytes added ,  05:55, 27 July 2020
Updating to match new version of source page
<noinclude>
<languages />
</noinclude>{{#switch:
| =
<includeonly>{{languages|Module:Transcluder/doc}}</includeonly>
{{Shared Template Warning|Module:Transcluder|Module:Transcluder}}
Este módulo es un '''motor de transclusiones''' genérico, capaz de transcluir cualquier parte de cualquier página y con muchas opciones que las trasnclusiones normales no ofrecen.

== Uso ==

== Módulos ==

El punto de entrada principal para módulos es el método <code>get</code>.

* <code>get( 'Title' )</code> — Obtener la páginas solicitada (idéntico resultado a una transclusión normal)
* <code>get( 'Title#' )</code> — Obtener la sección introductoria de la página solicitada
* <code>get( 'Title#Section' )</code> — Obtener la sección o etiqueta {{tag|section|open}} solicitada (incluye subsecciones)

Las etiquetas {{tag|noinclude|open}} y {{tag|onlyinclude|open}} se procesan de [[Special:MyLanguage/Transclusion#Transclusion markup|modo ordinario]] y también existe un segundo parámetro opcional para excluir varios elementos del resultado:

* <code>get( 'Title#Section', { files = 0 } )</code> — Excluir todos los archivos
* <code>get( 'Title#Section', { files = 1 } )</code> — Excluir todos los archivos excepto el primero
* <code>get( 'Title#Section', { files = 2 } )</code> — Excluir todos los archivos excepto el segundo
* <code>get( 'Title#Section', { files = '1,2' } )</code> — Excluir todos los archivos excepto el primero y el segundo
* <code>get( 'Title#Section', { files = '1-3' } )</code> — Excluir todos los archivos excepto el primero, segundo y tercero
* <code>get( 'Title#Section', { files = '1,3-5' } )</code> — Excluir todos los archivos excepto el primero, tercero, cuarto y quinto
* <code>get( 'Title#Section', { files = -2 } )</code> — Excluir el segundo archivo
* <code>get( 'Title#Section', { files = '-2,3' } )</code> — Excluir el segundo y tercer archivos
* <code>get( 'Title#Section', { files = '-1,3-5' } )</code> — Excluir el primer, tercer, cuarto y quinto archivos
* <code>get( 'Title#Section', { files = 'A.png' } )</code> — Excluir todos los archivos excepto A.png
* <code>get( 'Title#Section', { files = '-A.png' } )</code> — Excluir A.png
* <code>get( 'Title#Section', { files = 'A.png, B.jpg, C.gif' } )</code> — Excluir todos los archivos excepto A.png, B.jpg y C.gif
* <code>get( 'Title#Section', { files = '-A.png, B.jpg, C.gif' } )</code> — Excluir A.png, B.jpg y C.gif
* <code>get( 'Title#Section', { files = { [1] = true, [3] = true } } )</code> — Excluir todos los archivos excepto el primero y tercero
* <code>get( 'Title#Section', { files = { [1] = false, [3] = false } } )</code> — Excluir el primer y tercer archivo
* <code>get( 'Title#Section', { files = { ['A.png'] = false, ['B.jpg'] = false } } )</code> — Excluir A.png y B.jpg
* <code>get( 'Title#Section', { files = '.+%.png' } )</code> — Excluir todos los archivos excepto los archios PNG (véase [[Special:MyLanguage/Extension:Scribunto/Lua reference manual#Patterns|patrones Lua]])
* <code>get( 'Title#Section', { files = '-.+%.png' } )</code> — Excluir todos los archivos PNG

La misma sintaxis se puede utilizar para excluir muchos otros elementos:

* <code>get( 'Title#Section', { sections = 0 } )</code> — Excluir todas las subsecciones
* <code>get( 'Title#Section', { sections = 'History, Causes' } )</code> — Excluir todas las subsecciones excepto 'Historia' y 'Causas'
* <code>get( 'Title#Section', { lists = 1 } )</code> — Excluir todas las listas excepto la primera
* <code>get( 'Title#Section', { tables = 'stats' } )</code> — Excluir todas las tablas excepto la que tiene id 'stats'
* <code>get( 'Title#Section', { paragraphs = '1-3' } )</code> — Excluir todos los párrafos excepto el primero, segundo y tercero
* <code>get( 'Title#Section', { references = 0 } )</code> — Excluir todas las referencias
* <code>get( 'Title#Section', { categories = '0' } )</code> — Excluir todas las categorías
* <code>get( 'Title#Section', { templates = '-.+infobox' } )</code> — Excluir las plantillas de infoboxes
* <code>get( 'Title#Section', { parameters = 'image' } )</code> — Excluir todos los parámetros de todas las plantillas excepto el parámetro 'image'

Las opciones se pueden combinar a voluntad.
Por ejemplo:

* <code>get( 'Title#Section', { sections = 0, files = 1, paragraphs = '1-3' } )</code> — Excluir todas las subsecciones, todos los archivos excepto el primero y todos los párrafos excepto los primeros tres.

También puedes obtener solo algunos elementos así:

* <code>get( 'Title#Section', { only = 'files' } )</code> — Obtener solo los archivos
* <code>get( 'Title#Section', { only = 'lists', lists = 1 } )</code> — Obtener solo la primera lista
* <code>get( 'Title#Section', { only = 'tables', tables = 'stats' } )</code> — Obtener solo la tabla con id 'stats'
* <code>get( 'Title#Section', { only = 'paragraphs', paragraphs = '1,3-5' } )</code> — Obtener solo el primer, tercer, cuarto y quinto párrafos
* <code>get( 'Title#Section', { only = 'templates', templates = 'Infobox' } )</code> — Obtener solo la infobox
* <code>get( 'Title#Section', { only = 'files, lists', files = 1 } )</code> — Obtener solo el primer archivo, seguido de todas las listas

El resultado también se puede modificar con unas pocas opciones especiales:

* <code>get( 'Title#Section', { noFollow = true } )</code> — No seguir redirecciones
* <code>get( 'Title#Section', { linkBold = true } )</code> — Enlazar el título en negritas o su sinónimo cerca del comienzo del texto
* <code>get( 'Title#Section', { noBold = true } )</code> — Quitar el texto en negritas
* <code>get( 'Title#Section', { noSelfLinks = true } )</code> — Quitar los enlaces al artículo transclusor
* <code>get( 'Title#Section', { noBehaviorSwitches = true } )</code> — Quitar las [[Special:MyLanguage/Help:Magic words#Behavior switches|opciones de comportamiento]] como <code><nowiki>__NOTOC__</nowiki></code>
* <code>get( 'Title#Section', { fixReferences = true } )</code> — Rescatar referencias definidas fuera de la sección solicitada y prefijar los nombres de las referencias con 'Título ' para evitar conflictos en los nombres de las referencias

Además del método <code>get</code>, el módulo expone varios otros métodos para obtener partes específicas del wikitexto.
Esto permite a otros módulos combinar los elementos de maneras más avanzadas.

=== Plantillas ===

El principal punto de entrada para plantillas es el método <code>main</code>.
Esencialmente es un envoltorio del método <code>get</code> para que sea utilizable en plantillas.

Véase la documentación del método <code>get</code> para más detalles y opciones.

* <code><nowiki>{{#invoke:Transcluder|main|Title}}</nowiki></code> — Transcluir la página solicitada
* <code><nowiki>{{#invoke:Transcluder|main|Title#}}</nowiki></code> — Transcluir la sección introductoria de la página solicitada
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section}}</nowiki></code> — Transcluir la sección o etiqueta {{tag|section|open}} solicitada (incluye subsecciones)
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section|sections=0}}</nowiki></code> — Transcluir la sección solicitada, excluyendo subsecciones
* <code><nowiki>{{#invoke:Transcluder|main|Title|only=files|files=1}}</nowiki></code> — Transcluir solo el primer archivo de la página
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section|only=tables|tables=2}}</nowiki></code> — Transcluir solo la segunda tabla de la sección solicitada
* <code><nowiki>{{#invoke:Transcluder|main|Title#|only=paragraphs|linkBold=yes}}</nowiki></code> — Transcluir solo los párrafos de la sección introductoria y enlazar el texto en negritas

== Véase también ==
* [[Module:Transcluder/testcases]]
* [[c:Data:i18n/Module:Transcluder.tab]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->

}}</includeonly>
| #default=
{{#invoke:Template translation|renderTranslatedTemplate|template=Module:Transcluder/doc|noshift=1|uselang={{int:lang}}}}
}}
Anonymous user