add pagination

Author: kjaymiller

_layouts/_includes/header.html

@@ -3,7 +3,7 @@
   <h1 class="site-title">
     <a class="logo-text" href="/index.html"><img src="{{ '/assets/images/black_python_devs_logo-horizontal-white.png' }}" alt="Black Python Devs" /></a>
   </h1>
-  <nav class="site-navigation" aria-label="Main navigation">
+  <nav class="site-navigation" aria-label="Main navigation" style="padding-right: 2em">
     <div class="site-navigation-wrap">
       <ul class="menu" role="menu">
         {% for item in navigation %} {% set current = nil %} {% set nav_lang = nil %} {% if url == item.url %} {% set current = 'nav-current' %} {% endif %} {% if lang != 'en' %} {% set nav_lang = lang %} {% endif %}

_layouts/blog-list.html

@@ -17,4 +17,14 @@ <h2><a href="{{ page }}.html">
       </article>
     {% endfor %}
     </section>
-{% endblock %}
+<section>
+  <div role="group">
+    <h4>Pages:</h4>
+    <div>
+  {% for page in range(1, num_of_pages + 1) %}
+      <a role="button" {% if page == archive_index %} disabled {% endif %} href="/blog/blog{{page}}.html">{{ page }}</a>
+  {% endfor %}
+  </div>
+  </div>
+</section>
+{%endblock %}

app.py

@@ -1,3 +1,4 @@
+import itertools
 import datetime
 import json
 import pathlib
@@ -86,3 +87,13 @@ class Blog(Blog):
     routes = ["./blog"]
     has_archive = True
     archive_template = "blog-list.html"
+    items_per_page = 10
+
+
+if __name__ == "__main__":
+    blog = app.route_list["blog"]
+    posts = list(blog)
+    batched_posts = list(itertools.batched(posts, 10))
+    print(vars(list(blog.archives)[1]))
+    print(f"num of posts: {len(posts)}")
+    print(len(batched_posts))

pyproject.toml

@@ -2,7 +2,7 @@
 name = "blackpythondevs-site"
 version = "0.1.0"
 description = "Black Python Devs community website"
-dependencies = ["render-engine[cli]==2025.6.1b2", "pyyaml"]
+dependencies = ["render-engine[cli]>=2025.7.1a1", "pyyaml"]
 
 [project.optional-dependencies]
 dev = [