render-engine 2025.9.1a1__tar.gz → 2025.10.1a1__tar.gz

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.all-contributorsrc

@@ -175,6 +175,26 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "kjaymiller",
+      "name": "Jay Miller",
+      "avatar_url": "https://avatars.githubusercontent.com/u/8632637?v=4",
+      "profile": "https://github.com/kjaymiller",
+      "contributions": [
+        "code",
+        "doc",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "bdougie",
+      "name": "Brian Douglas",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5713670?v=4",
+      "profile": "https://b.dougie.dev/",
+      "contributions": [
+        "financial"
+      ]
     }
   ],
   "contributorsPerLine": 7,

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/devcontainer-ci.yml

@@ -19,7 +19,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Use Node.js 20.x
         uses: actions/setup-node@v4
         with:

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/labeler.yml

@@ -12,5 +12,5 @@ jobs:
   labeler:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - uses: actions/labeler@v5

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/lint.yml

@@ -13,7 +13,7 @@ jobs:
     name: Format and Lint Python
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Install Python
@@ -34,7 +34,7 @@ jobs:
     name: Lint Markdown
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Markdown Lint base-files
         uses: DavidAnson/markdownlint-cli2-action@v20
         with:

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/publish.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout source
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Set up Python 3.11
         uses: actions/setup-python@v5

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/scorecard.yml

@@ -32,7 +32,7 @@ jobs:
 
     steps:
       - name: "Checkout code"
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.1.1
         with:
           persist-credentials: false
 

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/.github/workflows/test.yml

@@ -23,7 +23,7 @@ jobs:
         python-version: ["3.10", "3.11", "3.12", "3.13"]
       fail-fast: true
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
@@ -44,7 +44,7 @@ jobs:
       fail-fast: true
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: render_engine
-Version: 2025.9.1a1
+Version: 2025.10.1a1
 Summary: A Flexible Static Site Generator for Python
 Project-URL: homepage, https://github.com/render-engine/render-engine/
 Project-URL: repository, https://github.com/render-engine/render-engine/
@@ -40,7 +40,7 @@ Requires-Dist: watchfiles; extra == "dev"
 
 <!-- markdownlint-disable -->
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-18-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-20-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 <!-- markdownlint-restore -->
 
