Diskuse k Wikipedii:WikiProjekt Strojový popis

Harmonogram

Doporučoval bych následující postup:

• projít šablony již TD obsahující (vyjma citačních) - asi 60 a v případě potřeby upravit (pořadí, chybějící vysvětlivky a příklady, povinné parametry atd.)
• napsat obecné články k TD a nápovědu
• oznámit komunitě existenci těchto článků a vydat doporučení, že mají autoři šablon již TD zahrnovat
• průběžně sledovat vznik nových šablon a žádat autory aby zahrnuli TD
• rozvrhnout práci na šablonách TD neobsahujících - asi 15.000
• ukončit projekt

--Juandev (diskuse) 27. 12. 2015, 14:29 (CET)

Priority

Doporučuji začít šablonami, u nichž je nejvyšší pravděpodobnost, že je nováčci budou v článcích používat. Tzn. časté infoboxy, šablona překlad, a podobně. Akorát nevím, jak tyto šablony vytipovat :-) --Vojtěch Dostál (diskuse) 27. 12. 2015, 14:35 (CET)

Pravda dobrý nápad. No tak můžeme vzít šablony, které začínají názvem Infobox a pak se podívat na četnost užití šablon.--Juandev (diskuse) 27. 12. 2015, 14:37 (CET)

Pojmenování

Vznik projektu moc vítám, občas se v popisech šablon taky vrtám a rád příležitostně přispěju. Dovoluji si jen upozornit přítomné, že příslušnou funkcionalitu tu už nějaký ten pátek v desítkách případů nazýváme česky „Data šablony“, takže pokud už ne celý wikiprojekt, tak prosím, aby se alespoň příslušné sekce na stránkách šablon jmenovaly jednotně. Díky --Blahma (diskuse) 27. 12. 2015, 20:00 (CET)

Aha, to jsem netušil. Tak já bych tedy teď na začátku celý projekt přejmenoval. Upozorňoval jsem na to pod lípou a je možné, že někteří teda netuší o co jde, když tam píši TemplateData:-)--Juandev (diskuse) 27. 12. 2015, 20:39 (CET)

Lepší mi to přijde s přívlastkem shodným, tzn. "Šablonová data", ale pro přejmenování rozhodně jsem :). Do budoucna bude vhodné mít pro to český výraz. --Vojtěch Dostál (diskuse) 27. 12. 2015, 21:17 (CET)

BTW, "data" moc česky nezní.--Juandev (diskuse) 27. 12. 2015, 21:34 (CET)

„Šablonová data“ bohužel svádí k tomu, že se jedná o data tvořená podle nějaké šablony, podle nějakého jednotného mustru, zatímco tady jde přesně o opak – tato data vyjadřují v kostce celou tu logiku, o které v šabloně jde. Proto teď máme „data šablony“, ačkoliv souhlasím, že to není ideální. I proto jsem zatím tady psal obšírněji o „strojově čitelných datech popisujících šablonu“, protože ta strojová zpracovatelnost a zachycení uživatelského rozhraní šablony je přesně to, o co v případě TemplateData jde. Taky souhlasím, že češtější než „data“ jsou „údaje“, což se bohužel u „Wikidat“ nepodařilo prosadit (Slováci své „Wikiúdaje“ mají), ale pochopitelné pro lidi je asi obojí. Naopak "template" není příliš mezinárodní slovo a nováčkům ostatně nebývá srozumitelné ani to, co to vůbec ty naše „šablony“ jsou a k čemu slouží, takže v tomto případě je i dobrý překlad jen poloviční cestou k úspěchu. Ono ani celé to anglické pojmenování "TemplateData" není úplně nejvýstižnější, ani vytvářené nijak zvlášť s ohledem na internacionalizaci (obdobně jako je těžko přeložitelný "VisualEditor", nebo si zkuste přeložit i anglosasky kulturně zatížené "Commons" – původně něco jako sdílené obecní pastviny), ale s tím se nedá moc dělat a považuju to za daň za to, že stejně jako Wikipedie i tyto nové funkcionality vznikají zčásti živelně a v převážně monolingvální komunitě. --Blahma (diskuse) 28. 12. 2015, 15:03 (CET)

Pokud by se mělo jednat o výstižné pojmenování, já bych si dovedl představit i volnější překlad a začal tomu říkat klidně „strojový popis“, což by dobře a srozumitelně znělo v různých kolokacích, např. „k této šabloně zatím není dostupný strojový popis“ nebo „strojový popis šablony usnadňuje její používání ve vizuálním editoru“. Co vy na to? --Blahma (diskuse) 28. 12. 2015, 15:07 (CET)

Taky může být.--Juandev (diskuse) 28. 12. 2015, 15:52 (CET)

Tak pokud nikdo nic nemá proti přejmenuji na Strojový popis.--Juandev (diskuse) 7. 1. 2016, 11:54 (CET)

Díky, já jsem pro. Pokud možno s doplněním „… šablony“ za „strojový popis“ v místech, kde by to mohlo být nejasné (třeba v nápovědních stránkách). --Blahma (diskuse) 7. 1. 2016, 23:58 (CET)

Hotovo.--Juandev (diskuse) 24. 1. 2016, 20:10 (CET)

Dárek pro projekt

