Merge pull request #1 from python-project-templates/tkp/link-actions-profile

Keep Pages site in sync with organization profile

Author: timkpaine

.github/workflows/docs.yml

@@ -4,30 +4,45 @@ on:
   push:
     branches:
       - main
-    tags:
-      - v*
-    paths-ignore:
-      - LICENSE
-      - README.md
+    paths:
+      - .github/workflows/docs.yml
+      - index.md
+      - profile/README.md
+      - pyproject.toml
   workflow_dispatch:
 
+concurrency:
+  group: docs
+  cancel-in-progress: false
+
 permissions:
-    contents: write
+  contents: write
 
 jobs:
   docs:
     runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
         with:
-          python-version: '3.11'
-      - run: pip install yardang
-      - run: yardang build
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v4
+          persist-credentials: false
+
+      - name: Setup Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
         with:
-          publish_branch: gh-pages
+          python-version: "3.11"
+
+      - name: Install Yardang
+        run: pip install yardang
+
+      - name: Build Pages
+        run: yardang build
+
+      - name: Deploy Pages
+        uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453  # v4.1.0
+        with:
+          force_orphan: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_branch: gh-pages
           publish_dir: docs/html
-          force_orphan: true

index.md

@@ -1,50 +1,2 @@
-```{toctree}
----
-caption: ""
-maxdepth: 2
-hidden: true
----
+```{include} profile/README.md
 ```
-
-## Python Project Templates
-
-This organization contains repos with examples of integrating Python with various tooling (CI/CD, linting, testing etc) and bindings/other language integration.
-
-```bash
-pip install copier
-copier copy https://github.com/python-project-templates/base.git path/to/new/project
-```
-
-### Python Templates
-
-[![Base Template](https://img.shields.io/badge/template-base-blue)](https://github.com/python-project-templates/base)
-[![GitHub](https://img.shields.io/badge/repo-github-181717?logo=github&logoColor=white)](https://github.com/python-project-templates)
-[![Copier](https://img.shields.io/badge/copier-docs-f8c200.svg?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDAiIGhlaWdodD0iNzgiIGZpbGw9Im5vbmUiPjxwYXRoIGZpbGw9IiNEREQiIHN0cm9rZT0iI0RERCIgc3Ryb2tlLXdpZHRoPSI2IiBkPSJtNzUuMjQgOC41OTMgMTcuODE4IDEzLjg0NWE5LjIgOS4yIDAgMCAxIDEuNjIyIDEyLjkzOEw2Ny4yMjQgNzAuNzA5YTkuMiA5LjIgMCAwIDEtMTIuOTM4IDEuNjIzTDM2LjQ2OSA1OC40ODZhOS4yIDkuMiAwIDAgMS0xLjYyMy0xMi45MzhsMjcuNDU3LTM1LjMzM0E5LjIgOS4yIDAgMCAxIDc1LjI0IDguNTkzWm0tMTkuODg0LTQuNTIgMjAuNTMgOS4zNjJhOS4yIDkuMiAwIDAgMSA0LjU2NCAxMi4yMTRMNjEuODg1IDY2LjM2M2E5LjIgOS4yIDAgMCAxLTEyLjIxNSA0LjU2NGwtMjAuNTMtOS4zNjJhOS4yIDkuMiAwIDAgMS00LjU2NC0xMi4yMTVMNDMuMTQyIDguNjM3YTkuMiA5LjIgMCAwIDEgMTIuMjE0LTQuNTY0Wm0tMTUuOTMtLjk0MSAyMi4yNSAzLjc2MWE5LjA3NCA5LjA3NCAwIDAgMSA3LjQ1IDEwLjYxbC03Ljk2MyA0NC4wMzNhOS4zMjcgOS4zMjcgMCAwIDEtMTAuNzMxIDcuNTM2bC0yMi4yNDktMy43NjFhOS4wNzQgOS4wNzQgMCAwIDEtNy40NS0xMC42MWw3Ljk2Mi00NC4wMzNhOS4zMjcgOS4zMjcgMCAwIDEgMTAuNzMyLTcuNTM2Wk0yNS4zODYgNS44NjRsMjIuNTQ2LS45YTkuMiA5LjIgMCAwIDEgOS41OCA4Ljg0NWwxLjc4NiA0NC43MTFhOS4yIDkuMiAwIDAgMS04Ljg0NSA5LjU4bC0yMi41NDcuOWE5LjIgOS4yIDAgMCAxLTkuNTgtOC44NDRMMTYuNTQgMTUuNDQ0YTkuMiA5LjIgMCAwIDEgOC44NDUtOS41OFpNOS40MjkgMTEuOTJsMjEuNTAyLTYuODQzYTkuMiA5LjIgMCAwIDEgMTEuNTgyIDUuOTlsMTMuNTcxIDQyLjYzOGE5LjIgOS4yIDAgMCAxLTUuOTkgMTEuNTgzbC0yMS41IDYuODQzYTkuMiA5LjIgMCAwIDEtMTEuNTgzLTUuOTlMMy40NCAyMy41MDRhOS4yIDkuMiAwIDAgMSA1Ljk5LTExLjU4MloiLz48cGF0aCBmaWxsPSIjMTExODI3IiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMi40MjIiIGQ9Im05LjQzIDExLjkyMSAyMS41LTYuODQzYTkuMiA5LjIgMCAwIDEgMTEuNTgzIDUuOTlsMTMuNTcxIDQyLjYzOGE5LjIgOS4yIDAgMCAxLTUuOTkgMTEuNTgzbC0yMS41IDYuODQzYTkuMiA5LjIgMCAwIDEtMTEuNTgzLTUuOTlMMy40NCAyMy41MDRhOS4yIDkuMiAwIDAgMSA1Ljk5LTExLjU4MloiLz48cGF0aCBmaWxsPSIjMzc0MTUxIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMi40MjIiIGQ9Im0yNS4zODUgNS44NjQgMjIuNTQ2LS45YTkuMiA5LjIgMCAwIDEgOS41OCA4Ljg0NWwxLjc4NiA0NC43MTFhOS4yIDkuMiAwIDAgMS04Ljg0NSA5LjU4bC0yMi41NDcuOWE5LjIgOS4yIDAgMCAxLTkuNTgtOC44NDRMMTYuNTQgMTUuNDQ0YTkuMiA5LjIgMCAwIDEgOC44NDUtOS41OFoiLz48cGF0aCBmaWxsPSIjNkI3MjgwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMi40MjIiIGQ9Im0zOS40MjYgMy4xMzIgMjIuMjQ5IDMuNzYxYTkuMDc0IDkuMDc0IDAgMCAxIDcuNDUgMTAuNjFsLTcuOTYyIDQ0LjAzM2E5LjMyNyA5LjMyNyAwIDAgMS0xMC43MzEgNy41MzZsLTIyLjI0OS0zLjc2MWE5LjA3NCA5LjA3NCAwIDAgMS03LjQ1LTEwLjYxbDcuOTYyLTQ0LjAzM2E5LjMyNyA5LjMyNyAwIDAgMSAxMC43MzEtNy41MzZaIi8+PHBhdGggZmlsbD0iI0QxRDVEQiIgc3Ryb2tlPSIjMDAwIiBzdHJva2Utd2lkdGg9IjIuNDIyIiBkPSJtNTUuMzU2IDQuMDczIDIwLjUzIDkuMzYyYTkuMiA5LjIgMCAwIDEgNC41NjQgMTIuMjE0TDYxLjg4NSA2Ni4zNjNhOS4yIDkuMiAwIDAgMS0xMi4yMTUgNC41NjRsLTIwLjUzLTkuMzYyYTkuMiA5LjIgMCAwIDEtNC41NjQtMTIuMjE1TDQzLjE0MiA4LjYzN2E5LjIgOS4yIDAgMCAxIDEyLjIxNC00LjU2NFoiLz48cGF0aCBmaWxsPSIjRjNGNEY2IiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMi40MjIiIGQ9Im03NS4yNCA4LjU5MyAxNy44MTggMTMuODQ1YTkuMiA5LjIgMCAwIDEgMS42MjIgMTIuOTM4TDY3LjIyNCA3MC43MDlhOS4yIDkuMiAwIDAgMS0xMi45MzggMS42MjNMMzYuNDY5IDU4LjQ4NmE5LjIgOS4yIDAgMCAxLTEuNjIzLTEyLjkzOGwyNy40NTctMzUuMzMzQTkuMiA5LjIgMCAwIDEgNzUuMjQgOC41OTNaIi8+PC9zdmc+)](https://copier.readthedocs.io/en/stable/)
-[![License](https://img.shields.io/badge/license-Apache--2.0-brightgreen)](https://github.com/python-project-templates/base)
-
-| Type                                                                                  | Build                                                                                                                                                                                                                                                        | Description                                                       |
-| :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |
-| [Python](https://github.com/python-project-templates/python-template)                 | [![Build Status](https://github.com/python-project-templates/python-template/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template/actions/workflows/build.yaml)                       | Pure Python                                                       |
-| [Python/C++](https://github.com/python-project-templates/python-template-cpp)         | [![Build Status](https://github.com/python-project-templates/python-template-cpp/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-cpp/actions/workflows/build.yaml)               | Python/C++ (binding via `pybind11` and/or standalone C++)         |
-| [Python/Rust](https://github.com/python-project-templates/python-template-rust)       | [![Build Status](https://github.com/python-project-templates/python-template-rust/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-rust/actions/workflows/build.yaml)             | Python with rust binding via `PyO3`                               |
-| [Python/Jupyter](https://github.com/python-project-templates/python-template-jupyter) | [![Build Status](https://github.com/python-project-templates/python-template-jupyter/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-jupyter/actions/workflows/build.yaml)       | Python with Jupyter extension (JS)                                |
-| [Python/JavaScript](https://github.com/python-project-templates/python-template-js)   | [![Build Status](https://github.com/python-project-templates/python-template-js/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-js/actions/workflows/build.yaml)                 | Python with self-contained JS frontend                            |
-| [Python/JS/Rust](https://github.com/python-project-templates/rust-js-wasm-template)   | [![Build Status](https://github.com/python-project-templates/rust-js-wasm-template/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/rust-js-wasm-template)                                         | Rust with Python binding (`PyO3`) and WebAssembly binding (to JS) |
-| [Python/Zig](https://github.com/python-project-templates/python-template-zig)         | [![Build Status](https://github.com/python-project-templates/python-template-zig/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-zig/actions?query=workflow%3A%22Build+Status%22) | Python with zig binding via `ziggy-pydust`                        |
-
-### Other Templates
-
-| Type        | Build | Description |
-| :---------- | :---- | :---------- |
-| Coming soon |       |             |
-
-### Other Tools
-
-| Name                                                                   | Version                                                                                            | Description                                                                                                                               |
-| :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
-| [yardang](https://yardang.python-templates.dev)                        | [![PyPI](https://img.shields.io/pypi/v/yardang.svg)](https://pypi.python.org/pypi/yardang)         | yardang is a Python library for generating Sphinx documentation                                                                           |
-| [hatch-cpp](https://github.com/python-project-templates/hatch-cpp)     | [![PyPI](https://img.shields.io/pypi/v/hatch-cpp.svg)](https://pypi.python.org/pypi/hatch-cpp)     | `hatch-cpp` is a [hatch](https://hatch.pypa.io/latest/) plugin for C++                                                                    |
-| [hatch-js](https://github.com/python-project-templates/hatch-js)       | [![PyPI](https://img.shields.io/pypi/v/hatch-js.svg)](https://pypi.python.org/pypi/hatch-js)       | `hatch-js` is a [hatch](https://hatch.pypa.io/latest/) plugin for JavaScript                                                              |
-| [hatch-multi](https://github.com/python-project-templates/hatch-multi) | [![PyPI](https://img.shields.io/pypi/v/hatch-multi.svg)](https://pypi.python.org/pypi/hatch-multi) | `hatch-multi` is a [hatch](https://hatch.pypa.io/latest/) plugin to create multiple discrete <br/> packages from optional-dependencies (extras) |
-
-Don't see a template you want? Reach out via [discussions](https://github.com/python-project-templates/base/discussions)

profile/README.md

@@ -1,13 +1,15 @@
-## Python Project Templates
+# Python Project Templates
 
 This organization contains repos with examples of integrating Python with various tooling (CI/CD, linting, testing etc) and bindings/other language integration.
 
+Reusable GitHub Actions and Apps supporting these projects are maintained by [Extension Actions](https://actions.python-templates.dev/) ([GitHub](https://github.com/actions-ext)).
+
 ```bash
 pip install copier
 copier copy https://github.com/python-project-templates/base.git path/to/new/project
 ```
 
-### Python Templates
+## Python Templates
 
 [![Base Template](https://img.shields.io/badge/template-base-blue)](https://github.com/python-project-templates/base)
 [![GitHub](https://img.shields.io/badge/repo-github-181717?logo=github&logoColor=white)](https://github.com/python-project-templates)
@@ -24,25 +26,25 @@ copier copy https://github.com/python-project-templates/base.git path/to/new/pro
 | [Python/JS/Rust](https://github.com/python-project-templates/python-template-rustjswasm) | [![Build Status](https://github.com/python-project-templates/python-template-rustjswasm/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-rustjswasm)                              | Rust with Python binding (`PyO3`) and WebAssembly binding (to JS) |
 | [Python/JS/C++](https://github.com/python-project-templates/python-template-cppjswasm) | [![Build Status](https://github.com/python-project-templates/python-template-cppjswasm/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-cppjswasm)                               | C++ with Python binding (`pybind11`) and WebAssembly binding (to JS) |
 
-### Other Templates
+## Other Templates
 
 | Type        | Build | Description |
 | :---------- | :---- | :---------- |
 | [Python/Go](https://github.com/python-project-templates/python-template-go)            | [![Build Status](https://github.com/python-project-templates/python-template-go/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-go/actions?query=workflow%3A%22Build+Status%22) | Python with Go binding via C API                        |
 | [Python/Zig](https://github.com/python-project-templates/python-template-zig)            | [![Build Status](https://github.com/python-project-templates/python-template-zig/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template-zig/actions?query=workflow%3A%22Build+Status%22) | Python with Zig binding via `ziggy-pydust`                        |
 | Coming soon |       |             |
 
-### Other Tools
+## Other Tools
 
 | Name                                                                   | Version                                                                                            | Description                                                                                                                                     |
 | :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |
 | [yardang](https://yardang.python-templates.dev)                        | [![PyPI](https://img.shields.io/pypi/v/yardang.svg)](https://pypi.python.org/pypi/yardang)         | yardang is a Python library for generating Sphinx documentation                                                                                 |
-| [check-dist](https://github.com/python-project-templates/check-dist)   | [![PyPI](https://img.shields.io/pypi/v/yardang.svg)](https://pypi.python.org/pypi/check-dist)      | check-dist is a Python library for sanity-checking source and wheel distribution included files                                                 |
+| [check-dist](https://github.com/python-project-templates/check-dist)   | [![PyPI](https://img.shields.io/pypi/v/check-dist.svg)](https://pypi.python.org/pypi/check-dist)   | check-dist is a Python library for sanity-checking source and wheel distribution included files                                                 |
 | [hatch-build](https://github.com/python-project-templates/hatch-build) | [![PyPI](https://img.shields.io/pypi/v/hatch-build.svg)](https://pypi.python.org/pypi/hatch-build) | A minimal CLI wrapper around [hatchling build](https://hatch.pypa.io/latest/)                                                                   |
 | [hatch-cpp](https://github.com/python-project-templates/hatch-cpp)     | [![PyPI](https://img.shields.io/pypi/v/hatch-cpp.svg)](https://pypi.python.org/pypi/hatch-cpp)     | `hatch-cpp` is a [hatch](https://hatch.pypa.io/latest/) plugin for C++                                                                          |
 | [hatch-js](https://github.com/python-project-templates/hatch-js)       | [![PyPI](https://img.shields.io/pypi/v/hatch-js.svg)](https://pypi.python.org/pypi/hatch-js)       | `hatch-js` is a [hatch](https://hatch.pypa.io/latest/) plugin for JavaScript                                                                    |
 | [hatch-rs](https://github.com/python-project-templates/hatch-rs)       | [![PyPI](https://img.shields.io/pypi/v/hatch-rs.svg)](https://pypi.python.org/pypi/hatch-rs)       | `hatch-rs` is a [hatch](https://hatch.pypa.io/latest/) plugin for Rust                                                                          |
-| [hatch-go](https://github.com/python-project-templates/hatch-go)       | [![PyPI](https://img.shields.io/pypi/v/hatch-zig.svg)](https://pypi.python.org/pypi/hatch-go)      | `hatch-go` is a [hatch](https://hatch.pypa.io/latest/) plugin for Go                                                                            |
+| [hatch-go](https://github.com/python-project-templates/hatch-go)       | [![PyPI](https://img.shields.io/pypi/v/hatch-go.svg)](https://pypi.python.org/pypi/hatch-go)       | `hatch-go` is a [hatch](https://hatch.pypa.io/latest/) plugin for Go                                                                            |
 | [hatch-zig](https://github.com/python-project-templates/hatch-zig)     | [![PyPI](https://img.shields.io/pypi/v/hatch-zig.svg)](https://pypi.python.org/pypi/hatch-zig)     | `hatch-zig` is a [hatch](https://hatch.pypa.io/latest/) plugin for Zig                                                                          |
 | [hatch-multi](https://github.com/python-project-templates/hatch-multi) | [![PyPI](https://img.shields.io/pypi/v/hatch-multi.svg)](https://pypi.python.org/pypi/hatch-multi) | `hatch-multi` is a [hatch](https://hatch.pypa.io/latest/) plugin to create multiple discrete <br/> packages from optional-dependencies (extras) |
 

pyproject.toml

@@ -23,7 +23,8 @@ develop = []
 
 [tool.yardang]
 title = "Python Project Templates"
-root = "profile/README.md"
+root = "index.md"
 cname = "python-templates.dev"
+exclude-patterns = ["profile/README.md"]
 pages = []
 use-autoapi = false