Use :gh-repo: role for links to GitHub repositories

CONTRIBUTING.rst

@@ -8,7 +8,7 @@ Našli jste chybu? Chtěli byste něco doplnit? Následující odstavce popisuj
 Rychlé úpravy bez instalace
 ---------------------------
 
-Abyste něco změnili v textech, nemusíte nic instalovat. Obsah lze upravovat online přes `repozitář na GitHubu <https://github.com/pyvec/docs.pyvec.org>`_ pomocí ikony s tužkou v pravém horním rohu u každého souboru.
+Abyste něco změnili v textech, nemusíte nic instalovat. Obsah lze upravovat online přes :gh-repo:`repozitář na GitHubu <pyvec/docs.pyvec.org>` pomocí ikony s tužkou v pravém horním rohu u každého souboru.
 
 Instalace
 ---------
@@ -46,7 +46,7 @@ Kdyby s tím byl nějaký problém, tady je `návod na kombo Sphinx + MyST <http
 Emoji
 ^^^^^
 
-Při psaní můžete používat Emoji jako třeba |:cz:| nebo |:snake:|, ale nepište je přímo pomocí Unicode, ale za pomocí značek jako ``|:cz:|`` nebo ``|:snake:|``. Unicode znaky by se zobrazovaly na každém operačním systému jinak, ale tyto značky budou díky rozšíření `emojicodes <https://github.com/sphinx-contrib/emojicodes>`__ přeloženy na obrázky a ty se zobrazí vždy všem stejně. Mrkněte na `seznam podporovaných Emoji <https://sphinxemojicodes.readthedocs.io/>`__. Obrázky jsou z `Twemoji <https://github.com/twitter/twemoji>`_.
+Při psaní můžete používat Emoji jako třeba |:cz:| nebo |:snake:|, ale nepište je přímo pomocí Unicode, ale za pomocí značek jako ``|:cz:|`` nebo ``|:snake:|``. Unicode znaky by se zobrazovaly na každém operačním systému jinak, ale tyto značky budou díky rozšíření :gh-repo:`emojicodes <sphinx-contrib/emojicodes>` přeloženy na obrázky a ty se zobrazí vždy všem stejně. Mrkněte na `seznam podporovaných Emoji <https://sphinxemojicodes.readthedocs.io/>`__. Obrázky jsou z :gh-repo:`Twemoji <twitter/twemoji>`.
 
 Slack
 ^^^^^
@@ -101,7 +101,7 @@ CI je pouze informativní a nezabrání tomu, aby se hlavní větev dostala do R
 Kontrola rozbitých odkazů
 -------------------------
 
-Na repozitáři je zapojená `GitHub Action <https://github.com/lycheeverse/lychee-action>`_, která jednou denně kontroluje, zda všechny odkazy fungují. Kontrolka:
+Na repozitáři je zapojená :gh-repo:`GitHub Action <lycheeverse/lychee-action>`, která jednou denně kontroluje, zda všechny odkazy fungují. Kontrolka:
 
 .. image:: https://github.com/pyvec/docs.pyvec.org/actions/workflows/check-links.yml/badge.svg
     :target: https://github.com/pyvec/docs.pyvec.org/actions
@@ -117,7 +117,7 @@ Generování stránek a souborů
 Některé stránky a soubory se generují automaticky pomocí skriptů. Tyto skripty se spouští pomocí `GitHub Actions <https://github.com/pyvec/docs.pyvec.org/actions>`_, konkrétně workflow ``generate.yml``. Tyto skripty se spouští jednou denně a generují soubory, které se pak posílají jako pull requesty do repozitáře, pokud vytvoří nějaké změny.
 
 - Generuje se ``docs/operations/boards.rst`` ze `souboru boards.toml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/boards.toml>`_ a ze šablony ``operations/boards.rst``.
-- Generuje se ``docs/operations/grants.rst`` z dat na `pyvec/money <https://github.com/pyvec/money>`_ a ze šablony ``operations/grants.rst``.
+- Generuje se ``docs/operations/grants.rst`` z dat na :gh-repo:`pyvec/money` a ze šablony ``operations/grants.rst``.
 - Generuje se ``docs/_static/twemoji.min.js``, abychom Twemoji měli lokálně a nemuseli se spoléhat na CDN.
 
 Kód pro generování je v ``src/pyvec_docs/cli.py``. Skripty jde pouštět např. ``uv run pyvec-docs gen-boards``.

docs/guides/calendar.rst

