pyvec · honzajavorek · May 9, 2025 · May 9, 2025 · May 9, 2025
diff --git a/.github/workflows/check_links.yml b/.github/workflows/check_links.yml
@@ -14,7 +14,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
       - name: Build documentation
-        run: uv run sphinx-build -nWaE . _build
+        run: uv run sphinx-build -nWaE docs build
       - name: Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2

diff --git a/.github/workflows/generate_grants.yml b/.github/workflows/generate_grants.yml
@@ -13,14 +13,14 @@ jobs:
     - name: Install uv
       uses: astral-sh/setup-uv@v6
     - name: Generate the list of grants
-      run: uv run python _scripts/generate_grants.py > ./operations/grants.rst
+      run: uv run python scripts/generate_grants.py > ./docs/operations/grants.rst
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     - name: Create PR
       uses: peter-evans/create-pull-request@v7
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
-        add-paths: ./operations/grants.rst
+        add-paths: ./docs/operations/grants.rst
         commit-message: "update the list of grants (generated)"
         branch: automation/grants
         title: "Automated update of the list of grants"

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -12,4 +12,4 @@ jobs:
     - name: Test
       run: uv run pytest
     - name: Build documentation
-      run: uv run sphinx-build -nWaE . _build
+      run: uv run sphinx-build -nWaE docs build
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -8,5 +8,5 @@ python:
     - method: pip
       path: .
 sphinx:
-  configuration: conf.py
+  configuration: docs/conf.py
   fail_on_warning: true
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -21,7 +21,7 @@ Když toho upravujete víc, nebo máte zálusk na nějaké složitější kejkle
 Běžná práce
 -----------
 
-#. Ve virtuálním prostředí spusťte projekt: ``uv sphinx-autobuild . _build``
+#. Ve virtuálním prostředí spusťte projekt: ``uv run sphinx-autobuild docs build``
 #. Otevřete si v prohlížeči `<http://127.0.0.1:8000>`_
 #. V editoru upravujete texty a v prohlížeči si kontrolujete výsledek
 #. Projekt zastavíte v terminálu pomocí :kbd:`Ctrl+C`
@@ -95,7 +95,7 @@ Dokonce by to mělo automaticky zakládat i issue, pokud to najde nějaký probl
 Skript na generování zápisů hlasování o grantech
 ------------------------------------------------
 
-V adresáři ``_scripts`` je skript ``generate_grants.py``, který:
+V adresáři ``scripts`` je skript ``generate_grants.py``, který:
 
 * se pomocí `GitHub Actions <https://github.com/pyvec/docs.pyvec.org/actions>`_ jednou denně spustí,
 * vygeneruje soubor ``operations/grants.rst`` z dat na `pyvec/money <https://github.com/pyvec/money>`_ a ze šablony ``operations/grants.rst``,

diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,4 @@
-Copyright (c) 2024 Pyvec, z.s. <info@pyvec.org>
+Copyright (c) 2025 Pyvec, z.s. <info@pyvec.org>
 
 Texty a obrázky materiálů jsou uvolněny pod licencí CC BY-SA 4.0
 https://creativecommons.org/licenses/by-sa/4.0

diff --git a/LICENSE.MIT b/LICENSE.MIT
@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Pyvec, z.s. <info@pyvec.org>
+Copyright (c) 2025 Pyvec, z.s. <info@pyvec.org>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

diff --git a/_static/custom.css → docs/_static/custom.css b/_static/custom.css → docs/_static/custom.css
diff --git a/_static/images/community.svg → docs/_static/images/community.svg b/_static/images/community.svg → docs/_static/images/community.svg
diff --git a/_static/images/money.svg → docs/_static/images/money.svg b/_static/images/money.svg → docs/_static/images/money.svg
diff --git a/_static/images/org-i.svg → docs/_static/images/org-i.svg b/_static/images/org-i.svg → docs/_static/images/org-i.svg
diff --git a/_static/images/org.svg → docs/_static/images/org.svg b/_static/images/org.svg → docs/_static/images/org.svg
diff --git a/_static/images/pylady.svg → docs/_static/images/pylady.svg b/_static/images/pylady.svg → docs/_static/images/pylady.svg
diff --git a/_static/images/snake.svg → docs/_static/images/snake.svg b/_static/images/snake.svg → docs/_static/images/snake.svg
diff --git a/_static/images/ukulele.svg → docs/_static/images/ukulele.svg b/_static/images/ukulele.svg → docs/_static/images/ukulele.svg
diff --git a/_static/redirect.js → docs/_static/redirect.js b/_static/redirect.js → docs/_static/redirect.js
diff --git a/conf.py → docs/conf.py b/conf.py → docs/conf.py
@@ -1,6 +1,15 @@
 # Configuration file for the Sphinx documentation builder
 
 import os
