bulma-clean-theme 0.5.8 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e069b6f5f4713ef53a9c89a4e07354aac95fca301a373de6093198b775d29f18
-  data.tar.gz: dde5ae8ba40555625f418a87cfe97f4cf50a025883027edae3c120899b3e1eea
+  metadata.gz: e5cc9861987c14401d52c7673310e32769691eab6c94d2dfbe5cc4cd81533063
+  data.tar.gz: 81d8d92d6e0108d9cf0c7463a0b911bcd99893839ad08373f82a77bf022263f0
 SHA512:
-  metadata.gz: 1dac119dc60f87b25792e3c8684f37ffb35e91cb8ef19e0ac74be6205a7ab9b31533d1462241a1849ca75cd9139d924bc3f5dc00557d324c78460a4aa5fd6317
-  data.tar.gz: 185cd417afa785a674734f415aec7f7f352c2a09ba20ac8d6fd321b5029f94ce82fb1eac222e8006eb6087c8c1dad18c643a38a931ee32ca12eade09c4033e3e
+  metadata.gz: 03c3570fb2a58d5f918a968531a8382d6c262c522626755acb6516179ea90a77fadb982cb7fa12669115986b28c4e4042289e7b1124f0a032bea00b9e9da6e94
+  data.tar.gz: 3d037f5529f0156239de5006b2ab4ad399fef1cbec0563adccd6c8543c42c2eed906cc689123b8c58838c9d0a5cc3cb6ab62e0f0738e956f559075d3b7e7b7e6

data/README.md

