Skip to content

Commit a794765

Browse files
honzajavorekhonzajavorek
committed
fix #274 
1 parent 9fe6b52 commit a794765

File tree

6 files changed

+99
-4
lines changed

6 files changed

+99
-4
lines changed

‎CONTRIBUTING.rst‎

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Slack
4343

4444
Při psaní lze psát ``:slack:`#pyladies`` nebo i jenom ``:slack:`pyladies``, což vytvoří odkaz na kanál :slack:`#pyladies` na Pyvec Slacku. Funguje to díky vlastnímu rozšíření Sphinxu, které lze najít v souboru ``_extensions/slack.py``.
4545

46-
Všechny odkazy na kanál ``:slack:`#pyvec-board``, ať už je to ``:slack:`#pyvec-board`` nebo ``:slack:`#pyvec-board-2019-2021`` jsou automaticky předělány na odkaz na aktuální tajný kanál výboru. K určení správných roků se využívá soubor ``board.yml``.
46+
Všechny odkazy na kanál ``:slack:`#pyvec-board``, ať už je to ``:slack:`#pyvec-board`` nebo ``:slack:`#pyvec-board-2019-2021`` jsou automaticky předělány na odkaz na aktuální tajný kanál výboru. K určení správných roků se využívá `soubor board.yml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/board.yml>`_.
4747

4848
.. _docs-pyvec-rtd:
4949

@@ -90,6 +90,19 @@ Na repozitáři je zapojená `GitHub Action <https://github.com/lycheeverse/lych
9090

9191
Dokonce by to mělo automaticky zakládat i issue, pokud to najde nějaký problém. V případě, že je potřeba ignorovat nějakou doménu nebo konkrétní odkaz, je možné to udělat v souboru ``lychee.toml``.
9292

93+
.. _generate_boards:
94+
95+
Skript na generování historie výborů
96+
------------------------------------
97+
98+
V adresáři ``scripts`` je skript ``generate_boards.py``, který:
99+
100+
* se pomocí `GitHub Actions <https://github.com/pyvec/docs.pyvec.org/actions>`_ jednou denně spustí,
101+
* vygeneruje soubor ``operations/boards.rst`` ze `souboru board.yml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/board.yml>`_ a ze šablony ``operations/boards.rst``,
102+
* commitne a pushne jej přes Git do repozitáře.
103+
104+
Výsledná stránka je pouze informační, kanonickým zdrojem pravdy jsou v tomto případě státní registry.
105+
93106
.. _generate_grants:
94107

95108
Skript na generování zápisů hlasování o grantech
@@ -101,4 +114,4 @@ V adresáři ``scripts`` je skript ``generate_grants.py``, který:
101114
* vygeneruje soubor ``operations/grants.rst`` z dat na `pyvec/money <https://github.com/pyvec/money>`_ a ze šablony ``operations/grants.rst``,
102115
* commitne a pushne jej přes Git do repozitáře.
103116

104-
Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues a tento skript hlasování archivuje 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 automatizovaný přepis. Skript započítává pouze hlasy od členů výboru (podle souboru ``src/pyvec_docs/board.yml``).
117+
Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues a tento skript hlasování archivuje 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 automatizovaný přepis. Skript započítává pouze hlasy od členů výboru (podle `souboru board.yml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/board.yml>`_).

‎docs/operations/boards.rst‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
Výbory spolku
2+
=============
3+
4+
Historie složení :term:`výboru <Výbor>`. Kanonickým zdrojem pravdy je `výpis na justice.cz <https://or.justice.cz/ias/ui/rejstrik-firma.vysledky?subjektId=760829&typ=UPLNY>`_. Historii výborů si pro vlastní potřeby zaznamenáváme do `souboru board.yml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/board.yml>`_ a z něj se generuje i tato stránka.
5+
6+
Kdyby něco nesedělo, ověřte `historii zdrojáku této stránky <https://github.com/pyvec/docs.pyvec.org/commits/master/operations/boards.rst>`_ a funkčnost :ref:`přepisů <generate_boards>`.
7+
8+
.. Soubor docs/operations/boards.rst je generován skriptem scripts/generate_boards.py ze šablony docs/operations/boards.rst.jinja. Neupravovat ručně!
9+
10+
11+
Mandát od 9.4.2022
12+
-------------------------------------------------
13+
14+
.. csv-table::
15+
:header: "Jméno", "GitHub", "Funkce"
16+
17+
Barbora Drbohlavová, `@baradrb <https://github.com/baradrb>`_, |:crown:|
18+
Anežka Müller, `@anezkamll <https://github.com/anezkamll>`_,
19+
Jan Javorek, `@honzajavorek <https://github.com/honzajavorek>`_,
20+
Jakub Vysoký, `@kvbik <https://github.com/kvbik>`_,
21+
Jan Čermák, `@sairon <https://github.com/sairon>`_,
22+
23+
Mandát od 8.4.2019
24+
-------------------------------------------------
25+
26+
.. csv-table::
27+
:header: "Jméno", "GitHub", "Funkce"
28+
29+
Martin Bílek, `@martinbilek <https://github.com/martinbilek>`_, |:crown:|
30+
Aleš Zoulek, `@aleszoulek <https://github.com/aleszoulek>`_,
31+
Jan Javorek, `@honzajavorek <https://github.com/honzajavorek>`_,
32+
Jakub Vysoký, `@kvbik <https://github.com/kvbik>`_,
33+
Jiří Bartoň, `@whiskybar <https://github.com/whiskybar>`_,
34+
35+
Mandát od 27.3.2012
36+
-------------------------------------------------
37+
38+
.. csv-table::
39+
:header: "Jméno", "GitHub", "Funkce"
40+
41+
Martin Bílek, `@martinbilek <https://github.com/martinbilek>`_, |:crown:|
42+
Aleš Zoulek, `@aleszoulek <https://github.com/aleszoulek>`_,
43+
Robin Gottfried, `@czervenka <https://github.com/czervenka>`_,
44+
Jan Král, `@honzakral <https://github.com/honzakral>`_,
45+
Jakub Vysoký, `@kvbik <https://github.com/kvbik>`_,
46+
Jiří Bartoň, `@whiskybar <https://github.com/whiskybar>`_,
47+
Vítězslav Pliska, `@whit <https://github.com/whit>`_,
48+

