Parametry formátítka

jirikalvoda commented

2023-09-19 23:58:16 +02:00

Owner

Taková trošku věc na zamyšlení, nemám na to jasný názor a ani to moc nemám rozmyšlené.

Nyní existují dvě cesty, jak nějak ovlivňovat chování formátítka.

pomocí cmd parametrů
Pomocí hlavičky souboru
(pak je tu ještě třetí a to volat pandoc jako knihovnu, ale to už je toršku více pro pokraočilé)

U spousty nastavítek moc netuším, kam vlastně patří. Nedávalo by smysl postavit nějakou abstrakci nad těmito dvěmi vstupy a umožnit libovolné nastavítko zadávat z obou míst? V případě kolize asi bude potřeba rozhodnout, které místo je to hlavní.

Připadá mi, že různí uživatelé/různé využití můžou mít dost jinou představu, co kam patří.
Např. když píšu kus pandocu, co chci sdílet jako formátíkto pandoc ostatním spoluprocovníkům, chci to mít v dokumentu.
Když naopak píši něco víc jako KSP, nechci tyto věci opakovat v každé sérii, má se to zadávat makem v parametrech.

Taková trošku věc na zamyšlení, nemám na to jasný názor a ani to moc nemám rozmyšlené. Nyní existují dvě cesty, jak nějak ovlivňovat chování formátítka. - pomocí cmd parametrů - Pomocí hlavičky souboru (pak je tu ještě třetí a to volat pandoc jako knihovnu, ale to už je toršku více pro pokraočilé) U spousty nastavítek moc netuším, kam vlastně patří. Nedávalo by smysl postavit nějakou abstrakci nad těmito dvěmi vstupy a umožnit libovolné nastavítko zadávat z obou míst? V případě kolize asi bude potřeba rozhodnout, které místo je to hlavní. Připadá mi, že různí uživatelé/různé využití můžou mít dost jinou představu, co kam patří. Např. když píšu kus pandocu, co chci sdílet jako formátíkto pandoc ostatním spoluprocovníkům, chci to mít v dokumentu. Když naopak píši něco víc jako KSP, nechci tyto věci opakovat v každé sérii, má se to zadávat makem v parametrech.

jirikalvoda commented

2023-09-19 23:59:47 +02:00

Author

Owner

Yes, issuje 42. 🎉

jirikalvoda commented

2023-09-20 00:01:19 +02:00

Author

Owner

Zase trošku vážněji: Možná je trošku problém, že některá nastavítka je třeba znát před tím, než volám pandoc, přitom já bych je zjistil až poté. To trošku boří celou myšlenu. :(

jan commented

2023-09-20 00:05:33 +02:00

Member

Dává mi smysl umět specifikovat v command lině jen takové věci, které jsou relevantní pro aktuální běh formátítka (což mi tak nějak vychází na souborové cesty vstupních a výstupních souborů) s tím, že zbytek (tedy věci, které se pro jeden dokument nemění mezi běhy na různých strojích a v různých kontextech) chceš už mít naspecifikovaný v souborech samotných. Myslím si, že i usecase KSP, kde bude nejspíš spousta věcí předvolených a společných pro mnoho souborů mi dává smysl explicitně zavolat nějaký import ze zdrojáku (přeci jen, alespoň to bude více očividně pro někoho, kdo to bude pak číst a třeba TeX to dělá stejně).

Citace jsou IMO spíše výjimka potvrzující pravidlo (případně tedy, u citací stejně specifikuješ vstupní soubor, takže ano, patří to do commandlinových přepínačů) a nevadí mi, pokud se budou jakémukoliv modelu, pro který se rozhodneme, nějak vymykat.

Dává mi smysl umět specifikovat v command lině jen takové věci, které jsou relevantní pro aktuální běh formátítka (což mi tak nějak vychází na souborové cesty vstupních a výstupních souborů) s tím, že zbytek (tedy věci, které se pro jeden dokument nemění mezi běhy na různých strojích a v různých kontextech) chceš už mít naspecifikovaný v souborech samotných. Myslím si, že i usecase KSP, kde bude nejspíš spousta věcí předvolených a společných pro mnoho souborů mi dává smysl explicitně zavolat nějaký import ze zdrojáku (přeci jen, alespoň to bude více očividně pro někoho, kdo to bude pak číst a třeba TeX to dělá stejně). Citace jsou IMO spíše výjimka potvrzující pravidlo (případně tedy, u citací stejně specifikuješ vstupní soubor, takže ano, patří to do commandlinových přepínačů) a nevadí mi, pokud se budou jakémukoliv modelu, pro který se rozhodneme, nějak vymykat.

jirikalvoda commented

2023-09-20 00:07:04 +02:00

Author

Owner

Jo, to asi dává smysl. Díky za vysvětlení.

Alespoň prozatím zavírám.

Jo, to asi dává smysl. Díky za vysvětlení. Alespoň prozatím zavírám.

❤️ 1

jirikalvoda closed this issue

2023-09-20 00:07:05 +02:00

jirikalvoda commented

2023-09-20 00:23:43 +02:00

Author

Owner

Napříklaad ale nastavovat flags z příkazové řádky by asi docela dávalo smysl, protože pak by šlo snadno zařídit překlad do tmavého a do světlého htmlka.

Napříklaad ale nastavovat `flags` z příkazové řádky by asi docela dávalo smysl, protože pak by šlo snadno zařídit překlad do tmavého a do světlého htmlka.

jan commented

2023-09-20 00:37:08 +02:00

Member

Zrovna tento use case má za mě tři elegantnější řešení:

Máš template dark.md a light.md které obě inkludí hlavní soubor a nastavují si vlastní věci – to může být fajn protože je pak můžeš poměrně bezbolestně generovat oba dva.
Nebo si naopak inkludíš dark a light jako motivy do svého hlavního souboru podle toho, co se ti zrovna aktuálně líbí.
Dark a light mód vyřešíš CSSkem.

Zrovna tento use case má za mě tři elegantnější řešení: 1. Máš template `dark.md` a `light.md` které obě inkludí hlavní soubor a nastavují si vlastní věci – to může být fajn protože je pak můžeš poměrně bezbolestně generovat oba dva. 2. Nebo si naopak inkludíš dark a light jako motivy do svého hlavního souboru podle toho, co se ti zrovna aktuálně líbí. 3. Dark a light mód vyřešíš CSSkem.

jirikalvoda commented

2023-09-20 09:33:13 +02:00

Author

Owner

``3. Nefunguje, protože highlight-style: "dracula".

``2. Toto obstojně funguje do té doby, dokud se chceš na oba výstupy dívat jen ty. Jakmile chceš na webu zveřejnit obě verze a nechat vybrat uživatele, mje to na nic. Potenciálně tohle by mohlo zachránit include z příkazové řádky, ale to je vlastně tak trošku to, o čem tady celou dobu mluvíme.

``1. Tohle už zní nadějně, ale je to použitelné, když máš jen pár stránek/md souborů. Když jich máš hodně, dostaneš nějak moc souborů.

``3. Nefunguje, protože `highlight-style: "dracula"`. ``2. Toto obstojně funguje do té doby, dokud se chceš na oba výstupy dívat jen ty. Jakmile chceš na webu zveřejnit obě verze a nechat vybrat uživatele, mje to na nic. Potenciálně tohle by mohlo zachránit include z příkazové řádky, ale to je vlastně tak trošku to, o čem tady celou dobu mluvíme. ``1. Tohle už zní nadějně, ale je to použitelné, když máš jen pár stránek/md souborů. Když jich máš hodně, dostaneš nějak moc souborů.

Parametry formátítka #42