Moduł:statystyka/opis
Użycie[edytuj]
Moduł obsługujący rankingi na stronie Wikisłownik:Statystyka oraz szablony liczników. Dane pochodzą ze zrzutów bazy danych ukazujących się dwa razy w miesiącu, analizowanych przez bota i kompilowanych w formacie JSON dla wykorzystania przez niniejszy moduł. Zestawienie uwzględnia wyłącznie wprowadzone języki (tj. z indeksem) z niezerową liczbą haseł w momencie wykonania zrzutu, natomiast zliczane hasła powinny być dostosowane do szablonu.
Schemat JSON[edytuj]
Schemat danych JSON:
currentDate,previousDate– odpowiednio data obecnego i poprzedniego zrzutu w formacie yyyyMMddoverall– statystyki ogólne dla wszystkich językówoverallDiff– statystyki ogólne, porównanie względem poprzedniego zrzutulanguages– statystyki dla poszczególnych języków, kluczem jest nazwa krótka języka
Bot zbiera następujące informacje (dla każdego języka oraz w podsumowaniu ogólnym):
entries– całkowita liczba hasełcanonical– liczba haseł zawierających definicjenonCanonical– liczba haseł zawierających formy fleksyjnedefinitions– liczba definicjiwithFiles– liczba haseł zawierających co najmniej jedną ilustrację pod nagłówkiem sekcjiwithAudio– liczba haseł zawierających co najmniej jedno nagranie wymowy w polu „wymowa”withReferences– liczba haseł zawierających co najmniej jeden przypis w formie <ref> gdziekolwiek w haśle oraz <references> w polu „źródła”combinedLength– łączna suma długości haseł w znakach (zob. objaśnienie w WS:STAT#Długość haseł)
Jeżeli wykryje różnice względem poprzedniego zrzutu, odzwierciedla je w odpowiednich właściwościach o takiej samej nazwie z dodaniem przyrostka „Diff”. Przykładowo definitionsDiff ukazuje liczbę znaczeń dodanych lub usuniętych od poprzedniego zrzutu. Jeżeli ta liczba jest równa zeru, właściwość zostaje pominięta.
Opis funkcji[edytuj]
Sposób wywołania: {{#invoke:statystyka|<funkcja>|<parametry>}}.
mainRanking[edytuj]
Generuje tabelę z zestawieniem języków z największą liczbą haseł (WS:STAT#Języki). Dodatkowe kolumny: liczba znaczeń.
Parametry:
1(opcjonalny): liczba języków do wyświetlenia; jeżeli jest pusty, wyświetla wszystkie języki oraz podsumowanie w stopce tabeli
Przykłady:
{{#invoke:statystyka|mainRanking|50}}– tabela zestawiająca 50 języków z największą liczbą haseł{{#invoke:statystyka|mainRanking}}– tabela zestawiająca wszystkie języki w projekce z podsumowaniem
combinedLengthRanking[edytuj]
Generuje tabelę z zestawieniem języków z największą sumą długości haseł (WS:STAT#Długość haseł). Dodatkowe kolumny: różnica sumy długości względem poprzedniego zrzutu, średnia długość hasła, różnica średniej długości hasła, liczba haseł.
Parametry:
1(opcjonalny): liczba języków do wyświetlenia; jeżeli jest pusty, wyświetla wszystkie języki oraz podsumowanie w stopce tabeli2(opcjonalny): główny klucz sortowania (zob. #Schemat JSON); jeżeli dodano przyrostekRate, kluczem będzie wynik dzielenia wskazanej właściwości (bez przyrostka) przez liczbę haseł; domyślnie suma długości haseł3(opcjonalny): filtr minimalnej liczby haseł; domyślnie zero
Przykłady:
{{#invoke:statystyka|combinedLengthRanking}}– tabela zestawiająca wszystkie języki w projekcie z podsumowaniem{{#invoke:statystyka|combinedLengthRanking|50}}– tabela zestawiająca 50 języków z największą sumą długości haseł{{#invoke:statystyka|combinedLengthRanking|50|definitions}}– tabela zestawiająca 50 języków z największą sumą długości haseł, posortowana wg liczby znaczeń w kolejności malejącej{{#invoke:statystyka|combinedLengthRanking|50|combinedLengthRate}}– tabela zestawiająca 50 języków z największą sumą długości haseł, posortowana wg średniej długości haseł w kolejności malejącej{{#invoke:statystyka|combinedLengthRanking|50|combinedLengthRate|500}}– tabela zestawiająca 50 języków z największą sumą długości haseł, posortowana wg średniej długości haseł w kolejności malejącej, z ograniczeniem do języków liczących 500 haseł lub więcej
definitionsRanking[edytuj]
Generuje tabelę z zestawieniem języków z największą liczbą znaczeń (WS:STAT#Znaczenia). Dodatkowe kolumny: różnica liczby znaczeń względem poprzedniego zrzutu, średnia znaczeń na hasło, różnica średniej znaczeń, liczba haseł.
Parametry:
1(opcjonalny): liczba języków do wyświetlenia; jeżeli jest pusty, wyświetla wszystkie języki oraz podsumowanie w stopce tabeli2(opcjonalny): główny klucz sortowania (zob. #Schemat JSON); jeżeli dodano przyrostekRate, kluczem będzie wynik dzielenia wskazanej właściwości (bez przyrostka) przez liczbę haseł; domyślnie liczba znaczeń3(opcjonalny): filtr minimalnej liczby haseł; domyślnie zero
Przykłady:
{{#invoke:statystyka|definitionsRanking}}– tabela zestawiająca wszystkie języki w projekcie z podsumowaniem{{#invoke:statystyka|definitionsRanking|50}}– tabela zestawiająca 50 języków z największą liczbą znaczeń{{#invoke:statystyka|definitionsRanking|50|combinedLength}}– tabela zestawiająca 50 języków z największą liczbą znaczeń, posortowana wg sumy długości haseł w kolejności malejącej{{#invoke:statystyka|definitionsRanking|50|definitionsRate}}– tabela zestawiająca 50 języków z największą liczbą znaczeń, posortowana wg średniej liczby znaczeń na hasło w kolejności malejącej{{#invoke:statystyka|definitionsRanking|50|definitionsRate|500}}– tabela zestawiająca 50 języków z największą liczbą znaczeń, posortowana wg średniej liczby znaczeń na hasło w kolejności malejącej, z ograniczeniem do języków liczących 500 haseł lub więcej
miscellaneaRanking[edytuj]
Generuje tabelę z zestawieniem haseł z ilustracjami, z nagraniem wymowy oraz ze źródłem dla języków z największą liczbą haseł (WS:STAT#Multimedia i źródła). Dodatkowe kolumny: stosunek haseł ze wskazaną właściwością do całkowitej liczby haseł, różnica względem poprzedniego zrzutu.
Parametry:
1(opcjonalny): liczba języków do wyświetlenia; jeżeli jest pusty, wyświetla wszystkie języki oraz podsumowanie w stopce tabeli2(opcjonalny): główny klucz sortowania (zob. #Schemat JSON); jeżeli dodano przyrostekRate, kluczem będzie wynik dzielenia wskazanej właściwości (bez przyrostka) przez liczbę haseł; domyślnie liczba haseł3(opcjonalny): filtr minimalnej liczby haseł; domyślnie zero
Przykłady:
{{#invoke:statystyka|miscellaneaRanking}}– tabela zestawiająca wszystkie języki w projekcie z podsumowaniem{{#invoke:statystyka|miscellaneaRanking|50}}– tabela zestawiająca 50 języków z największą liczbą haseł{{#invoke:statystyka|miscellaneaRanking|50|definitions}}– tabela zestawiająca 50 języków z największą liczbą haseł, posortowana wg średniej liczby znaczeń w kolejności malejącej{{#invoke:statystyka|miscellaneaRanking|50|definitionsRate}}– tabela zestawiająca 50 języków z największą liczbą haseł, posortowana wg średniej liczby znaczeń w kolejności malejącej{{#invoke:statystyka|miscellaneaRanking|50|definitionsRate|500}}– tabela zestawiająca 50 języków z największą liczbą haseł, posortowana wg liczby znaczeń w kolejności malejącej, z ograniczeniem do języków liczących 500 haseł lub więcej
languageIndex[edytuj]
Generuje indeks języków na stronie głównej.
Parametry:
1(wymagany): lista najniższych niepodzielnych progów w kolejności rosnącej, oddzielonych przecinkiem; ostatnia wartość wyznacza wielokrotność kolejnych progów
Przykłady:
{{#invoke:statystyka|languageIndex|10000}}– grupuje języki w odstępach co 10 000 haseł{{#invoke:statystyka|languageIndex|1000,2000,5000}}– generuje grupę języków z tysiącem haseł lub więcej, z dwoma tysiącami, z pięcioma tysiącami, a wyżej z wielokrotnością 5000 (ponad 10 000 haseł, ponad 15 000, ponad 20 000 itd.)
queryStorage[edytuj]
Wyłuskuje wartość pożądanej właściwości z tablicy danych JSON.
Parametry: zobacz #Schemat JSON.
Przykłady:
{{#invoke:statystyka|queryStorage|currentDate}}– data ostatniego zrzutu{{#invoke:statystyka|queryStorage|overall|withReferences}}– suma wszystkich haseł z przypisami w projekcie{{#invoke:statystyka|queryStorage|languages|hiszpański|withReferences}}– licznik hiszpańskich haseł z przypisami
canonicalCounter[edytuj]
Licznik haseł z definicją. Zwraca rozmiar kategorii [1] (indeks), jeżeli nie znaleziono wskazanego języka w tablicy danych JSON.
Parametry:
1(opcjonalny): krótka nazwa języka; jeżeli jest pusty, zwraca sumę liczników haseł dla wszystkich języków
Przykłady:
{{#invoke:statystyka|canonicalCounter|hiszpański}}– licznik hiszpańskich haseł z definicją{{#invoke:statystyka|canonicalCounter}}– suma wszystkich haseł z definicją w projekcie
flexiveFormCounter[edytuj]
Licznik haseł bez definicji (jedyne znaczenia to formy fleksyjne). Zwraca rozmiar kategorii [1] (formy fleksyjne), jeżeli nie znaleziono wskazanego języka w tablicy danych JSON.
Parametry:
1(opcjonalny): krótka nazwa języka; jeżeli jest pusty, zwraca sumę liczników haseł dla wszystkich języków
Przykłady:
{{#invoke:statystyka|flexiveFormCounter|hiszpański}}– licznik hiszpańskich haseł bez definicji{{#invoke:statystyka|flexiveFormCounter}}– suma wszystkich haseł bez definicji w projekcie
definitionCounter[edytuj]
Licznik znaczeń. Zwraca 0, jeżeli nie znaleziono wskazanego języka w tablicy danych JSON.
Parametry:
1(opcjonalny): krótka nazwa języka; jeżeli jest pusty, zwraca sumę liczników definicji dla wszystkich języków
Przykłady:
{{#invoke:statystyka|definitionCounter|hiszpański}}– licznik znaczeń w hiszpańskich hasłach{{#invoke:statystyka|definitionCounter}}– suma znaczeń we wszystkich hasłach w projekcie
Zobacz też[edytuj]
To jest strona dokumentacji dla Moduł:statystyka