Merge wip/site-design-rollout-v2-parallel into master

Ship v2 parallel deployment for A/B feedback. Old site routes unchanged;
new design accessible at /v2home/, /v2writings/, /v2theforge/,
/v2/<slug>/, /v2/pages/<slug>/.

To remove after feedback decision: revert this merge commit.

Author: Sohailm25

history/2026-05-19-site-design-rollout-plan.md

@@ -45,8 +45,22 @@
 PAGE_SAVE_AS = "pages/{slug}/index.html"
 ARTICLE_URL = "{slug}/"
 ARTICLE_SAVE_AS = "{slug}/index.html"
-DIRECT_TEMPLATES = ("index", "archives")
+DIRECT_TEMPLATES = ("index", "archives", "v2_index", "v2_archives", "v2_theforge")
 ARCHIVES_SAVE_AS = "writings/index.html"
+
+# v2 parallel deployment — same article/page data, rendered through v2_*.html templates
+# at /v2home/, /v2writings/, /v2theforge/, plus per-article /v2/<slug>/ via the
+# v2_router plugin. Old site remains unchanged.
+V2_INDEX_SAVE_AS = "v2home/index.html"
+V2_INDEX_URL = "v2home/"
+V2_ARCHIVES_SAVE_AS = "v2writings/index.html"
+V2_ARCHIVES_URL = "v2writings/"
+V2_THEFORGE_SAVE_AS = "v2theforge/index.html"
+V2_THEFORGE_URL = "v2theforge/"
+
+PLUGIN_PATHS = ["plugins"]
+PLUGINS = ["v2_router"]
+
 TAG_SAVE_AS = ""
 CATEGORY_SAVE_AS = ""
 AUTHOR_SAVE_AS = ""

history/mockups/2026-05-19-home-editorial.html

@@ -0,0 +1,68 @@
+# ABOUTME: Pelican plugin — for each article and page, also render a v2 copy
+# ABOUTME: at /v2/<slug>/ or /v2/pages/<slug>/ using v2_*.html templates.
+
+from pelican import signals
+
+
+def _v2_article_template(article):
+    """Return the v2 template name for a given article based on its Template metadata."""
+    meta_template = article.metadata.get("template", "article")
+    if meta_template == "longform_article":
+        return "v2_longform_article"
+    return "v2_article"
+
+
+def _v2_page_template(page):
+    """Return the v2 template name for a given page based on its Template metadata."""
+    meta_template = page.metadata.get("template", "page")
+    if meta_template == "inference-economics":
+        return "v2_inference_economics"
+    return "v2_page"
+
+
+def write_v2_articles(article_generator, writer):
+    env = article_generator.env
+    for article in article_generator.articles:
+        template_name = _v2_article_template(article)
+        try:
+            template = env.get_template(template_name + ".html")
+        except Exception:
+            continue
+        save_as = "v2/{slug}/index.html".format(slug=article.slug)
+        url = "v2/{slug}/".format(slug=article.slug)
+        writer.write_file(
+            name=save_as,
+            template=template,
+            context=article_generator.context,
+            relative_urls=article_generator.settings.get("RELATIVE_URLS", False),
+            article=article,
+            category=article.category,
+            override_output=True,
+            url=url,
+        )
+
+
+def write_v2_pages(page_generator, writer):
+    env = page_generator.env
+    for page in page_generator.pages:
+        template_name = _v2_page_template(page)
+        try:
+            template = env.get_template(template_name + ".html")
+        except Exception:
+            continue
+        save_as = "v2/pages/{slug}/index.html".format(slug=page.slug)
+        url = "v2/pages/{slug}/".format(slug=page.slug)
+        writer.write_file(
+            name=save_as,
+            template=template,
+            context=page_generator.context,
+            relative_urls=page_generator.settings.get("RELATIVE_URLS", False),
+            page=page,
+            override_output=True,
+            url=url,
+        )
+
+
+def register():
+    signals.article_writer_finalized.connect(write_v2_articles)
+    signals.page_writer_finalized.connect(write_v2_pages)