classic-jekyll-theme 1.5.1 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8fc15b1ba5e37d61cab92b5c30dfc75e5205e362
-  data.tar.gz: 7979390e9d4f62b1e5289bfd217428afc868202c
+  metadata.gz: 8d66db088a87b5e5e94c949c041b975572b3cb5b
+  data.tar.gz: 5b7eaf91abf6a65c5d88865cd0b120ee3c6ce581
 SHA512:
-  metadata.gz: c3e714b17448884535a14789800e812c44e82333ebc60cc4d0dbd441e03042b49f2b5bd9da2220d80a03d776b94ec0f945a4f74b8ed4fa1542af3cce50af63d2
-  data.tar.gz: 727410b2e57ad4815905073aa9fe4b64937bd6f688e73e2503997b63946a3719acb7b10f086d0c39fa56eddafdf166a8057270422526238fedf1376598d4d8c0
+  metadata.gz: b06a89f85a6772beafe7fca4cc1ab94a8c3c3ce38acd4bcc6f9b3cd8f4aef69a3686556ad8abe7c2487683e46ebb9af289d98382cb3f648d91bc532eb2f2331c
+  data.tar.gz: df298a8486a0a696d78a9ca42295d4c507af39234f7be898516bb6da3463e4f8b3d972958df6d94d67232289d5da2696fab5e4762515846b48574e31f0a97357

data/README.md

@@ -1,4 +1,4 @@
-# Classic-Jekyll-Theme v1.5.1
+# Classic-Jekyll-Theme v1.5.2
 
 Welcome to Classic-Jekyll-Theme. This theme centers around one of the most used website structures on the web. A banner, navigation menu, (up to) three columns and a footer. The design is fully responsive for three different screen widths: wide, medium and narrow. It is probably best shown in an example:
 
