Jump to content

Module:Transcluder/doc

From mediawiki.org
This page is a translated version of the page Module:Transcluder/doc and the translation is 100% complete.

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 transclusiones normales no ofrecen.

Uso

Módulos

El punto de entrada principal para módulos es el método get.

  • get( 'Title' ) — Obtener la páginas solicitada (idéntico resultado a una transclusión normal)
  • get( 'Title#' ) — Obtener la sección introductoria de la página solicitada
  • get( 'Title#Section' ) — Obtener la sección o etiqueta ‎<section> solicitada (incluye subsecciones)

Las etiquetas ‎<noinclude> y ‎<onlyinclude> se procesan de modo ordinario y también existe un segundo parámetro opcional para excluir varios elementos del resultado:

  • get( 'Title#Section', { files = 0 } ) — Excluir todos los archivos
  • get( 'Title#Section', { files = 1 } ) — Excluir todos los archivos excepto el primero
  • get( 'Title#Section', { files = 2 } ) — Excluir todos los archivos excepto el segundo
  • get( 'Title#Section', { files = '1,2' } ) — Excluir todos los archivos excepto el primero y el segundo
  • get( 'Title#Section', { files = '1-3' } ) — Excluir todos los archivos excepto el primero, segundo y tercero
  • get( 'Title#Section', { files = '1,3-5' } ) — Excluir todos los archivos excepto el primero, tercero, cuarto y quinto
  • get( 'Title#Section', { files = -2 } ) — Excluir el segundo archivo
  • get( 'Title#Section', { files = '-2,3' } ) — Excluir el segundo y tercer archivos
  • get( 'Title#Section', { files = '-1,3-5' } ) — Excluir el primer, tercer, cuarto y quinto archivos
  • get( 'Title#Section', { files = 'A.png' } ) — Excluir todos los archivos excepto A.png
  • get( 'Title#Section', { files = '-A.png' } ) — Excluir A.png
  • get( 'Title#Section', { files = 'A.png, B.jpg, C.gif' } ) — Excluir todos los archivos excepto A.png, B.jpg y C.gif
  • get( 'Title#Section', { files = '-A.png, B.jpg, C.gif' } ) — Excluir A.png, B.jpg y C.gif
  • get( 'Title#Section', { files = { [1] = true, [3] = true } } ) — Excluir todos los archivos excepto el primero y tercero
  • get( 'Title#Section', { files = { [1] = false, [3] = false } } ) — Excluir el primer y tercer archivo
  • get( 'Title#Section', { files = { ['A.png'] = false, ['B.jpg'] = false } } ) — Excluir A.png y B.jpg
  • get( 'Title#Section', { files = '.+%.png' } ) — Excluir todos los archivos excepto los archivos PNG (véase patrones Lua)
  • get( 'Title#Section', { files = '-.+%.png' } ) — Excluir todos los archivos PNG

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

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

Las opciones se pueden combinar a voluntad. Por ejemplo:

  • get( 'Title#Section', { sections = 0, files = 1, paragraphs = '1-3' } ) — 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í:

  • get( 'Title#Section', { only = 'files' } ) — Obtener solo los archivos
  • get( 'Title#Section', { only = 'lists', lists = 1 } ) — Obtener solo la primera lista
  • get( 'Title#Section', { only = 'tables', tables = 'stats' } ) — Obtener solo la tabla con id 'stats'
  • get( 'Title#Section', { only = 'paragraphs', paragraphs = '1,3-5' } ) — Obtener solo el primer, tercer, cuarto y quinto párrafos
  • get( 'Title#Section', { only = 'templates', templates = 'Infobox' } ) — Obtener solo la infobox
  • get( 'Title#Section', { only = 'parameters', parameters = 'abstract', references = 0 } ) — Obtener solo el parámetro llamado 'abstract' y quitar todas las referencias del mismo

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

  • get( 'Title#Section', { noFollow = true } ) — No seguir redirecciones
  • get( 'Title#Section', { linkBold = true } ) — Enlazar el título en negritas o su sinónimo cerca del comienzo del texto
  • get( 'Title#Section', { noBold = true } ) — Quitar el texto en negritas
  • get( 'Title#Section', { noComments = true } ) — Quitar comentarios
  • get( 'Title#Section', { noLinks = true } ) — Quitar todos los enlaces
  • get( 'Title#Section', { noSelfLinks = true } ) — Quitar los enlaces al artículo transclusor
  • get( 'Title#Section', { noNonFreeFiles = true } ) — Quitar archivos no libres (identificados por tener las palabras 'non-free' en su descripción local o en Commons)
  • get( 'Title#Section', { noBehaviorSwitches = true } ) — Quitar las opciones de comportamiento como __NOTOC__
  • get( 'Title#Section', { fixReferences = true } ) — 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 get, 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 main. Esencialmente es un envoltorio del método get para que sea utilizable en plantillas.

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

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

Véase también