Ayuda:Árbol de categorías

Esta extensión está activada por defecto en Fandom.

Un árbol de categorías, provisto por la extensión CategoryTree, proporciona una vista dinámica de la estructura de categorías de tu wiki como un árbol. Utiliza Ajax para cargar partes del árbol bajo demanda.

Uso

Se puede usar de tres maneras:

  • directamente en las páginas de categorías,
  • como una "etiqueta personalizada" (o "función parser") para mostrar una estructura de categoría en línea en una página wiki,
  • y como página especial.

La extensión CategoryTree añade widgets [+] o [×] de "expandir" a las subcategorías enumeradas en las páginas de categorías, donde [+] indica la presencia de más subcategorías y [×] indica la ausencia de ellas. Si JavaScript está deshabilitado, esos widgets simplemente no hacen nada.

Nota para los usuarios de bots: los bots y los scripts que procesan el HTML de las páginas de categoría pueden usar el parámetro de URL notree para forzar la salida tradicional. Sin embargo, la salida HTML generalmente no es estable, por lo que se recomienda cambiar tu secuencia de comandos para usar query.php o api.php para obtener listas de categorías y demás.

Etiqueta <categorytree>

Ejemplo:

Imágenes
Imágenes por licencia
Imágenes por uso
<categorytree mode="pages" style="float:right; clear:right; margin-left:1ex; border:1px solid rgba(105, 105, 105, 0.2); padding:0.7ex; background-color: rgba(105, 105, 105, 0.08);">Imágenes</categorytree>

La etiqueta personalizada se llama <categorytree>. Por ejemplo, si colocas <categorytree>Foo</categorytree> en una página wiki, mostrará los contenidos de la categoría Foo como un árbol dinámico en esa página (véase el ejemplo a la derecha). La etiqueta acepta los siguientes atributos, utilizando una sintaxis similar a HTML:

mode
Determina qué páginas se muestran en el árbol. Esto se puede anular mediante el uso de la opción namespaces. Valores posibles:
categories
Solo muestra subcategorías (constante de configuración CT_MODE_CATEGORIES).
pages
Muestra subcategorías y páginas, excepto imágenes (constante de configuración CT_MODE_PAGES), limitado a 200 páginas.
all
Muestra todas las páginas, subcategorías, imágenes, etc. (constante de configuración CT_MODE_ALL).
parents
Lista categorías principales en lugar de subcategorías (constante de configuración CT_MODE_PARENTS). Esto coloca a CategoryTree en operación "inverse" (inversa).
depth
Determina cuántos niveles del árbol se muestran al inicio. Por defecto es 1, 0 significa solo el nodo raíz. El valor máximo depende del nodo especificadom y en la opción $wgCategoryTreeMaxDepth.
hideroot
Coloca esto en "on" (encendido) para esconder el nodo "raíz" del árbol; por ejemplo, la mención de la categoría Foo del ejemplo.
hideprefix
Determina cuándo se debe ocultar el prefijo del espacio de nombres de las entradas en el árbol. Valores posibles:
always
Siempre oculta el prefijo. Solo debería usarse si todas las páginas provienen del mismo espacio de nombres (constante de configuración CT_MODE_CT_HIDEPREFIX_ALWAYS)
never
Nunca oculta el prefijo, ni siquiera para las categorías (constante de configuración CT_MODE_CT_HIDEPREFIX_NEVER)
auto
Oculta el espacio de nombres de las categorías, si solo se muestran categorías, como con mode="categories" (constante de configuración CT_MODE_CT_HIDEPREFIX_AUTO)
categories
Siempre oculta el espacio de nombres de las categorías, pero muestra todos los demás prefijos (constante de configuración CT_MODE_CT_HIDEPREFIX_CATEGORIES); este es el comportamiento predeterminado.
showcount
Coloca esto en "on" (encendido) para mostrar el número de entradas en las subcategorías, por ejemplo showcount="on". Esto está deshactivado por defecto para los árboles de categorías en línea en las páginas, pero está habilitado de manera predeterminada en las listas de categorías y en Especial:ÁrbolDeCategorías.
namespaces
Una lista de espacios de nombres desde los cuales las páginas deben mostrarse en el árbol. Las entradas de la lista deben ser nombres de espacios de nombres, separados por espacios. Los espacios de nombres principales se pueden representar con "-" o "0". Esto anula la opción "mode".
class, style, id, etc.
La etiqueta <categorytree> admite todos los atributos HTML estándar para elementos de bloque.

Función parser {{#categorytree}}

También puedes usar la sintaxis de función parser para colocar un árbol de categorías en una página. Esto funciona igual que la etiqueta <categorytree>, usando una sintaxis diferente, como {{#categorytree:Foo}} por ejemplo; las opciones se pueden especificar usando la sintaxis para parámetros de plantilla nombrados, como {{#categorytree:Foo|hideroot|mode=pages}} por ejemplo.

Usar la sintaxis de función parser tiene la ventaja de que te permite usar palabras mágicas, plantillas y parámetros de plantilla al especificar la categoría que se mostrará. Algunos ejemplos:

  • Usar una variable mágica para mostrar el árbol de categorías de "estas páginas" (puede ser útil en las páginas de descripción de categorías): {{#categorytree:{{PAGENAME}}}}.
  • Usar una plantilla para especificar la categoría: {{#categorytree:{{categoría raíz}}}}; el nombre de la categoría raíz se definiría por el contenido de Plantilla:Categoría_raíz.
  • Usar un parámetro de plantilla para especificar la categoría, cuando se usa CategoryTree dentro de una plantilla: {{#categorytree:{{{1}}}}} en Plantilla:Baz puede ser llamado usando {{Baz|Foo}}.

Página Especial:ÁrbolDeCategorías

La página especial se llama Especial:ÁrbolDeCategorías; allí puedes ingresar el nombre de una categoría y luego navegar por su contenido.

Véase también

Ayuda y comentarios