Ayuda:DPL/Criterios para la selección de páginas/Categoría

De Bestiario del Hypogripho

DynamicPageList3, criterios para la selección de páginas, sección de categoría.

Selección por CATEGORÍA

category

category Selecciona artículos basados en categorías. Puede especificar más de una categoría con la barra vertical '|' como separador, con el efecto de que las páginas enumeradas deben estar al menos en una de las categorías (OR lógico).

Si especificas el parámetro 'categoría=' más de una vez, las páginas enumeradas deben coincidir con todos estos parámetros (Y lógico).


Sintaxis:

category=Nombre de la categoría 1|Nombre 2|Nombre 3|…
o
category=Nombre de la categoría 1&Nombre 2&Nombre 3&…
o
category=_none_

Puedes usar el símbolo de pleca o tuberia | para el operador lógico OR o puedes usar el símbolo & para el operador lógico AND. ¡No es posible mezclar ambos! Si especificas más de una línea de categoría, los argumentos de estas líneas se conectarán implícitamente con AND. Por lo tanto, puedes crear una expresión lógica en la que tengas varios términos AND (las líneas) y que cada uno de estos términos contenga un grupo de categorías OR (separado por barras).

Atención: el comando categoría usa el símbolo de tubería para delimitar sus argumentos (OR lógico). Cuando utilices DPL con la sintaxis de la función del analizador, es decir, con llaves {}, DEBEs escapar el carácter de tubería mediante una plantilla (que normalmente se llama "!") O debes usar el símbolo tubería rota ("¦"):

Ejemplo de AND OR:

