Add related projects (StanFromIreland)

.github/workflows/update.yml

@@ -21,6 +21,7 @@ jobs:
       - run: sudo apt-get install -y gettext
       - run: pip install -r requirements.txt
       - run: uv run generate.py  # generates index.html and index.json
+      - run: uv run generate_related_projects.py  # generates related.html
       - name: Deploy 🚀
         if: github.event_name != 'pull_request'
         uses: JamesIves/github-pages-deploy-action@v4

.pre-commit-config.yaml

@@ -46,5 +46,11 @@ repos:
       - id: deptry
         args: ["--per-rule-ignores", "DEP002=python-docs-theme", "--package-module-name-map", "gitpython=git,sphinx-lint=sphinxlint"]
 
+  - repo: https://github.com/oxipng/oxipng
+    rev: v9.1.5
+    hooks:
+      - id: oxipng
+        args: [ --strip=safe, --alpha ]
+
 ci:
   autoupdate_schedule: quarterly

generate.py

@@ -7,6 +7,7 @@
 from dataclasses import dataclass, asdict
 from datetime import datetime, timezone
 from pathlib import Path
+from shutil import copyfile
 
 from git import Repo
 from jinja2 import Environment, FileSystemLoader
@@ -104,9 +105,8 @@ class LanguageProjectData:
         generation_time=generation_time,
         duration=(datetime.now(timezone.utc) - generation_time).seconds,
     )
-
-    Path('build/style.css').write_bytes(Path('src/style.css').read_bytes())
-    Path('build/logo.png').write_bytes(Path('src/logo.png').read_bytes())
+    copyfile('src/style.css', 'build/style.css')
+    copyfile('src/logo.png', 'build/logo.png')
     Path('build/index.html').write_text(index)
 
     Path('build/index.json').write_text(

generate_related_projects.py

@@ -0,0 +1,21 @@
+import tomllib
+from pathlib import Path
+from shutil import copyfile, copytree
+
+from jinja2 import Environment, FileSystemLoader
+
+
+if __name__ == '__main__':
+    Path('build').mkdir(parents=True, exist_ok=True)
+
+    with open('related_projects.toml', 'rb') as f:
+        data = tomllib.load(f)
+    projects = data['projects']
+
+    env = Environment(loader=FileSystemLoader('templates'))
+    related = env.get_template('related.html.jinja').render(projects=projects)
+
+    Path('build/related.html').write_text(related)
+    copyfile('src/style.css', 'build/style.css')
+    copyfile('src/logo.png', 'build/logo.png')
+    copytree('src/images', 'build/images', dirs_exist_ok=True)

related_projects.toml

@@ -0,0 +1,35 @@
+[[projects]]
+name = "packaging.python.org"
+description = "Python Packaging User Guide translation"
+logo = "images/pypa_logo.png"
+url = "https://hosted.weblate.org/projects/pypa/packaging-python-org/#information"
+
+[[projects]]
+name = "PyPI (Warehouse)"
+description = "Python Package Index translation"
+logo = "images/pypi_logo.svg"
+url = "https://hosted.weblate.org/projects/pypa/warehouse/#information"
+
+[[projects]]
+name = "Scientific Python"
+description = "Scientific Python ecosystem translations"
+logo = "images/scientific-python_logo.svg"
+url = "https://scientific-python-translations.github.io/status/"
+
+[[projects]]
+name = "micro:bit"
+description = "micro:bit translation programme"
+logo = "images/microbit_logo.svg"
+url = "https://microbit.org/translate/"
+
+[[projects]]
+name = "Django"
+description = "Localizing Django documentation"
+logo = "images/django_logo.svg"
+url = "https://docs.djangoproject.com/en/dev/internals/contributing/localizing/"
+
+[[projects]]
+name = "Sphinx"
+description = "Sphinx documentation generator translation"
+logo = "images/sphinx_logo.png"
+url = "https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#contributing-to-sphinx-reference-translation"