From fe6038ac4f14f9b49275bb898483fe122be62168 Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:34 +0200
Subject: [PATCH 1/7] feat: Show RSS icon if config enables it

This adds support for showing a tiny RSS svg badge in the top menu in
case the user added a menu_item that looks like this:
`{name = "", url = "$BASE_URL/$FEED_FILENAME"}`

This also requires that the user has a config.toml that contains the
following entries:

generate_feed = true
feed_filename = "rss.xml"
author = "your name here"
---
 templates/macros/menu.html | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/templates/macros/menu.html b/templates/macros/menu.html
index 090388f..90cd50e 100644
--- a/templates/macros/menu.html
+++ b/templates/macros/menu.html
@@ -38,11 +38,26 @@
             <ul class="menu__inner">
             {%- for item in menu_items %}
                 <li {%- if current_item and current_item == item %} class="active" {%- endif %}>
+
                     {%- if item.newtab -%}
                         <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}" target="_blank" rel="noopener noreferrer">{{ item.name | safe }}</a>
                     {%- else -%}
                         <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}">{{ item.name | safe }}</a>
                     {%- endif -%}
+
+                    <!-- RSS -->
+                    {%- set is_rss = item.url == "$BASE_URL/$FEED_FILENAME" -%}
+
+                    {%- if is_rss %}
+                        <a type="application/rss+xml" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
+                            <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">
+                                <!--!Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.-->
+                                <path fill="#ee802f" d="M128.1 416c0 35.4-28.7 64-64 64S0 451.3 0 416s28.7-64 64-64 64 28.7 64 64zm175.7 47.3c-8.4-154.6-132.2-278.6-287-287C7.7 175.8 0 183.1 0 192.3v48.1c0 8.4 6.5 15.5 14.9 16 111.8 7.3 201.5 96.7 208.8 208.8 .5 8.4 7.6 14.9 16 14.9h48.1c9.1 0 16.5-7.7 16-16.8zm144.2 .3C439.6 229.7 251.5 40.4 16.5 32 7.5 31.7 0 39 0 48v48.1c0 8.6 6.8 15.6 15.5 16 191.2 7.8 344.6 161.3 352.5 352.5 .4 8.6 7.4 15.5 16 15.5h48.1c9 0 16.3-7.5 16-16.5z"/>
+                            </svg>
+                        </a>
+                    </p>
+                    {% endif -%}
+
                 </li>
             {% endfor -%}
             </ul>

From d12ae1a0662fab9a94d9360217a2c2397210b0f2 Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:35 +0200
Subject: [PATCH 2/7] feat: Also gate on config.generate_feed

---
 templates/macros/menu.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/macros/menu.html b/templates/macros/menu.html
index 90cd50e..347087d 100644
--- a/templates/macros/menu.html
+++ b/templates/macros/menu.html
@@ -48,7 +48,7 @@
                     <!-- RSS -->
                     {%- set is_rss = item.url == "$BASE_URL/$FEED_FILENAME" -%}
 
-                    {%- if is_rss %}
+                    {%- if is_rss and config.generate_feed %}
                         <a type="application/rss+xml" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
                             <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">
                                 <!--!Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.-->

From ecc74dfa7e9349daa48bb482a5a0c0b12ddcb761 Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:37 +0200
Subject: [PATCH 3/7] chore: Newlines

---
 templates/macros/menu.html | 2 --
 1 file changed, 2 deletions(-)

diff --git a/templates/macros/menu.html b/templates/macros/menu.html
index 347087d..0d9ee3a 100644
--- a/templates/macros/menu.html
+++ b/templates/macros/menu.html
@@ -38,7 +38,6 @@
             <ul class="menu__inner">
             {%- for item in menu_items %}
                 <li {%- if current_item and current_item == item %} class="active" {%- endif %}>
-
                     {%- if item.newtab -%}
                         <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}" target="_blank" rel="noopener noreferrer">{{ item.name | safe }}</a>
                     {%- else -%}
@@ -47,7 +46,6 @@
 
                     <!-- RSS -->
                     {%- set is_rss = item.url == "$BASE_URL/$FEED_FILENAME" -%}
-
                     {%- if is_rss and config.generate_feed %}
                         <a type="application/rss+xml" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
                             <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

