Модуль:Wikidata/P54/Дакументацыя

Гэты модуль фарматуе звесткі, якія змяшчаюцца ў сутнасці Вікіданых, і прадстаўляе іх у выглядзе радкоў са звесткамі аб спартыўнай кар'еры для выкарыстання ў шаблонах {{Футбаліст}}, {{Гандбаліст}} і іншых.

Модуль змяшчае функцыі:

• formatPropertyP54 — асноўная функцыя, якая забірае звесткі з Вікіданых і вяртае радок кар'еры.
• formatFootballCareer — фарматуе адзін радок кар'еры.
• formatEntityId — вяртае подпіс аднаго элемента, па магчымасці з вікі-спасылкай. Код функцыі ўзяты з модуля Модуль:Wikidata.
• loadCacheSafe — здаецца, не выкарыстоўваецца (трэба прыбраць?).
• orderByDate — функцыя, якая сартыруе каманды паводле даты выступлення за іх.
• parseISO8601Year — дапаможная функцыя атрымання года з даты.

Прынцып працы функцый:

• formatPropertyP54 — забірае значэнні сцвяржэнняў уласцівасці "options.property" (звычайна P54 — "член спартыўнай каманды"), фільтруе іх па "options.clubEntity" (калі ён заданы), сартыруе па даце з дапамогай функцыі orderByDate, для кожнага сцвярджэння выклікае функцыю formatFootballCareer для атрымання радкоў і запісвае ўсе радкі ў шаблон {{Футбольная кар’ера}}.
• orderByDate — сартыруе радкі паводле даты. Улічваюцца па магчымасці даты пачатку і заканчэння выступу за клуб. Асобна апрацоўваецца знаходжанне ў арэндзе. Каманды, для якіх дата невядомая, застануцца ў тым жа парадку, як запісаны ў Вікідата.
• formatFootballCareer — для адной каманды атрымлявае радок са звесткамі аб выступленні. Запісваюцца даты пачатку і заканчэнні выступу (калі іх няма, застаюцца прагалы), сцяг краіны каманды памеру 20px (Швейцарыя — 15px), назва каманды, сфармаваная з дапамогай функцыі formatEntityId, далей колькасць матчаў і набраных ачкоў (забітых галоў) за каманду (калі вядома).