+import tomllib
+
+
+# -- Metadata reading --------------------------------------------------------
+
+with open("../pyproject.toml", "rb") as f:
+    pyproject = tomllib.load(f)
+pyproject_version = pyproject["project"]["version"]
+pyproject_name = pyproject["project"]["name"]
 
 
 # -- Project information -----------------------------------------------------
@@ -10,7 +19,7 @@
 author = "Pyvec, z.s."
 
 # The short X.Y version
-version = ""
+version = pyproject_version
 # The full version, including alpha/beta/rc tags
 release = ""
 
@@ -53,18 +62,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path .
-exclude_patterns = [
-    "_build",
-    "Thumbs.db",
-    ".DS_Store",
-    "venv",
-    ".venv",
-    ".github",
-    ".pytest_cache",
-    ".ruff_cache",
-    "src",
-    "tests",
-]
+exclude_patterns = ["Thumbs.db", ".DS_Store"]
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "monokai"
@@ -89,7 +87,7 @@
 # -- Options for HTMLHelp output ---------------------------------------------
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = "pyvec-doc"
+htmlhelp_basename = pyproject_name
 
 
 # -- Options for LaTeX output ------------------------------------------------
@@ -100,15 +98,15 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, "pyvec.tex", project, author, "manual"),
+    (master_doc, pyproject_name + ".tex", project, author, "manual"),
 ]
 
 
 # -- Options for manual page output ------------------------------------------
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [(master_doc, "pyvec", project, [author], 1)]
+man_pages = [(master_doc, pyproject_name, project, [author], 1)]
 
 
 # -- Options for Texinfo output ----------------------------------------------
@@ -117,7 +115,7 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    (master_doc, "pyvec", project, author, "pyvec", project, "Miscellaneous"),
+    (master_doc, pyproject_name, project, author, pyproject_name, project, "Miscellaneous"),
 ]
 
 

diff --git a/docs/contributing.rst b/docs/contributing.rst
@@ -0,0 +1 @@
+.. include:: ../CONTRIBUTING.rst
diff --git a/guides/beginners-course.rst → docs/guides/beginners-course.rst b/guides/beginners-course.rst → docs/guides/beginners-course.rst
diff --git a/guides/calendar.rst → docs/guides/calendar.rst b/guides/calendar.rst → docs/guides/calendar.rst
diff --git a/guides/django-girls.rst → docs/guides/django-girls.rst b/guides/django-girls.rst → docs/guides/django-girls.rst
diff --git a/guides/high-school-class.rst → docs/guides/high-school-class.rst b/guides/high-school-class.rst → docs/guides/high-school-class.rst
diff --git a/guides/meetup.rst → docs/guides/meetup.rst b/guides/meetup.rst → docs/guides/meetup.rst
diff --git a/guides/promotion.rst → docs/guides/promotion.rst b/guides/promotion.rst → docs/guides/promotion.rst
diff --git a/guides/pyladies-runs.rst → docs/guides/pyladies-runs.rst b/guides/pyladies-runs.rst → docs/guides/pyladies-runs.rst
diff --git a/guides/pyworkings.rst → docs/guides/pyworkings.rst b/guides/pyworkings.rst → docs/guides/pyworkings.rst
diff --git a/guides/slido-moderation.rst → docs/guides/slido-moderation.rst b/guides/slido-moderation.rst → docs/guides/slido-moderation.rst
diff --git a/index.rst → docs/index.rst b/index.rst → docs/index.rst
@@ -1,4 +1,4 @@
-.. include:: README.rst
+.. include:: ../README.rst
 
 .. image:: _static/images/community.svg
     :width: 80%
@@ -27,7 +27,7 @@ Obsah
 .. toctree::
    :hidden:
 
-   CONTRIBUTING
+   contributing
 
 Navigace
 --------

diff --git a/operations/bylaws.rst → docs/operations/bylaws.rst b/operations/bylaws.rst → docs/operations/bylaws.rst
diff --git a/operations/domains.rst → docs/operations/domains.rst b/operations/domains.rst → docs/operations/domains.rst
diff --git a/operations/elections.rst → docs/operations/elections.rst b/operations/elections.rst → docs/operations/elections.rst
diff --git a/operations/glossary.rst → docs/operations/glossary.rst b/operations/glossary.rst → docs/operations/glossary.rst
diff --git a/operations/grants.rst → docs/operations/grants.rst b/operations/grants.rst → docs/operations/grants.rst
@@ -3,7 +3,7 @@ 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>`_. 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>`.
 
-.. Soubor operations/grants.rst je generován skriptem _scripts/generate_grants.py ze šablony operations/grants.rst.jinja. Neupravovat ručně!
+.. Soubor operations/grants.rst je generován skriptem scripts/generate_grants.py ze šablony operations/grants.rst.jinja. Neupravovat ručně!
 
 
 18. 3. 2025 - elektronické hlasování výboru