From 315f0923d3e641855e00c7538543c46f50ab3534 Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:38 +0200
Subject: [PATCH 4/7] feat: Support atom rss too

---
 templates/macros/menu.html | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/templates/macros/menu.html b/templates/macros/menu.html
index 0d9ee3a..d35d9f8 100644
--- a/templates/macros/menu.html
+++ b/templates/macros/menu.html
@@ -47,7 +47,14 @@
                     <!-- RSS -->
                     {%- set is_rss = item.url == "$BASE_URL/$FEED_FILENAME" -%}
                     {%- if is_rss and config.generate_feed %}
-                        <a type="application/rss+xml" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
+
+                        {%- if config.feed_filename == "rss.xml" %}
+                            {% set feed_type = 'rss+xml' %}
+                        {%- else %}
+                            {% set feed_type = 'atom+xml' %}
+                        {% endif -%}
+
+                        <a type="application/{{feed_type}}" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
                             <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">
                                 <!--!Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.-->
                                 <path fill="#ee802f" d="M128.1 416c0 35.4-28.7 64-64 64S0 451.3 0 416s28.7-64 64-64 64 28.7 64 64zm175.7 47.3c-8.4-154.6-132.2-278.6-287-287C7.7 175.8 0 183.1 0 192.3v48.1c0 8.4 6.5 15.5 14.9 16 111.8 7.3 201.5 96.7 208.8 208.8 .5 8.4 7.6 14.9 16 14.9h48.1c9.1 0 16.5-7.7 16-16.8zm144.2 .3C439.6 229.7 251.5 40.4 16.5 32 7.5 31.7 0 39 0 48v48.1c0 8.6 6.8 15.6 15.5 16 191.2 7.8 344.6 161.3 352.5 352.5 .4 8.6 7.4 15.5 16 15.5h48.1c9 0 16.3-7.5 16-16.5z"/>

From 6dfa410d4ee15f2c403fa6c264639e6c7a583e40 Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:38 +0200
Subject: [PATCH 5/7] feat: Change RSS icon, do not prepend {{name}}

There's some css rules for which prepending the name of the menu item as
set in the config causes the <a> element to appear shifted down compared
to the other <a> elements of the menu. I might have a look later, but
for now this enables only the appeareance of the RSS icon, discarding
entirely the name of the link.
---
 templates/macros/menu.html | 48 ++++++++++++++++++++++++--------------
 1 file changed, 30 insertions(+), 18 deletions(-)

diff --git a/templates/macros/menu.html b/templates/macros/menu.html
index d35d9f8..246ab51 100644
--- a/templates/macros/menu.html
+++ b/templates/macros/menu.html
@@ -38,30 +38,42 @@
             <ul class="menu__inner">
             {%- for item in menu_items %}
                 <li {%- if current_item and current_item == item %} class="active" {%- endif %}>
-                    {%- if item.newtab -%}
-                        <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}" target="_blank" rel="noopener noreferrer">{{ item.name | safe }}</a>
-                    {%- else -%}
-                        <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}">{{ item.name | safe }}</a>
-                    {%- endif -%}
 
                     <!-- RSS -->
                     {%- set is_rss = item.url == "$BASE_URL/$FEED_FILENAME" -%}
-                    {%- if is_rss and config.generate_feed %}
 
-                        {%- if config.feed_filename == "rss.xml" %}
-                            {% set feed_type = 'rss+xml' %}
-                        {%- else %}
-                            {% set feed_type = 'atom+xml' %}
+                    {%- if config.extra.rss_icon_color %}
+                        {%- set rss_icon_color = config.extra.rss_icon_color %}
+                    {%- else %}
+                        {%- set rss_icon_color = "#ee802f" %}
+                    {%- endif %}
+
+                    {%- if is_rss -%}
+                        {%- if config.generate_feed %}
+                            {%- if config.feed_filename == "rss.xml" %}
+                                {% set feed_type = 'rss+xml' %}
+                            {%- else %}
+                                {% set feed_type = 'atom+xml' %}
+                            {% endif -%}
+
+                            <a type="application/{{feed_type}}" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
+                                <svg id="rss-icon" xmlns="http://www.w3.org/2000/svg" width="22" height="22" viewBox="0 0 32 32" fill="none" stroke="{{rss_icon_color}}" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-rss">
+                                <g transform="translate(0,5)">
+                                    <path d="M4 11a9 9 0 0 1 9 9"></path>
+                                    <path d="M4 4a16 16 0 0 1 16 16"></path>
+                                    <circle cx="5" cy="19" r="1"></circle>
+                                </g>
+                                </svg>
+                            </a>
                         {% endif -%}
 