Input Resultado
<dpl>
category=Milegu|Umaggar
category=Sapientes
count=6
</dpl>
{{#dpl:category=Milegu{{!}}Umaggar|category=Sapientes|count=6}}
{{#dpl:category=Milegu¦Umaggar|category=Sapientes|count=6}}

Esta instrucción generará una lista de páginas que tienen [[Categoría:Milegu]] OR [[Categoría:Umaggar]], AND [[Categoría:Sapientes]] entre sus categorías.

Puede especificar el conjunto de páginas no categorizadas como una categoría normal, con la palabra clave _none_.

Ejemplo del uso de _none_:

  • 'category=_none_' solo para páginas no categorizadas.
  • 'category=_none_¦Animales' o 'namespace=Animales¦_none_' Que significa: para las categorías Uncategorized o Animales.
  • 'category=Mammals¦_none_¦Insects' Que significa: para la categoría Mamíferos, páginas no categorizadas o la categoría Insectos, etc.

Si ordermethod=category,… y headingmode están habilitadas, puedes restringir las categorías que deseas como títulos en el resultado precediendo la lista de categorías (especificadas con el parámetro de categoría) con un + o -. Se explica en el ejemplo a continuación.

  • Un símbolo + significa que solo las categorías enumeradas en esa declaración pueden aparecer como encabezados en la salida.
  • Un símbolo - significa que las categorías enumeradas en esa declaración NO pueden aparecer como encabezados en la salida (pero si todas las demás).

Si pones un asterisco * antes del nombre de una categoría, DPL agregará todas las subcategorías DIRECTAS de esa categoría a su declaración. El uso de DOS asteriscos ** ampliará la búsqueda del árbol a dos niveles. Esto proporciona un soporte mínimo para las jerarquías de categorías. La sintaxis y / o la semántica de esta función pueden cambiarse en una versión futura.

Ejemplo del uso de + **:

Input Resultado
{{#dpl:
|category=+Milegu¦Umaggar
|category=**Sapientes
|ordermethod=category,sortkey
|headingmode=ordered
|count=6
}}

Extension:DynamicPageList3 (DPL3), version 3.5.2: Error: Too many categories! Maximum: 4. Help: increase $wgDplSettings['maxCategoryCount'] to specify more categories or set $wgDplSettings['allowUnlimitedCategories'] = true; for no limitation. (Set the variable in the wiki's LocalSettings.php configuration file.)

En este ejemplo, DPL creará una lista de páginas que tienen las categorías [[Categoría:Milegu]] OR [[Categoría:Umaggar]], AND ( [[Categoría:Sapientes]] o una subcategoría directa de sapientes o una subcategoría de segundo nivel de una subcategoría de sapientes). La lista estará ordenada (etiqueta HTML OL) y organizada en 2 elementos / encabezados principales: El encabezado Milegu y el encabezado Umaggar. Sapientes o sus respectivas subcategorías no se utilizarán como encabezado. Debajo de cada elemento / encabezado, verás una sublista de páginas ordenadas por su clave de clasificación (sortkey) para la categoría utilizada como encabezado.

Notas:

Si quieres usar palabras mágicas como {{CURRENTMONTHNAME}}, {{CURRENTDAY}}, {{CURRENTYEAR}} etc. en el nombre de la categoría, debes utilizar la variante de sintaxis de la función del analizador. Es decir, poner la declaración entre llaves {}, no entre angulos <>.

Para evitar que una consulta DPL devuelva un resultado enorme (o consuma demasiados recursos), existen algunas variables de configuración. Puedes consultar $wgDPL2MaxCategoryCount, $wgDPL2AllowUnlimitedCategories, $wgDPL2MinCategoryCount en el código fuente del módulo de extensión y en mw:Extension:DynamicPageList3.

El uso de la declaración categoría sin un argumento no tendrá efecto alguno. En versiones anteriores de DPL esto actuaba como categoría = _ninguno_ pero ya no es así.

categorymatch

categorymatch Selecciona artículos basados en categorías. Puedes especificar uno o más patrones (como en SQL); se seleccionará una página si al menos una de sus categorías coincide con al menos uno de los patrones.


Sintaxis: categorymatch=patrón para la primera categoría|..

Un símbolo % se utiliza para indicar "cualquier número de caracteres".

Ejemplo de categorymatch:

Input Resultado
{{#dpl:
|categorymatch=Milegu%¦Umaggar%
|count6
}}

Esta petición devolverá páginas que pertenecen a categorías como Milegu, Milegum, Milegus, Umaggar, Umaggaran, Umaggariano, etc.

categoryregexp

categoryregexp seleccionar páginas con una categoría que coincida con una expresión regular.


El texto completo detrás de "categoryregexp" se tomará como UN argumento y se usará en una cláusula SQL REGEXP, es decir, caracteres como | se pueden utilizar como parte normal de la expresión regular.

notcategory

notcategory Al igual que el parámetro category, pero requiere que todas las páginas enumeradas no estén en una categoría particular. A diferencia de "category", no se pueden combinar varias categorías utilizando un OR lógico en este parámetro.


Sintaxis: notcategory=nombre de la categoría

Ejemplo de notcategory:

Input Resultado
{{#dpl:
|category=Milegu
|notcategory=Sapientes
|notcategory=Sintientes
|count=6
}}

Esto generará una lista de páginas que tienen [[Categoría:Milegu]] pero no tienen las categorías [[Categoría:Sapientes]] ni [[Categoría:Sintientes]] en la página.

Notas:

Si usas la sintaxis de la función del analizador, podrás usar palabras mágicas como {{CURRENTMONTHNAME}}, {{CURRENTDAY}}, {{CURRENTYEAR}} etc. en el nombre de la categoría.

Las variables DPL $wgDPL2MaxCategoryCount, $wgDPL2AllowUnlimitedCategories, $wgDPL2MinCategoryCount amplian estas funcionalidades. Puedes consultarlas en mw:Extension:DynamicPageList3.

notcategorymatch

notcategorymatch Funciona como notcategory pero basado en busqueda similar a SQL.


notcategoryregexp

notcategoryregexp Funciona como notcategory pero basado en SQL REGEXP.


categoriesminmax

categoriesminmax Para restringir la búsqueda a artículos asignados al menos a [mínimo] y como máximo a [máximo] categorías.


Sintaxis: categoriesminmax=[min],[max]

Ejemplo de mínimos:

Input Resultado
{{#dpl:
|category=Milegu
|categoriesminmax=3
|count=6
}}
{{#dpl:
|category=Umaggar
|categoriesminmax=7
|count=6
}}
  • Casilla 1: mínimo=3 La lista contendrá artículos que pertenezcan a la categoría "Milegu" y al menos a otras dos categorías.
  • Casilla 2: mínimo=7 La lista contendrá artículos que pertenezcan a la categoría "Umaggar" y al menos a otras seis categorías.

Ejemplo de máximos:

Input Resultado
{{#dpl:
|category=Milegu
|categoriesminmax=,4
|Count=6
}}
{{#dpl:
|category=Umaggar
|categoriesminmax=,5
|Count=6
}}
{{#dpl:
|category=Milegu
|categoriesminmax=,1
|Count=6
}}
  • Casilla 1: máximo=4 La lista contendrá artículos que pertenezcan a la categoría "Milegu" y como máximo a otras tres categorías.
  • Casilla 2: máximo=5 La lista contendrá artículos que pertenezcan a la categoría "Umaggar" y como máximo a otras cuatro categorías.
  • Casilla 3: máximo=1 La lista contendrá artículos que pertenezcan a la categoría "Milegu" como máximo. y no estén asignados a ninguna otra categoría. Es decir máximo=1.

Ejemplo con mínimos y máximos:

Input Resultado
{{#dpl:
|category=Milegu
|categoriesminmax=2,7
|Count=6
}}
  • Casilla 1: La lista contendrá artículos que pertenezcan a la categoría "Milegu", como mínimo a otra categoría más (min=2) y como máximo a otras seis categorías (max=7).

⚜️