@@ -14,7 +14,7 @@ Pravidelné akce
 
 Pravidelné akce lze přidat přes tzv. iCal export. Ten může generovat přímo vaše webová stránka (jako v případě `pyvo.cz <https://pyvo.cz/>`__), nebo jej lze vytáhnout z nějaké služby (Google Calendar, meetup.com).
 
-URL exportu pak na náš web přidejte do souboru `static/data/events_feeds.yml <https://github.com/pyvec/python.cz/edit/master/pythoncz/static/data/events_feeds.yml>`__ repozitáře `pyvec/python.cz <https://github.com/pyvec/python.cz>`__ pomocí pull requestu. Po začlenění se akce objeví rovnou a následně se budou načítat samy každý den.
+URL exportu pak na náš web přidejte do souboru `static/data/events_feeds.yml <https://github.com/pyvec/python.cz/edit/master/pythoncz/static/data/events_feeds.yml>`__ repozitáře :gh-repo:`pyvec/python.cz` pomocí pull requestu. Po začlenění se akce objeví rovnou a následně se budou načítat samy každý den.
 
 Jednorázové akce
 ~~~~~~~~~~~~~~~~

docs/guides/meetup.rst

@@ -40,7 +40,7 @@ Slovníček
 Web
 ^^^
 
-Hlavním rozcestníkem komunity je sice `python.cz <https://python.cz/>`__, ale srazy mají vyhrazený svůj vlastní web, `pyvo.cz <https://pyvo.cz/>`__. Jako i všechno ostatní co se tvoří pro Python komunitu u nás, i tento web `je Open Source <https://github.com/pyvec/pyvo.cz>`__ a může do něj přispět kdokoliv.
+Hlavním rozcestníkem komunity je sice `python.cz <https://python.cz/>`__, ale srazy mají vyhrazený svůj vlastní web, `pyvo.cz <https://pyvo.cz/>`__. Jako i všechno ostatní co se tvoří pro Python komunitu u nás, i tento web :gh-repo:`je Open Source <pyvec/pyvo.cz>` a může do něj přispět kdokoliv.
 
 
 Mám založit sraz?
@@ -177,7 +177,7 @@ Informace na pyvo.cz
 ^^^^^^^^^^^^^^^^^^^^
 
 Před každým setkáním v předstihu přidejte informace na `pyvo.cz <https://pyvo.cz>`__.
-Každý sraz je zaznamenán v `.yaml` souboru v `repozitáři na GitHubu <https://github.com/pyvec/pyvo-data>`__.
+Každý sraz je zaznamenán v `.yaml` souboru v :gh-repo:`repozitáři na GitHubu <pyvec/pyvo-data>`.
 
 Na stránce pro konkrétní město je odkaz *přidat informace o dalším srazu*,
 který otevře stránku s předvyplněnými informacemi pro další sraz.
@@ -194,7 +194,7 @@ jste-li už na našem :ref:`Slacku <slack>`, volat o pomoc v kanálu :slack:`#py
 Propagace
 ^^^^^^^^^
 
-Existuje Twitter účet :twitter:`napyvo`, kam lze psát cokoliv v souvislosti s vaším srazem. :ref:`Zažádejte si o přístup <twitter>` a nebojte se tam psát. Nad toto ještě existuje robot `pyvo-twitter <https://github.com/pyvec/pyvo-twitter>`_, který píše na :twitter:`napyvo` automatické zprávy upozorňující na srazy. Upozorňuje ovšem jen na ty srazy, které jsou včas :ref:`potvrzené na pyvo.cz <srazy-pyvocz>`. Jestliže zaznamenáte nějaký problém s robotem, pište do :slack:`#automatizace`.
+Existuje Twitter účet :twitter:`napyvo`, kam lze psát cokoliv v souvislosti s vaším srazem. :ref:`Zažádejte si o přístup <twitter>` a nebojte se tam psát. Nad toto ještě existuje robot :gh-repo:`pyvo-twitter <pyvec/pyvo-twitter>`, který píše na :twitter:`napyvo` automatické zprávy upozorňující na srazy. Upozorňuje ovšem jen na ty srazy, které jsou včas :ref:`potvrzené na pyvo.cz <srazy-pyvocz>`. Jestliže zaznamenáte nějaký problém s robotem, pište do :slack:`#automatizace`.
 
 .. warning::
     Tato sekce ještě není zcela připravena.
@@ -347,7 +347,7 @@ V průběhu volné zábavy by bylo fajn, kdyby se k sobě účastníci pořád c
 Knihovnička
 ^^^^^^^^^^^
 
