Ayuda:Extensiones:CategoryTree
|
La Extensión CategoryTree permite una vista dinámica de la estructura de las categorías como un árbol. Esta extensión fue escrita originalmente por Daniel Kinzler como una herramienta externa e incorporada más tarde a mediawiki con la ayuda de Tim Starling. La extensión permite pegar en un artículo un árbol de categorías a las que el artículo es afín. Pudiendo expandir o esconder las categorías deseadas (vista dinámica) y navegar entre ellas buscando el contenido que se desea.
Uso
Se puede usar de 3 maneras:
- En las páginas de categorías.
- Como etiqueta (o parsr function) para ver la estructura de una categoría en un artículo
- Como página especial.
La extensión CategoryTree añade un [+] delante de la categoría indicada que expande a las subcategorías.
La etiqueta <categorytree>
<categorytree>Ayuda</categorytree>
La etiqueta es <categorytree>. Si la utilizas en una página de la wiki te mostrará los contenidos de dicha categoría como un árbol dinámico, como muestra el cuadro de la derecha.
Se pueden usar atributos usando una sintáxis parecida al HTML:
- mode (muestra que páginas se ven en el árbol)
- categories → muestra solo las subcategorías (constante CT_MODE_CATEGORIES).
- pages → muestra subcategorías y artículos, excepto las imágenes (constante CT_MODE_PAGES).
- all → muestra todos los artículos, subcategorías, imágenes, etc (constante CT_MODE_ALL)
- parents → muestra las categorías padre en lugar de las subcategorías (constante CT_MODE_PARENTS). Es como utilizar la extensión CategoryTree a la inversa.
- depth (profundidad) → Determina cuantos niveles del árbol se ven en un principio. Por defecto 1; 0 significa ver solo el nivel principal. El número máximo de niveles a visualizar está especificado en $wgCategoryTreeMaxDepth.
- hideroot → Al activarlo ("on") esconderá el nombre de el nombre de la categoría indicada, marcando solo las subcategorías, páginas e imagenes (en caso de indicar mode=all) de esta categoría.
- hideprefix → Determina cuando se debe esconder el nombre del espacio en las entradas del árbol:
- always → siempre. Solo se debería usar si todas las páginas de la categoría son del mismo "tipo". (Constante CT_MODE_CT_HIDEPREFIX_ALWAYS).
- never → nunca. Incluso para las categorías(Constante CT_MODE_CT_HIDEPREFIX_NEVER).
- auto → esconde el espacio de las categorías, si solo se ven categorias (como por ejemplo al usar mode="categories". (Configuration constant CT_MODE_CT_HIDEPREFIX_AUTO)
- categories → siempre esconde el espacio categorías pero muestra otros prefijos (Configuration constant CT_MODE_CT_HIDEPREFIX_CATEGORIES).
- showcount → Al activarlo ("on") se muestra el numero de entradas en cada subcategoría. Está desactivado por defecto en los árboles de las páginas pero activado en las de las categorías y en la página especial.
- namespaces → una lista de espacios de nombres desde las que se deben mostrar en el árbol. Las entradas de la lista deben ser los nombres de los espacios separados por espacios. El principal puede ser representado por "-" or "0". (sustituye la opción mode).
- class, style, id, etc → soporta los atributos standard del HTML para bloques.
Categorytree como parser function
Desde septiembre de 2007, se puede usar la sintáxis de las parser functions para colocar un árbol de categorías en una página. Funciona como la etiqueta <Categorytree>, pero con otro formato; i.e. {{#categorytree:Ayuda}}; y las opciones pueden especificarse como parámetros; i.e. {{#categorytree:Ayuda|hideroot|mode=pages}}.
Utilizar la sintáxis de parser function tiene como ventaja la opción de usar palabras mágicas, plantillas y parámetros de plantillas al especificar la categoría a mostrar.
Algunos ejemplos:
- Usar una palabra mágica para mostrar el árbol de esta página (útil en las descripciones de categoría) → {{#categorytree:{{PAGENAME}}}}.
- Usar una plantilla para especificar la categoría {{#categorytree:{{root category}}}}; el nombre de la categoría principal estaría definido por el contenido de la plantilla:Root category.
- Usar parametros de una plantilla para especificar la categoría; al usar Categorytree dentro de una plantilla {{#categorytree:{{{1}}}}}.
La página especial: Categorytree
En la página especial CategoryTree puedes introducir el nombre de una categoría y te muestra el contenido de la misma.
Enlaces externos
- Para más información Extension:Categorytree en mediawiki.
| |||||||||||||||||||
