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:
- Bir "Dahil et" metin alanı: gezinme için sayfaları toplamak istediğiniz kategorileri burada listeleyin. Bir sayfa, yalnızca belirtilen kategorilerin her birini içeriyorsa listelenecektir. En az 1 kategori belirtmelisiniz
- Bir "Hariç tut" metin alanı: Belirli kategorilerdeki sayfaları listelememeyi tercih ederseniz, onları burada listeleyebilirsiniz. Bu metin alanı isteğe bağlıdır ve boş bırakabilirsiniz.
İş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:
- Metin alanlarının üzerindeki "favoriler" menüsü, sık kullanılan kategorileri favorilerinize eklemenize olanak tanır. Belirli bir vikiye CatNav'a her girdiğinizde, favori kategorileriniz yüklenir. Bir kategoriye sol tıklamak onu Dahil et metin alanına ekler ve sağ tıklama onu Hariç tut metin alanına ekler. Yeni favoriler ekleyebilir ve favorilerinizden ögeleri silebilirsiniz.
- Her gezinme alt sayfasının sahip olduğu satır sayısını seçme (genişlik, ekran boyutunuz tarafından belirlenir)
- Yalnızca ana alan sayfalarını veya tüm ad alanlarındaki sayfaları listeleme seçeneği (varsayılan maddelerdir)
- Sıralama seçenekleri
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
- Aynı vikiyi iki kez bildirebilirsiniz, ancak daha kolay bir kategori yönetimi için her viki için tüm kategorileri birlikte kaydetmeniz önerilir.
- Öncelikle ilişkili vikilerini bildirmeden kategorileri listelemediğinizden emin olun.
- Bildirilen vikinin alt etki alanının geçerli olduğundan emin olun. Geçersiz URL karakterleri bir hataya neden olur, ancak yalnızca geçersiz viki alt alanları sessizce geçebilir.
- Yorumlar, satıra "@" veya "#" dışında herhangi bir karakterle başlanarak yazılabilir, ancak diğer karakterleri gelecekteki olası güncellemeler için ayırmak için lütfen yalnızca yorum satırı başlatıcıları olarak boşluk kullanın. Yorumlar için başka karakterlerin kullanılması gelecekte beklenmeyen bir davranışa neden olabilir.
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];
wikiUrltam viki URL'sidir (ör."https://community.fandom.com/tr"scriptPath, o vikideki komut dosyalarının URL yoludur (Fandom durumunda boş dize).wgScriptPathile kontrol edebilirsiniz.
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
- Chiến Thần Vương - birkaç küçük betil düzeltmesi göndermenin yanı sıra sıralama seçenekleri ve favori kategoriler eklemeyi önerdi
- Dai ca superman - birden çok önemli hata raporu gönderdiği için
- RianL110 - hataları gönderdiği için
- Aspallar - UCP'nin ne zaman uygulandığına ilişkin bir API sözdizimi düzeltmesinin bildirilmesi ve sağlanması
- CrescentHusky12 - alfabetik olmayan sıralama yöntemleriyle ilgili hata raporu göndermesi
- Magiczocker - uluslarasılaştırma ve büyük temizlemeyi uygulama
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 |