-Existuje tzv. `Knihovnička <https://github.com/pyvec/bookshelf/>`__, do které můžete darovat knihy a z níž si knihy můžete půjčovat. Přestože jsou srazy v různých městech, docela se nám zatím daří knihy distribuovat a poptávky po zapůjčkách uspokojovat (velký dík za to patří především knihovníkovi `Petru Viktorinovi <https://encukou.cz/>`__, jenž s knihami pravidelně objíždí většinu srazů v ČR). Máš-li sraz, tato Knihovnička je jednou z věcí, kterou tam můžeš docela snadno zavést a podpořit tak interakci lidí i přenos vědomostí.
+Existuje tzv. :gh-repo:`Knihovnička <pyvec/bookshelf>`, do které můžete darovat knihy a z níž si knihy můžete půjčovat. Přestože jsou srazy v různých městech, docela se nám zatím daří knihy distribuovat a poptávky po zapůjčkách uspokojovat (velký dík za to patří především knihovníkovi `Petru Viktorinovi <https://encukou.cz/>`__, jenž s knihami pravidelně objíždí většinu srazů v ČR). Máš-li sraz, tato Knihovnička je jednou z věcí, kterou tam můžeš docela snadno zavést a podpořit tak interakci lidí i přenos vědomostí.
 
 
 Po akci
@@ -359,9 +359,9 @@ Po akci
 Materiály z přednášek
 ^^^^^^^^^^^^^^^^^^^^^
 
-Jako archiv informací o jednotlivých srazech jsme využívali `Lanyrd <https://en.wikipedia.org/wiki/Lanyrd>`__, ale nakonec jsme si na `pyvo.cz <https://pyvo.cz/>`__ udělali vlastní systém s databází `pyvo-data <https://github.com/pyvec/pyvo-data>`__.
+Jako archiv informací o jednotlivých srazech jsme využívali `Lanyrd <https://en.wikipedia.org/wiki/Lanyrd>`__, ale nakonec jsme si na `pyvo.cz <https://pyvo.cz/>`__ udělali vlastní systém s databází :gh-repo:`pyvo-data <pyvec/pyvo-data>`.
 
-Pokud máš nějaké slajdy nebo jiné materiály, je dobré je na stránky vašeho srazu doplnit k popisu přednášek. Může to být skoro cokoliv od odkazu na YouTube s videem z přednášky, po odkazy na slajdy ze služeb jako `Speaker Deck <https://speakerdeck.com/>`__ či `SlideShare <https://www.slideshare.net/>`__. Pokud ti přednášející předá slajdy ve formě souboru, převeď je pokud možno na PDF a nahraj do repozitáře `talks-archive <https://github.com/pyvec/talks-archive>`__.
+Pokud máš nějaké slajdy nebo jiné materiály, je dobré je na stránky vašeho srazu doplnit k popisu přednášek. Může to být skoro cokoliv od odkazu na YouTube s videem z přednášky, po odkazy na slajdy ze služeb jako `Speaker Deck <https://speakerdeck.com/>`__ či `SlideShare <https://www.slideshare.net/>`__. Pokud ti přednášející předá slajdy ve formě souboru, převeď je pokud možno na PDF a nahraj do repozitáře :gh-repo:`talks-archive <pyvec/talks-archive>`.
 
 
 .. _srazy-fotky:
@@ -381,7 +381,7 @@ Videa
 
 Pokud se ti povedlo natočit nějaká videa (viz :ref:`srazy-nataceni`), buď dej vědět `Petrovi Viktorinovi <https://encukou.cz/>`__ a nebo se pokus o jejich zpracování sám/sama.
 
- 1. Připrav prázdný adresář pro každou přednášku. S ti tím pomůže funkce ``videometadata`` nástroje `pyvodb <https://github.com/pyvec/pyvodb>`__:
+ 1. Připrav prázdný adresář pro každou přednášku. S ti tím pomůže funkce ``videometadata`` nástroje :gh-repo:`pyvodb <pyvec/pyvodb>`:
 
 .. code-block:: shell
 
@@ -404,7 +404,7 @@ Pokud se ti povedlo natočit nějaká videa (viz :ref:`srazy-nataceni`), buď de
 
  2. Do připravených adresářů nahraj soubory s videem – jak z kamery, tak záznamy projekce. Uprav vygenerovaný soubor ``config.yaml``, tak aby obsahoval správný název přednášky, jméno přednášejícího, datum a URL akce, stejně jako odkazy na videosoubory (pokud kamera automaticky dělí záběry do více souborů, nevadí to) a další metadata: jestli byla projekce 4:3 nebo 16:9, jestli jde o lightning talk, v jakém jazyku byla přednáška a v jakém slajdy, atd. Všechny možné volby najdeš v nápovědě níže zmíněného nástroje ``talk-video-maker``.
 
