From 22255d12a995f7393d445b2684f704a2750edfe5 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Wed, 30 Dec 2020 18:53:38 +0100
Subject: [PATCH 1/7] Create a top-level _index.md file

---
 blog/content/_index.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 blog/content/_index.md

diff --git a/blog/content/_index.md b/blog/content/_index.md
new file mode 100644
index 00000000..ef6083b7
--- /dev/null
+++ b/blog/content/_index.md
@@ -0,0 +1,3 @@
++++
+template = "index.html"
++++

From ee1ca9fa6149a9a820738bad3b27a2363e0662a4 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sat, 2 Jan 2021 17:36:21 +0100
Subject: [PATCH 2/7] Point index page directly to edition-2/index.html
 template

---
 blog/content/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/blog/content/_index.md b/blog/content/_index.md
index ef6083b7..56b8ab3d 100644
--- a/blog/content/_index.md
+++ b/blog/content/_index.md
@@ -1,3 +1,3 @@
 +++
-template = "index.html"
+template = "edition-2/index.html"
 +++

From aa227c7dc69a97a94f05e2236653c9010c729aa5 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sat, 2 Jan 2021 18:09:06 +0100
Subject: [PATCH 3/7] Restructure macros

- Split macros.html in per-edition files
- Create new snippets.html macro file with utterances snippet
- Move support.html to snippets.html as new macro
- Create new `latest_post` macro in 2nd edition macros.html
---
 blog/templates/edition-1/index.html           |  2 +-
 blog/templates/edition-1/macros.html          | 39 +++++++++++++++++++
 blog/templates/edition-1/section.html         |  2 +-
 blog/templates/edition-2/extra.html           |  4 +-
 blog/templates/edition-2/index.html           |  5 ++-
 blog/templates/{ => edition-2}/macros.html    | 15 +++----
 blog/templates/edition-2/page.html            |  7 ++--
 blog/templates/news-page.html                 |  4 +-
 blog/templates/news-section.html              |  2 -
 .../templates/{support.html => snippets.html} | 14 ++++++-
 blog/templates/status-update-page.html        |  4 +-
 blog/templates/status-update-section.html     |  2 -
 12 files changed, 72 insertions(+), 28 deletions(-)
 create mode 100644 blog/templates/edition-1/macros.html
 rename blog/templates/{ => edition-2}/macros.html (85%)
 rename blog/templates/{support.html => snippets.html} (71%)