Napsal jsem pro projekt modul, který v článku použije TemplateData šablony a zjistí, jestli v něm není použit nějaký neznámý parametr. Pokud je, vloží do článku údržbovou kategorii a současně na to upozorní editora pod editačním oknem pod „Data profilování syntaktického analyzátoru“ v „Protokoly Lua“. TemplateData mohou být vložena i v /doc podstránce, ale ta je pak považována za další šablonu použitou na stránce. Modul se používá takto: <includeonly>{{#invoke:CheckParameters|checkParameters}}</includeonly>. V případě zájmu přidělám hledání zastaralých parametrů, také pomocí TemplateData. Matěj Suchánek (diskuse) 1. 1. 2016, 17:09 (CET)

Díky, budu to muset prozkoumat.--Juandev (diskuse) 7. 1. 2016, 11:56 (CET)

Přiznám se, že to nechápu. Kdyby byla nějaká vidoe nebo obrazová dokumentace k funkcionalitě, tak bych se asi dovtípil.

• Modul, který v čláku použije TD - to jako automaticky, bez editace článku? Jak to funguje? nebo musíme někam vložit ten níže uvedený kód? Vážně nechápu, nejsem programátor.
• použití neznámích parametrů v článku by měl zjistit nějaký robot, a minimálně by to mohlo třeba poničit zobrazní šablony ne? Jak je pro tento projekt důležité vědět, jestli není konkrétní použití šablony chybné?--Juandev (diskuse) 24. 1. 2016, 21:21 (CET)

Daný kód se vkládá na konec šablony (třeba před <noinclude>{{Dokumentace}}...). Když šablona parametr nezná, nijak se to neprojeví. Pravda, spíš než využití projektem by šlo o další využití projektu. Matěj Suchánek (diskuse) 24. 1. 2016, 21:53 (CET)

Dobrá, ale to je možné k širší diskusi ne?--Juandev (diskuse) 24. 1. 2016, 22:11 (CET)

Jako já jsem pro takovou evidenci. Otázka je co všechno evidovat, zatím jsem nalezl tyto problémy:

1. šablona nemá dokumentadi (tedy takový ten obvyklý popis pro použití kodu)
2. šablona není v kategorii--Juandev (diskuse) 24. 1. 2016, 22:32 (CET)

Tohle jedině pomocí databáze (dumpu).

Ten modul není nutné využívat hromadně, dá se použít při předělávání celé šablony pro zjištění, kde ještě je ve starém formátu. Klidně můžeš diskutovat... Matěj Suchánek (diskuse) 25. 1. 2016, 14:13 (CET)

Vedlejší výstupy

Ač to není (a nemělo by být cílem), tak si myslím, že by jsme mohli vydat i nějaké vedlejší výstupy:

• statistické - kolik šablon máme, jaké jsou apod.
• upozornit na chybně fungující šablony, zastaralé šablony etc. - prostě navrhnout udělání pořádku
• možná něco dalšího.

--Juandev (diskuse) 7. 1. 2016, 12:25 (CET)

Pár dotazů

Tak jsem si prošel pár šablon a zjistil jsem, že je to ještě náročnější než jsem čekal (což mě značně teda otrávilo). Tady je pár dotazů do pléna:

1. budeme dávat strojový popis přímo na stránku, nebo na substránku s dokumentací?
2. pokud je to na stránce, nemělo by se to graficky oddělit? - v některých šablonách to splývá
3. budeme evidovat šablony bez dokumentace?
4. budeme evidovat šabony bez kategorií?
5. prostě budeme evidovat šablony s různými nedostatky?
6. Popisky parametrů by měli začínat velkým písmenem
7. nebudeme označovat do diskuse již zpracovatné šablony a mít tam odkaz pro případ, že by někdo doplnil parametr, aby věděl jak to dělat v SP?
8. nějaký tracker šablon, respetive jak označovat v jakém jsou stavu zpracování?
9. které proměnné vyplňovat a jak:
   1. Název
   2. aliasy
   3. výchozí
   4. automatická hodnota
10. jaké jsou typy parametrů?
11. budeme řešit preferovaný formát šablony?
12. jak řešit kombinace parametrů - viz Možná hledáte

Huh, je toho víc.--Juandev (diskuse) 8. 3. 2016, 20:46 (CET)

Huh nic, tak to asi nejsem schopen moc přispívat, když tomu nerozumím. Alespoň, kdyby někdo to vysvětlil - z tutoriálu na mw to není moc jasné, neb je zastaralý.--Juandev (diskuse) 12. 4. 2016, 20:49 (CEST)

Spíš je toho moc :). Teď rychle, zítra podrobněji, chceš-li. Strojový podpis rozhodně na doc stránku, šablony bez dokumentace/kategorií, seznam klidně vytvořím, to není velký problém. Zbytek zítra. K vysvětlení: Co vysvětlit? Pojem to mi není zcela jasný. Jestli budeš mít technický dotaz, polož ho pod technickou lípou. Já ti s čímkoliv technickým taky rád pomůžu, budu-li vědět. --Urbanecm (diskuse) 12. 4. 2016, 21:54 (CEST)

Parametry

Řekl jsem si, že popíši šablonu {{Sloučit}}, ale koukám, že jsem to trochu zapomněl. Když si dám naimportovat parametry, tak jich mám 9. Číselné i popsané. Není možné, že některé popsané se rovnají těm číselným a není jich tedy 9 ale jen 7? Jak ten nástroj ty parametry generuje?--Juandev (diskuse) 10. 12. 2018, 11:10 (CET)