bulma-clean-theme 0.11.2 → 0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e73c0bc32284ba14dbc9140134ba444c925da1a007ab5e44d07a0abd182d2edf
-  data.tar.gz: 6d3b5013b5b3b8964b601a09e9415b42bf4639572d0ed794344a1f5767ea42f8
+  metadata.gz: 411147a7d028879cd29523fb38f6df85bcaaa60dbd1f32f56720d9f8b51bf988
+  data.tar.gz: 59c0abdb9a67097f3e5e0d71a2ef264300ac958d90e65a44efbd4c752d0fb060
 SHA512:
-  metadata.gz: b62f80990e5da94b2c305ee434b9bcd63b44b869fbd2726f63eb834db19deb18b2f1abc456333123e43fb1157b79fcc2ae94ddfe7684ea6ce78ed2a20a5de462
-  data.tar.gz: 3bb1ad05c7dfc05f41946910ceb01c9d732d28b4e044fa970c59ac3963f1203b7ee7afb755742f57f9436ab1e9e5148057db762fd966d5e2a6d88b2b967f24a7
+  metadata.gz: 00f7bb88affdc05ec4244e3d00bfbaa0b513df006ac9103c24ac6ff05cf544511742407e399c8da0826ecef690e58e71bd4405c8df16ea9f2881260148ac61a8
+  data.tar.gz: 307d0c09cb5290057a5ca47f687a24a91372478c91b9e9dcc4761925aea6b43ee05a6e9aa041c8b2d4535f920903a1fa559c19aad653a0b4618b5f13bbe56476

data/README.md