- 3. Nainstaluj `talk-video-maker <https://github.com/encukou/talk-video-maker>`__ a jeho závislosti – `Inkscape <https://inkscape.org/cs/>`__, `FFmpeg <https://ffmpeg.org/>`__ a font `Signika Negative <https://fonts.google.com/specimen/Signika+Negative>`__. Tohle s největší pravděpodobností nebude fungovat jinde než na Linuxu. Na wiki projektu je stručný `návod, jak s tím začít <https://github.com/encukou/talk-video-maker/wiki/Jak-s-t%C3%ADm-za%C4%8D%C3%ADt>`__.
+ 3. Nainstaluj :gh-repo:`talk-video-maker <encukou/talk-video-maker>` a jeho závislosti – `Inkscape <https://inkscape.org/cs/>`__, `FFmpeg <https://ffmpeg.org/>`__ a font `Signika Negative <https://fonts.google.com/specimen/Signika+Negative>`__. Tohle s největší pravděpodobností nebude fungovat jinde než na Linuxu. Na wiki projektu je stručný `návod, jak s tím začít <https://github.com/encukou/talk-video-maker/wiki/Jak-s-t%C3%ADm-za%C4%8D%C3%ADt>`__.
 
 .. code-block:: shell
 
@@ -416,7 +416,7 @@ Pokud se ti povedlo natočit nějaká videa (viz :ref:`srazy-nataceni`), buď de
 
  4. Pokud se vše podařilo, máš v aktuálním adresáři sestříhané video a k němu YAML soubor s metadaty potřebnými pro YouTube. Zkontroluj, jestli video vypadá, jak vypadat má, jestli nejsou překlepy v titulcích a jestli i na konci videa je synchronní obraz a zvuk. Pokud něco není v pořádku, pokus se najít příčinu – nejspíš to bude poškozený nebo špatně ustřižený video soubor.
 
- 5. Pro nahrávání do `kanálu Pyvo na YouTube <https://www.youtube.com/channel/UCaT4I7hjX9iH1YFvNvuu84A>`__ potřebuješ vlastní Google účet. Následně požádáš `Petra Viktorina <https://encukou.cz/>`__, aby tě přidal jako správce. Na YouTube pak budeš moci přepínat mezi svými účty, přičemž jedním z nich bude právě Pyvo. Protože ruční nahrávání je otrava, existuje nástroj `talk-video-uploader <https://github.com/oskar456/talk-video-uploader>`__, který video nahraje za tebe. Při prvním spuštění tě požádá o udělení oprávnění ke konkrétnímu účtu, do kterého následně bude nahrávat všechna videa.
+ 5. Pro nahrávání do `kanálu Pyvo na YouTube <https://www.youtube.com/channel/UCaT4I7hjX9iH1YFvNvuu84A>`__ potřebuješ vlastní Google účet. Následně požádáš `Petra Viktorina <https://encukou.cz/>`__, aby tě přidal jako správce. Na YouTube pak budeš moci přepínat mezi svými účty, přičemž jedním z nich bude právě Pyvo. Protože ruční nahrávání je otrava, existuje nástroj :gh-repo:`talk-video-uploader <oskar456/talk-video-uploader>`, který video nahraje za tebe. Při prvním spuštění tě požádá o udělení oprávnění ke konkrétnímu účtu, do kterého následně bude nahrávat všechna videa.
 
 .. code-block:: shell
 
@@ -428,7 +428,7 @@ Pokud se ti povedlo natočit nějaká videa (viz :ref:`srazy-nataceni`), buď de
 
 ..
 
- 6. Po nahrání všech videí je potřeba doplnit odkazy na ně do databáze `pyvo-data <https://github.com/pyvec/pyvo-data>`__. Příslušný fragment YAML souboru vygeneruje přímo ``talk-video-uploader``. Videa jsou při nahrávání nastavena jako neveřejná. Až YouTube video zpracuje a zkontroluješ, že je všechno v pořádku, nastav ho jako veřejné přímo z webového rozhraní YouTube.
+ 6. Po nahrání všech videí je potřeba doplnit odkazy na ně do databáze :gh-repo:`pyvo-data <pyvec/pyvo-data>`. Příslušný fragment YAML souboru vygeneruje přímo ``talk-video-uploader``. Videa jsou při nahrávání nastavena jako neveřejná. Až YouTube video zpracuje a zkontroluješ, že je všechno v pořádku, nastav ho jako veřejné přímo z webového rozhraní YouTube.
 
 Při sdílení myslete na to, že ne každý může chtít, aby byla jeho přednáška veřejně přístupná (viz :ref:`srazy-prednasejici`). Měli byste mít od přednášejícího svolení s nahráváním a uveřejněním nebo by mělo být alespoň jasné, že si mohou vybrat.
 