@@ -100,22 +100,24 @@ We've compiled a set of [awesome add-ons](https://github.com/render-engine/rende
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Tashuuuu"><img src="https://avatars.githubusercontent.com/u/85075827?v=4?s=57" width="57px;" alt="Akriti Sengar"/><br /><sub><b>Akriti Sengar</b></sub></a><br /><a href="#tool-Tashuuuu" title="Tools">🔧</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://tonybaloney.github.io/"><img src="https://avatars.githubusercontent.com/u/1532417?v=4?s=57" width="57px;" alt="Anthony Shaw"/><br /><sub><b>Anthony Shaw</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=tonybaloney" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://b.dougie.dev/"><img src="https://avatars.githubusercontent.com/u/5713670?v=4?s=57" width="57px;" alt="Brian Douglas"/><br /><sub><b>Brian Douglas</b></sub></a><br /><a href="#financial-bdougie" title="Financial">💵</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://brassnet.biz"><img src="https://avatars.githubusercontent.com/u/1806946?v=4?s=57" width="57px;" alt="Dan Shernicoff"/><br /><sub><b>Dan Shernicoff</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=brass75" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/mannyanebi"><img src="https://avatars.githubusercontent.com/u/25439000?v=4?s=57" width="57px;" alt="Emmanuel Anebi"/><br /><sub><b>Emmanuel Anebi</b></sub></a><br /><a href="#plugin-mannyanebi" title="Plugin/utility libraries">🔌</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://giovannimartins.dev"><img src="https://avatars.githubusercontent.com/u/7796661?v=4?s=57" width="57px;" alt="Giovanni Martins"/><br /><sub><b>Giovanni Martins</b></sub></a><br /><a href="#infra-giovannism20" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://webology.dev"><img src="https://avatars.githubusercontent.com/u/50527?v=4?s=57" width="57px;" alt="Jeff Triplett"/><br /><sub><b>Jeff Triplett</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jefftriplett" title="Documentation">📖</a> <a href="#mentoring-jefftriplett" title="Mentoring">🧑‍🏫</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://linktr.ee/john0isaac"><img src="https://avatars.githubusercontent.com/u/64026625?v=4?s=57" width="57px;" alt="John Aziz"/><br /><sub><b>John Aziz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=john0isaac" title="Documentation">📖</a> <a href="#maintenance-john0isaac" title="Maintenance">🚧</a> <a href="#userTesting-john0isaac" title="User Testing">📓</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kjaymiller"><img src="https://avatars.githubusercontent.com/u/8632637?v=4?s=57" width="57px;" alt="Jay Miller"/><br /><sub><b>Jay Miller</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=kjaymiller" title="Code">💻</a> <a href="https://github.com/render-engine/render-engine/commits?author=kjaymiller" title="Documentation">📖</a> <a href="#maintenance-kjaymiller" title="Maintenance">🚧</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://webology.dev"><img src="https://avatars.githubusercontent.com/u/50527?v=4?s=57" width="57px;" alt="Jeff Triplett"/><br /><sub><b>Jeff Triplett</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jefftriplett" title="Documentation">📖</a> <a href="#mentoring-jefftriplett" title="Mentoring">🧑‍🏫</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://linktr.ee/john0isaac"><img src="https://avatars.githubusercontent.com/u/64026625?v=4?s=57" width="57px;" alt="John Aziz"/><br /><sub><b>John Aziz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=john0isaac" title="Documentation">📖</a> <a href="#maintenance-john0isaac" title="Maintenance">🚧</a> <a href="#userTesting-john0isaac" title="User Testing">📓</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.jonafato.com"><img src="https://avatars.githubusercontent.com/u/392720?v=4?s=57" width="57px;" alt="Jon Banafato"/><br /><sub><b>Jon Banafato</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jonafato" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/jlgimeno"><img src="https://avatars.githubusercontent.com/u/17421585?v=4?s=57" width="57px;" alt="Jorge L. Gimeno"/><br /><sub><b>Jorge L. Gimeno</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jlgimeno" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://lauralangdon.io"><img src="https://avatars.githubusercontent.com/u/48335772?v=4?s=57" width="57px;" alt="Laura Langdon"/><br /><sub><b>Laura Langdon</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=LauraLangdon" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Mahhheshh"><img src="https://avatars.githubusercontent.com/u/100200105?v=4?s=57" width="57px;" alt="Mahhheshh"/><br /><sub><b>Mahhheshh</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=Mahhheshh" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=Mahhheshh" title="Code">💻</a> <a href="#maintenance-Mahhheshh" title="Maintenance">🚧</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.pythonbynight.com"><img src="https://avatars.githubusercontent.com/u/46942991?v=4?s=57" width="57px;" alt="Mario Munoz"/><br /><sub><b>Mario Munoz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=tataraba" title="Code">💻</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MohitKambli"><img src="https://avatars.githubusercontent.com/u/31406633?v=4?s=57" width="57px;" alt="Mohit Kambli"/><br /><sub><b>Mohit Kambli</b></sub></a><br /><a href="#infra-MohitKambli" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/OsamaRab3"><img src="https://avatars.githubusercontent.com/u/159753803?v=4?s=57" width="57px;" alt="Osama Rabea "/><br /><sub><b>Osama Rabea </b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Tests">⚠️</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MohitKambli"><img src="https://avatars.githubusercontent.com/u/31406633?v=4?s=57" width="57px;" alt="Mohit Kambli"/><br /><sub><b>Mohit Kambli</b></sub></a><br /><a href="#infra-MohitKambli" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/OsamaRab3"><img src="https://avatars.githubusercontent.com/u/159753803?v=4?s=57" width="57px;" alt="Osama Rabea "/><br /><sub><b>Osama Rabea </b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.pamelafox.org"><img src="https://avatars.githubusercontent.com/u/297042?v=4?s=57" width="57px;" alt="Pamela Fox"/><br /><sub><b>Pamela Fox</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=pamelafox" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/viktoriussuwandi"><img src="https://avatars.githubusercontent.com/u/68414300?v=4?s=57" width="57px;" alt="Viktorius Suwandi"/><br /><sub><b>Viktorius Suwandi</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=viktoriussuwandi" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/VinayakG311"><img src="https://avatars.githubusercontent.com/u/96966973?v=4?s=57" width="57px;" alt="VinayakG311"/><br /><sub><b>VinayakG311</b></sub></a><br /><a href="#plugin-VinayakG311" title="Plugin/utility libraries">🔌</a></td>

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/README.md

