Ayuda:DPL/Criterios para la selección de páginas/Categoría
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 |
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).