Muchas comunidades utilizan plantillas de citas para destacar fragmentos de texto importantes, como letras de canciones, pasajes de libros, frases habladas o extractos de entrevistas o artículos de noticias. Estas plantillas pueden contener citas de una sola fuente, diálogos, etc.
Creación de plantillas
Template:StructuredQuote es la plantilla que se utilizará de forma predeterminada. Esta plantilla será creada por Fandom, y respetará cualquier versión anterior creada por la comunidad. Se puede cambiar el nombre, pero solo funcionará si hay una redirección desde el nombre original.
Wikitext funciona en esta plantilla, como cualquier otra plantilla. El siguiente código se puede utilizar para crear una versión simple de esta plantilla con todos los parámetros que se almacenarán:
:"''{{{text}}}''"
:— <small>speaker: {{{speaker}}}
:- receiver: {{{receiver}}}
:- attribution {{{attribution}}}
:- source: {{{source}}}</small>
:- author: {{{author}}}</small>
Las citas estructuradas (Structured Quote) siempre presentan su resultado como lo hace una plantilla normal. Esto significa que no se ha creado ningún bloque de texto implícito.
Usando diferentes plantillas de salida
Template:StructuredQuote es la plantilla predeterminada que utiliza {{#SQuote:...}}. Sin embargo, es posible formatear la salida utilizando una plantilla diferente, utilizando el parámetro template cuando se crea una nueva cita, se consultan varias citas o se invoca una cita creada en un artículo diferente.
El nombre de la plantilla debe darse en la sintaxis como texto sin formato, es decir Example template y no [[Template:Example template]] o {{Example template}}.
Personalizaciones de diseño
Al igual que con cualquier otra plantilla, es posible personalizar el diseño de las plantillas utilizando wikitexto, HTML, JavaScript, Lua, CSS, TemplateStyles y estilos en línea. Por favor, consulta nuestra Política de personalización para conocer más detalles sobre lo que se puede personalizar en nuestra plataforma.
Muestras
Size matters not. Look at me. Judge me by my size, do you? Hmm? Hmm. And well you should not. (...)—Yoda, a Luke Skywalker, Star Wars: Episode V The Empire Strikes Back
- Diseño más complejo
Plantilla:StructuredQuote2
Citas
Aunque la plantilla tiene el mismo comportamiento que una plantilla normal, el marcado para invocar la plantilla en los artículos difiere. Suponiendo que está utilizando los parámetros predeterminados utilizados en el ejemplo anterior, tendrá que usar la siguiente sintaxis para usar la plantilla en los artículos:
{{#SQuote:
|id=<Identificador único>
|text=<Texto de la cita>
|speaker=<Persona(s) que pronunció o escribió las palabras citadas (enlaces de wikitexto, separados por comas)>
|receiver=<Persona a la que se le dijo la cita (enlaces de wikitexto, separados por comas)>
|attribution=<Atribución (enlaces de wikitexto, separados por comas)>
|source=<Lugar donde se dijo (enlace de wikitexto)>
|author=<Autor (enlaces de wikitexto, separados por comas)>
|template=<Nombre de la plantilla personalizada sin un espacio de nombres (opcional, de forma predeterminada usa "StructuredQuote")>
}}
No es posible usar la plantilla en los artículos usando {{StructuredQuote|id=....}}, no renderizará la plantilla correctamente y la cita estructurada no se almacenará en nuestra base de datos. Solo funciona con el marcado anterior. Esto significa que todas las citas creadas anteriormente usando plantillas sin el marcado anterior tendrán que convertirse con un ID único para que funcionen como contenido estructurado.
El ID único puede ser un número, una palabra o una combinación de ambos. - y _ también están permitidos. Los ID distinguen entre mayúsculas y minúsculas y verá una advertencia si se utiliza un ID anterior en una nueva cita. El ID no puede contener espacios.
Esta sintaxis se cargará automáticamente en el editor de código fuente después de hacer clic en el icono de Cita estructurada en la barra de herramientas:
Reutilizar una cita existente
Una de las principales ventajas de las Citas Estructuradas es la posibilidad de consultar citas de los artículos sin actualizar la página cada vez que se añade una nueva cita a la wiki. Para usar una cita en diferentes artículos, solo tendrás que usar el ID original y el código de sintaxis {{#SQuoteGet:id=...}}
Por ejemplo:
{{#SQuoteGet:
|id=testquote
|template=StructuredQuote2
}}
Siendo el parámetro de template opcional dependiendo de la plantilla que se deba utilizar para representar la cita.
Consulta
En el caso de que desee enumerar varias citas en lugar de una sola, existe una función especial de analizador que le permitirá enumerarlas utilizando criterios específicos: #SQuoteQuery.
{{#SQuoteQuery:
|limit=<number of quotes to show>
|speaker=<individual(s) who uttered or wrote the quoted words (wikitext links, comma-separated)>
|receiver=<person the quote was spoken to (wikitext links, comma-separated)>
|attribution=<attribution (wikitext links, comma-separated)>
|source=<place where it was spoken (wikitext link)>
|author=<author (wikitext links, comma-separated)>
|template=<name of the custom template without a namespace (optional, by default it's using "StructuredQuote")>
}}
Esto le permitirá agregar varias citas en un artículo sin tener que agregarlas manualmente, y el contenido de esas citas se actualizará cuando se cambie la cita original.
No es posible filtrar las citas por ID o usar exclusiones, por ejemplo: enumere las citas hechas por el personaje X con el ID que comienza por "Yoda" y elimine las citas recibidas por "Mace Windu".
Las citas aparecerán de forma predeterminada usando Template:StructuredQuote. Es posible presentar las citas utilizando otra plantilla utilizando el parámetro de template descrito anteriormente.
Algunas consideraciones
Al igual que otras plantillas, puede agregar diferentes parámetros, usar wikitexto, agregar imágenes, usar marcado HTML, funciones de analizador, palabras mágicas, etcétera. Pero hay algunas reglas que tienes que recordar:
- La plantilla de cita predeterminada creada por Fandom se llama "
Template:StructuredQuote", pero se puede cambiar de nombre y funcionará siempre que quede una redirección en la plantilla original.- Es posible utilizar otras plantillas para las citas indicándolo con el parámetro
template.
- Es posible utilizar otras plantillas para las citas indicándolo con el parámetro
- No creará datos estructurados si la plantilla se invoca utilizando el código de marcado regular
{{StructuredQuote}}. Esta plantilla tiene su propia sintaxis. - Cada cita en un wiki determinado debe tener un ID único.
- Los ID pueden usar números, letras, guiones y guiones bajos.
- Los identificadores distinguen entre mayúsculas y minúsculas.
- Si le das a una cita un ID que ya se ha utilizado, producirá un error y te impedirá guardar la edición.
- Cambiar el ID de una cita romperá todas las instancias en las que esa cita se usa en otros artículos a través de
SQuoteGet.
- Se pueden agregar varios enlaces a los parámetros (por ejemplo, se puede atribuir a más de un personaje la cita), pero esta plantilla no está optimizada para incluir diálogo.
- Aunque puede agregar más parámetros, solo se almacenarán en la base de datos
id,text,speaker,receiver,attribution,source, andauthor - Los parámetros
speaker,receiver,attribution,source, andauthorpueden contener enlaces externos e internos, y pueden vincular a páginas no creadas.
Más ayuda y comentarios
Plantilla:Help and feedback section