@@ -1,6 +1,6 @@
 <!-- markdownlint-disable -->
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-18-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-20-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 <!-- markdownlint-restore -->
 
@@ -60,22 +60,24 @@ We've compiled a set of [awesome add-ons](https://github.com/render-engine/rende
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Tashuuuu"><img src="https://avatars.githubusercontent.com/u/85075827?v=4?s=57" width="57px;" alt="Akriti Sengar"/><br /><sub><b>Akriti Sengar</b></sub></a><br /><a href="#tool-Tashuuuu" title="Tools">🔧</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://tonybaloney.github.io/"><img src="https://avatars.githubusercontent.com/u/1532417?v=4?s=57" width="57px;" alt="Anthony Shaw"/><br /><sub><b>Anthony Shaw</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=tonybaloney" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://b.dougie.dev/"><img src="https://avatars.githubusercontent.com/u/5713670?v=4?s=57" width="57px;" alt="Brian Douglas"/><br /><sub><b>Brian Douglas</b></sub></a><br /><a href="#financial-bdougie" title="Financial">💵</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://brassnet.biz"><img src="https://avatars.githubusercontent.com/u/1806946?v=4?s=57" width="57px;" alt="Dan Shernicoff"/><br /><sub><b>Dan Shernicoff</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=brass75" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/mannyanebi"><img src="https://avatars.githubusercontent.com/u/25439000?v=4?s=57" width="57px;" alt="Emmanuel Anebi"/><br /><sub><b>Emmanuel Anebi</b></sub></a><br /><a href="#plugin-mannyanebi" title="Plugin/utility libraries">🔌</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://giovannimartins.dev"><img src="https://avatars.githubusercontent.com/u/7796661?v=4?s=57" width="57px;" alt="Giovanni Martins"/><br /><sub><b>Giovanni Martins</b></sub></a><br /><a href="#infra-giovannism20" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://webology.dev"><img src="https://avatars.githubusercontent.com/u/50527?v=4?s=57" width="57px;" alt="Jeff Triplett"/><br /><sub><b>Jeff Triplett</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jefftriplett" title="Documentation">📖</a> <a href="#mentoring-jefftriplett" title="Mentoring">🧑‍🏫</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://linktr.ee/john0isaac"><img src="https://avatars.githubusercontent.com/u/64026625?v=4?s=57" width="57px;" alt="John Aziz"/><br /><sub><b>John Aziz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=john0isaac" title="Documentation">📖</a> <a href="#maintenance-john0isaac" title="Maintenance">🚧</a> <a href="#userTesting-john0isaac" title="User Testing">📓</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kjaymiller"><img src="https://avatars.githubusercontent.com/u/8632637?v=4?s=57" width="57px;" alt="Jay Miller"/><br /><sub><b>Jay Miller</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=kjaymiller" title="Code">💻</a> <a href="https://github.com/render-engine/render-engine/commits?author=kjaymiller" title="Documentation">📖</a> <a href="#maintenance-kjaymiller" title="Maintenance">🚧</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://webology.dev"><img src="https://avatars.githubusercontent.com/u/50527?v=4?s=57" width="57px;" alt="Jeff Triplett"/><br /><sub><b>Jeff Triplett</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jefftriplett" title="Documentation">📖</a> <a href="#mentoring-jefftriplett" title="Mentoring">🧑‍🏫</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://linktr.ee/john0isaac"><img src="https://avatars.githubusercontent.com/u/64026625?v=4?s=57" width="57px;" alt="John Aziz"/><br /><sub><b>John Aziz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=john0isaac" title="Documentation">📖</a> <a href="#maintenance-john0isaac" title="Maintenance">🚧</a> <a href="#userTesting-john0isaac" title="User Testing">📓</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.jonafato.com"><img src="https://avatars.githubusercontent.com/u/392720?v=4?s=57" width="57px;" alt="Jon Banafato"/><br /><sub><b>Jon Banafato</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jonafato" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/jlgimeno"><img src="https://avatars.githubusercontent.com/u/17421585?v=4?s=57" width="57px;" alt="Jorge L. Gimeno"/><br /><sub><b>Jorge L. Gimeno</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=jlgimeno" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://lauralangdon.io"><img src="https://avatars.githubusercontent.com/u/48335772?v=4?s=57" width="57px;" alt="Laura Langdon"/><br /><sub><b>Laura Langdon</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=LauraLangdon" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Mahhheshh"><img src="https://avatars.githubusercontent.com/u/100200105?v=4?s=57" width="57px;" alt="Mahhheshh"/><br /><sub><b>Mahhheshh</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=Mahhheshh" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=Mahhheshh" title="Code">💻</a> <a href="#maintenance-Mahhheshh" title="Maintenance">🚧</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.pythonbynight.com"><img src="https://avatars.githubusercontent.com/u/46942991?v=4?s=57" width="57px;" alt="Mario Munoz"/><br /><sub><b>Mario Munoz</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=tataraba" title="Code">💻</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MohitKambli"><img src="https://avatars.githubusercontent.com/u/31406633?v=4?s=57" width="57px;" alt="Mohit Kambli"/><br /><sub><b>Mohit Kambli</b></sub></a><br /><a href="#infra-MohitKambli" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/OsamaRab3"><img src="https://avatars.githubusercontent.com/u/159753803?v=4?s=57" width="57px;" alt="Osama Rabea "/><br /><sub><b>Osama Rabea </b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Tests">⚠️</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MohitKambli"><img src="https://avatars.githubusercontent.com/u/31406633?v=4?s=57" width="57px;" alt="Mohit Kambli"/><br /><sub><b>Mohit Kambli</b></sub></a><br /><a href="#infra-MohitKambli" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/OsamaRab3"><img src="https://avatars.githubusercontent.com/u/159753803?v=4?s=57" width="57px;" alt="Osama Rabea "/><br /><sub><b>Osama Rabea </b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Documentation">📖</a> <a href="https://github.com/render-engine/render-engine/commits?author=OsamaRab3" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.pamelafox.org"><img src="https://avatars.githubusercontent.com/u/297042?v=4?s=57" width="57px;" alt="Pamela Fox"/><br /><sub><b>Pamela Fox</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=pamelafox" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/viktoriussuwandi"><img src="https://avatars.githubusercontent.com/u/68414300?v=4?s=57" width="57px;" alt="Viktorius Suwandi"/><br /><sub><b>Viktorius Suwandi</b></sub></a><br /><a href="https://github.com/render-engine/render-engine/commits?author=viktoriussuwandi" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/VinayakG311"><img src="https://avatars.githubusercontent.com/u/96966973?v=4?s=57" width="57px;" alt="VinayakG311"/><br /><sub><b>VinayakG311</b></sub></a><br /><a href="#plugin-VinayakG311" title="Plugin/utility libraries">🔌</a></td>

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/docs/docs/cli.md

