Fandom Developers Wiki
Advertisement

Esta página, o partes de ella, siguen sin traducir. Por favor traduzcala al lenguaje apropriado (español).

CatNav es una herramienta para realizar un listado de miembros de categoría avanzada. Es muy similar a la función wiki "Exposición de categorías", sin embargo, le permite numerar páginas de múltiples categorías, así como especificar categorías de las que no le gustaría numerar páginas.

Instalación[]

Uso[]

Una vez instalado, aparecerá un enlace "CatNav" en la barra inferior de la wiki. Al hacer clic en él, accederá a Special:CatNav, donde se encuentra la función.

El componente principal de CatNav consta de 2 áreas de texto, cada una es una lista de nombres de categorías separados por espacios en blanco:

  • Un área de texto "Incluir": enumere aquí las categorías de las que le gustaría recopilar páginas para la navegación. Una página solo aparecerá en la lista si contiene cada una de las categorías especificadas. Debes especificar al menos 1 categoría
  • Un área de texto "Excluir": si prefiere no numerar las páginas de ciertas categorías, puede numerarlas aquí. Este área de texto es opcional y puede dejarlo en blanco

Cuando haya terminado, haga clic en el botón "generar". Si se encuentran resultados, se numerarán debajo del formulario de CatNav, con cada página representada por una miniatura cuadrada con un título. i hay demasiados resultados, se dividirán en subpáginas.

Además, hay algunas opciones extra:

  • Un menú de "favoritos" encima de las áreas de texto le permite agregar categorías de uso frecuente a sus favoritos. Siempre que ingrese a CatNav en esa wiki específica, se cargarán sus categorías favoritas. Al hacer clic con el botón izquierdo en una categoría, se agrega al área de texto Incluir, y al hacer clic con el botón derecho, se agrega al área de texto Excluir. Puede agregar nuevos favoritos y eliminar elementos de sus favoritos.
  • Seleccionar el número de filas que tiene cada subpágina de navegación (el ancho está determinado por el tamaño de su pantalla)
  • La opción de numerar solo las páginas del espacio principal o las páginas de todos los espacios de nombres (la opción predeterminada es artículos)
  • Opciones de clasificación

Configuración[]

El script siempre define un objeto window.CatNav, con un método init para reinicializar su interfaz en cualquier momento. Puede usarlo como una función de devolución de llamada o llamar a CatNav.init en cualquier momento.

Debug mode[]

General console events are logged in a local array. If you're interested in them being displayed in the browser's console, add the following line above the import:

window.CatNav = {debug: true};

Eventos[]

Puede usar eventos DOM personalizados para saber cuándo sucede algo en la página de CatNav. Cada evento está destinado a ser activado por un elemento específico (usando addEventListener o .on() de jQuery, por ejemplo). Los eventos disponibles son los siguientes:

Evento Objetivo Cuando es despedido
catnavready document.body Cuando la interfaz de CatNav se carga completamente
catnavgenerated #catnav Siempre que CatNav termine de generar contenido
catnavpageload #catnav Siempre que el usuario acceda a una determinada página de navegación. Si se activa al mismo tiempo que catnavgenerated, tendrá una propiedad adicional de uponGeneration establecida en true. Esto se puede usar si desea que catnavpageload tenga un comportamiento diferente cuando el script abre automáticamente la primera página después de generar contenido.

Favoritos globales[]

También puede establecer una lista de categorías favoritas a través de Community Central, a través de Special:MyPage/catnav.css. Presionar el botón "importar" importaría todas las categorías favoritas asociadas con el wiki actual al almacenamiento local en su dispositivo (pero para cambiar la configuración global, tendría que editar la página global).

Tenga en cuenta que si ya tiene categorías favoritas en un wiki dado y luego presiona el botón "importar", "no" eliminará las categorías favoritas que no aparecen en su configuración global para el wiki dado, sino que solo agregará categorías que no eran favoritos de antemano.

La sintaxis es la siguiente:

  una línea que comienza con espacio (s) es un comentario.  también puedes dejar una línea vacía

  para declarar categorías favoritas primero declarar la wiki a la que pertenecen
  para hacer eso, comience una línea con una '@', seguida del subdominio de la wiki
  (use el prefijo '<lang>.' si es necesario)
@clubpenguin
  cualquier categoría debajo de esta línea será de [[w:c:clubpenguin]]
  para declarar una categoría, comience una línea con un '#'
#Clothing
  la línea superior está relacionada con [[w:c:clubpenguin:Category:Clothing]]
#Puffles
#Parties
#Characters/Penguin Band
  ^ también puedes usar subcategorías


  para declarar categorías para otra wiki, vuelva a declarar el subdominio, por ejemplo, la wiki española de Runescape:
