jekyll-theme-simplex 0.9.1 → 0.9.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b400558017dc9880481571e324445166a8441f42023c7ae3b6fc9ff4fb1ca73
-  data.tar.gz: 3f0d9d83445582964ec0aea747926aab7c18dd3c90cc60c7b42d160fe01dd398
+  metadata.gz: '018a6a5f2af74af998326fc1916d92c5064a6225a1488ed6e7d89efbcf643caa'
+  data.tar.gz: 63ede6dc44bc801e35e7bb7db32135004f78fd55f0b6099c99cf0f63f532455a
 SHA512:
-  metadata.gz: 750a553751a456607cbe2dfb022b8fd718a9e331d383624a8eaea4c222c16afa0a69d701391e3ec1fa0b0f3111f4d29eee61b6d24886bbe149bc8961ec132328
-  data.tar.gz: 04f8f930c2a4861d08b9392bbb01656f4f25b09e4bf9fc0fc8f9caecb3a1de1075d0822129552c36bcc73dad1328fc140377877c28579176d78b83ddd919bb46
+  metadata.gz: b42d2ba7eb31fc8df60ff8c299a6e8a48f511e3261307f0eba3eb583df676e2c8e519f9239a8dea9e4b659f2cdfefaec7b9bca4d0d8ca9a828828b2c72c9a4b5
+  data.tar.gz: fcf9a760f971c3f98c7133432962d84bb94960cbff3b2c5489f7c693b37f1fdb1f73e3a8ba6cfdf413b787018691b644e43b9e9abaa2c68a4b4da56057de3543

data/README.md