‎docs/operations/boards.rst.jinja‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Výbory spolku
2+
=============
3+
4+
Historie složení :term:`výboru <Výbor>`. Kanonickým zdrojem pravdy je `výpis na justice.cz <https://or.justice.cz/ias/ui/rejstrik-firma.vysledky?subjektId=760829&typ=UPLNY>`_. Historii výborů si pro vlastní potřeby zaznamenáváme do `souboru board.yml <https://github.com/pyvec/docs.pyvec.org/blob/master/src/pyvec_docs/board.yml>`_ a z něj se generuje i tato stránka.
5+
6+
Kdyby něco nesedělo, ověřte `historii zdrojáku této stránky <https://github.com/pyvec/docs.pyvec.org/commits/master/operations/boards.rst>`_ a funkčnost :ref:`přepisů <generate_boards>`.
7+
8+
.. Soubor docs/operations/boards.rst je generován skriptem scripts/generate_boards.py ze šablony docs/operations/boards.rst.jinja. Neupravovat ručně!
9+
10+
{% for board in boards %}
11+
Mandát od {{ board.from.strftime("%-d.%-m.%Y") }}
12+
-------------------------------------------------
13+
14+
.. csv-table::
15+
:header: "Jméno", "GitHub", "Funkce"
16+
{% for github_username, member_name in board.members.items() %}
17+
{{ member_name }}, `@{{ github_username }} <https://github.com/{{ github_username }}>`_, {% if loop.first %}|:crown:|{% endif %}
18+
{%- endfor %}
19+
{% endfor %}

‎docs/operations/grants.rst.jinja‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
Elektronická hlasování o grantech
22
=================================
33

4-
Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře `pyvec/money <https://github.com/pyvec/money>`_. Zde je strojový přepis proběhlých hlasování. Kanonickým zdrojem pravdy je hlasování přímo na GitHub Issues. Kdyby něco nesedělo, ověřte `historii tohoto souboru <https://github.com/pyvec/docs.pyvec.org/commits/master/operations/grants.rst>`_ a funkčnost :ref:`přepisů <generate_grants>`.
4+
Od roku 2020 o grantech :term:`výbor <Výbor>` hlasuje prostřednictvím repozitáře `pyvec/money <https://github.com/pyvec/money>`_. Zde je strojový přepis proběhlých hlasování. Kanonickým zdrojem pravdy je hlasování přímo na GitHub Issues. Kdyby něco nesedělo, ověřte `historii zdrojáku této stránky <https://github.com/pyvec/docs.pyvec.org/commits/master/operations/grants.rst>`_ a funkčnost :ref:`přepisů <generate_grants>`.
55

6-
.. Soubor operations/grants.rst je generován skriptem scripts/generate_grants.py ze šablony operations/grants.rst.jinja. Neupravovat ručně!
6+
.. Soubor docs/operations/grants.rst je generován skriptem scripts/generate_grants.py ze šablony docs/operations/grants.rst.jinja. Neupravovat ručně!
77

88
{% for grant in grants %}
99
{{ grant.voted_at.day }}. {{ grant.voted_at.month }}. {{ grant.voted_at.year }} - elektronické hlasování výboru

‎docs/operations/index.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ kolem `programovacího jazyka Python <https://python.cz>`__. Její cíle jsou fo
1111

1212
support
1313
support-money
14+
boards
1415
runbooks
1516
domains
1617
web-apps

‎scripts/generate_boards.py‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
from pathlib import Path
2+
3+
from jinja2 import Template
4+
5+
from pyvec_docs.board import BOARD_HISTORY
6+
7+
8+
CONTENT_PATH = Path(__file__).parent.parent / "docs"
9+
10+
11+
if __name__ == "__main__":
12+
tpl_path = CONTENT_PATH / "operations" / "boards.rst.jinja"
13+
tpl = Template(tpl_path.read_text())
14+
print(tpl.render(boards=BOARD_HISTORY))

0 commit comments

Comments
 (0)