@@ -29,7 +29,7 @@ collection = "blog"  # optional
 ### Example Configuration
 
 ```toml
-[render-engine.cli]
+[tool.render-engine.cli]
 module = "my_site"
 site = "MySite"
 collection = "posts"

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/docs/docs/collection.md

@@ -46,6 +46,7 @@ sort_reverse: bool = False
 title: str
 template: str | None
 archive_template str | None: The template to use for the archive pages.
+skip_site_map: bool = False: Flag to indicate whether this Collection should not be included in the SiteMap.
 ```
 
 ## Attributes

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/docs/docs/page.md

@@ -24,12 +24,13 @@ This is not intended to be used directly.
 
 **Attributes:**
 
-| Name | Type | Description |
-| --- | --- | --- |
-| `slug` |  |The slug of the page. Defaults to the `title` slugified. |
-| `content` |  |The content to be rendered by the page |
-| `parser` |  |The Parser used to parse the page's content. Defaults to `BasePageParser`. |
-| `reference` |  |The attribute to use as the reference for the page in the site's route list. Defaults to `slug`. |
+| Name               | Type | Description |
+|--------------------| --- | --- |
+| `slug`             |  |The slug of the page. Defaults to the `title` slugified. |
+| `content`          |  |The content to be rendered by the page |
+| `parser`           |  |The Parser used to parse the page's content. Defaults to `BasePageParser`. |
+| `reference`        |  |The attribute to use as the reference for the page in the site's route list. Defaults to `slug`. |
+| `skip_site_map`    | `False` | When set to `True` the `Page` will not be included in the generated `SiteMap` |
 
 ### Functions
 