docs/guides/promotion.rst

@@ -114,7 +114,7 @@ Komunikační kanály
 Kalendář na PyCon.org
 ~~~~~~~~~~~~~~~~~~~~~
 
-Na `pycon.org <https://pycon.org/>`__ je kalendář, kam je potřeba co nejdříve zadat datum konference. Dělá se to přidáním řádku do CSV souboru v `repozitáři na GitHubu <https://github.com/python-organizers/conferences>`__.
+Na `pycon.org <https://pycon.org/>`__ je kalendář, kam je potřeba co nejdříve zadat datum konference. Dělá se to přidáním řádku do CSV souboru v :gh-repo:`repozitáři na GitHubu <python-organizers/conferences>`.
 
 Kromě toho existuje `Python Events Calendar <https://wiki.python.org/python/conferences/regional/PythonEventsCalendar.html>`__. Aktuálně není jasné, jestli se změny v CSV výše promítnou i do něj. Proto radši navíc `pošli e-mail <https://wiki.python.org/python/conferences/regional/PythonEventsCalendar.html#submitting-an-event>`__ i sem. Pozor, je nutné použít danou šablonu.
 

docs/operations/grants.rst

@@ -1,9 +1,9 @@
 Elektronická hlasování o grantech
 =================================
 
-Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře `pyvec/money <https://github.com/pyvec/money>`_.
+Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře :gh-repo:`pyvec/money`.
 
-Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues. Hlasování se automaticky archivují sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s `pyvec/money <https://github.com/pyvec/money>`_ něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen přepis. Skript započítává pouze hlasy od členů výboru (podle `souboru boards.toml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/boards.toml>`_).
+Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues. Hlasování se automaticky archivují sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s :gh-repo:`pyvec/money` něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen přepis. Skript započítává pouze hlasy od členů výboru (podle `souboru boards.toml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/boards.toml>`_).
 
 Kdyby něco nesedělo, ověřte `historii zdrojáku této stránky <https://github.com/pyvec/docs.pyvec.org/commits/master/docs/operations/grants.rst>`_ a funkčnost :ref:`přepisů <generate_files>`.
 

docs/operations/grants.rst.jinja

@@ -1,9 +1,9 @@
 Elektronická hlasování o grantech
 =================================
 
-Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře `pyvec/money <https://github.com/pyvec/money>`_.
+Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře :gh-repo:`pyvec/money`.
 
-Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues. Hlasování se automaticky archivují sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s `pyvec/money <https://github.com/pyvec/money>`_ něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen přepis. Skript započítává pouze hlasy od členů výboru (podle `souboru boards.toml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/boards.toml>`_).
+Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues. Hlasování se automaticky archivují sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s :gh-repo:`pyvec/money` něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen přepis. Skript započítává pouze hlasy od členů výboru (podle `souboru boards.toml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/boards.toml>`_).
 
 Kdyby něco nesedělo, ověřte `historii zdrojáku této stránky <https://github.com/pyvec/docs.pyvec.org/commits/master/docs/operations/grants.rst>`_ a funkčnost :ref:`přepisů <generate_files>`.
 

docs/operations/runbooks.rst

@@ -150,7 +150,7 @@ Schůze výboru
 
    * Projít agendu sestavenou před schůzí.
    * Projít otevřené žádosti o `granty <github.com/pyvec/money/issues>`, díky čemuž žádosti nečekají nikdy déle než měsíc.
-   * Projít, zda není potřeba **něco schválit** (Pull Requesty na `docs.pyvec.org <https://github.com/pyvec/docs.pyvec.org>`__ nebo jinde…).
+   * Projít, zda není potřeba **něco schválit** (Pull Requesty na :gh-repo:`docs.pyvec.org <pyvec/docs.pyvec.org>` nebo jinde…).
    * Pokud zbývá čas, projít Trello nástěnku: pročesat kartičky ve sloupcech *Ke schválení*, *Doing* a *To Do* a posunout je tak, aby se shodovaly s realitou.
    * Potvrdit si datum a čas příští schůze.