@@ -1,10 +1,21 @@
-![GitHub](https://img.shields.io/github/license/andreondra/jekyll-theme-simplex?style=flat-square)
+⚠ WORK IN PROGRESS - DO NOT USE IN PRODUCTION ⚠
+
 [![Demo](https://img.shields.io/badge/demo-golasblog-blue?style=flat-square)](https://golas.blog/)
 
 # <img src="assets/img/icons/simplex_logo.svg" alt="Simplex" height="50"/>
 
 A *simple* yet neat blogging theme. Developed for the [golas blog](https://golas.blog/) project.
 
+## 👓 Preview
+![Preview](preview.gif)
+
+## 💎 Features
+### Responsive
+![Responsivity preview](previewResponsive.gif)
+
+### Dark mode
+![Dark mode preview](previewDark.gif)
+
 ## ℹ Installation
 
 Add this line to your Jekyll site's `Gemfile`:
@@ -29,10 +40,119 @@ Or install it yourself as:
 
 ## ✔ Usage
 
-TODO: Write usage instructions here. Describe your available layouts, includes, sass and/or assets.
+### ⚙ Setting up the template
+Replace the contents of the _config.yml file with the following:
+```yaml
+title: the Simplex theme #The name of your blog.
+logo_img: /assets/img/icons/golasblog_logo.svg #Absolute path to the logo. If not specified, the title will be displayed instead.
+description: description #Description.
+global_tags: jekyll theme simplex golasblog responsive html5 #Tags.
+copyright: © Golasowski 2020 #Your copyright.
+
+collections:
+    category:
+        output: true
+    authors:
+        output: false
+
+defaults:
+  -
+    scope:
+      path: ""
+      type: category
+    values:
+      layout: "category"
+```
+
+### ✨ Defining categories
+Create a `_category` folder in the root directory of the blog. Create a `.md` file for every category with the contents:
+```
+---
+category: [design] #Category ID.
+hue: var(--c-themeHueOrange) #Category hue. See note [1].
+title: Design #Category title.
+description: Lorem ipsum dolor sit amet.
+---
+```
 
-## 🤝 Contributing
+### 🤵 Defining authors
+Create a `_authors` folder in the root directory. Create a `.md` file for every author with the contents:
+```
+---
+nick: golas #Author's nick.
+full_name: Andrew Golasowski #Author's full name.
+photo_dir: assets/img/authors/golas.png #Path to the author's pic.
+---
+```
 
+### 📰 Defining the menu
+Create a `_data` folder in the root directory. In the folder, create a `nav.yaml` file. Here's an example:
+```yaml
+- title: Programming #Menu item title.
+  url: category/programming.html #Menu item url.
+  icon: assets/img/icons/programming.svg #Menu item icon.
+  hue: "var(--c-themeHueRed)" #Menu item hue - see note [1].
+  subnav: #Subnav. See note [2].
+      - title: C++ #Submenu item title.
+        url: cpp.html #Submenu item url.
+        hue: "var(--c-themeHueOrange)" #Submenu item hue.
+        subnav: #Another subnav
+            - title: Libraries
+              url: libs.html
+              hue: "var(--c-themeHueBlue)"
+- title: Design
+  url: design.html
+  icon: assets/img/icons/design.svg
+  hue: "var(--c-themeHueRed)"
+```
+#### Pro tip:
+Use color icons with the same hue as the menu items. Icons will be black and on hover the color will be shown.
+
+### ✒ Creating posts
+Posts are created in the `_posts` directory. Following front matter attributes are supported:
+```
+---
+layout: post #Do not change.
+category: [programming, testing] #One, more categories or no at all.
+title: "Lorem ipsum" #Article title.
+author: andy #Author's nick.
+---
+Your markdown content here.
+```
+
+### Syntax highlighting
+The theme uses Pygments CSS files created by [@richleland](https://github.com/richleland). If you want to modify the highlighting styles, just download different CSS or create your own - see [Jekyll docs](https://jekyllrb.com/docs/liquid/tags/#stylesheets-for-syntax-highlighting).
+
+Note - `@media` is used to supply different styles for light and dark browser mode. See `_variables.scss` file for details.
+
+### ℹ Notes
+[1] Hue can be either one of the predefined colors or any of the CSS `color` attribute supported values (hex, rgb...).
+
+[2] Submenus are generated recursively, so any menu (and submenu) can have its own submenu.
+
+#### Predefined colors
+You can use following predefined colors:
+```scss
+--c-themePrimaryLight: #EFEFEF;
+--c-themePrimaryDark:  #101010;
+--c-themeSecondaryLight: #DADADA;
+--c-themeSecondaryDark: #252525;
+--c-themeTerniaryLight: #AEAEAE;
+--c-themeTerniaryDark: #515151;
+--c-themeQuaternaryLight: #919191;
+--c-themeQuaternaryDark: #888888;
+
+--c-themeHueRed: #C02717;
+--c-themeHueGreen: #8EA604;
+--c-themeHueBlue: #2E86AB;
+--c-themeHueOrange: #E59500;
+--c-themeHuePurple: #9F00CE;
+--c-themeHueBrown: #230007;
+```
+These colors are CSS variables, usage: `var(--var-name)`
+
+## 🤝 Contributing
+ 
 Bug reports and pull requests are welcome on [GitHub](https://github.com/andreondra/jekyll-theme-simplex).
 
 ## ⚙ Development
@@ -44,7 +164,9 @@ Your theme is setup just like a normal Jekyll site! To test your theme, run `bun
 When your theme is released, only the files in `_layouts`, `_includes`, `_sass` and `assets` tracked with Git will be bundled.
 To add a custom directory to your theme-gem, please edit the regexp in `jekyll-theme-simplex.gemspec` accordingly.
 
-## ⚖ License
+## Credit
+Includes icons by [uxwing](https://uxwing.com/).
 
-The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+## ⚖ License
+© Ondrej Golasowski. The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 

data/_includes/header.html

@@ -1,6 +1,13 @@
 <header class="header">
     <section class="logo">
-        <h1>golasblog</h1>
+        <a href="{{ site.url }}/" class="logo__link">
+            {% if site.logo_img != nil %}
+                <h1 style="display: none;">golasblog</h1>
+                <img class="logo__link__img" src={{site.logo_img}}/>
+            {% else %}
+                <h1>golasblog</h1>
+            {% endif %}
+        </a>
     </section>
     <button id="menuToggle">
         <div></div>

data/_includes/nav.html

@@ -8,11 +8,9 @@
 
             <div class="item-controls">
                 <a href="{{ site.url }}/{{ item.url }}">
-                    {% for img in site.static_files %}
-                        {% if img.name == item.icon and img.path contains "img/icons" %}
-                            <img src="{{ site.url }}/{{ img.path }}"/>
-                        {% endif %}
-                    {% endfor %}
+                {% if item.icon != nil %}
+                    <img src="{{ site.url }}/{{ item.icon }}"/>
+                {% endif %}
                 {% if item.hue != nil %}
                     <p style="color: {{ item.hue }}">{{ item.title }}</p>
                 {% else %}

data/_includes/snippet.html

@@ -4,11 +4,11 @@
         background-image: 
         radial-gradient(ellipse closest-side, var(--c-snippetBackgroundExternal), var(--c-snippetBackgroundInternal)),
         url(
-            {% if post.image_dir == nil %}
+            {% if post.image_dir == "default" %}
                 {% assign url = post.path |  split: "." | first | split: "/" | last %}
                 {{ site.url }}/assets/posts/{{ url }}/background_image.png
-            {% else if post.image_dir != "null" %}
-                {{ post.image_dir }}
+            {% else if post.image_dir != nil %}
+                {{ site.url }}/{{ post.image_dir }}
             {% endif %}
         );
     }
@@ -16,15 +16,23 @@
 <a class="snippet__link" href="{{ post.url }}">
     <section class="snippet__data">
         <section class="snippet__data__metadata">
-            <p class="snippet__data__metadata__category" style="color: {{ site.category | where: "category", post.category | map: "hue" }}">{{ post.category | join: " · " }}</p>
+            <section class="snippet__data__metadata__category">
+                {% for category in post.category %}
+                    <p class="snippet__data__metadata__category__title" style="background: {{ site.category | where: "category", category | map: "hue"}}">{{ category }}</p>
+                {% else %}
+                    <p class="snippet__data__metadata__category__title">No category</p>
+                {% endfor %}
+            </section>
             <p class="snippet__data__metadata__date">{{ post.date | date: '%B %d, %Y' }}</p>
         </section>
         <h2 class="snippet__data__header">{{post.title }}</h2>
         <p class="snippet__data__text">{{ post.excerpt | strip_html }}</p>
-        <div class="snippet__data__author"> 
-            {% assign author = site.authors | where: "nick", post.author | first %}
-            <img src="{{ site.url }}/{{ author.photo_dir }}"/>
-            <p>{{ author.full_name }}</p>
-        </div>
+        {% if post.author != nil %}
+            <div class="snippet__data__author"> 
+                {% assign author = site.authors | where: "nick", post.author | first %}
+                <img src="{{ site.url }}/{{ author.photo_dir }}"/>
+                <p>{{ author.full_name }}</p>
+            </div>
+        {% endif %}
     </section>
 </a> 

data/_layouts/home.html

@@ -0,0 +1,16 @@
+---
+layout: default
+---
+
+<section class="feed">
+    <section class="feed__description">
+        <h1>{{ site.title }}</h1>
+        <p>{{ site.description }}</p>
+    </section>
+    
+    {% for post in site.posts %}
+        <section class="snippet snippet_{{ post.id | slugify: "ascii" }}">
+            {% include snippet.html post=post %}
+        </section>
+    {% endfor %}
+</section>

data/_layouts/page.html

@@ -2,4 +2,6 @@
 layout: default
 ---
 
-{{ content }}
+<main class="page">
+    {{ content }}
+</main>

data/_layouts/post.html

@@ -2,6 +2,59 @@
 layout: default
 ---
 
-<section class="post">
-    {{ content }}
-</section>
+<article class="post">
+
+    <div class="post__title">
+        <h1 class="post__title__text">{{ page.title }}</h1>
+    </div>
+    <div class="post__meta"> 
+        <div class="post__meta__category">
+            {% for category in page.category %}
+                <p class="post__meta__category__title" style="background: {{ site.category | where: "category", category | map: "hue"}}">{{ category }}</p>
+            {% else %}
+                <p class="post__meta__category__title">No category</p>
+            {% endfor %}
+        </div>
+        <p class="post__meta__divider">·</p>
+        <div class="post__meta__date">
+            {{ page.date | date: '%B %d, %Y' }}
+        </div>
+        {% if page.author != nil %}
+            {% assign author = site.authors | where: "nick", page.author | first %}
+            <p class="post__meta__divider">·</p>
+            <div class="post__meta__author">
+                <p>by </p>
+                <img class="post__meta__author__photo" src="{{ site.url }}/{{ author.photo_dir }}"/>
+                <p>{{ author.full_name }}</p>
+            </div>
+        {% endif %}
+    </div>
+
+    {% if page.prevPart != nil or page.nextPart != nil %}
+        <div class="post__navigator">
+            <div
+                class="post__navigator__buttons"
+                {% if page.prevPart == nil %}
+                    style="justify-content: flex-end;"
+                {% endif %}
+            >
+                {% if page.prevPart != nil %}
+                    <a href="{% link {{ page.prevPart }} %}">
+                        <img  class="arrow-left" src="{{ site.url }}/assets/img/icons/arrow_left.svg"/>
+                        Previous
+                    </a>
+                {% endif %}
+                {% if page.nextPart != nil %}
+                    <a href="{% link {{ page.nextPart }} %}">
+                        Next
+                        <img class="arrow-right" src="{{ site.url }}/assets/img/icons/arrow_right.svg"/>
+                    </a>
+                {% endif %}
+            </div>
+        </div>
+    {% endif %}
+
+    <div class="post__content">
+        {{ content }}
+    </div>
+</article>

data/_plugins/button.rb

@@ -0,0 +1,26 @@
+module Jekyll
+    class ButtonTagBlock < Liquid::Block
+  
+        def initialize(tag_name, text, tokens)
+            super
+            @input = text
+        end
+
+        def render(context)
+            
+            input_split = split_params(@input)
+            theme = input_split[0].strip
+            link = input_split[1].strip
+            icon = input_split[2].strip
+
+            text = super
+            "<div class='sx-button'><a href='#{link}' class='sx-button__content #{theme}'><img src='#{icon}'/>#{text}</a></div>"
+        end
+
+        def split_params(params)
+            params.split("|")
+        end
+    end
+end
+  
+Liquid::Template.register_tag('button', Jekyll::ButtonTagBlock)

data/_sass/_feed.scss

@@ -20,12 +20,19 @@
             flex-direction: column;
         };
 
+        color: var(--c-feed-title);
+
         text-align: center;
         padding: 0 2rem;
+        margin-bottom: 2rem;
         min-width: 80%;
 
         h1{
             margin: 1rem 0 0 0;
+
+            @include for-size('tablet'){
+                margin: 0;
+            }
         }
     }
 
@@ -42,12 +49,12 @@
             height: 100%;
             margin: 1rem 0;
             padding: 1rem 2rem;
-            box-shadow: inset 0px 0px 14px -4px rgba(0, 0, 0, 0);
+            box-shadow: inset 0px 0px 14px -4px var(--c-snippetShadow);
             transition: $t-smooth;
 
             &:hover{
                 transform: scale(.99);
-                box-shadow: inset 0px 0px 14px -4px rgba(0,0,0,0.5);
+                box-shadow: inset 0px 0px 14px -4px var(--c-snippetShadowHover);
             }
         }
 
@@ -71,6 +78,24 @@
                 &__category{
                     text-transform: uppercase;
                     margin: 0;
+                    @include flexbox;
+
+                    &__title{
+                        color: var(--c-noCategoryText);
+                        background: var(--c-noCategoryBackground);                        
+                        padding: .2rem .5rem;
+                    }
+
+                    
+                    @include for-size('tablet'){
+                        flex-direction: column;
+
+                        p{
+                            text-align: center;
+                            width: 100%;
+                            margin: 0;
+                        }
+                    }
                 }
 
                 &__date{
@@ -89,6 +114,7 @@
             
             &__header{
                 margin: 1rem 0 0 0;
+                color: var(--c-articleHeading);
 
                 @include for-size('tablet'){
                     margin: 1rem 0 0 0;
@@ -98,12 +124,14 @@
 
             &__text{
 
+                color: var(--c-snippetHeading);
                 margin: 1rem 0 0 0;
             }
 
             &__author{
 
                 margin: 1.5rem 0 0 0;
+                color: var(--c-snippetAuthor);
 
                 @include flexbox{
                     flex-direction: row;

data/_sass/_footer.scss

@@ -7,6 +7,8 @@
 
     @include flexbox;
     padding: 1rem 0 0 0;
+    margin-top: auto;
+    color: var(--c-footerText);
 
     &__about{
 
@@ -35,6 +37,7 @@
                 height: 1.25rem;
                 margin: 0 .5rem;
                 transition: $t-smooth;
+                filter: var(--c-footerImageFilter);
 
                 &:hover{
                     transform: scale(1.05) rotate(-5deg);