Plantilla:Categoría por fecha (núcleo)

Documentación de la plantilla

La plantilla Categoría por fecha (núcleo) es una metaplantilla, destinada a ser llamada como plantilla auxiliar de las plantillas Categoría por año, Categoría por década, Categoría por siglo y Categoría por milenio, para las que realiza una selección auxiliar mediante parámetros, devolviendo parte de las categorías en las que las anteriores deben categorizar.

Además de la creación de categorías automáticas ligadas con la organización cronológica año-década-siglo-milenio, permite añadir otras categorías, aunque su utilización es algo compleja por lo que se aconseja ser prudente al modificarla.

Uso

Código: {{Categoría por fecha (núcleo)|<tema>|<nexo>|<periodo>|<parámetros opcionales>}}
Campo de aplicación:
- Para categorías . Esta plantilla SOLAMENTE debe disponerse en páginas de categorías del tipo «Categoría:<tema> <nexo> <año>» y ella se encarga de colocar en dicha página una plantilla de navegación cronológica y enlazar las categorías automáticamente.

Parámetros

Parámetros obligatorios:
- <tema>: es el tema principal de la categoría. Debe escribirse exactamente igual como lo está en el nombre de la categoría, ya que si no la clasifica en categorías inexistentes (que apareceran en rojo).
- <nexo>: la preposición o nexo a usar entre el tema y el año. Los más comunes son «en» o «de», aunque acepta cualquier otro nexo, como «formados en» o «fundadas en». Cuando el nombre de la categoría tenga la forma «Categoría:<tema> de <año>», se usará «de»; cuando el nombre de la categoría sea del tipo «Categoría:<tema> en <año>», se usará «en»; y análogo uso en el resto de los casos.
- <periodo>: exclusivamente el periodo (año-década-siglo-milenio) en cuestión. Por ejemplo, «1953» para la categoría correspondiente al año 1953, u «siglo XX» para la categoría correspondiente al siglo XX. Para los años anteriores a nuestra era se deben usar números negativos. Por ejemplo «-132» para la categoría correspondiente al año 132 a. C., o «-3» para la categoría correspondiente al año 3 a. C. Obviamente «0» no da resultado alguno, pues ese año no existe.

Hay que hacer notar que, para facilitar su uso en el vigente sistema de categorizacion por siglos y milenios de Wikipedia, esta plantilla considera de forma convencional que el siglo I va del año 1 al 99, el siglo II del año 100 al 199... el siglo XX del año 1900 al 1999, y el siglo XXI comienza en el año 2000. Considera que el siglo I a. C. va del año 1 a. C. al 99 a. C., el siglo II a. C. del año 100 a. C. al 199 a. C. y así sucesivamente.

Parámetros opcionales:
- <parámetros opcionales>: permite información complementaria.

Recuerdo de algunos códigos usados en la edición

Esta plantilla hace uso de muchas subplantillas, palabras mágicas y funciones parser (ver Ayuda:Extensión:ParserFunctions) anudadas lo que que hace dificil seguir su comportamiento. A modo de recuerdo y para facilitar su mantenimiento:

En la edición del código los parámentos de la plantilla corresponden con

{{Categoría por fecha (núcleo)|<tema> ns:0 |<nexo>{{{2}}}|<periodo>{{{3}}}|<parámetros opcionales>{{{4}}}}} Así, cuando aparezcan:

ns:0 = tema
{{{2}}} = nexo: en general serán las preposiciones «de» y «en», pero admite cualquiera otro nexo:
{{{3}}} = periodo: aqui serán exclusivamente «año», «década», «siglo» y «milenio», que llamaran/insertaran a su vez a las plantillas cronológicas correspondientes.
{{{4}}} =art=el, los

{{#if:}}

Esta función evalúa una cadena de prueba y determina si está vacía o no. Una cadena de prueba que contiene solo espacio en blanco se considera vacía.

{{#if: cadena de prueba | valor si la cadena de prueba no está vacía | valor si la cadena de prueba está vacía (o solo en blanco }}

{{#if: primer parámetro | segundo parámetro | tercer parámetro }}

Esta función primero prueba si el primer parámetro no está vacío. Si el primer parámetro no está vacío, la función muestra el segundo argumento. Si el primer parámetro está vacío o contiene solo espacios en blanco (espacios, líneas nuevas, etc.), muestra el tercer argumento.

{{ifeq: }}

Compara dos cadenas y determina si son idénticas.

{{#ifeq: cadena 1 | cadena 2 | valor si son idénticas | valor si son diferentes}}

{{#switch: }}

Esta función compara un valor de entrada con varios casos de prueba, y devuelve una cadena asociada si se encuentra coincidencia.

{{#switch: cadena a comparar

| caso = resultado

| ...

| caso = resultado

}}

Por ejemplo:

{{#switch: {{{1}}}}} |Arquitectura|Cine|Esculturas|Cuadros|Música|Obras literarias|Teatro =[[Categoría:Arte{{!}}{{{1}}}]]

aplica la plantilla a toda la secuencia de temas (Arquitectura, Cine, Escultura...) y los categoriza alfabéticamente en la «Categoría:Arte».

{{ucfirst: }}

{{ucfirst:text TRANSFORM}} → Text TRANSFORM<br/> pone en mayúsculas, sólo el primer caracter de <string>.

Aqui se usa para ordenar la categoría según un orden diferente al que le corresponderia: p.ej, «categoría:arquitectura de España» se lista en la «A» y lo usariamos si quisieramos que aparezca en la «E», España:

{{ucfirst:{{{1}}}}}|Arquitectura de España=España|Arquitectura de Estados Unidos=Estados}}

(parte del texto es de control, ya que la única significativa es la primera letra).

{{!}} . Esta plantilla auxiliar permite poner «|» dentro de los parámetros de plantillas. Se usa en general para especificar en las categoría el orden en el listado alfanúmerico. Se usan espacios duros para sacarlo del orden habitual:

|Nombre categoría]]: lista Nombre categoría en la letra N

| Nombre categoría]]: lista Nombre categoría fuera del orden alfanúmerico

|*Nombre categoría]]:lista Nombre categoría detrás del asterisco

Ejemplos

[[Categoría:Continentes {{#if:{{{por|}}}|por |en {{#if:{{{art|}}}|{{{art}}} }}}}{{{3}}}{{!}}{{{1}}}]]
[[Categoría:Álbumes {{#if:{{{por|}}}|por|de{{#if:{{{art|}}}|{{#ifeq:{{{art}}}|el|l| los}}}}}} {{{3}}}{{!}}{{{1}}}]]

Esta documentación está transcluida desde Plantilla:Categoría por fecha (núcleo)/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.