@@ -16,6 +16,8 @@ The theme uses [Alpine.js](https://github.com/alpinejs/alpine) for its interacti
         * [Page Hero](#page-hero)
         * [Table Of Contents](#table-of-contents)
     * [Posts](#posts)
+        * [Post Excerpt and Summary](#post-excerpt-and-summary)
+        * [Series](#series)
     * [Navigation](#navigation)
     * [Colours and Styles](#colours-and-styles)
     * [Sidebar Visibility](#sidebar-visibility)
@@ -119,6 +121,55 @@ summary: |-
     It can be in **Markdown format** if required.
 ```
 
+#### Series
+
+From version 0.12, you can now make a post a part of a series of posts, linking to the other posts in the series, by creating a `series` data file and then setting the series in each of the post's front matter.
+
+The current post in the list is highlighted to help give context of where you are in the series.
+
+##### Blog Series Data File
+
+Start by creating a yml file in the _data directory, for example `my_blog_series.yml`. Give the series a title and, optionally, a description.
+
+##### Sections
+
+Next add sections. Each section can have a label (optional) and items. Each item is the title of an existing blog post. If the title is not found then the link will be empty.
+
+If you just want one list without labels, then omit the label and just add the items.
+
+```yaml
+title: The series title
+sections:
+  - items:
+      - title: Why use a static site generator
+      - title: Getting started with Bulma Clean Theme for Jekyll
+```
+
+Here is a full example with multiple sections with labels.
+
+```yaml
+title: The series title
+description: The series description text
+sections:
+  - label: The first section
+    items:
+      - title: Why use a static site generator
+      - title: Getting started with Bulma Clean Theme for Jekyll
+  - label: Another section
+    items:
+      - title: Introducing some new layouts to Bulma Clean Theme
+      - title: Creating a docs site with Bulma Clean Theme
+      - title: Creating a post series
+```
+
+##### Update your posts
+
+Finally, add the series setting to your front matter in each post you want the series to show in.
+
+```yaml
+series: my_blog_series
+```
+
 #### Social Share Buttons
 
 Share buttons will be displayed on your posts unless you hide them by adding `hide_share_buttons: true` to your config file.

data/_includes/series.html

@@ -0,0 +1,32 @@
+{% assign series = site.data.[page.series] %}
+{% assign posts = site.posts %}
+
+<p class="title is-5 is-spaced">{{ series.title }}</p>
+
+{% if series.description %}
+    <p>{{ series.description }}</p>
+{% endif %}
+
+{% for section in series.sections %}
+
+{% if section.label %}
+    <p class="title is-6">{{ section.label }}</p>
+{% endif %}
+
+<ul class="block-list is-small is-outlined">
+    {% for item in section.items %}
+        {% assign post = posts | where: "title", item.title %}
+
+        {% if page.url == post[0].url %}
+            <li class="is-highlighted is-dark">
+                <p>{{ item.title }}</p>
+            </li>
+        {% else %}
+            <li>
+                <a href="{{ site.baseurl }}{{ post[0].url }}" class="is-flex" >{{ item.title }}</a>
+            </li>
+        {% endif %}
+
+    {% endfor %}
+</ul>
+{% endfor %}

data/_layouts/post.html

@@ -6,6 +6,10 @@ layout: default
 
     <p>Published: {{ page.date | date: "%b %-d, %Y" }} by {{ page.author }}</p>
 
+    {% if page.series %}
+        {% include series.html %}
+    {% endif %}
+
     {{ content }}
 </div>
 

data/_posts/2021-10-30-creating-a-post-series.md

@@ -0,0 +1,59 @@
+---
+layout: post
+title: Creating a post series
+description: How to create a post series with Bulma Clean Theme
+date: 2021-10-30 09:00:07
+hero_image: /bulma-clean-theme/img/blog-post-series.jpg
+image: /bulma-clean-theme/img/blog-post-series.jpg
+hero_height: is-large
+hero_darken: true
+tags: bulma-clean-theme jekyll blog
+series: example_blog_series
+---
+
+From version 0.12, you can now make a post a part of a series of posts, linking to the other posts in the series, by creating a `series` data file and then setting the series in each of the post's front matter.  
+
+The current post in the list is highlighted to help give context of where you are in the series. 
+
+## Blog Series Data File
+
+Start by creating a yml file in the _data directory, for example `my_blog_series.yml`. Give the series a title and, optionally, a description. 
+
+## Sections
+
+Next add sections. Each section can have a label (optional) and items. Each item is the title of an existing blog post. If the title is not found then the link will be empty.
+
+If you just want one list without labels, then omit the label and just add the items. 
+
+```yaml
+title: The series title
+sections:
+  - items:
+      - title: Why use a static site generator
+      - title: Getting started with Bulma Clean Theme for Jekyll
+```
+
+Here is a full example with multiple sections with labels.
+
+```yaml
+title: The series title
+description: The series description text
+sections:
+  - label: The first section
+    items:
+      - title: Why use a static site generator
+      - title: Getting started with Bulma Clean Theme for Jekyll
+  - label: Another section
+    items:
+      - title: Introducing some new layouts to Bulma Clean Theme
+      - title: Creating a docs site with Bulma Clean Theme
+      - title: Creating a post series
+```
+
+## Update your posts
+
+Finally, add the series setting to your front matter in each post you want the series to show in. 
+
+```yaml
+series: my_blog_series
+```

data/node_modules/.package-lock.json

@@ -0,0 +1,26 @@
+{
+  "name": "bulma-clean-theme",
+  "version": "1.0.0",
+  "lockfileVersion": 2,
+  "requires": true,
+  "packages": {
+    "node_modules/bulma": {
+      "version": "0.9.3",
+      "resolved": "https://registry.npmjs.org/bulma/-/bulma-0.9.3.tgz",
+      "integrity": "sha512-0d7GNW1PY4ud8TWxdNcP6Cc8Bu7MxcntD/RRLGWuiw/s0a9P+XlH/6QoOIrmbj6o8WWJzJYhytiu9nFjTszk1g=="
+    },
+    "node_modules/bulma-block-list": {
+      "version": "0.5.0",
+      "resolved": "https://registry.npmjs.org/bulma-block-list/-/bulma-block-list-0.5.0.tgz",
+      "integrity": "sha512-M5IXvvLtU5AjWIhRnYK7ZpNnJ1zEHe+25EnE2jBfpoXQDjVTsHRDfAsMXTyE7TA0FX1OBdVWL8A+ejQ7oSbIQw==",
+      "dependencies": {
+        "bulma": "^0.8.0"
+      }
+    },
+    "node_modules/bulma-block-list/node_modules/bulma": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/bulma/-/bulma-0.8.2.tgz",
+      "integrity": "sha512-vMM/ijYSxX+Sm+nD7Lmc1UgWDy2JcL2nTKqwgEqXuOMU+IGALbXd5MLt/BcjBAPLIx36TtzhzBcSnOP974gcqA=="
+    }
+  }
+}