jekyll-theme-editorial 1.0.5 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9c036c2011c5a7a035a3f2837e5417985ca08b45f86eb3f019ef49f0e3e9b71
-  data.tar.gz: b3822cd7ea020d8e262f2a410c04082d95638aeded04fad82a592f7b042940e0
+  metadata.gz: 35a176b8f2ff001b1a27a292dd19b85037aa5a04af8200b9f6d2e3773f3ae0aa
+  data.tar.gz: 072a4dbd98ac269aac446f68c4eecbffffc79e51aef15c184d921069c3742d1a
 SHA512:
-  metadata.gz: 3ea4ad4bb31c514d4946c22b7b1bd4aa14ff3456f9624c15650b5c91ce6fa3151798071b3d76cee0990c646955540907396a923a5a7aaf79b60c7e790d75e5db
-  data.tar.gz: aa14d2af956d281867fa265021f9aebe34f75e08cc54306db52b46edec5b83c83c072355febfbf4370aa04b5fc176a4dd000385920bcf9ec23f18623e5cf4cd0
+  metadata.gz: bfd768be320f4bd7d986ce7f50f097b0cb06a6f4ffba2f285b31f2fc6ac1e841dfeda6e98956f58c2d1ecec17e26869944aa4d355b4e7aace5c0a0f51a7a6f06
+  data.tar.gz: 07e6be2cf3736bc4eea152defe10c39d6983e20083d125b20b0c0297ec1f4c940fabd93275e75aeb877b9729fdd0141ec9f0b888ad41a5cd5012b6379c2f32cf

data/README.md

@@ -1090,7 +1090,7 @@ collections:
 ```
 
 #### People page defaults
-We'll also need to add some page defaults to the `_config.yml` file for people pages, under the `defaults` key:
+We'll also need to add some page defaults to the `_config.yml` file for people pages, under the `defaults` key that we defined earlier:
 
 ```yaml
   - scope:
@@ -1137,7 +1137,7 @@ permalink:        /people/    # trailing slash makes it an `index.html` file ins
 ---
 
 {% if site.show.authors-%}
-  {% assign peeps = site.collections | find: "label", 'people'-%}
+  {% assign peeps = site.collections | where: "label", 'people' | first-%}
   {% if peeps.output-%}
     <p>Our wonderful authors love to share tales of wonder and zeal. Sometimes they go overboard and fall into the waters of silliness or cynicism. We hope you do understand, and take that into the highest consideration.</p>
     <hr class="major"/>
@@ -1160,9 +1160,277 @@ If all went well, you should be able to refresh the ugly people index listing an
 
 ### Add Authors to our lone post
 
+Now let's add an author or two to our lone post, so we can see author bylines and related posts on author pages. Add the follow yaml front matter to your `_posts/20yy-mm-dd-welcome-to-jekyll.md` file:
+
+```yaml
+author:           [julia, petunia]
+```
+
+Let's also remove the `layout: post` entry while we're at it, since the layout is set by the site config defaults to `post` already. The edited front matter should look like:
+
+```yaml
+---
+title:            "Welcome to Jekyll!"
+author:           [julia, petunia]
+date:             2020-08-01 11:48:57 -0700
+categories:       jekyll update
+tags:             [jekyll, meta, technology, code, site, editorial theme]
+---
+```
+
+Now refresh our lone post, and we should now see a byline with julia and petunia listed as authors. Julia should even be conveniently linked to her author page (and only her, because petunia is not yet published). If you navigate to her author page, you'll now see our one post listed under her "Authored Posts" section.
+
+#### Add Author cards to posts
+
+Instead of only linking to author pages, we can also show author cards at the bottom of posts, and link those to full author pages. To do so, we need to add a `post_authors` configuration key to `_config.yml` under the `show` key:
+
+```yaml
+show:                                         # series of switches to customize what appears on the site
+  authors:          true                      # single author blogs may want to disable showing the same author everywhere
+  post_authors:     true                      # you may still want to show the author(s) at the bottom of posts
+```
+Now restart our Jekyll server since we changed our site config, and refresh the post page to see the changes. You'll notice two author cards, one each for julia and petunia, at the bottom of the post. Our byline now helpfully links down to those author cards instead of directly to the author pages. The cards link to the full author pages instead. Notice that petunia's card doesn't link, since she's unpublished, and therefore doesn't have an author page yet.
+
 ### Add Projects
 