@es.runescape
#Armaduras Híbridas

Notas[]

  • Puede declarar la misma wiki dos veces, pero es aconsejable guardar todas las categorías de cada wiki juntas, para una gestión de categorías más sencilla.
  • Asegúrese de no numerar categorías sin declarar primero sus wikis asociados.
  • Asegúrese de que el subdominio declarado de la wiki sea válido. Los caracteres de URL no válidos darán lugar a un error, pero los subdominios wiki simplemente no válidos pueden pasar silenciosamente.
  • Los comentarios se pueden escribir comenzando la línea con cualquier carácter que no sea "@" o "#", pero por favor solo use espacios como iniciadores de línea de comentarios, para reservar otros caracteres para posibles actualizaciones futuras. El uso de otros caracteres para los comentarios podría crear un comportamiento inesperado en el futuro.

En caso de que el wiki en el que almacena sus importaciones/exportaciones de categorías favoritas (más información en la sección favoritos globales) no sea Community Central, puede definirlo de la siguiente manera:

window.CatNav = window.CatNav || {};
window.CatNav.storage = [wikiUrl, scriptPath];
  • wikiUrl es la URL completa de la wiki (por ejemplo, "https://community.fandom.com")
  • scriptPath es la ruta de la URL a los scripts en esa wiki (cadena vacía en el caso de Fandom). Puede comprobarlo con wgScriptPath

Tenga en cuenta que la funcionalidad de CatNav se basa en API de Fandom, por lo que actualmente no funcionará con wikis que no sean de Fandom (por ejemplo, wikis de WikiMedia, como Wikipedia y Commons)

Créditos y agradecimientos especiales[]

  • Chiến Thần Vương - sugirió agregar opciones de clasificación y categorías favoritas, así como enviar algunos pequeños ajustes en el guión.
  • Dai ca superman - para enviar varios informes de errores cruciales
  • RianL110 - para enviar informes de errores
  • Aspallar - notificando y proporcionando una corrección de sintaxis API para cuando se implemente UCP
  • CrescentHusky12 - sending bug report related to non-alphabetic sorting methods
  • Magiczocker - implementing i18n & major cleanup

Registro de cambios[]

Date Description
March 17, 2015 Prototype release in the Club Penguin Wiki.
September 9, 2015 Script improvements and official release in the Dev wiki.
September 3, 2016 Adding favorite categories and sorting options. Also, now adding empty lines no longer returns an error. Minor changes in the interface and some other code tweaks.
September 18, 2016 Providing global favorites importing to the current wiki in the current device. Some small CSS changes.
October 7, 2016 Added sorting by popularity (uses standard Category Exhibition order, due to limitations of the current popular pages API available in Fandom and MediaWiki) and the ability to get the exported syntax for your current wiki. Added monobook selectors and added support for wikis with a different "Special:" prefix.
October 8, 2016 syntax fixes, fixing sorting issues with sorting by popularity, and extra updates for the export interface.
October 10, 2016 Providing global CatNav object. Making script path wiki-specific.
October 15, 2016 Solving issue with global imports.
October 28, 2016 Adding sorting by article comments.
November 19, 2016 Adding results counter and the catnavpageload event.
November 19, 2016 Giving a contrast to the results counter, and adding the catnavready and catnavgenerated events.
May 26, 2017 Fixed crash that occurs if any of the pages in the currently-viewed CatNav page contains commas in its title.
April 1, 2018 Fixed contrast of results counter.
June 9, 2020 Fixed script compatibility for non-English wikis after an update in their URL path syntax across Fandom.
June 22, 2020 Fixed text contrast issues for wikis with a non-hexadecimal page background value.
June 23, 2020 Adapting the API requests to the MediaWiki version of the Unified Community Platform.
October 31, 2020 Updating lines that relied on UFC-deprecated wg parameters.
June 26, 2021 Adding FandomDesktop compatibility (special thanks to Original Authority), as well as making it compatible with non-FandomDesktop Gamepedia wikis. Making the script compatible with UCP wikis that have numerous language versions. Removing sorting options that relied on the now-defunct article comment and category exhibition features. Adding title filtering options. Most console logs/errors will now only be visible on debug mode. Some UI and other small, miscellaneous changes.
July 1, 2021 Fixing bug related to updating the browser's tab title.
August 2, 2021 Fixing issue with large results when selecting non-alphabetic sorting modes (special thanks to CrescentHusky12).
August 14, 2022 Implementing i18n and major cleanup (special thanks to Magiczocker)
August 20, 2022 Updating variables, fixing minor issues with the number of results
September 26, 2022 Fixing issue with large requests sorted by non-alphabetical order, small i18n change
Advertisement