Implementace citací #38

Merged
jan merged 2 commits from citace into master 8 months ago
Owner

Jednoduchá implementace citací.

Jednoduchá implementace citací.
jirikalvoda added 1 commit 9 months ago

Nevím přesně, jak citace v pandocu fungují, ale přijde mi, že nechceme mít implementaci, která náhodně vytváří odkazy někam do zbytku dokumentu, nad kterým nemáme kontrolu -- ale pokud se chceme starat o citace, asi bychom měli mít.

Pokud se naučíme tu část dokumentu, do které tyhle odkazy vedou taky generovat, nepřijde mi to jako špatná implementace.

Na druhou stranu by se mi asi daleko více líbila (čistě graficky) implementace podobnější tomu, co dělá Wikipedie, aby za citovaným místem byl třeba horní index s číslíčkem v hranatých závorkách (nebo něco podobného). Nepřijde mi hezké (pokud to chápu správně) mít celou citaci, která může být dlouhá, jako odkaz.

Also also, pokud chceme používat citace, měli bychom si je zapnout tady.

Nevím přesně, jak citace v pandocu fungují, ale přijde mi, že nechceme mít implementaci, která náhodně vytváří odkazy někam do zbytku dokumentu, nad kterým nemáme kontrolu -- ale pokud se chceme starat o citace, asi bychom měli mít. Pokud se naučíme tu část dokumentu, do které tyhle odkazy vedou taky generovat, nepřijde mi to jako špatná implementace. Na druhou stranu by se mi asi daleko více líbila (čistě graficky) implementace podobnější tomu, co dělá Wikipedie, aby za citovaným místem byl třeba horní index s číslíčkem v hranatých závorkách (nebo něco podobného). Nepřijde mi hezké (pokud to chápu správně) mít celou citaci, která může být dlouhá, jako odkaz. Also also, pokud chceme používat citace, měli bychom si je zapnout [tady](https://gitea.ks.matfyz.cz/KSP/formatitko/src/branch/master/src/formatitko/util.py#L40).
Poster
Owner

Nevím přesně, jak citace v pandocu fungují, ale přijde mi, že nechceme mít implementaci, která náhodně vytváří odkazy někam do zbytku dokumentu, nad kterým nemáme kontrolu -- ale pokud se chceme starat o citace, asi bychom měli mít.

Moje chápání tohoj, jak pandoc funguje:
Když si řekneš o citaci, tak na dané místo vloží Cite obsahující rozumně nagenerovaný text uvnitř.
Na konec souboru nebo tam, kde dáš ::: {#refs}\n::: ti pak vloží seznam citací.
Jako já tomu také moc nerozummím, ale z mého pozorování mi přišlo, že pandoc umí docela slušně parsovat .bib soubory a myslím, že byh mělo být hodně nastavitelné, jak přesně věci formátuje (ale s tím jsem si ještě moc nehrál). Osobně bych tedy rád implementaci udržel co nejejdodužší a co nejvíce práce nechal na pandocu, který je v tom docela dobrý a vzhledem k tomu, že to asi stejně nikdo nebude potřeba, nemá smysl na tom pálit moc času.

Pokud se naučíme tu část dokumentu, do které tyhle odkazy vedou taky generovat, nepřijde mi to jako špatná implementace.

Ta část dokumentu, kam verdou nám vygeneruje pandoic a bohužel ani moc neoznačí, že tam něco je. Moc tedy nevím, co s tím.

Na druhou stranu by se mi asi daleko více líbila (čistě graficky) implementace podobnější tomu, co dělá Wikipedie, aby za citovaným místem byl třeba horní index s číslíčkem v hranatých závorkách (nebo něco podobného). Nepřijde mi hezké (pokud to chápu správně) mít celou citaci, která může být dlouhá, jako odkaz.

Doufám, že přesně toto jde nastavit zvnějšku.

Also also, pokud chceme používat citace, měli bychom si je zapnout tady.

Jo chtělo, nějak mi nedošlo, že je něco potřeba, protože tuto část kódu nějak vynechávám. ;D

Osobně by mi dávalo smysl, aby toto vše bylo nastgavitelné parametry programu s tím, že default bude citace nedělat, ale jinak půjdou zadat \pm stejné věci, co umí pandoc.

> Nevím přesně, jak citace v pandocu fungují, ale přijde mi, že nechceme mít implementaci, která náhodně vytváří odkazy někam do zbytku dokumentu, nad kterým nemáme kontrolu -- ale pokud se chceme starat o citace, asi bychom měli mít. Moje chápání tohoj, jak pandoc funguje: Když si řekneš o citaci, tak na dané místo vloží `Cite` obsahující rozumně nagenerovaný text uvnitř. Na konec souboru nebo tam, kde dáš `::: {#refs}\n:::` ti pak vloží seznam citací. Jako já tomu také moc nerozummím, ale z mého pozorování mi přišlo, že pandoc umí docela slušně parsovat `.bib` soubory a myslím, že byh mělo být hodně [nastavitelné](https://pandoc.org/chunkedhtml-demo/9.2-specifying-a-citation-style.html), jak přesně věci formátuje (ale s tím jsem si ještě moc nehrál). Osobně bych tedy rád implementaci udržel co nejejdodužší a co nejvíce práce nechal na pandocu, který je v tom docela dobrý a vzhledem k tomu, že to asi stejně nikdo nebude potřeba, nemá smysl na tom pálit moc času. > Pokud se naučíme tu část dokumentu, do které tyhle odkazy vedou taky generovat, nepřijde mi to jako špatná implementace. Ta část dokumentu, kam verdou nám vygeneruje pandoic a bohužel ani moc neoznačí, že tam něco je. Moc tedy nevím, co s tím. > Na druhou stranu by se mi asi daleko více líbila (čistě graficky) implementace podobnější tomu, co dělá Wikipedie, aby za citovaným místem byl třeba horní index s číslíčkem v hranatých závorkách (nebo něco podobného). Nepřijde mi hezké (pokud to chápu správně) mít celou citaci, která může být dlouhá, jako odkaz. Doufám, že přesně toto jde nastavit zvnějšku. > Also also, pokud chceme používat citace, měli bychom si je zapnout [tady](https://gitea.ks.matfyz.cz/KSP/formatitko/src/branch/master/src/formatitko/util.py#L40). Jo chtělo, nějak mi nedošlo, že je něco potřeba, protože tuto část kódu nějak vynechávám. ;D Osobně by mi dávalo smysl, aby toto vše bylo nastgavitelné parametry programu s tím, že default bude citace nedělat, ale jinak půjdou zadat \pm stejné věci, co umí pandoc.
Poster
Owner

Dává to za tebe nějak takto smysl?

Dává to za tebe nějak takto smysl?

Osobně by mi dávalo smysl, aby toto vše bylo nastgavitelné parametry programu s tím, že default bude citace nedělat, ale jinak půjdou zadat \pm stejné věci, co umí pandoc.

Tady mi dává smysl, abychom si od pandocu nenechali vyrábět elementy, které neumíme dál vygenerovat. Pokud se je naučíme alespoň generovat, nevidím důvod, je nemít zapnuté. (Ano může se to teoreticky hodit, pokud máš nějakou divokou syntaxi vlastníoh markdownu a nechceš, aby ti ji pandoc sežral, některé fíčury vypínat, ale to mi přijde trochu out of scope toho, co má commandlinová verze formátítka sama umět)

že by mělo být hodně nastavitelné, jak přesně věci formátuje

Tedy platí, že v contentu toho Citeu je jen nějaká zkratka (MAREŠ - Průvodce) a to, kam to pak ukazuje obsahuje celou citaci? V takovém případě mi to nepřijde špatné. Uměl bys udělat nějaký example, jak to bude vypadat?

> Osobně by mi dávalo smysl, aby toto vše bylo nastgavitelné parametry programu s tím, že default bude citace nedělat, ale jinak půjdou zadat \pm stejné věci, co umí pandoc. Tady mi dává smysl, abychom si od pandocu nenechali vyrábět elementy, které neumíme dál vygenerovat. Pokud se je naučíme alespoň generovat, nevidím důvod, je nemít zapnuté. (Ano může se to teoreticky hodit, pokud máš nějakou divokou syntaxi vlastníoh markdownu a nechceš, aby ti ji pandoc sežral, některé fíčury vypínat, ale to mi přijde trochu out of scope toho, co má commandlinová verze formátítka sama umět) > že by mělo být hodně nastavitelné, jak přesně věci formátuje Tedy platí, že v contentu toho `Cite`u je jen nějaká zkratka (`MAREŠ - Průvodce`) a to, kam to pak ukazuje obsahuje celou citaci? V takovém případě mi to nepřijde špatné. Uměl bys udělat nějaký example, jak to bude vypadat?
Poster
Owner
https://kam.mff.cuni.cz/~jirikalvoda/past_zapoctak/
jan added 1 commit 8 months ago
jan merged commit dc48cd411c into master 8 months ago
Poster
Owner
Zdrojový markdown je zde: https://gitlab.kam.mff.cuni.cz/jirikalvoda/binary-paint-shop-problem/-/blob/master/zapoctak-past/index.md Implementaci volání pandocu najdeš na řádku 157 zde: https://gitlab.kam.mff.cuni.cz/jirikalvoda/binary-paint-shop-problem/-/blob/master/zapoctak-past/static_web.py

Jo jasně, ty musíš ještě nějak umět tomu pandocu předhodit bib soubor, :fn:🇬🇧, přidávám si issue.

Jo jasně, ty musíš ještě nějak umět tomu pandocu předhodit bib soubor, :fn::uk:, přidávám si issue.
Poster
Owner

dc48cd411c

Moc mi není jasně, co tu provádíš, resp. jak by to mělo fungovat.
Aby citace funogovaly, musíš při nejmenším pandocu říct, odkud má tahat metadata. To dělám pomocí ["-C", "--bibliography="+bibliography]. Naopak nput_format="markdown-definition_lists-citations-latex_macros" finálně ani nepotřebuješ.

Tvoje nimplementace naopak vlastně jen řekne pandocu, aby naparsoval citace a už s nimi nic nedělal, což by se hodilo, pokud bychom to chtěli dělat sami (což nechceme).

Pro vstup:
https://kam.mff.cuni.cz/~jirikalvoda/priv/ab45a37a3b9b2b8506cce0f158a099/index.md

Získáš:
https://kam.mff.cuni.cz/~jirikalvoda/priv/bd04de7dfa5170ee12fde3d11cf07f/a.html#ref-glim_gr

dc48cd411c Moc mi není jasně, co tu provádíš, resp. jak by to mělo fungovat. Aby citace funogovaly, musíš při nejmenším pandocu říct, odkud má tahat metadata. To dělám pomocí `["-C", "--bibliography="+bibliography]`. Naopak `nput_format="markdown-definition_lists-citations-latex_macros"` finálně ani nepotřebuješ. Tvoje nimplementace naopak vlastně jen řekne pandocu, aby naparsoval citace a už s nimi nic nedělal, což by se hodilo, pokud bychom to chtěli dělat sami (což nechceme). Pro vstup: https://kam.mff.cuni.cz/~jirikalvoda/priv/ab45a37a3b9b2b8506cce0f158a099/index.md Získáš: https://kam.mff.cuni.cz/~jirikalvoda/priv/bd04de7dfa5170ee12fde3d11cf07f/a.html#ref-glim_gr
Poster
Owner

Přemíšlím, jestli nezavézt obecný mechanismus, jak pandocu předávat parametry.

Alternativně můžeme říct, že je náĺ to vlastně jedno a že citace budou jen když používáš pandocv jako knihovnu (což mi osobně stačí a nevím, jestli to někdo jiný využije).

Přemíšlím, jestli nezavézt obecný mechanismus, jak pandocu předávat parametry. Alternativně můžeme říct, že je náĺ to vlastně jedno a že citace budou jen když používáš pandocv jako knihovnu (což mi osobně stačí a nevím, jestli to někdo jiný využije).

Ok, sorry, myslel jsem si, že to je podstatně jednodušší. Ale asi to chceme někdy umět.

Ok, sorry, myslel jsem si, že to je podstatně jednodušší. Ale asi to chceme někdy umět.
The pull request has been merged as dc48cd411c.
Sign in to join this conversation.
No reviewers
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date

No due date set.

Dependencies

This pull request currently doesn't have any dependencies.

Loading…
There is no content yet.