-TODO
+Projects are just another type of collection that are neither date-based posts nor people. You can use them for any kind of collection you'd like, visually renaming the collection to something more suitable to your purposes, even if the theme calls the collection "projects" internally. We'll largely go through the same steps as adding people.
+
+#### Set up the Projects collection
+As with the people collection, configure Jekyll in the `_config.yml` file to output our projects collection:
+
+```yaml
+###################
+# Collections
+###################
+collections:
+  people:
+    output:         true
+  pages:
+    output:         true
+  projects:                 # find/put projects in `\_projects`
+    output:         true
+```
+Now we have three entries&mdash;one each for people, pages, and projects&mdash;under the `collections` key in our `_config.yml` file.
+
+#### Project page defaults
+Let's add in the relevant page defaults to the `_config.yml` file under the `defaults` key we defined earlier:
+
+```yaml
+  - scope:
+      path:         ""
+      type:         "projects"
+    values:
+      layout:       "project"
+      menus:        'projects'                # used by jekyll-menus plugin
+      type:         "projects"
+      image_path:   "/assets/images/"
+      comments:     false
+      published:    false
+```
+
+#### Create some projects
+As before, nothing will have changed at this point until we add some projects. We'll again just copy them from the Editorial theme gem rather than create them from scratch. If necessary, use `bundle info` again to find the theme gem from which to copy the `_projects` folder with its 4 project files inside into your site folder:
+
+```sh
+:~/my-jekyll-site$ bundle info --path jekyll-theme-editorial
+```
+Then, after you save the `_config.yml` file, restart, and refresh the browser, you should see three new menu items under "Projects" in the menu sidebar for the added project pages (as with authors, the 4th is unpublished). By the way, now that we have some projects, we're showing their mini-post cards in the sidebar as well!
+
+
+### Add the Projects index page
+
+Similar to what we did with authors, we'll use the theme's `projects.html` include to list out standard project blocks for the projects index page. We set the page's `permalink` in the front matter to `/projects/` so that it overrides the ugly default HTML index page. If there are no published projects, we'll just show a little message stating as much. Save this file as `_pages/projects.html` (not to be confused with `_includes/projects.html` which is provided by the Editorial theme gem).
+
+```liquid
+---
+title:            Projects
+date:             2020-03-01 01:23:45 -0800
+permalink:        /projects/
+---
+
+<p>These projects are the bomb. Well, not really a bomb, but <em>da bomb</em>, y'know, like awesome but more explosive or something. Anyway check em out and make happy noises <em>en masse</em>.</p>
+
+{% include projects.html %}
+```
+Now you can click on "Projects" in the sidebar menu and hopefully see a nicely formatted list of the 3 published projects. You can toggle the `published` status of the fourth project to see that one as well.
+
+#### Toggle summaries and dates for project pages
+
+Our sample project pages have extended summaries which we'd like to show. At the same time, our projects index page is displaying a page creation date that looks odd in the upper right corner of page content area. We can fix both via two site configuration settings in `_config.yml`:
+
+```yaml
+include_summary:    [projects]                # collections for which to show the summary in the header
+exclude_dates:      [people, pages]           # collections for which to not show dates in the header
+```
+Add these two lines to `_config.yml` and restart Jekyll to see the date disappear on the projects index page (which is part of the `pages` collection, not the `projects` colllection) and summaries on each of the individual published project pages (which *are* part of the `projects` collection). While we're at it, we removed publication dates from people pages too.
+
+#### Add Author cards to projects
+
+Like posts, we can show author cards at the bottom of projects, and link those to the full author pages. To do so, we'll add a `project_authors` configuration key to `_config.yml` under the `show` key:
+
+```yaml
+show:                                         # series of switches to customize what appears on the site
+  authors:          true                      # single author blogs may want to disable showing the same author everywhere
+  post_authors:     true                      # you may still want to show the author(s) at the bottom of posts
+  page_authors:     true                      # you may still want to show the author(s) for pages
+  project_authors:  true                      # you may still want to show the author(s) for projects
+```
+While here, we also added the `page_authors` key. Note that no pages so far have authors defined in their front matter, so you shouldn't see authors on any pages in the pages collection. This is only for pages you explicily want authors to show, by including them in the front matter. Restart the Jekyll server and refresh any published project page to see author cards at the bottom.
+
+### Post decorations
+
+Posts can be decorated with more than the titles, authors, body content, tags, and categories we've seen so far. The Editorial theme supports an array of images, metadata, and supplementary fields to make your posts. Let's pull up the relevant `_sample` file, `post-template.md` to get an overview:
+
+```yaml
+---
+# defaults assumed for these jekyll variables: layout, permalink, published, excerpt
+# name the file similar to title (slugified - replace spaces with underscores & remove punctuation)
+title:            ""                          # used in the page/post header, HTML title, menus & SEO
+subtitle:         ""                          # optional; shown under the page/post header
+author:           []                          # use the handle of the author, not their name
+date:             2020-01-01 00:00:00 -0800   # publication date; overrides the file save date
+last_modified_at:                             # optional; date to show in addition to/in place of create date
+categories:       []                          # choose one best category, ideally
+tags:             []                          # choose 3-7 tags, ideally
+series:           "Build a blog"              # optional; use `series` to group posts and show a sidebar of posts in the series (limited to 1 for now)
+location:         "New York, NY"              # optional; location where the post was made
+website:          https://example.com/        # optional; external, related website, possibly featured
+image:            ""                          # default image for SEO & jekyll-feed
+images:                                       # all images are optional; banner and either default or thumbnail are recommended
+  default:                                    # general-use size, default for lists if no thumbnail
+    file:         ""                          # no path, just the filename (e.g., "my great image.png")
+                                              # default images generally use the default image texts, but can be specified here
+  banner:                                     # largest, full-page width landscape at top of page
+    file:         ""                          # no path, just the filename (e.g., "my great image.png")
+    alt_text:     ""                          # describe the image for screen readers
+    caption:      ""                          # optional explanatory text, can be used for attributions
+    title:        ""                          # optional; usually shown as a tooltip on hover
+  thumbnail:                                  # smaller image for lists/grids (like index pages)
+    file:         ""                          # no path, just the filename (e.g., "my great image.png")
+                                              # thumbnails generally use the default image texts, but can be specified here
+# these texts are defaults for all images in the images array, if not individually specified:
+  alt_text:       ""                          # describe the image for screen readers
+  caption:        ""                          # optional explanatory text, can be used for attributions
+  title:          ""                          # optional; usually shown as a tooltip on hover
+canonical_url:    ""                          # optional; customize the canonical URL for this page
+lang:             ""                          # optional; language for the page, `en_US` by default
+description:      ""                          # optional; short description of the page's content used for SEO
+# NOTE that the first paaragraph below is the excerpt, if no excerpt is defined here in the front matter.
+---
+```
+
+#### Adding textual elements
+We'll first start by adding some textual elements, like subtitle and location. Add the following to our blog post's front matter:
+
+```yaml
+subtitle:         "How Jekyll Makes It All So Easy!"
+location:         "San Francisco, CA"
+website:          https://jekyllrb.com/docs/home
+description:      Let's make sure Google and company know enough about this page that it will pop up higher in search results
+```
+Refresh our blog post page, and you should see the page title is now linked (visually indicated with a superscripted link icon), a subtitle under it, and the location listed in the byline. The description field is purely for <abbr title="Search Engine Optimization">SEO</abbr> purposes, and can only be seen by viewing the source of the page (in the HTML HEAD section).
+
+#### Adding a post to a series
+
+Sometimes you want to group a few posts together as a series of posts in a way that's unsuitable for tags or categories. You can do this grouping with series. It's a single title for the series, like "Build a blog", that must be the exact same for each post you want grouped together. In fact, let's add this exact series to our lone blog post. Add the following line to the blog post's front matter:
+
+```yaml
+series:           "build-a-blog"
+```
+Now refresh the blog post page in your browser and you should see a new series sidebar appear on the right. Note that you don't have to "slugify" the series name. This sames series name just happens to be that way.
+
+### Adding a post image
+
+The Editorial theme, like many blog themes, features a prominent banner image for most pages, including blog posts. To define this images, we have a few different methods. We'll go through them from simplest to most flexible.
+
+#### The Simplest, but least flexible, way to add an image
+
+Because many Jekyll themes will simply use an `image` key in the post front matter, the Editorial theme includes this option as a backwards compatibility measure. We'll use the [Jekyll logo](https://jekyllrb.com/img/logo-2x.png) as a convenient sample image. Be sure to save this image file to your site's `/assets/images/` folder (creating these folders along the way, if necessary), which is the theme-wide default location for image assets. Then add the following to our blog post's front matter:
+
+```yaml
+image:            "logo-2x.png"
+```
+Save the changes and then refresh our blog post page to see a nice, and possibly blurry (due to its lower resolution), Jekyll logo pop up as a banner image on the post.
+
+#### Adding alt text, title, and caption
+
+Because HTML images have some textual metadata often attached to them, the Editorial theme introduces these extra fields for the common image metadata in the post's front matter:
+
+```yaml
+alt_text:         "The Jekyll logo, featuring stylized script and a test tube filled with red, bubbling liquid"
+image_title:      "The Jekyll logo is so cool!"
+caption:          "Jekyll lets you create static websites quickly and easily!"
+```
+Add these lines, save, and refresh the page, and you should see a caption added to the bottom of the logo.
+
+#### A more flexible middle option for images
+
+One problem you might recognize right away is that this method only ever allows one image per post. What if you what 2 different sizes, like a thumbnail and a high resolution version? Our Editorial theme handles this with a slightly more complex yaml structure (replace the *four* previous lines with this):
+
+```yaml
+images:
+  default:
+    file:         "logo-2x.png"
+  alt_text:       "The Jekyll logo, featuring stylized script and a test tube filled with red, bubbling liquid"
+  title:          "The Jekyll logo is so cool!"
+  caption:        "Jekyll lets you create static websites quickly and easily!"
+```
+or alternatively,
+
+```yaml
+images:
+  default:        "logo-2x.png"
+  alt_text:       "The Jekyll logo, featuring stylized script and a test tube filled with red, bubbling liquid"
+  title:          "The Jekyll logo is so cool!"
+  caption:        "Jekyll lets you create static websites quickly and easily!"
+```
+
+You can even mix and match the prior two styles, for backwards compatibility:
+
+```yaml
+image:            "logo-2x.png"
+images:
+  alt_text:       "The Jekyll logo, featuring stylized script and a test tube filled with red, bubbling liquid"
+  title:          "The Jekyll logo is so cool!"
+  caption:        "Jekyll lets you create static websites quickly and easily!"
+```
+
+#### The most flexible option for images
+
+The prior structure sets us up to be able to add a few different versions of the image (`default`, `banner`, and `thumbnail`):
+
+```yaml
+images:
+  default:
+    file:         "pic02.jpg"
+  banner:
+    file:         "logo-2x.png"
+  thumbnail:
+    file:         "pic06.jpg"
+    alt_text:     "A thumbnail version of the Jekyll logo, featuring stylized script and a red-liquid-filled test tube"
+    title:        "Read more about how to use Jekyll!"
+  alt_text:       "The Jekyll logo, featuring stylized script and a test tube filled with red, bubbling liquid"
+  title:          "The Jekyll logo is so cool!"
+  caption:        "Jekyll lets you create static websites quickly and easily!"
+```
+
+You'll notice that you can customize the metadata for each image along with the image file itself. Now if you save and then navigate to the posts index page (clicking "All Posts" in the post nav area or "Recent Posts" in the sidebar menu), you should notice the thumbnail image is different and has different hover text from that on the post page.
+
+#### Missing image
+
+Note that if you happen to misspell the name of your image in the front matter config, you'll get a helpful "Missing image" message with the file name and image title in a box instead of the image that Jekyll couldn't find during build.
+
+### Multiple posts and post navigation
+
+To see post navigation in action, we'll need more than one post to navigate to. Rather than making up a bunch of posts, we'll simply copy sample posts from the theme gem, as we've done for other demo content. Remember to `bundle info` to find the theme gem folder:
+
+```sh
+:~/my-jekyll-site$ bundle info --path jekyll-theme-editorial
+```
+And then copy the posts in the `_posts` directory from the theme gem to your site directory's `_posts` folder. Refresh the browser and see these new posts show up in the sidebar menu. You should also see a "previous" post navigation link (likely to the "Look at my great tatoos everybody!" post) at the top and bottom of the post content. You'll also notice that our "Welcome to Jekyll!" post now has some sibling posts in the "Build A Blog" series of posts. Finally, a set of "Latest Posts" (or "Related Posts" if you have Jekyll's `site.related_posts` LSI functionality enabled, which is not supported by the Github Pages build process) will show up below the post author(s).
+
+Clicking around the "Archives", "Categories", and "Tags" pages, not to mention author pages and the home page, will now show more post-related content as well.
+
 
 ## Setup Notes
 

data/_config.yml

@@ -24,6 +24,7 @@ timezone:           America/Los_Angeles       # set this to a standardized TZ na
 date_format:                                  # optional; set the way dates are formatted throughout the site - see https://ruby-doc.org/core/Time.html#method-i-strftime
 
 
+
 ###################
 # Build settings
 ###################

data/_includes/articles.html

@@ -18,7 +18,7 @@ local:
 {%-assign list_limit  = include.list_limit      | default: site.related_posts_limit | default: 6-%}
 
 {%-case article_type-%}
-  {%-when 'posts'-%}          {%-assign articles  = site.posts          | where: 'author', page.handle | default: site.posts-%}
+  {%-when 'posts'-%}          {%-if page.handle != empty and page.handle != "" and page.handle != nil-%}{%-assign articles  = site.posts | where: 'author', page.handle-%}{%-else-%}{%-assign articles = site.posts-%}{%-endif-%}
   {%-when 'related_posts'-%}  {%-assign articles  = site.related_posts  | where: 'author', page.handle | default: site.related_posts-%}
   {%-when 'projects'-%}       {%-assign articles  = site.projects       | where: 'author', page.handle | default: site.projects-%}
   {%-when 'authors'-%}        {%-assign articles  = site.people         | where: 'author', page.handle | default: site.posts-%}
@@ -33,10 +33,14 @@ local:
     <h2>{{-include.section_title | default: "Articles"-}}</h2>
   </header>
   <div class="{{-article_type }} posts">
+{%-if articles != empty-%}
   {%-for article in articles limit:list_limit-%}
   {%-unless article.published == false-%}
     {% include article.html %}
   {%-endunless-%}
   {%-endfor-%}
+{%-else-%}
+  <article class="post-card">Looks like there are no {{ include.section_title | default: "Articles" }} here yet!</article>
+{%-endif-%}
   </div>
 </section>

data/_includes/author.html

@@ -16,9 +16,9 @@ local:
   auth                    the author's handle, included only on authored pages;
                           `auth` also determines the `authored` boolean value
 {%-endcomment-%}
-{%-assign peeps       = site.collections | find: "label", 'people'-%}
-{%-assign next_post   = site.posts | find_exp: 'item', "item.author contains auth and item.url != page.url" %}
-{%-assign authored    = !!auth-%}
+{%-assign peeps       = site.collections | where: "label", 'people' | first-%}
+{%-assign next_post   = site.posts | where_exp: 'item', "item.author contains auth" | where_exp: 'item', "item.url != page.url" | first %}
+{%-if auth != empty and auth != "" and auth != nil-%}{%-assign authored = true-%}{%-else-%}{%-assign authored = false-%}{%-endif-%}
 {%-if include.show_next == false %-}{%-assign show_next = false-%}{%-else-%}{%-assign show_next = true-%}{%-endif-%}
 {%-if include.show_social == false %-}{%-assign show_social = false-%}{%-else-%}{%-assign show_social = true-%}{%-endif-%}
 <!-- Author - {{ author.handle | default: auth }} -->

data/_includes/authors.html

@@ -8,7 +8,7 @@
               <hr class="sigil"/>
               {%-endif %}
           {%-for auth in page.author %}
-            {%-assign author = site.people | find: 'handle', auth-%}
+            {%-assign author = site.people | where: 'handle', auth | first-%}
             {%-if author.published %}
               {% include author.html %}
             {%-else-%}

data/_includes/authors_byline.html

@@ -20,9 +20,12 @@ local:
 {%-endcomment-%}
 
 {%-assign authors       = include.author        | default: page.author-%}
-{%-assign peeps         = site.collections      | find: "label", 'people'-%}
+{%-assign peeps         = site.collections      | where: "label", 'people' | first-%}
 
-{%-if site.show.post_authors and page.type=="posts"-%}
+{%-if site.show.authors and include.page_type=="index"-%}
+  {%-assign show_authors      = true-%}
+  {%-assign has_author_cards  = false-%}
+{%-elsif site.show.post_authors and page.type=="posts"-%}
   {%-assign show_authors      = true-%}
   {%-assign has_author_cards  = true-%}
 {%-elsif site.show.project_authors and page.type=="projects"-%}
@@ -35,6 +38,9 @@ local:
     {%-assign show_authors    = false-%}
   {%-endif-%}
   {%-assign has_author_cards  = false-%}
+{%-elsif site.show.authors-%}
+  {%-assign show_authors      = true-%}
+  {%-assign has_author_cards  = false-%}
 {%-else-%}
   {%-assign show_authors      = false-%}
   {%-assign has_author_cards  = false-%}
@@ -43,16 +49,16 @@ local:
             {%-if site.show.authors and show_authors-%}
                 <ul class="inline csv authors">
               {%-for slug in authors-%}
-                {%-assign author      = site.people | find: 'handle', slug-%}
+                {%-assign author      = site.people | where: 'handle', slug  | first-%}
                 {%-assign author_name = author.name | default: slug-%}
                 {%-if author.published and has_author_cards %}
-                  <li><a href="#{{-author.handle-}}" class="p-author" title="Read {{ author.handle-}}'s excerpt below">{{-author_name-}}</a></li>
+                  <li><a href="#{{-author.handle-}}" class="p-author" itemprop="author" title="Read {{ author.handle-}}'s excerpt below">{{-author_name-}}</a></li>
                 {%-elsif author.published and peeps.output-%}
-                  <li><a href="{{-author.url-}}" rel="author" class="p-author u-author" title="Read {{ author.handle-}}'s bio">{{-author_name-}}</a></li>
+                  <li><a href="{{-author.url-}}" rel="author" class="p-author u-author" itemprop="author" title="Read {{ author_name | split: ' ' | first-}}'s bio">{{-author_name-}}</a></li>
                 {%-elsif author.published-%}
-                  <li class="p-author">{{-author_name-}}</li>
+                  <li class="p-author" itemprop="author">{{-author_name-}}</li>
                 {%-elsif has_author_cards %}
-                  <li><a href="#{{-slug-}}" class="p-author" title="Read {{ slug-}}'s excerpt below">{{-slug-}}</a></li>
+                  <li><a href="#{{-slug-}}" class="p-author" itemprop="author" title="Read {{ slug-}}'s excerpt below">{{-slug-}}</a></li>
                 {%-else-%}
                   <li class="p-author">{{-slug-}}</li>
                 {%-endif-%}

data/_includes/banner.html

@@ -1,10 +1,17 @@
-{%-assign static_file_names = site.static_files | map: 'name'-%}
-            {%-if static_file_names contains page.image or static_file_names contains page.images.banner.file or static_file_names contains page.images.default.file or static_file_names contains page.images.file %}
+{%-assign static_file_names = site.static_files           | map: 'name'-%}
+{%-assign banner_image      = page.images.banner.file     | default: page.images.banner           | default: page.images.default.file | default: page.images.default | default: page.image-%}
+{%-assign banner_alt_text   = page.images.banner.alt_text | default: page.images.default.alt_text | default: page.images.alt_text     | default: page.alt_text-%}
+{%-assign banner_title      = page.images.banner.title    | default: page.images.default.title    | default: page.images.title        | default: page.image_title-%}
+{%-assign banner_caption    = page.images.banner.caption  | default: page.images.default.caption  | default: page.images.caption      | default: page.caption-%}
+
+{%-if static_file_names contains banner_image %}
             <!-- Banner Image -->
             <figure class="image main">
-              <img src="{{-page.image_path-}}{{-page.image | default: page.images.banner.file | default: page.images.default.file-}}" title="{{-page.images.banner.title | default: page.images.default.title | default: page.images.title | default: page.image_title-}}" alt="{{-page.images.banner.alt_text | default: page.images.default.alt_text | default: page.images.alt_text | default: page.alt_text-}}"/>
-              {%-if page.caption or page.images.banner.caption or page.images.default.caption or page.images.caption or page.caption %}
-              <figcaption>{{-page.images.banner.caption | default: page.images.default.caption | default: page.images.caption | default: page.caption | markdownify-}}</figcaption>
-              {%-endif %}
+              <img src="{{-page.image_path-}}{{-banner_image-}}" title="{{-banner_title-}}" alt="{{-banner_alt_text-}}"/>
+            {%-if banner_caption %}
+              <figcaption>{{-banner_caption | markdownify-}}</figcaption>
+            {%-endif %}
             </figure>
-            {%-endif %}
+{%-else %}
+            <figure class="box"><h3>Missing image</h3>{{-banner_image-}}<br>{{-banner_title-}}</figure>
+{%-endif %}

data/_includes/mini-posts.html

@@ -1,5 +1,5 @@
-{%-assign published_projects  = site.projects           | where: 'published', true -%}
-{%-assign project_menu        = site.data.menus.sidebar | find: 'identifier', 'projects' -%}
+{%-assign published_projects  = site.projects           | where: 'published', true-%}
+{%-assign project_menu        = site.data.menus.sidebar | find: 'identifier', 'projects'-%}
 {%-if published_projects != empty %}
           <!-- Section - Mini-posts -->
           <section>

data/_includes/post_header.html

@@ -1,5 +1,5 @@
 <!-- Post Header -->
-{%-assign peeps           = site.collections      | find: "label", 'people'-%}
+{%-assign peeps           = site.collections      | where: "label", 'people' | first-%}
 {%-assign authors         = include.author        | default: page.author-%}
 {%-assign page_title      = include.page_title    | default: page.title-%}
 {%-assign subtitle        = include.subtitle      | default: page.subtitle-%}

data/_includes/posts.html

@@ -1,5 +1,5 @@
-{%-assign peeps         = site.collections      | find: "label", 'people'-%}
-{%-assign placeholder   = site.static_files     | find: 'name', 'placeholder.png'-%}
+{%-assign peeps         = site.collections      | where: "label", 'people' | first-%}
+{%-assign placeholder   = site.static_files     | where: 'name', 'placeholder.png' | first-%}
 {% if paginator.posts != nil and site.paginate %}
   {% assign posts       = paginator.posts %}
 {% elsif page.layout == "page" %}
@@ -35,7 +35,7 @@
                   <p class="byline">
                   {%-if site.show.authors-%}
                     {%-for auth in post.author-%}
-                      {%-assign author = site.people | find: 'handle', auth-%}
+                      {%-assign author = site.people | where: 'handle', auth | first-%}
                       {%-if author.published and peeps.output-%}
                         <a href="{{-author.url-}}" rel="author" itemprop="author" class="u-author p-author" title="Read {{ author.name | split: ' ' | first-}}'s bio">{{-author.name-}}</a>
                       {%-elsif author.published-%}

data/_includes/project.html

@@ -0,0 +1,57 @@
+{%-comment-%}
+lists a project as a section card given a project hash
+
+inputs:
+  project                 the project to render
+dependencies:
+  site.show.authors       used to determine whether to show authors
+  site.show.project_authors used to determine whether to show authors
+  site.title              used to determine whether to show separator
+local:
+  modified_date           the proejct's modification date, if any, that differs from project.date
+{%-endcomment-%}
+
+          {%-if project.published %}
+            <article itemid="{{-project.url|absolute_url-}}" class="h-entry project-card row gtr-50 gtr-uniform" itemscope itemtype="http://schema.org/Article">
+            {% if project.images-%}
+              <div class="col-4 col-12-small">
+                <figure>
+                  <a href="{{-project.url-}}" class="image fit" title="Learn more about '{{-project.title-}}'">
+                    {% include item_image.html-%}
+                  </a>
+                </figure>
+                <div class="snug smaller categories">{%-include categories.html %}</div>
+              {%-if project.series %}
+                <div class="snug series" title="This project is part of a series">{{ project.series | replace: '-',' ' |  split: " " | join: "-----" | camelcase | split: "-----" | join: " "-}}</div>
+              {%-endif %}
+              </div>
+            {%-endif %}
+              <div class="col-8 col-12-small">
+                {%-assign modified_date = project.modified_date | default: project.last_modified_at-%}
+              {%-if modified_date-%}
+                {% include date_modified.html item_date=modified_date lead_in='last modified: '-%}
+              {%-endif %}
+                <header class="tight">
+                  <span class="header-aside">{% include item_date.html %}</span>
+                  <h3><a href="{{-project.url-}}" itemprop="name" class="u-url p-name" title="Learn more about '{{-project.title-}}'">{{-project.title-}}</a></h3>
+                  <p class="subtitle p-subtitle" itemprop="alternativeHeadline">{{-project.subtitle-}}</p>
+                  {%-if site.show.project_authors and site.show.authors and project.author or project.location-%}
+                  <div class="byline">
+                    {% include authors_byline.html page_type="index" author=project.author-%}
+                    {%-if project.location-%}
+                    {% if project.author or site.title-%}{{-" | "-}}{%-endif %}
+                    <span class="p-location" itemprop="location" title="Post location">{{-project.location-}}</span>
+                    {%-endif %}
+                  </div>
+                  {%-endif-%}
+                </header>
+                {% if include.summary or project.summary or project.excerpt-%}
+                <div class="summary p-summary" itemprop="abstract">
+                {{-include.summary | default: project.summary | default: project.excerpt | markdownify-}}
+                </div>
+                {%-endif %}
+                {%-include tags.html %}
+              </div>
+            </article>
+            <hr class="major"/>
+          {% endif %}

data/_includes/projects.html

@@ -1,88 +1,22 @@
 {%-comment-%}
 lists projects as section cards given a projects hash
 
-inputs:                   none
-dependencies:
+inputs:
   projects                the projects to render
+dependencies:
   site.projects           used as the default if `projects` isn't available already
-  site.static_files       lookup and make sure a placeholder.png file exists
-  site.show.authors       used to determine whether to show authors
-  site.show.project_authors used to determine whether to show authors
-  site.people             lookup authors in the people array
-  site.title              use as the author, as a last resort
+  page.layout             used to see if projects should be set to site.projects
 local:
   projects                default to site.projects if not already provided
   published_projects      projects filtered for `published==true`
-  placeholder             placeholder.png file to use in case no other page image is available
-  auth                    the author's handle, used for unpublished authors in place of their name
-  author                  the looked-up author in site.people
 {%-endcomment-%}
 
-{%-if page.layout == "page"-%}
-  {%-assign projects          = site.projects-%}
-{%-endif-%}
-{%-assign published_projects  = projects          | where: 'published', true-%}
+{%-if page.layout == "page"-%}{%-assign projects = site.projects-%}{%-endif-%}
+{%-assign published_projects = projects | where: 'published', true-%}
 
       {%-if published_projects != empty %}
         {%-for project in published_projects %}
-          {%-if project.published %}
-            <article itemid="{{-project.url|absolute_url-}}" class="h-entry project-card row gtr-50 gtr-uniform" itemscope itemtype="http://schema.org/Article">
-            {% if project.images-%}
-              <div class="col-4 col-12-small">
-                <figure>
-                  <a href="{{-project.url-}}" class="image fit" title="Learn more about '{{-project.title-}}'">
-                    {% include item_image.html-%}
-                  </a>
-                </figure>
-                <div class="snug smaller categories">{%-include categories.html %}</div>
-              {%-if project.series %}
-                <div class="snug series" title="This project is part of a series">{{ project.series | replace: '-',' ' |  split: " " | join: "-----" | camelcase | split: "-----" | join: " "-}}</div>
-              {%-endif %}
-              </div>
-            {%-endif %}
-              <div class="col-8 col-12-small">
-                {%-assign modified_date = project.modified_date | default: project.last_modified_at-%}
-              {%-if modified_date-%}
-                {% include date_modified.html item_date=modified_date lead_in='last modified: '-%}
-              {%-endif %}
-                <header class="tight">
-                  <span class="header-aside">{% include item_date.html %}</span>
-                  <h3><a href="{{-project.url-}}" itemprop="name" class="u-url p-name" title="Learn more about '{{-project.title-}}'">{{-project.title-}}</a></h3>
-                  <p class="subtitle p-subtitle" itemprop="alternativeHeadline">{{-project.subtitle-}}</p>
-                  {%-if site.show.project_authors and site.show.authors and project.author or project.location-%}
-                  <p class="byline">
-                  {%-if site.show.authors %}
-                    {%-for auth in project.author-%}
-                      {%-assign author = site.people | find: 'handle', auth-%}
-                      {%-if author.published and author.url-%}
-                        <a href="{{-author.url-}}" rel="author" itemprop="author" class="u-author p-author" title="Read {{ author.name | split: ' ' | first-}}'s bio">{{-author.name-}}</a>
-                      {%-elsif author.published-%}
-                        <span itemprop="author" class="p-author">{{-author.name-}}</span>
-                      {%-else-%}
-                        <span itemprop="author" class="p-author">{{-auth-}}</span>
-                      {%-endif-%}
-                      {%-unless forloop.last %}, {% endunless-%}
-                    {%-else-%}
-                      <span itemprop="author" class="p-author">{{-site.title-}}</span>
-                    {%-endfor-%}
-                    {%-if project.location and project.author or site.title-%}{{-"&nbsp; | &nbsp;"-}}{%-endif-%}
-                  {%-endif %}
-                    {%-if project.location %}
-                    <span class="p-location" itemprop="location" title="Post location">{{-project.location-}}</span>
-                    {%-endif %}
-                  </p>
-                  {%-endif-%}
-                </header>
-                {% if include.summary or project.summary or project.excerpt-%}
-                <div class="summary p-summary" itemprop="abstract">
-                {{-include.summary | default: project.summary | default: project.excerpt | markdownify-}}
-                </div>
-                {%-endif %}
-                {%-include tags.html %}
-              </div>
-            </article>
-            <hr class="major"/>
-          {% endif %}
+          {% include project.html %}
         {% endfor %}
       {% else %}
             <h2>Oof!</h2>

data/_includes/responsive_banner.html

@@ -3,18 +3,31 @@ uses parent page settings or a special parent page.banner hash for more flexibil
 (parent) page: [title, subtitle, description, etc.]
   banner: [header, subheader, content, etc.]
 {%-endcomment-%}
+
+{%-assign static_file_names = site.static_files     | map: 'name'-%}
+{%-assign banner_header   = page.banner.header      | default: page.title                   | default: site.title-%}
+{%-assign banner_subheader= page.banner.subheader   | default: page.subtitle                | default: site.tagline-%}
+{%-assign banner_content  = page.banner.content     | default: page.description             | default: site.description-%}
+{%-assign banner_image    = page.banner.image       | default: page.images.banner.file      | default: page.images.banner           | default: page.images.default.file | default: page.images.default | default: page.image-%}
+{%-assign banner_alt_text = page.banner.alt_text    | default: page.images.banner.alt_text  | default: page.images.default.alt_text | default: page.images.alt_text     | default: page.alt_text-%}
+{%-assign banner_title    = page.banner.image_title | default: page.images.banner.title     | default: page.images.default.title    | default: page.images.title        | default: page.image_title-%}
+
 <section id="banner">
         <div class="content">
           <header>
-            <h1>{{-page.banner.header   | default: page.title     | default: site.title-}}</h1>
-            <p>{{-page.banner.subheader | default: page.subtitle  | default: site.tagline-}}</p>
+            <h1>{{-banner_header-}}</h1>
+            <p>{{-banner_subheader-}}</p>
           </header>
-          <p>{{-page.banner.content   | default: page.description | default: site.description-}}</p>
+          <p>{{-banner_content-}}</p>
           <ul class="actions">
             <li><a href="{{-page.banner.url | default: site.url-}}" title="{{-page.banner.link_title-}}" class="button big">{{-page.banner.button_text-}}</a></li>
           </ul>
         </div>
+      {%-if static_file_names contains banner_image %}
         <figure class="image object">
-          <img src="{{-site.image_path-}}{{-page.banner.image | default: page.images.banner.file | default: page.images.banner | default: page.image-}}" alt="{{-page.banner.alt_text | default: page.images.banner.alt_text | default: page.images.alt_text | default: page.alt_text-}}" title="{{-page.banner.image_title | default: page.images.banner.title | default: page.images.title | default: page.image_title-}}"/>
+          <img src="{{-site.image_path-}}{{-banner_image-}}" alt="{{-banner_alt_text-}}" title="{{-banner_title-}}"/>
         </figure>
-</section>
+      {%-else %}
+        <figure class="box"><h3>Missing image</h3>{{-banner_image-}}<br>{{-banner_title-}}</figure>
+      {%-endif %}
+      </section>

data/_layouts/post.html

@@ -18,13 +18,14 @@ layout:           default
           {%-if site.show.post_authors and page.author %}
             {% include authors.html %}
           {%-endif %}
-          {% if site.disqus.shortname-%}
+          {% if page.comments == true and site.disqus.shortname-%}
             <hr class="major"/>
             {% include disqus_comments.html %}
-          {%-endif-%}
-          {% if page.comments == true-%}
+          {%-elsif page.comments == true-%}
             <hr class="major"/>
             {% include comments.html %}
+          {%-else-%}
+            <br>
           {%-endif %}
             <a class="u-url" href="{{-page.url | relative_url-}}" hidden></a>
           </article>

data/_pages/people.html

@@ -7,7 +7,7 @@ excerpt:          ""
 ---
 
 {% if site.show.authors-%}
-  {% assign peeps = site.collections | find: "label", 'people'-%}
+  {% assign peeps = site.collections | where: "label", 'people' | first-%}
   {% if peeps.output-%}
     <p>Our wonderful authors love to share tales of wonder and zeal. Sometimes they go overboard and fall into the waters of silliness or cynicism. We hope you do understand, and take that into the highest consideration.</p>
     <hr class="major"/>

data/assets/images/index.html

@@ -0,0 +1,4 @@
+---
+---
+
+{% include 404.html %}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-editorial
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.10
 platform: ruby
 authors:
 - Middle Bear
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-03 00:00:00.000000000 Z
+date: 2020-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -143,6 +143,7 @@ files:
 - _includes/post_header.html
 - _includes/post_nav.html
 - _includes/posts.html
+- _includes/project.html
 - _includes/projects.html
 - _includes/responsive_banner.html
 - _includes/scripts.html
@@ -236,6 +237,7 @@ files:
 - assets/css/github.css
 - assets/css/main.css
 - assets/css/user.css
+- assets/images/index.html
 - assets/images/logo.png
 - assets/images/pic01-thumb.jpg
 - assets/images/pic01.jpg