@@ -24,6 +24,7 @@ This is a clean and simple Jekyll Theme built with the [Bulma](https://bulma.io/
     * [Scripts](#scripts)
     * [Callouts](#callouts)
     * [Favicon](#favicon)
+    * [Showcases](#showcases)
 * [Contributing](#contributing)
 * [Development](#development)
 * [Licence](#licence)
@@ -79,6 +80,13 @@ If you want to display a table of contents (toc) then add `toc: true` to your pa
 
 If you want posts, create a `_posts` directory to store your posts as per normal Jekyll usage, with the `layout: post`. Next create a `blog` directory with an index.html file that has `layout: blog`
 
+Set the paginate and the paginate_path up in the `_config.yaml` to configure the posts per page and the blog pagination path.
+
+```yaml
+paginate: 5
+paginate_path: "/blog/page:num"
+```
+
 **New in 0.2** It will now display an image in the blog page if you set `image: /path/to/image.jpg` in your post's or page's front matter, or in the [defaults](https://jekyllrb.com/docs/configuration/front-matter-defaults/) in your sites `_config.yml`
 
 You can also set the height of the hero by providing a Bulma hero height class in your front matter, such as `hero_height: is-fullwidth`. If you do not provide this, it will revert to is-medium
@@ -398,6 +406,52 @@ callouts: example_callouts
 
 The default favicon path is `{{ site.baseurl }}/favicon.png` but you can overwrite it in the sites `_config.yml` like this `favicon: /path/to/favicon.png`
 
+### Showcases
+
+Showcases allow you to display your work to others using a simple layout. 
+
+#### Creating A Showcase Datafile
+
+Create a datafile in your sites `_data` directory in the following format. Subtitle, features and tags are not required. 
+
+The description text accepts markdown and is run through the markdownify filter on the page.
+
+The image_ratio will default to is-16by9 if it is not defined and accepts the [Bulma image](https://bulma.io/documentation/elements/image/) classes.
+
+```yaml
+intro: |-
+  This is some introduction text for the showcases.
+  
+  ## Example Heading
+  It can convert markdown format
+
+items:
+  - title: Example showcase item
+    subtitle: Example subtitle
+    description: |-
+      This is the example description for this item that you are showcasing and has an image, title, description, tags and a link.
+    features:
+      - This is a feature
+      - This is a feature
+    image: https://via.placeholder.com/1024x788
+    image_ratio: is-16by9
+    link: http://www.example.com
+    link_text: View example
+    tags: PHP,CSS,JavaScript
+```
+
+#### Displaying the Showcase
+
+Set the showcase in the page's front matter to be the name of the showcase data file without the extension. This gives you the ability to create multiple showcases to be used on different pages. 
+
+```yaml
+title: Showcase
+subtitle: An example showcase page
+layout: page
+showcase: showcase_example
+show_sidebar: false
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/chrisrhymes/bulma-clean-theme. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

data/_includes/showcase.html

@@ -0,0 +1,48 @@
+{% if page.showcase %}
+    {% assign showcase = site.data.[page.showcase] %}
+
+    <div class="content">
+        <p>{{ showcase.intro | markdownify }}</p>
+    </div>
+
+    {% for showcase in showcase.items %}
+        <section class="showcase">
+            <figure class="image {% if showcase.image_ratio %} {{ showcase.image_ratio }} {% else %} is-16by9 {% endif %}">
+                <img src="{{ showcase.image | prepend: site.baseurl }}" />
+            </figure>
+            <div class="showcase-content">
+                <div class="columns is-centered">
+                    <div class="column is-8-desktop is-12-tablet">
+                        <p class="title">{{ showcase.title }}</p>
+                        <p class="subtitle">{{ showcase.subtitle }}</p>
+                        <div class="content">
+                            <p>{{ showcase.description | markdownify }}</p>
+
+                            {% if showcase.features %}
+                            <div class="showcase-features">
+                                {% for feature in showcase.features %}
+                                <div class="showcase-feature">{{ feature }}</div>
+                                {% endfor %}
+                            </div>
+                            {% endif %}
+                        </div>
+
+                        {% if showcase.tags %}
+                        {% assign tags = showcase.tags | split: "," %}
+                        <div class="tags is-centered">
+                            {% for tag in tags %}
+                            <div class="tag is-dark">{{ tag }}</div>
+                            {% endfor %}
+                        </div>
+                        {% endif %}
+
+                        <a href="{{ showcase.link }}" class="button is-primary">
+                            {{ showcase.link_text }}
+                        </a>
+                    </div>
+                </div>
+
+            </div>
+        </section>
+    {% endfor %}
+{% endif %}

data/_layouts/default.html

@@ -24,6 +24,7 @@
                 {% endif %}
                 <div class="column {{ content_width }}">
                     {% include tabs.html %}
+                    {% include showcase.html %}
                     {{ content }}
                 </div>
                 {% if site.posts and page.show_sidebar %}

data/_sass/_main.scss

@@ -9,4 +9,5 @@ $tabs-link-active-border-bottom-color: $primary;
 
 @import "../node_modules/bulma/bulma.sass";
 @import "layout";
-@import "syntax";
+@import "syntax";
+@import "showcase";

data/_sass/_showcase.scss

@@ -0,0 +1,15 @@
+.showcase {
+    margin-bottom: 3rem;
+    box-shadow: $box-shadow;
+
+    &-content {
+        padding: 1.5rem;
+        text-align: center;
+    }
+
+    &-feature {
+        background: $light;
+        margin-bottom: 0.2rem;
+        padding: 0.5rem;
+    }
+}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bulma-clean-theme
 version: !ruby/object:Gem::Version
-  version: 0.5.8
+  version: '0.6'
 platform: ruby
 authors:
 - chrisrhymes
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-19 00:00:00.000000000 Z
+date: 2019-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -159,6 +159,7 @@ files:
 - _includes/post-card.html
 - _includes/rating.html
 - _includes/review.html
+- _includes/showcase.html
 - _includes/tabs.html
 - _includes/toc.html
 - _layouts/blog.html
@@ -172,6 +173,7 @@ files:
 - _posts/2019-07-23-introducing-some-new-layouts-to-bulma-clean-theme.markdown
 - _sass/_layout.scss
 - _sass/_main.scss
+- _sass/_showcase.scss
 - _sass/syntax.scss
 - assets/css/app.scss
 - assets/js/app.js