Add workaround for icons backwards compatibility

Now old pelicanconf.py should be rendered correctly with new Font Awesome:
- Some special cases are hardcoded. For now those are 'rss' and 'feed'
- If icon string starts with 'fa' it is assumed to represent full CSS class
- Otherwise a brand icon is assumed - sensible fallback for most users

README.md

@@ -116,7 +116,10 @@ Visit the [Settings docs](docs/settings.md) for examples:
 - **SITEIMAGE**: Image that appears in the header.
 - **DESCRIPTION**: Index HTML head `<meta>` description.
 - **LINKS**: A list of tuples (Title, URL) for menu links.
-- **ICONS**: A list of tuples (Icon, URL) for icon links.
+- **ICONS**: A list of tuples (Icon, URL) for icon links. Icons are assumed to
+  be Font Awesome brand icons, if you need to use icons from other Font
+  Awesome icon set please provide full [CSS class], e.g. `fas fa-camera`
+  instead on just `camera`
 - **FOOTER_LINKS**: A list of tuples (Title, URL) for footer links. Replaces
   default set of links (Authors, Archives, Categories, Tags).
 - **BOOTSTRAP_CSS**: URL of Bootstrap CSS file. Use this to enable Boostwatch themes.
@@ -129,6 +132,8 @@ Visit the [Settings docs](docs/settings.md) for examples:
   theme. Alchemy uses no JS by default. Both relative and absolute URLs are
   supported.
 
+[CSS class]: https://fontawesome.com/how-to-use/on-the-web/referencing-icons/basic-use
+
 Misc settings:
 
 - **DISQUS_SITENAME**

alchemy/templates/include/header.html

@@ -1,3 +1,16 @@
+{%- macro fa(icon) -%}
+{%- set fa_special_icons = {
+  "feed": "fas fa-rss",
+  "rss": "fas fa-rss",
+} -%}
+{%- if icon in fa_special_icons -%}
+{{ fa_special_icons[icon] }}
+{%- elif icon.startswith("fa") -%}
+{{ icon }}
+{%- else -%}
+fab fa-{{icon}}
+{%- endif -%}
+{%- endmacro -%}
 <div class="row">
   {% if SITEIMAGE %}
     <div class="col-sm-4">
@@ -28,7 +41,7 @@
           {% if (LINKS or (DISPLAY_PAGES_ON_MENU and pages)) and loop.first %}
             <li class=" list-inline-item text-muted">|</li>
           {% endif %}
-          <li class="list-inline-item"><a class="{{ icon }}" href="{{ url(link) }}" target="_blank"></a></li>
+          <li class="list-inline-item"><a class="{{ fa(icon) }}" href="{{ url(link) }}" target="_blank"></a></li>
         {% endfor %}
       </ul>
     {% endif %}