@@ -72,6 +73,7 @@ When you create a page, you specify variables passed into rendering template.
 | `template` | `str | None` |The template used to render the page. If not provided, the `Site`'s `content`will be used. |
 | `Parser` | `type[BasePageParser]` |The parser to generate the page's `raw_content`. Defaults to `BasePageParser`. |
 | `title` | `str` |The title of the page. Defaults to the class name. |
+| `skip_site_map`    | `False` | When set to `True` the `Page` will not be included in the generated `SiteMap` |
 
 ## About Page Attributes
 
@@ -103,3 +105,19 @@ By default Page._content will return the result of `Page.Parser.parse(Page.conte
 ### Page Templates
 
 `Page.template` should always be a `str`. `Page.template` refers to the template name that will be passed to the engine given to `Page.render()`.
+
+### Accessing URLs for other pages in the site from within the page content
+
+In order to allow lookup of URLs for other pages within a Site the `content` of a page may be
+a template. If the `content` matches the pattern `{{.*?}}` we will render the `content` as a
+template prior to rendering the page itself.
+
+Example:
+
+```html
+{{ site_map.find('my_page').url_for }}
+```
+
+will render to the URL for `my_page` in the `content` and then in the generated page.
+
+For more details on using the `SiteMap` please check the [SiteMap documentation](site_map.md).

render_engine-2025.10.1a1/docs/docs/site_map.md

@@ -0,0 +1,76 @@
+---
+title: "SiteMap Objects"
+description: "Overview of the SiteMap"
+date: September 27, 2025
+tags: ["site-map"]
+---
+Prior to rendering the `Site` Render Engine will create a `SiteMap` containing searchable information
+about all of the `Collection` and `Page` objects it has.
+
+## Searching the `SiteMap`
+
+To search the `SiteMap` use the `find` method.
+
+```python
+    def find(
+        self,
+        value: str,
+        attr: str = "slug",
+        collection: str = None,
+        full_search: bool = False,
+    ) -> SiteMapEntry | None:
+```
+
+### Parameters
+
+- `value`: The value to search for
+- `attr`: Optional attribute to search by. Options are `slug`, `title`, `path_name`. Defaults to `slug`.
+- `collection`: Limit the search to a single `Collection`. Defaults to `None`.
+- `full_search`: Search all `Page` and `Collection` objects. Defaults to `False`.
+
+Notes:
+
+1. If `collection` is set the search will be limited to that `Collection` object regardless of whether
+`full_search` is set.
+2. If `full_search` is set it will return the first match found. If you have 3 pages with the same `slug`,
+1 not in a `Collection` and 2 others in different `Collection` objects, the first one defined will be the
+one found.
+
+## Generating an HTML site map
+
+The `SiteMap` object has an `html` property that will return an HTML sitemap with _absolute_ URLs with the
+`Site`'s `SITE_URL`.
+
+As a convenience, Render Engine will generate a site map page if the `Site` property of `render_html_site_map`
+is `True` (it defaults to `False`.) Please note that this will not be templated. Should you wish the generated
+site map to be on a template you can add the following to your app:
+
+```python
+@app.page
+class SiteMapPage(Page):
+    template = "site_map_template.html"
+    content = "{{ site_map.html }}"
+    skip_site_map = True
+```
+
+Please note the `skip_site_map = True` to avoid having a self-referential link to the site map.
+
+## Generating an XML site map
+
+To have your site generate an XML site map set the `render_xml_site_map` property of your `Site` object
+to `True` (defaults to `False`.) This will create the `site_map.xml` file in the root output directory
+of your site.
+
+## The `SiteMapEntry` object
+
+The `SiteMap` is a collection of `SiteMapEntry` objects. Each `SiteMapEntry` has the following attributes
+and properties:
+
+### Attributes and Properties
+
+- `slug` - The `slug` for the referenced `Page` or `Collection`.
+- `title` - The `title` for the referenced `Page` or `Collection`.
+- `path_name` - The `path_name` for the referenced `Page` or `Collection`.
+- `entries` - A list of `SiteMapEntry` objects representing the `Page` objects in a given `Collection`.
+for a `Page` this will be an empty `list`.
+- `url_for` - This property will provide the _relative_ URL for the given entry.

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/requirements.txt

@@ -4,7 +4,7 @@
 #
 #    pip-compile --extra=dev --output-file=requirements.txt pyproject.toml
 #
-anyio==4.9.0
+anyio==4.10.0
     # via
     #   httpx
     #   watchfiles
@@ -12,11 +12,11 @@ arrow==1.3.0
     # via cookiecutter
 babel==2.17.0
     # via mkdocs-material
-backrefs==5.8
+backrefs==6.0.1
     # via mkdocs-material
 binaryornot==0.4.4
     # via cookiecutter
-certifi==2025.4.26
+certifi==2025.8.3
     # via
     #   httpcore
     #   httpx
@@ -25,7 +25,7 @@ cfgv==3.4.0
     # via pre-commit
 chardet==5.2.0
     # via binaryornot
-charset-normalizer==3.4.2
+charset-normalizer==3.4.3
     # via requests
 click==8.2.1
     # via
@@ -38,21 +38,21 @@ colorama==0.4.6
     #   mkdocs-material
 cookiecutter==2.6.0
     # via render_engine (pyproject.toml)
-coverage[toml]==7.8.2
+coverage[toml]==7.10.6
     # via pytest-cov
-distlib==0.3.9
+distlib==0.4.0
     # via virtualenv
 ephemeral-port-reserve==1.1.4
     # via render_engine (pyproject.toml)
-filelock==3.18.0
+filelock==3.19.1
     # via virtualenv
 ghp-import==2.1.0
     # via mkdocs
 gitdb==4.0.12
     # via gitpython
-gitpython==3.1.44
+gitpython==3.1.45
     # via render_engine (pyproject.toml)
-griffe==1.7.3
+griffe==1.13.0
     # via mkdocstrings-python
 h11==0.16.0
     # via httpcore
@@ -60,7 +60,7 @@ httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via render_engine (pyproject.toml)
-identify==2.6.12
+identify==2.6.13
     # via pre-commit
 idna==3.10
     # via
@@ -76,16 +76,16 @@ jinja2==3.1.6
     #   mkdocs-material
     #   mkdocstrings
     #   render_engine (pyproject.toml)
-markdown==3.8
+markdown==3.8.2
     # via
     #   mkdocs
     #   mkdocs-autorefs
     #   mkdocs-material
     #   mkdocstrings
     #   pymdown-extensions
-markdown-it-py==3.0.0
+markdown-it-py==4.0.0
     # via rich
-markdown2==2.5.3
+markdown2==2.5.4
     # via
     #   render-engine-markdown
     #   render_engine (pyproject.toml)
@@ -107,25 +107,25 @@ mkdocs==1.6.1
     #   mkdocs-material
     #   mkdocstrings
     #   render_engine (pyproject.toml)
-mkdocs-autorefs==1.4.2
+mkdocs-autorefs==1.4.3
     # via
     #   mkdocstrings
     #   mkdocstrings-python
 mkdocs-get-deps==0.2.0
     # via mkdocs
-mkdocs-material==9.6.14
+mkdocs-material==9.6.18
     # via render_engine (pyproject.toml)
 mkdocs-material-extensions==1.3.1
     # via mkdocs-material
-mkdocstrings[python]==0.29.1
+mkdocstrings[python]==0.30.0
     # via
     #   mkdocstrings-python
     #   render_engine (pyproject.toml)
-mkdocstrings-python==1.16.11
+mkdocstrings-python==1.18.2
     # via mkdocstrings
-more-itertools==10.7.0
+more-itertools==10.8.0
     # via render_engine (pyproject.toml)
-mypy==1.16.0
+mypy==1.17.1
     # via render_engine (pyproject.toml)
 mypy-extensions==1.1.0
     # via mypy
@@ -139,7 +139,7 @@ paginate==0.5.7
     # via mkdocs-material
 pathspec==0.12.1
     # via mkdocs
-platformdirs==4.3.8
+platformdirs==4.4.0
     # via
     #   mkdocs-get-deps
     #   virtualenv
@@ -147,23 +147,23 @@ pluggy==1.6.0
     # via
     #   pytest
     #   render_engine (pyproject.toml)
-pre-commit==4.2.0
+pre-commit==4.3.0
     # via render_engine (pyproject.toml)
-pygments==2.19.1
+pygments==2.19.2
     # via
     #   mkdocs-material
     #   rich
-pymdown-extensions==10.15
+pymdown-extensions==10.16.1
     # via
     #   mkdocs-material
     #   mkdocstrings
     #   render_engine (pyproject.toml)
-pytest==8.3.5
+pytest==8.4.2
     # via
     #   pytest-cov
     #   pytest-mock
     #   render_engine (pyproject.toml)
-pytest-cov==6.1.1
+pytest-cov==6.2.1
     # via render_engine (pyproject.toml)
 pytest-mock==3.14.1
     # via render_engine (pyproject.toml)
@@ -197,16 +197,16 @@ render-engine-parser==2024.9.0
     # via
     #   render-engine-markdown
     #   render_engine (pyproject.toml)
-requests==2.32.4
+requests==2.32.5
     # via
     #   cookiecutter
     #   mkdocs-material
-rich==14.0.0
+rich==14.1.0
     # via
     #   cookiecutter
     #   render_engine (pyproject.toml)
     #   typer
-ruff==0.11.12
+ruff==0.12.11
     # via render_engine (pyproject.toml)
 shellingham==1.5.4
     # via typer
@@ -219,11 +219,11 @@ sniffio==1.3.1
 text-unidecode==1.3
     # via python-slugify
 toml==0.10.2
-typer==0.16.0
+typer==0.17.3
     # via render_engine (pyproject.toml)
-types-python-dateutil==2.9.0.20250516
+types-python-dateutil==2.9.0.20250822
     # via arrow
-typing-extensions==4.13.2
+typing-extensions==4.15.0
     # via
     #   anyio
     #   mypy
@@ -232,9 +232,9 @@ tzdata==2025.2
     # via render_engine (pyproject.toml)
 urllib3==2.5.0
     # via requests
-virtualenv==20.31.2
+virtualenv==20.34.0
     # via pre-commit
 watchdog==6.0.0
     # via mkdocs
-watchfiles==1.0.5
+watchfiles==1.1.0
     # via render_engine (pyproject.toml)

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/src/render_engine/_base_object.py

@@ -26,6 +26,7 @@ class BaseObject:
     template_vars: dict
     plugins: list[Callable] | None
     plugin_settings: dict = {"plugins": defaultdict(dict)}
+    skip_site_map: bool = False
 
     @property
     def _title(self) -> str:
@@ -126,3 +127,7 @@ class BaseObject:
                 base_dict[key] = value
 
         return base_dict
+
+    def render(self, *args, **kwargs):
+        """Render method. Implemented in child objects"""
+        raise NotImplementedError(f'{self.__class__.__name__} does not implement the "render" method.')

{render_engine-2025.9.1a1 → render_engine-2025.10.1a1}/src/render_engine/collection.py

@@ -252,6 +252,33 @@ class Collection(BaseObject):
             return
         method(collection=self, site=site, settings=self.plugin_manager.plugin_settings)
 
+    def render(self) -> None:
+        """Iterate through Pages and Check for Collections and Feeds"""
+
+        for entry in self:
+            entry.plugin_manager = copy.deepcopy(self.plugin_manager)
+
+            for route in entry.routes:
+                entry.site = self.site
+                entry.render(route, self.site.theme_manager)
+
+        if getattr(self, "has_archive", False):
+            for archive in self.archives:
+                archive.site = self.site
+                logging.debug("Adding Archive: %s", archive.__class__.__name__)
+
+                for _ in self.routes:
+                    archive.render(self.routes[0], self.site.theme_manager)
+
+                if archive.is_index:
+                    archive.slug = "index"
+                    archive.render(self.routes[0], self.site.theme_manager)
+        feed: RSSFeed
+        if hasattr(self, "Feed"):
+            feed = self.feed
+            feed.site = self.site
+            feed.render(route="./", theme_manager=self.site.theme_manager)
+
 
 def render_archives(archive, **kwargs) -> list[Archive]:
     return [archive.render(pages=archive.pages, **kwargs) for archive in archive]