diff --git a/blog/templates/edition-1/index.html b/blog/templates/edition-1/index.html
index 31d4aae7..0d8a68ab 100644
--- a/blog/templates/edition-1/index.html
+++ b/blog/templates/edition-1/index.html
@@ -1,6 +1,6 @@
 {% extends "edition-1/base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "edition-1/macros.html" as macros %}
 
 {% block title %}{{ config.title }}{% endblock title %}
 
diff --git a/blog/templates/edition-1/macros.html b/blog/templates/edition-1/macros.html
new file mode 100644
index 00000000..a6197dad
--- /dev/null
+++ b/blog/templates/edition-1/macros.html
@@ -0,0 +1,39 @@
+{% macro post_link(page) %}
+    {% set translations = page.translations | filter(attribute="lang", value=lang) -%}
+    {%- if translations -%}
+        {%- set post = get_page(path = translations.0.path) -%}
+    {%- else -%}
+        {%- set post = page -%}
+        {%- set not_translated = true -%}
+    {%- endif -%}
+    <div{% if post.extra.rtl %} class="right-to-left"{% endif %}>
+        <h2 class="post-title"><a href="{{ post.path | safe }}">{{ post.title }}</a></h2>
+        <div class="post-summary">
+            {{ post.summary | safe }}
+            <a class="read-more" href="{{ post.path | safe }}"><em>read&nbsp;more&nbsp;»</em></a>
+
+            {%- if lang and not_translated and lang != config.default_language -%}
+            <aside class="no-translation">
+                (This post is not translated yet.)
+            </aside>
+            {%- endif -%}
+        </div>
+    </div>
+{% endmacro post_link %}
+
+{% macro toc(toc) %}
+    <details id = "toc-inline">
+        <summary><b>Table of Contents</b></summary>
+        <ul>
+            {% for h2 in toc %}<li>
+                <a href="#{{h2.id | safe}}">{{ h2.title | safe }}</a>
+                {% if h2.children %}<ul>
+                    {% for h3 in h2.children %}<li>
+                        <a href="#{{h3.id | safe}}">{{ h3.title | safe }}</a>
+                    </li>{% endfor %}
+                </ul>{% endif %}
+            </li>{% endfor %}
+            <li class="toc-comments-link"><a href="#comments">Comments</a></li>
+        </ul>
+    </details>
+{% endmacro toc %}
diff --git a/blog/templates/edition-1/section.html b/blog/templates/edition-1/section.html
index 3bbe0a8a..45d12fa3 100644
--- a/blog/templates/edition-1/section.html
+++ b/blog/templates/edition-1/section.html
@@ -1,6 +1,6 @@
 {% extends "edition-1/base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "edition-1/macros.html" as macros %}
 
 {% block title %}{{ section.title }} | {{ config.title }}{% endblock title %}
 
diff --git a/blog/templates/edition-2/extra.html b/blog/templates/edition-2/extra.html
index bdd5a16a..93c98f59 100644
--- a/blog/templates/edition-2/extra.html
+++ b/blog/templates/edition-2/extra.html
@@ -1,6 +1,6 @@
 {% extends "edition-2/base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "snippets.html" as snippets %}
 
 {% block title %}{{ page.title }} | {{ config.title }}{% endblock title %}
 
@@ -17,6 +17,6 @@
     <hr>
     <section>
         <h2>Comments</h2>
-        {{ macros::utterances() }}
+        {{ snippets::utterances() }}
     </section>
 {% endblock after_main %}
diff --git a/blog/templates/edition-2/index.html b/blog/templates/edition-2/index.html
index b8303d4b..dbf3762d 100644
--- a/blog/templates/edition-2/index.html
+++ b/blog/templates/edition-2/index.html
@@ -1,6 +1,7 @@
 {% extends "edition-2/base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "edition-2/macros.html" as macros %}
+{% import "snippets.html" as snippets %}
 
 {% block title %}{{ config.title }}{% endblock title %}
 
@@ -71,7 +72,7 @@
 
 <div class="">
     <h2>Support Me</h2>
-    {% include "support.html" %}
+    {{ snippets::support() }}
 </div>
 {% endblock main %}
 
diff --git a/blog/templates/macros.html b/blog/templates/edition-2/macros.html
similarity index 85%
rename from blog/templates/macros.html
rename to blog/templates/edition-2/macros.html
index a7c700a9..a28a44bb 100644
--- a/blog/templates/macros.html
+++ b/blog/templates/edition-2/macros.html
@@ -1,3 +1,8 @@
+{% macro latest_post(posts) %}
+    {% set post = posts|last %}
+    <strong><a href="{{ post.path | safe }}">{{ post.title }}</a></strong>
+{% endmacro latest_post %}
+
 {% macro post_link(page) %}
     {% set translations = page.translations | filter(attribute="lang", value=lang) -%}
     {%- if translations -%}
@@ -21,16 +26,6 @@
     </div>
 {% endmacro post_link %}
 
-{% macro utterances() %}
-    <script src="https://utteranc.es/client.js"
-        data-repo="phil-opp/blog_os"
-        data-issue-term="url"
-        data-label="comments"
-        crossorigin="anonymous"
-        async>
-    </script>
-{% endmacro utterances %}
-
 {% macro toc(toc) %}
     <details id = "toc-inline">
         <summary><b>Table of Contents</b></summary>
diff --git a/blog/templates/edition-2/page.html b/blog/templates/edition-2/page.html
index ef440314..13a70d79 100644
--- a/blog/templates/edition-2/page.html
+++ b/blog/templates/edition-2/page.html
@@ -1,6 +1,7 @@
 {% extends "edition-2/base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "edition-2/macros.html" as macros %}
+{% import "snippets.html" as snippets %}
 
 {% block title %}{{ page.title }} | {{ config.title }}{% endblock title %}
 {% block header %}
@@ -75,7 +76,7 @@
 
     <div class="post-footer-support">
         <h2>Support Me</h2>
-        {% include "support.html" %}
+        {{ snippets::support() }}
     </div>
 
     <hr>
@@ -98,7 +99,7 @@
         </p>
         {% endif %}
 
-        {{ macros::utterances() }}
+        {{ snippets::utterances() }}
     </section>
 
     <aside class="page-aside-right">
diff --git a/blog/templates/news-page.html b/blog/templates/news-page.html
index de988f7d..0de7b67c 100644
--- a/blog/templates/news-page.html
+++ b/blog/templates/news-page.html
@@ -1,6 +1,6 @@
 {% extends "base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "snippets.html" as snippets %}
 
 {% block title %}{{ page.title }} | {{ config.title }}{% endblock title %}
 
@@ -17,7 +17,7 @@
     <hr>
     <section>
         <h2 id="comments">Comments</h2>
-        {{ macros::utterances() }}
+        {{ snippets::utterances() }}
     </section>
 
 {% endblock after_main %}
diff --git a/blog/templates/news-section.html b/blog/templates/news-section.html
index abea315d..2834d277 100644
--- a/blog/templates/news-section.html
+++ b/blog/templates/news-section.html
@@ -1,7 +1,5 @@
 {% extends "base.html" %}
 
-{% import "macros.html" as macros %}
-
 {% block title %}{{ section.title }} | {{ config.title }}{% endblock title %}
 
 {% block main %}
diff --git a/blog/templates/support.html b/blog/templates/snippets.html
similarity index 71%
rename from blog/templates/support.html
rename to blog/templates/snippets.html
index b2fbe445..d3057a32 100644
--- a/blog/templates/support.html
+++ b/blog/templates/snippets.html
@@ -1,3 +1,4 @@
+{% macro support() %}
 <p>
     Creating and <a href="{{ get_url(path="@/status-update/_index.md") }}">maintaining</a> this blog and the associated libraries is a lot of work, but I really enjoy doing it. By supporting me, you allow me to invest more time in new content, new features, and continuous maintenance.
 </p>
@@ -6,4 +7,15 @@
 </p>
 <p>
     Thank you!
-</p>
\ No newline at end of file
+</p>
+{% endmacro support %}
+
+{% macro utterances() %}
+    <script src="https://utteranc.es/client.js"
+        data-repo="phil-opp/blog_os"
+        data-issue-term="url"
+        data-label="comments"
+        crossorigin="anonymous"
+        async>
+    </script>
+{% endmacro utterances %}
\ No newline at end of file
diff --git a/blog/templates/status-update-page.html b/blog/templates/status-update-page.html
index 78630e4d..45741e7d 100644
--- a/blog/templates/status-update-page.html
+++ b/blog/templates/status-update-page.html
@@ -1,6 +1,6 @@
 {% extends "base.html" %}
 
-{% import "macros.html" as macros %}
+{% import "snippets.html" as snippets %}
 
 {% block title %}{{ page.title }} | {{ config.title }}{% endblock title %}
 
@@ -32,7 +32,7 @@
     <hr>
     <section>
         <h2 id="comments">Comments</h2>
-        {{ macros::utterances() }}
+        {{ snippets::utterances() }}
     </section>
 
 {% endblock after_main %}
diff --git a/blog/templates/status-update-section.html b/blog/templates/status-update-section.html
index dc8b46da..99d66d77 100644
--- a/blog/templates/status-update-section.html
+++ b/blog/templates/status-update-section.html
@@ -1,7 +1,5 @@
 {% extends "base.html" %}
 
-{% import "macros.html" as macros %}
-
 {% block title %}{{ section.title }} | {{ config.title }}{% endblock title %}
 
 {% block main %}

From 5a86a715c93f501844ed5cf30a84963330559fe1 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sat, 2 Jan 2021 18:09:47 +0100
Subject: [PATCH 4/7] Move introduction from index template to markdown file

To allow translations.
---
 blog/content/_index.md              | 10 ++++++++++
 blog/templates/edition-2/index.html | 18 ++++--------------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/blog/content/_index.md b/blog/content/_index.md
index 56b8ab3d..493e0c96 100644
--- a/blog/content/_index.md
+++ b/blog/content/_index.md
@@ -1,3 +1,13 @@
 +++
 template = "edition-2/index.html"
 +++
+
+<h1 style="visibility: hidden; height: 0px; margin: 0px; padding: 0px;">Writing an OS in Rust</h1>
+
+<div class="front-page-introduction">
+
+This blog series creates a small operating system in the [Rust programming language](https://www.rust-lang.org/). Each post is a small tutorial and includes all needed code, so you can follow along if you like. The source code is also available in the corresponding [Github repository](https://github.com/phil-opp/blog_os).
+
+Latest post: <!-- latest-post -->
+
+</div>
diff --git a/blog/templates/edition-2/index.html b/blog/templates/edition-2/index.html
index dbf3762d..4c893f5c 100644
--- a/blog/templates/edition-2/index.html
+++ b/blog/templates/edition-2/index.html
@@ -9,20 +9,10 @@
 {% set posts_section = get_section(path = "edition-2/posts/_index.md") %}
 {% set posts = posts_section.pages %}
 
-<h1 style="visibility: hidden; height: 0px; margin: 0px; padding: 0px;">Writing an OS in Rust</h1>
-
-<div class="front-page-introduction">
-    <p>
-        This blog series creates a small operating system in the
-        <a href="https://www.rust-lang.org/">Rust programming language</a>. Each post is a small tutorial and includes all
-        needed code, so you can follow along if you like. The source code is also available in the corresponding
-        <a href="https://github.com/phil-opp/blog_os">Github repository</a>.
-    </p>
-    <p>Latest post:
-        {% set latest_post = posts|last %}
-        <strong><a href="{{ latest_post.path | safe }}">{{ latest_post.title }}</a></strong>
-    </p>
-</div>
+{{ section.content
+    | replace(from="<!-- latest-post -->", to=macros::latest_post(posts=posts))
+    | safe
+}}
 
 <div>
 {%- set chapter = "none" -%}

From d2daf9dc48dc56528a09d8dca570255ea62fc475 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sat, 2 Jan 2021 18:11:07 +0100
Subject: [PATCH 5/7] Move section template to `edition-2` subfolder

---
 blog/templates/edition-2/section.html | 19 +++++++++++++++++++
 blog/templates/section.html           | 20 +-------------------
 2 files changed, 20 insertions(+), 19 deletions(-)
 create mode 100644 blog/templates/edition-2/section.html

diff --git a/blog/templates/edition-2/section.html b/blog/templates/edition-2/section.html
new file mode 100644
index 00000000..572012b6
--- /dev/null
+++ b/blog/templates/edition-2/section.html
@@ -0,0 +1,19 @@
+{% extends "base.html" %}
+
+{% import "edition-2/macros.html" as macros %}
+
+{% block title %}{{ section.title }} | {{ config.title }}{% endblock title %}
+
+{% block main %}
+
+<h1>{{ section.title }}</h1>
+
+{% block introduction %}{% endblock introduction %}
+
+<div class="posts neutral">
+    {% for page in section.pages %}
+        {{ macros::post_link(page=page) }}
+    {% endfor %}
+</div>
+
+{% endblock main %}
diff --git a/blog/templates/section.html b/blog/templates/section.html
index 3b879148..fc048eab 100644
--- a/blog/templates/section.html
+++ b/blog/templates/section.html
@@ -1,19 +1 @@
-{% extends "base.html" %}
-
-{% import "macros.html" as macros %}
-
-{% block title %}{{ section.title }} | {{ config.title }}{% endblock title %}
-
-{% block main %}
-
-<h1>{{ section.title }}</h1>
-
-{% block introduction %}{% endblock introduction %}
-
-<div class="posts neutral">
-    {% for page in section.pages %}
-        {{ macros::post_link(page=page) }}
-    {% endfor %}
-</div>
-
-{% endblock main %}
+{% extends "edition-2/section.html" %}

From 36c4e6a7fedf0b74a4865721182c41d402359c02 Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sat, 2 Jan 2021 18:14:21 +0100
Subject: [PATCH 6/7] Add example for a Persian translation of introduction

---
 blog/content/_index.fa.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 blog/content/_index.fa.md

diff --git a/blog/content/_index.fa.md b/blog/content/_index.fa.md
new file mode 100644
index 00000000..f52c7dae
--- /dev/null
+++ b/blog/content/_index.fa.md
@@ -0,0 +1,13 @@
++++
+template = "edition-2/index.html"
++++
+
+<h1 style="visibility: hidden; height: 0px; margin: 0px; padding: 0px;">Writing an OS in Rust</h1>
+
+<div class="front-page-introduction right-to-left">
+
+TODO: TRANSLATION OF INTRODUCTION
+
+Latest post: <!-- latest-post -->
+
+</div>

From 4d4a2e5ae8118ac96a1401a957eed4a475c7c06b Mon Sep 17 00:00:00 2001
From: Philipp Oppermann <dev@phil-opp.com>
Date: Sun, 3 Jan 2021 14:29:38 +0100
Subject: [PATCH 7/7] Revert "Add example for a Persian translation of
 introduction"

This reverts commit 36c4e6a7fedf0b74a4865721182c41d402359c02.
---
 blog/content/_index.fa.md | 13 -------------
 1 file changed, 13 deletions(-)
 delete mode 100644 blog/content/_index.fa.md

diff --git a/blog/content/_index.fa.md b/blog/content/_index.fa.md
deleted file mode 100644
index f52c7dae..00000000
--- a/blog/content/_index.fa.md
+++ /dev/null
@@ -1,13 +0,0 @@
-+++
-template = "edition-2/index.html"
-+++
-
-<h1 style="visibility: hidden; height: 0px; margin: 0px; padding: 0px;">Writing an OS in Rust</h1>
-
-<div class="front-page-introduction right-to-left">
-
-TODO: TRANSLATION OF INTRODUCTION
-
-Latest post: <!-- latest-post -->
-
-</div>