-                        <a type="application/{{feed_type}}" title="RSS" href="{{ get_url(path=config.feed_filename) | safe }}">
-                            <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">
-                                <!--!Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.-->
-                                <path fill="#ee802f" d="M128.1 416c0 35.4-28.7 64-64 64S0 451.3 0 416s28.7-64 64-64 64 28.7 64 64zm175.7 47.3c-8.4-154.6-132.2-278.6-287-287C7.7 175.8 0 183.1 0 192.3v48.1c0 8.4 6.5 15.5 14.9 16 111.8 7.3 201.5 96.7 208.8 208.8 .5 8.4 7.6 14.9 16 14.9h48.1c9.1 0 16.5-7.7 16-16.8zm144.2 .3C439.6 229.7 251.5 40.4 16.5 32 7.5 31.7 0 39 0 48v48.1c0 8.6 6.8 15.6 15.5 16 191.2 7.8 344.6 161.3 352.5 352.5 .4 8.6 7.4 15.5 16 15.5h48.1c9 0 16.3-7.5 16-16.5z"/>
-                            </svg>
-                        </a>
-                    </p>
-                    {% endif -%}
+                    {%- else -%}
+                        {%- if item.newtab -%}
+                            <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}" target="_blank" rel="noopener noreferrer">{{ item.name | safe }}</a>
+                        {%- else -%}
+                            <a href="{{ item.url | replace(from="$BASE_URL", to=config.base_url) | safe }}">{{ item.name | safe }}</a>
+                        {%- endif -%}
+                    {%- endif -%}
 
                 </li>
             {% endfor -%}

From 618125998bfb5f46e7b09a016a7e54cc3ed0948d Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:39 +0200
Subject: [PATCH 6/7] feat: Initial support for custom rss icon color

At some point this might follow the same logic used by `accent_color`
and `background_color`, for consistency.
---
 config.toml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/config.toml b/config.toml
index cfcceca..4c89822 100644
--- a/config.toml
+++ b/config.toml
@@ -34,6 +34,9 @@ accent_color = "blue"
 # Defaults to accent color (or, if not accent color specified, to blue).
 background_color = "blue"
 
+# You can set this to any rgb hex value.
+rss_icon_color = "#ee802f"
+
 # The logo text - defaults to "Terminimal theme"
 logo_text = "Terminimal theme"
 

From c84d03c60db4c0885546ef0fd1cadfab2ab4949f Mon Sep 17 00:00:00 2001
From: vvzen <10340139+vvzen@users.noreply.github.com>
Date: Sun, 9 Jun 2024 11:25:40 +0200
Subject: [PATCH 7/7] docs: Add entry documenting RSS icon settings

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/README.md b/README.md
index 586b50c..8983dd8 100644
--- a/README.md
+++ b/README.md
@@ -346,6 +346,41 @@ page_titles = "combined"
 All the configuration options are also described in
 [`config.toml`](../master/config.toml).
 
+
+### RSS
+
+This theme supports RSS feeds.
+To enable RSS you need to set those 3 configuration settings to valid values: 
+
+```toml
+generate_feed = true
+author = "yourself@email.com"
+
+# Use `rss.xml` for RSS feeds and `atom.xml` for ATOM.
+feed_filename = "atom.xml"
+```
+
+Note that `author` is also required as part of the RSS spec.
+You can read more on https://www.getzola.org/documentation/templates/feeds/ about the potential values, since RFC 4287 requires author to be a name and not an email.
+
+To add an RSS icon to the main menu, you can add this entry to the `menu_items` :
+
+```toml
+menu_items = [
+    # RSS
+    {name = "", url = "$BASE_URL/$FEED_FILENAME"}
+]
+```
+
+You can also customize the color of the RSS icon by changing the `rss_icon_color`:
+
+```toml
+[extra]
+
+# ...
+rss_icon_color = "#ee802f"
+```
+
 ## Extending
 
 Each of the templates defines named blocks, so