@@ -48,6 +48,8 @@ Other features:
 
 - __Normalize.css__ As of release 1.5.0 [`normalize.css`](https://necolas.github.io/normalize.css/) is used directly instead of through the Jekyll adaptation. This allows for faster upgrade cycles.
 
+- __Excerpt on pages__ Pages defining an explicit "excerpt" in their YAML will use this as the description for the header description meta tag (necessary for SEO purposes). Note that Jekyll does not generate excerpt information for pages, only posts. Hence it is necessary to define the excerpt as a YAML tag.
+
 You can get it from [github](https://github.com/Swiftrien/classic-jekyll-theme) or [rubygems](https://rubygems.org/gems/classic-jekyll-theme).
 
 Subscribe to news about this theme (be informed of new releases) by sending a mail to: rien@balancingrock.nl with the subject "classic".
@@ -229,6 +231,17 @@ To create a page that must be included in the menu bar, add the following front
 
 For a consistent user experience in the narrow layout, it is recommened not to link pages to top level menu items if these menu items have a drop-down submenu.
 
+## Specifying html header description meta tag content for pages
+
+The "description" meta tag is possibly the most important SEO information that we can put in our pages. It shows up as the "description" for a link in search engines. Jekyll does support this as the "excerpt" tag in YAML front matter. And if the "excerpt" is not defined, Jekyll will grab the first part of the post as its description. However, for pages there was no such support. As of verion 1.5.2 this theme adds a limited form of this support. If a page defines an excerpt in its YAML front matter, that excerpt information will be used as the information in a description meta tag.
+
+	---
+	...
+	excerpt: "Up to 160 characters can be used to provide a text for the description meta tag"
+	---
+
+Note that the "excerpt_separator" does *not* work on pages, only posts.
+
 ## Editing the secondary and tertiary columns
 
 The prime column is populated by the 'normal' pages and posts. The secondary and tertairy columns have a fixed content that is created by directly editing the `_include/secondary-column.html` and `_include/tertiary-column.html`. These files must be copied from the gem dictionary to the directory with the jekyll files for the website at the path `_include`.
@@ -320,6 +333,9 @@ Release 1.5.1
 
 - Removed some non-ascii characters in the comments of `_sass/classic-jekyll-theme`.
 
+Release 1.5.2
+
+- Added excerpt for pages. YAML only, no support for excerpts generated from the main content.
 
 ## Upgrade information
 
@@ -454,6 +470,10 @@ The index for a menu item. If not present, the menu ordering is undetermined. If
 - Update the version number in the `Gemfile` & delete the `Gemfile.lock` file.
 - Remove the ≡ , ⇨ and ⇩ characters from the `_sass/classic-jekyll-theme.scss` file to prevent future problems. (If you had problems, you have already removed them...)
 
+### from 1.5.1 to 1.5.2
+
+- Update the version number in the `Gemfile` & delete the `Gemfile.lock` file.
+- If the (undocumented) 'description' YAML tag was used, it must be changed to 'excerpt'.
 
 ## Feedback
 

data/_includes/head.html

@@ -4,7 +4,9 @@
   <meta name="viewport" content="width=device-width, initial-scale=1">
 
   <title>{% if page.title %}{{ page.title | escape }}{% else %}{{ site.title | escape }}{% endif %}</title>
-  <meta name="description" content="{{ page.excerpt | default: site.description | strip_html | normalize_whitespace | truncate: 160 | escape }}">
+
+  {% if page.excerpt %}{% assign description = page.excerpt %}{% else %}{% assign description = site.description %}{% endif %}
+  <meta name="description" content="{{ description | strip_html | normalize_whitespace | truncate: 160 | escape }}">
 
   <link rel="stylesheet" href="{{ "/assets/main.css" | relative_url }}">
   <link rel="canonical" href="{{ page.url | replace:'index.html','' | absolute_url }}">

data/_sass/classic/_support.scss

@@ -1,10 +1,15 @@
 // This file contains class definitions for support of page and post layout. The classes are intended to be used in the markdown files as follows:
 //
+// ![image-name](image-source){:.image-centered}
+//
+// Or:
+//
 // ^
 // {:.text-boxed-float-left}
 // This is the text that will be in the box on the left hand side.
 // ^
 //
+// Note: The second method will not always work for images! For images, follow the image with a class definition.
 
 // text centered in a column
 .text-centered {

data/pages/about/about.md

@@ -5,7 +5,7 @@ menuInclude: yes
 menuLink: yes
 menuTopTitle: About
 menuTopIndex: 100
-description: A short introduction to the content of this site.
+excerpt: A short introduction to the content of this site.
 # end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
 ---
 

data/pages/classic/categories.md

@@ -5,8 +5,7 @@ date: 2016-11-04
 menuInclude: yes
 menuTopTitle: Classic
 menuSubTitle: "About Categories"
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 The "Categories" navigation menu is created automatically. However the website designer has to specify which categories must be included in the menu. This can be done by adding a page with the layout set to "category-page". This kicks off the creation of a page for the categorie specified in the `title` of that page's YAML matter.

data/pages/classic/classic.md

@@ -6,8 +6,7 @@ menuInclude: yes
 menuLink: yes
 menuTopTitle: Classic
 menuTopIndex: 2
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 The sub-pages contain some information about the "Classic-Jekyll-Theme", or "classic" in short.

data/pages/classic/known-problems.md

@@ -6,8 +6,7 @@ menuInclude: yes
 menuTopTitle: Classic
 menuSubTitle: "Known problems"
 menuSubIndex: 4
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 There is some odd behaviour in the navigation bar that I have not been able to nail down yet. It has to do with the space between top level menu items. There is some additional space that I am not able to trace down. For those who like a puzzle: there is some space around a ".navbanner-menu ul li" that has no obvious source. Please let me know if you happen to find where it comes from. (rien@balancingrock.nl)

data/pages/classic/pages.md

@@ -6,8 +6,7 @@ menuInclude: yes
 menuTopTitle: Classic
 menuSubTitle: "About Pages"
 menuSubIndex: 2
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 Pages in classic can be linked to from the navigation menu. To do so there are some additional YAML tags that help building the navigation menu.

data/pages/classic/posts.md

@@ -6,8 +6,7 @@ menuInclude: yes
 menuTopTitle: Classic
 menuSubTitle: "About Posts"
 menuSubIndex: 1
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 Posting in classic is identical to standard jekyll.

data/pages/contact/contact.md

@@ -4,8 +4,7 @@ title: Contact
 menuInclude: true
 menuTopTitle: Contact
 menuTopIndex: 99
-description: Contact information for this site.
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: Contact information for this site.
 ---
 
 Publish your contact information on this page.

data/pages/cookie-consent/cookie-consent.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Cookie policy
-description: Cookie policy information
+excerpt: Cookie policy information
 ---
 
 In compliance with EU law we inform you that this website uses cookies to etc etc.

data/pages/more/more.md

@@ -5,8 +5,7 @@ menuLink: no
 menuTopTitle: More
 menuTopIndex: 10
 menuSubTitle: More of anything
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 More of anything.

data/pages/other/example-page.md

@@ -6,8 +6,7 @@ menuInclude: yes
 menuTopTitle: Other
 menuSubTitle: The menu title
 menuSubIndex: 1
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 Example content.

data/pages/other/other.md

@@ -4,8 +4,7 @@ menuInclude: yes
 menuLink: yes
 menuTopTitle: Other
 menuTopIndex: 3
-description: A description can be up to 156 characters long...
-# end of description at 156 characters ----------| (last 3 chars will be replaced by '...' on overflow)
+excerpt: "An excerpt is used as the page description and can be up to 160 characters long..."
 ---
 
 just some text

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: classic-jekyll-theme
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.5.2
 platform: ruby
 authors:
 - Rien
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-12-24 00:00:00.000000000 Z
+date: 2017-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll-feed
@@ -166,7 +166,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: A responsive 3 column Jekyll theme for wide, medium and narrow displays.