@@ -339,7 +339,7 @@ Dne 25. 7. 2023 požádal uživatel `@clytaemnestra <https://github.com/clytaemn
     2990
 
     **Na jakou věc to je?**
-    trička na EuroPython pro stankaře 
+    trička na EuroPython pro stankaře
 
     **Proč? (čemu prospějeme, proč je to dobrý nápad, jaký to bude mít dopad?)**
     promoce PyCon CZ a české komunity
@@ -366,7 +366,7 @@ Dne 13. 6. 2023 požádal uživatel `@befeleme <https://github.com/befeleme>`_ o
     Karolina Surma - PyLadies
 
     **Kolik potřebujete? (aspoň odhad nebo rozmezí)**
-    ~6800 Kč 
+    ~6800 Kč
 
     *detailně*
     hlavička: 6.24 Kč / ks = 2496 Kč
@@ -403,7 +403,7 @@ Dne 27. 2. 2023 požádal uživatel `@Zuzanita <https://github.com/Zuzanita>`_ o
 .. code-block:: text
 
     **Kdo jste?**
-    Organizátoři PyLadies - podává Zuzana Pokorná za všechny 
+    Organizátoři PyLadies - podává Zuzana Pokorná za všechny
 
     **Kolik potřebujete? (aspoň odhad nebo rozmezí)**
     25 000 Kč z toho bude část vrácena z příspěvků jednotlivců na trička
@@ -613,15 +613,15 @@ Dne 16. 12. 2020 požádal uživatel `@kvbik <https://github.com/kvbik>`_ o gran
 
     **Kdo jste?**
 
-    Jakub Vysoky, clen Pyvec, spolu organizator prazskeho Pyva 
+    Jakub Vysoky, clen Pyvec, spolu organizator prazskeho Pyva
 
     **Kolik potřebujete? (aspoň odhad nebo rozmezí)**
 
     Do 15tis Kc. (jidlo a piti na 3-4 dny pro 20-30 lidi)
 
     **Na jakou věc to je?**
 
-    Letni edice Python komunitniho Sprintu ve Msenych-laznich v srpen 2020. 
+    Letni edice Python komunitniho Sprintu ve Msenych-laznich v srpen 2020.
 
     **Proč? (čemu prospějeme, proč je to dobrý nápad, jaký to bude mít dopad?)**
 
@@ -651,13 +651,13 @@ Dne 26. 2. 2020 požádal uživatel `@radusaaa <https://github.com/radusaaa>`_ o
     PyLadies Praha
 
     **Kolik potřebujete? (aspoň odhad nebo rozmezí)**
-    500,- Kč za oba běhy 
+    500,- Kč za oba běhy
 
     **Na jakou věc to je?**
 
     - kancelářské potřeby
 
-    - drobné odměny do soutěží 
+    - drobné odměny do soutěží
 
     **Proč? (čemu prospějeme, proč je to dobrý nápad, jaký to bude mít dopad?)**
     Organizujeme dva běhy začátečnických kurzů viz https://pyladies.cz/praha/. Součástí kurzů jsou i dva sobotní celodenní pyworkingy a závěrečný hackathon.

diff --git a/operations/grants.rst.jinja → docs/operations/grants.rst.jinja b/operations/grants.rst.jinja → docs/operations/grants.rst.jinja
@@ -3,7 +3,7 @@ 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>`_. 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>`.
 
-.. Soubor operations/grants.rst je generován skriptem _scripts/generate_grants.py ze šablony operations/grants.rst.jinja. Neupravovat ručně!
+.. Soubor operations/grants.rst je generován skriptem scripts/generate_grants.py ze šablony operations/grants.rst.jinja. Neupravovat ručně!
 
 {% for grant in grants %}
 {{ grant.voted_at.day }}. {{ grant.voted_at.month }}. {{ grant.voted_at.year }} - elektronické hlasování výboru

diff --git a/operations/index.rst → docs/operations/index.rst b/operations/index.rst → docs/operations/index.rst
diff --git a/operations/meeting-notes.rst → docs/operations/meeting-notes.rst b/operations/meeting-notes.rst → docs/operations/meeting-notes.rst
diff --git a/operations/runbooks.rst → docs/operations/runbooks.rst b/operations/runbooks.rst → docs/operations/runbooks.rst
diff --git a/operations/support-money.rst → docs/operations/support-money.rst b/operations/support-money.rst → docs/operations/support-money.rst
diff --git a/operations/support.rst → docs/operations/support.rst b/operations/support.rst → docs/operations/support.rst
diff --git a/operations/twitter.rst → docs/operations/twitter.rst b/operations/twitter.rst → docs/operations/twitter.rst
diff --git a/operations/web-apps.rst → docs/operations/web-apps.rst b/operations/web-apps.rst → docs/operations/web-apps.rst
diff --git a/_scripts/generate_grants.py → scripts/generate_grants.py b/_scripts/generate_grants.py → scripts/generate_grants.py
diff --git a/uv.lock b/uv.lock