From 18996a6c1da497440ad64c878ef389511b38ce62 Mon Sep 17 00:00:00 2001
From: Vitaly Potyarkin <sio.wtf@gmail.com>
Date: Wed, 18 Sep 2019 16:40:49 +0300
Subject: [PATCH] Enable alternative themes for Bootstrap (e.g. Boostwatch)

Alchemy is a great theme, but it was not using the full potential of
underlying technology. Bootstrap provides an easy way to customize look
and feel of rendered pages, and a lot of themes for Bootstrap are freely
available, e.g. at <https://boostwatch.com>

This commit introduces a new configuration variable BOOTSTRAP_CSS to make
use of any existing Bootstrap skins. All incompatibilities in `theme.css`
were fixed:

- Instead of using constant color values we use Bootstrap css variables for
  colors:
  <https://getbootstrap.com/docs/4.3/getting-started/theming/#css-variables>
- The only hardcoded color value left is the color for header/footer
  borders. It was moved into a variable `--alchemy-border` for easier
  overriding if needed. I have tested the current value against both dark
  and light Boostwatch themes, it works ok.
- Pagination template was slightly changed to avoid producing invisible
  text with some of Bootstrap skins
---
 README.md                                 |  1 +
 alchemy/static/css/theme.css              | 33 +++++++----------------
 alchemy/templates/base.html               |  2 +-
 alchemy/templates/include/pagination.html |  2 +-
 4 files changed, 12 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index 81c1fef..9d1c80f 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,7 @@ Visit the [Settings wiki](https://github.com/nairobilug/pelican-alchemy/wiki/Set
 - **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.
+- **BOOTSTRAP_CSS**: URL of Bootstrap CSS file. Use this to enable Boostwatch themes.
 - **PYGMENTS_STYLE**: Built-in Pygments style for syntax highlighting.
 - **HIDE_AUTHORS**: Hide the author(s) of an article - useful for single author sites.
 - **RFG_FAVICONS**: Use a Favicon Generator package.
diff --git a/alchemy/static/css/theme.css b/alchemy/static/css/theme.css
index 4eee79d..36fb232 100644
--- a/alchemy/static/css/theme.css
+++ b/alchemy/static/css/theme.css
@@ -1,24 +1,14 @@
+:root {
+    --alchemy-border: rgba(0,0,0,.1);
+}
 ::selection {
-  background: #0085a1;
-  color: #fff;
+  background: var(--primary);
+  color: var(--secondary);
   text-shadow: none;
 }
 
-body {
-  background-color: #f5f5f5;
-}
-
-a {
-  color: #333;
-}
-
-a:focus,
-a:hover {
-  color: #0085a1;
-}
-
 blockquote {
-  color: #818a91;
+  opacity: .7;
   font-style: italic;
 }
 
@@ -38,7 +28,7 @@ hr {
 }
 
 .header {
-  border-bottom: 1px solid rgba(0,0,0,.1);
+  border-bottom: 1px solid var(--alchemy-border);
 }
 
 .header img {
@@ -62,23 +52,18 @@ hr {
 }
 
 .main {
-  background-color: #fff;
   padding: 1.5rem 0;
 }
 
 .footer {
-  border-top: 1px solid rgba(0,0,0,.1);
+  border-top: 1px solid var(--alchemy-border);
 }
 
 .highlight pre {
-  border: 1px solid rgba(0,0,0,.1);
+  border: 1px solid var(--alchemy-border);
   padding: 1rem;
 }
 
-.pagination .page-link {
-  color: #333;
-}
-
 .teaser header ul {
   list-style: none;
   padding-left: 0;
diff --git a/alchemy/templates/base.html b/alchemy/templates/base.html
index 4847a02..97e323a 100644
--- a/alchemy/templates/base.html
+++ b/alchemy/templates/base.html
@@ -17,7 +17,7 @@
     <meta name="theme-color" content="#333333">
   {% endif %}
 
-  <link rel="stylesheet" href="{{ SITEURL }}/theme/css/bootstrap.min.css">
+  <link rel="stylesheet" href="{{ BOOTSTRAP_CSS or SITEURL + '/theme/css/bootstrap.min.css'}}">
   <link rel="stylesheet" href="{{ SITEURL }}/theme/css/font-awesome.min.css">
   <link rel="stylesheet" href="{{ SITEURL }}/theme/css/pygments/{{ PYGMENTS_STYLE|default('default') }}.min.css">
   <link rel="stylesheet" href="{{ SITEURL }}/theme/css/theme.css">
diff --git a/alchemy/templates/include/pagination.html b/alchemy/templates/include/pagination.html
index cd8ad45..3b39a5c 100644
--- a/alchemy/templates/include/pagination.html
+++ b/alchemy/templates/include/pagination.html
@@ -9,7 +9,7 @@
         </a>
       </li>
     {% endif %}
-    <li class="page-item disabled">
+    <li class="page-item">
       <span class="page-link">{{ articles_page.number }} of {{ articles_paginator.num_pages }}</span>
     </li>
     {% if articles_page.has_next() %}