dev

CatNav, gelişmiş bir kategori üye listesi gerçekleştirmek için bir araçtır. "Kategori Sergisi" viki özelliğine çok benzer, ancak birden çok kategoriden sayfaları listelemenize ve ayrıca sayfaları listelemek istemediğiniz kategorileri belirtmenize olanak tanır.

Installation

Usage

Kurulduğunda, alt viki çubuğunda bir "CatNav" bağlantısı görünecektir. Tıklamak sizi özelliğin bulunduğu Special:CatNav seçeneğine götürecektir.

CatNav'ın ana bileşeni, her biri boşlukla ayrılmış kategori adları listesi olan 2 metin alanından oluşur:

İşiniz bittiğinde, "oluştur" düğmesini tıklayın. Sonuçlar bulunursa, bunlar CatNav formunun altında listelenir ve her sayfa bir başlığı olan kare bir küçük resimle gösterilir. Çok fazla sonuç varsa, bunlar alt sayfalara bölünür.

Ek olarak, bazı ekstra seçenekler vardır:

Ayarlar

Betik her zaman, arayüzünü herhangi bir zamanda yeniden başlatmak için bir init yöntemiyle bir window.CatNav nesnesi tanımlar. Bunu bir işlev geri araması olarak kullanabilir veya herhangi bir anda CatNav.init ile arayabilirsiniz.

Hata ayıklama

Genel konsol olayları yerel bir diziye kaydedilir. Tarayıcı konsolunda görüntülenmeleriyle ilgileniyorsanız, içe aktarmanın üstüne aşağıdaki satırı ekleyin:

window.CatNav = {debug: true};

Olaylar

CatNav'ın sayfasında ne zaman bir şey olduğunu bilmek için özel DOM olaylarını kullanabilirsiniz. Her olayın belirli bir öge tarafından tetiklenmesi amaçlanmıştır (örneğin, addEventListener veya jQuery'nin .on() ile kullanılarak). Mevcut olaylar şunlardır:

Olay Hedef Tetiklendiğinde
catnavready document.body CatNav'ın arayüzü tamamen yüklendiğinde
catnavgenerated #catnav CatNav içerik oluşturmayı bitirdiğinde
catnavpageload #catnav Kullanıcı belirli bir gezinme sayfasına gittiğinde. catnavgenerated ile aynı anda tetiklenirse, ek bir uponGeneration özelliği true olarak ayarlanır. Bu, catnavpageload değerinin içerik oluşturduktan sonra betik ilk sayfayı otomatik olarak açtığında farklı bir davranışa sahip olmasını istiyorsanız kullanılabilir.

Küresel favoriler

Ayrıca Topluluk Merkezi üzerinden Special:MyPage/catnav.css aracılığıyla sık kullanılan kategorilerin bir listesini ayarlayabilirsiniz. "İçe aktar" düğmesine basmak, geçerli viki ile ilişkili tüm favori kategorileri cihazınızdaki yerel depolamaya aktarır (ancak genel ayarları değiştirmek için genel sayfayı düzenlemeniz gerekir).

Belirli bir vikide zaten favori kategorileriniz varsa ve ardından "içe aktar" düğmesine basarsanız, verilen viki için genel ayarlarınızda görünmeyen favori kategorileri silmez, ancak yalnızca önceden favori olmayan kategorileri ekler.

Sözdizimi aşağıdaki gibidir:

  boşluk(lar) ile başlayan bir satır bir yorumdur. ayrıca favori
  
  kategorileri bildirmek için bir satırı boş bırakabilirsiniz, bunu
  yapmak için önce ait oldukları vikiyi bildirin, bir '@' ile bir
  satır başlatın, ardından vikinin alt etki alanı
  (gerekirse '<dil>.' önekini kullanın)
@clubpenguin
  Bu satırın altındaki herhangi bir kategori, bir kategori ilan
  etmek için [[w:c:clubpenguin]]'den olacaktır, bir satıra '#' ile başlayın
#Clothing
  üst satır [[w:c:clubpenguin:Category:Clothing]] ile ilgilidir
#Puffles
#Parties
#Characters/Penguin Band
#Puffles
#Parties
#Characters/Penguin Band
  ^ alt kategorileri başka bir wiki için kategori bildirmek,
  
  
  alt etki alanını yeniden bildirmek için de kullanabilirsiniz. ör. İspanyolca Runescape Viki'si:
@es.runescape
#Armaduras Híbridas

Notlar

Favori kategorilerinizi içe/dışa aktardığınız vikinin (küresel favoriler bölümü hakkında daha fazla bilgi) Topluluk Merkezi olmaması durumunda, bunu aşağıdaki şekilde tanımlayabilirsiniz:

window.CatNav = window.CatNav || {};
window.CatNav.storage = [wikiUrl, scriptPath];

CatNav'ın işlevselliğinin Fandom'un API'ye dayandığını unutmayın, bu nedenle şu anda Fandom dışı vikilerle (ör. Vikipedi ve Commons gibi Wikimedia vikileri) çalışmayacaktır.

Katkılar ve özel teşekkürler

Değişiklik günlüğü

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