jekyll-theme-editorial 1.0.6 → 1.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 713298d11a3dd1673806658ae9ff4a70d1cbc83cfc06eb6cdf4dab8a9dc1b7f5
-  data.tar.gz: 2754deecdbd94222cab3cd46e20dca24cd7131402bff98a40ff04eccbcd06d1c
+  metadata.gz: 723032f0b04256a4ae75e2a54d43243e034b03fd8f5dd0c0eb658627d23a64cc
+  data.tar.gz: c6c57efc31b84092e942225095f8ec37468ceb4975a9a37490292005ee7e4b07
 SHA512:
-  metadata.gz: 15959920203a1ee93244e6180ed4f49dd84b536450b0073a55329dfcb53c34f398ab282ff4139debd9918f69e2272edb5404a502070157f5dbdc85f40fb41129
-  data.tar.gz: 5fc0545414c6335f2d571ce618c91ab66895c1859a4c7a80c1d11f6718989445b67712f31a91a5fb11097669bd91142a0ffef4f1b4d7c14aaa9381734bb57e42
+  metadata.gz: d43c437efa287ea3c593d290952eba986c3133454bd1891c094042e565fac3801bd4ae1c492393b41673f1870620ba961ae424d5769df07c1be126f1ace9559e
+  data.tar.gz: caae30eff44c04d927640a4c230d485d9d2fbd062dffd9f629f7f5793c497bd2a86407e0b921382625dc65e81c253339a3d1e9d9a02bf398dd36e346907b3fe2

data/README.md

@@ -85,7 +85,7 @@ layout: home
 ---
 
 ```
-To replicate the basic theme home page, replace this file with the following:
+To replicate Editorial's theme home page, replace this file with the following:
 
 ```markdown
 ---
@@ -93,11 +93,11 @@ layout:               home
 body_class:           home
 title:                "Hi, I’m Editorial<br /> by HTML5 UP & Middle Bear"
 subtitle:             My overridden site.tagline
-description:          "Aenean ornare velit lacus, ac varius enim ullamcorper eu. Proin aliquam facilisis ante interdum congue. Integer mollis, nisl amet convallis, porttitor magna ullamcorper, amet egestas mauris. Ut magna finibus nisi nec lacinia. Nam maximus erat id euismod egestas. Pellentesque sapien ac quam. Lorem ipsum dolor sit nullam."
+description:          "Check out the Github repo for the Editorial theme, or take a look at the code for this demo site, <a href='https://github.com/jekyll-theme-editorial/jekyll-theme-editorial.github.io/'>jekyll-theme-editorial.github.io</a>."
 banner:
-  url:                "/about"
-  link_title:         "Read About Editorial"
-  button_text:        "Learn More"
+  url:                "https://github.com/middlebear/jekyll-theme-editorial"
+  link_title:         "Visit the Editorial theme Github repo"
+  button_text:        "Github Repo"
 images:
   banner:
     file:             "pic10.jpg"
@@ -106,7 +106,7 @@ images:
 # NOTE: features are set in `/_data/features.yml`
 ---
 
-<!-- Responsive Banner -->
+<!-- Banner -->
 {%-include responsive_banner.html-%}
 
 <!-- Section - Features -->
@@ -114,12 +114,11 @@ images:
 
 <!-- Section - Articles -->
 {%-include articles.html section_title="Neat Articles"-%}
-
 ```
 
-This adds three includes (`responsive_banner.html`, `features.html`, and `articles.html`) to the home page. The added yaml front matter is mainly there to configure the banner, although the `title` and `subtitle` keys can be used by the jekyll-seo-tag, for instance.
+This adds three includes (`responsive_banner.html`, `features.html`, and `articles.html`) to the home page. The added yaml front matter is mainly there to configure the banner, although the `title` and `subtitle` keys can be used by the `jekyll-seo-tag` plugin, for instance.
 
-This index page is the root page of your site by default, and uses the special `home` layout from the theme. The `home` layout is generally only used by this index page, so that your homepage can have a unique feel and design. If you wish to change this layout, copy the file `_layouts/home.html` from the theme gem (or copy/download it from the Github repository for the theme gem) to your site's `~/my-jekyll-site/_layouts/home.html` file.
+This index page is the root page of your site by default, and uses the special `home` layout from the Editorial theme. The `home` layout is generally only used by this site index page, so that your homepage can have a unique feel and design. If you wish to change this layout, copy the file `_layouts/home.html` from the theme gem (or copy/download it from the Github repository for the theme gem) to your site's `~/my-jekyll-site/_layouts/home.html` file.
 
 #### Aside: Finding the theme gem
 
@@ -170,6 +169,10 @@ scripts:                                      # these scripts entries can be mov
   - file: comments.js
 ```
 
+The Editorial theme convention is to keep image, script, and styling assets (as well as fonts) in separate subdirectories of the `/assets` directory, as defined by the three keys, `image_path`, `script_path`, and `style_path` above. You could set these to any paths you'd like (even setting them all to just `/assets/`), but remember that you'll need to move default assets from the theme gem into those folders, if you do make such changes.
+
+The `scripts` key is an (ordered) array of script includes for every page in the site (placed at the end of the <abbr>HTML</abbr> `<head>` tag). `jquery.min.js` is of course the [jQuery](https://jquery.com/) library. The next 4 files provide basic interactivity and originates from the Editorial template by HTML5 UP. `email-obfuscation.js` provides utility functions to obfuscate and de-obfuscate email addresses for some light protection against email scraping and spam. `comments.js` provides interactivity for ([staticman](https://staticman.net/)-based) static comments (like form positioning and async response notification). These latter features will be documented separately.
+
 #### Change the site title/subtitle
 
 The title and subtitle of the site is configured by the site's `_config.yml` file, since this is usually a one-time configuration at the start of creating your site. Find this line in `_config.yml`:
@@ -178,7 +181,7 @@ The title and subtitle of the site is configured by the site's `_config.yml` fil
 title: Your awesome title
 ```
 
-and change it as you wish. Notice that the subtitle doesn't appear anywhere in this file. That's because it's inherited from the Editorial theme's configuration file, when the value is absent in your site's config file. Add the following line (typically, you'd place this right under the `title` key to group these together), changing the value as you desire:
+and change it as you wish. Notice that the subtitle doesn't appear anywhere in this file (*if you're on Jekyll 4.0+*). That's because it's inherited from the Editorial theme's configuration file, when the value is absent in your site's config file. Add the following line (typically, you'd place this right under the `title` key to group these together), changing the value as you desire:
 
 ```yaml
 subtitle: by me and Middlebear
@@ -210,7 +213,10 @@ Features are simple components composed of an icon, a title, and some descriptiv
   icon: solid fa-gift
 ```
 
-Note that the `name` and `description` keys can incorporate html (but not Liquid filters/tags). The `icon` key is the class name(s) for the desired [Font Awesome](https://fontawesome.com/icons?d=gallery&m=free) icon. The free Font Awesome icons are divided into `regular`, `solid`, and `brand` variants. The `regular` icons need only a single class value (e.g., `fa-address-book`), but `solid` (e.g., `solid fa-address-book`) and `brand` (e.g., `brand fa-500px`) variants require adding `solid` or `brand` respectively to the class names for the `icon` key.
+Note that the `name` and `description` keys can incorporate <abbr title="HyperText Markup Language">HTML</abbr> (but not Liquid filters/tags).
+
+#### Using Font Awesome icon names
+The `icon` key is the class name(s) for the desired [Font Awesome](https://fontawesome.com/icons?d=gallery&m=free) icon. The free Font Awesome icons are divided into `regular`, `solid`, and `brand` variants. The `regular` icons need only a single class value (e.g., `fa-address-book`), but `solid` (e.g., `solid fa-address-book`) and `brand` (e.g., `brand fa-500px`) variants require adding `solid` or `brand` respectively to the class names for the `icon` key.
 
 Now refresh the home page again, and you should see the 4 features you added show up in the Features section.
 
@@ -252,7 +258,7 @@ sidebar:
     identifier: signin
 ```
 
-Note that, for compatibility, this is the same basic format employed by the [jekyll-menus plugin](https://github.com/forestryio/jekyll-menus) plugin. However, the Editorial theme's basic menu system doesn't use the `weight` key for ordering entries as `jeyll-menus` does.
+Note that, for compatibility, this is the same basic format (and file name) employed by the [jekyll-menus plugin](https://github.com/forestryio/jekyll-menus) plugin. However, the Editorial theme's basic menu system doesn't use the `weight` key for ordering entries as `jeyll-menus` does.
 
 Refresh the page, and you should now see the menu items populated under the "Menu" header. Since most of these pages don't yet exist at this point, they'll show the "404 Not Found" message.
 
@@ -406,9 +412,12 @@ Refreshing the page after saving this file should reveal a new set of social ico
 
 The introductory comments (text after `# `) provide configuration info for social icons. This list is used not only for the social icons in the site header, but also as templates for social links for people, posts, and pages elsewhere.
 
+### What about minima's `twitter_username` and `github_username`?
+Jekyll's default theme, minima, defines two social media keys in the default `_config.yml` file: `twitter_username` and `github_username`. These two keys are not used by the Editorial theme, so at this point, you can keep them for flexibility or remove them to keep your site config file trim.
+
 ### Add the Elements page
 
-To view the site styling elements on a single page, save the following content into `_pages/elements.html`:
+To view the site styling elements on a single page, save the following <abbr>HTML</abbr> content into `_pages/elements.html`:
 
 ```html
 ---
@@ -815,11 +824,11 @@ print 'It took ' + i + ' iterations to sort the deck.';
   </div>
 </div>
 ```
-To view the elements file in your browser, click the "Elements" link in the sidebar menu (`http://localhost:4000/elements`).
+This <abrr>HTML</abbr> comes from the underlying Editorial template from HTML5 UP, and demonstrates the built-in styles available. To view the elements file in your browser, click the "Elements" link in the sidebar menu (`http://localhost:4000/elements`).
 
 ### Add site defaults to make posts render properly
 
-Because of a slight mismatch between HTML5 UP's CSS in the original Editorial HTML template and the default body classes assigned by Jekyll, we need to adjust some sitewide defaults to make posts render correctly. Although these preferences are set in the theme gem's `_config.yml` file, Jekyll doesn't use those defaults as "default defaults", so they must be replicated in your own site's configuration.
+Because of a slight mismatch between HTML5 UP's <abbr title="Cascading Style Sheets">CSS</abbr> in the original Editorial <abbr>HTML</abbr> template and the default body classes assigned by Jekyll, we need to adjust some sitewide defaults to make posts render correctly. Although these preferences are set in the theme gem's `_config.yml` file, Jekyll doesn't use those defaults as "default defaults", so they must be replicated in your own site's configuration.
 
 With that in mind, add the following `defaults` key to you Jekyll site's `_config.yml` file:
 
@@ -848,15 +857,15 @@ defaults:
       comments:     false
       published:    true
 ```
-The only key of interest right now is `body_class` under the second entry's `values` key. This is set to `post` and will override jekyll's default body class of `posts`, giving us `<body class="post">` instead of `<body class="posts">` in the html of our post pages.
+The only key of interest right now is `body_class` under the second entry's `values` key. This is set to `post` and will override jekyll's default body class of `posts`, giving us `<body class="post">` instead of `<body class="posts">` in the <abbr>HTML</abbr> of our post pages.
 
-Restart the Jekyll server and navigate your browser to the "Welcome to Jekyll!" post (should have a URL along the lines of `http://localhost:4000/jekyll/update/20yy/mm/dd/welcome-to-jekyll.html`) to see it properly styled.
+Restart the Jekyll server and navigate your browser to the "Welcome to Jekyll!" post (should have a <abbr title="Uniform Resource Locator">URL</abbr> along the lines of `http://localhost:4000/jekyll/update/20yy/mm/dd/welcome-to-jekyll.html`) to see it properly styled.
 
 Notice also that the sidebar menu now lists the "Welcome to Jekyll!" post automatically under the "Recent Posts" menu item.
 
 #### Add the posts index page, and the pages collection
 
-To view a listing of posts once we have more than one, let's add a posts index page viewable at the relative URL `/posts/` in the browser. We employ a permalink and Jekyll's collections feature to achieve this desired routing. Create the page `~/my-jekyll-site/_pages/posts.html` (creating the `_pages` folder along the way if necessary):
+To view a listing of posts once we have more than one, let's add a posts index page viewable at the relative <abbr>URL</abbr> `/posts/` in the browser. We employ a permalink and Jekyll's collections feature to achieve this desired routing. Create the page `~/my-jekyll-site/_pages/posts.html` (creating the `_pages` folder along the way if necessary):
 
 ```html
 ---
@@ -871,6 +880,7 @@ permalink:        /posts/     # trailing slash makes it an `index.html` file ins
 {% include posts.html %}
 {% include pagination.html %}
 ```
+This page is fairly straightforward. The page header is already included by the layout (`page` by default, set below in `_config.yml`) automatically, so we only need to include an intro paragraph and the posts list, sandwiched by pagination at the top and bottom of the page. We won't see pagination in action until later, when we discuss it specifically.
 
 We also need to tell Jekyll to output collection pages, so add the `collections` key to `_config.yml`:
 
@@ -1090,7 +1100,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:
@@ -1121,11 +1131,11 @@ For the `authors` key under the `show` key in `_config.yml`, replace `false` wit
 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
 ```
-Restart the Jekyll server and click on the "People" link (which now has 3 sub-items too!) in the sidebar menu. Oops... you'll see an unstyled HTML listing page. We'll fix that next. In the meantime, you should be able to click on the three people listed to see their author pages. Why 3 and not 4? Because one of them is not yet published.
+Restart the Jekyll server and click on the "People" link (which now has 3 sub-items too!) in the sidebar menu. Oops... you'll see an unstyled <abbr>HTML</abbr> listing page. We'll fix that next. In the meantime, you should be able to click on the three people listed to see their author pages. Why 3 and not 4? Because one of them is not yet published.
 
 ### Add the Authors index page
 
-To provide a nice list of authors, we'll take advantage of the theme's `author.html` include, which provides a standard block list format for an author. We iterate through our `site.people` and generate this include for each published author. We set the pages `permalink` in the front matter to `/people/` so that it overrides the ugly HTML index page we saw earlier. Incidentally, if `site.show.authors` is set to `false`, then we'll just show a "404 Not Found" page instead.
+To provide a nice list of authors, we'll take advantage of the theme's `author.html` include, which provides a standard block list format for an author. We iterate through our `site.people` and generate this include for each published author. We set the pages `permalink` in the front matter to `/people/` so that it overrides the ugly <abbr>HTML</abbr> index page we saw earlier. Incidentally, if `site.show.authors` is set to `false`, then we'll just show a "404 Not Found" page instead.
 
 
 ```liquid
@@ -1166,7 +1176,7 @@ Now let's add an author or two to our lone post, so we can see author bylines an
 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 be,
+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
 ---
@@ -1178,9 +1188,265 @@ 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 <abbr>HTML</abbr> 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 <abbr>HTML</abbr> `<head>` section).
+
+#### The `last_modified_at` date and the `canonical_url`
+
+Note that we can also add an extra date on top of the explicitly set `date` field in the front matter, and Jekyll's implicitly-set post date from the file name (YYYY-MM-DD-filename.ext). When you update a post, you don't necessarily want to change its original post date, or implicitly change its (canonical) <abbr>URL</abbr> along with it.
+
+This is a good place to note that the `canonical_url` value is only used if the `jekyll-seo-tag` plugin is active, and it only changes the canonical <abbr>URL</abbr> `<link>` value in the <abbr>HTML</abbr> `<head>`, not the actual <abbr>URL</abbr> of the page (you'd still do this via the `permalink` key). Its use is for when the content of the page appears at multiple <abbr>URL</abbr>s, to denote the most original, or canonical, version of the page. Some site builders may want to explicitly display a link to the canonical version of the page, but the Editorial theme doesn't currently do this automatically for you when there is a `canonical_url` value present.
+
+#### 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 sample series name just happens to be that way, to show that series names are unslugified and capitalized on display. This is useful if you have multiple series with the same name, but don't want them all grouped together, by making the names unique using only dashes and capitalization to create the illusion of multiple series with the same name.
+
+### 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 <abbr>HTML</abbr> 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 on the rendered page with the file name and image title in a box instead of a broken/missing 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
 
@@ -1249,7 +1515,7 @@ If you want to link to your Github Pages site instead, you could, for instance,
 
 
 ##### Font Awesome Icons
-The `icon` entry is the Font Awesome icon to be used, expressed as CSS class(es). It's likely Font Awesome already has an existing brand icon for the social media site, in which case, keep the `brands` value in this class list. You should always keep the `icon` class in the `icon` entry, so the resultant icon is rendered consistently.
+The `icon` entry is the Font Awesome icon to be used, expressed as <abbr>CSS</abbr> class(es). It's likely Font Awesome already has an existing brand icon for the social media site, in which case, keep the `brands` value in this class list. You should always keep the `icon` class in the `icon` entry, so the resultant icon is rendered consistently.
 
 You can also add new entries, like for a fictitious WhatsIt App:
 
@@ -1310,7 +1576,7 @@ TODO
 TODO
 
 ### Banner
-One neat little trick buried in the CSS is the selective removal of `<br>` line breaks from the `h1` header of the `#banner` secion of a page. That's most prominently used on the sample home page, where there is a line break between "Editorial" and "by", which forces a particular spacing on large screens, where the header is beside the image, but gets removed on small (vertically-oriented) screens, where the header is below the image.
+One neat little trick buried in the <abbr>CSS</abbr> is the selective removal of `<br>` line breaks from the `h1` header of the `#banner` secion of a page. That's most prominently used on the sample home page, where there is a line break between "Editorial" and "by", which forces a particular spacing on large screens, where the header is beside the image, but gets removed on small (vertically-oriented) screens, where the header is below the image.
 
 ### Navigation
 The site navigation menu will auto-generate based on the contents of the `menus.yml` data file and the pages, posts, and projects you add to the site. By default, the menu will list the last 10 items for each type. It will also have links to each category page, a link to the tag index page, about, privacy, and terms.
@@ -1359,7 +1625,7 @@ Bug reports and pull requests are welcome on [GitHub](https://github.com/middleb
 The Editorial Jekyll theme is available as open source under the terms of the [CC BY 3.0 License](https://creativecommons.org/licenses/by/3.0/).
 
 ### [HTML5 UP](https://html5up.net) Credits
-* HTML template: [AJ](mailto:"AJ" <aj@lkn.io>) | [🐦](https://twitter.com/ajlkn)<br>  Free for personal and commercial use under the [CCA 3.0 license](https://html5up.net/license).
+* <abbr>HTML</abbr> template: [AJ](mailto:"AJ" <aj@lkn.io>) | [🐦](https://twitter.com/ajlkn)<br>  Free for personal and commercial use under the [CCA 3.0 license](https://html5up.net/license).
 * Demo Images: [Unsplash](unsplash.com)
 * Icons: [Font Awesome](fontawesome.io)
 * Other: [jQuery](jquery.com), [Responsive Tools](https://github.com/ajlkn/responsive-tools)

data/_config.yml

@@ -24,11 +24,14 @@ 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
 ###################
-theme:              jekyll-theme-editorial    # this theme! =)
-permalink:          /:collection/:title:output_ext  # NOTE: changing this default hasn't been tested
+theme:              jekyll-theme-editorial                      # this theme! =)
+remote_theme:       middlebear/jekyll-theme-editorial           # only needed on github pages, which automatically compiles jekyll for you
+# remote_theme:       middlebear/jekyll-theme-editorial@0.1.0   # to lock to a given version - https://github.com/benbalter/jekyll-remote-theme
+permalink:          /:collection/:title:output_ext              # NOTE: changing this default hasn't been tested
 # lsi:                true                      # provides related posts functionality using classifier-reborn - unsupported by github pages
 
 
@@ -95,7 +98,7 @@ analytics:
   goatcounter:                                # goatcounter for personal websites is free
     code:                                     # required if using goatcounter for stats; leave blank otherwise
     allow_local:    false                     # set `true` to test analytics locally, otherwise stats won't be sent from localhost to goatcounter
-staticman_url:      # https://{{bridge_app_name}}.herokuapp.com/v2/entry/{{github-username}}/{{blog-repo}}/{{branch}}/comments
+staticman_url:      # the URL for the staticman API bridge endpoint: https://{{bridge_app_name}}.herokuapp.com/v2/entry/{{github-username}}/{{blog-repo}}/{{branch}}/comments
 search:                                       # site search parameters; NOTE: untested for now
   url:                                        # default: "/search"; where the search form POSTs to
   form_method:                                # default: "post";    typically "post" or "get"--how the search form gets submitted
@@ -209,14 +212,6 @@ feed:
 jekyll-mentions:    /people
 
 
-###################
-# Remote Theme    - https://github.com/benbalter/jekyll-remote-theme
-#   only needed on github pages, which automatically compiles jekyll for you
-###################
-remote_theme:       middlebear/jekyll-theme-editorial
-# remote_theme:       middlebear/jekyll-theme-editorial@0.1.0   # to lock to a given version
-
-
 ###################
 # Jekyll Paginate - https://jekyllrb.com/docs/pagination/
 ###################

data/_data/menus.yml

@@ -16,10 +16,10 @@ sidebar:
     title:      Recent Posts
     identifier: posts
     weight:     20
-  # - url:        /archives
-  #   title:      Archives
-  #   identifier: archives
-  #   weight:     21
+  - url:        /archives
+    title:      Archives
+    identifier: archives
+    weight:     21
   - url:        /categories
     title:      Categories
     identifier: categories

data/_includes/archives_menu.html

@@ -1,6 +1,6 @@
 {%-assign archived = site.jekyll-archives.enabled-%}
 {%-if archived contains 'year' or archived contains 'month' or archived contains 'day'-%}
-  {%-assign archives_menu = site.data.navigation | find: "identifier", "archives"-%}
+  {%-assign archives_menu = site.data.navigation | where: "identifier", "archives"  | first-%}
   {%-assign posts_by_year = site.posts          | group_by_exp: "post", "post.date  | date: '%Y'"-%}
   {%-assign years         = posts_by_year       | map: 'name'-%}
   {%-assign firsts        = "1,21,31"           | split: ','-%}

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/contact.html

@@ -15,28 +15,29 @@
               {% elsif site.email and site.show.email_address-%}
               <li class="icon solid fa-envelope"><a href="mailto:{{-site.email-}}" class="u-email" title="{{-email_title-}}">{{-site.email-}}</a></li>
               {%-endif-%}
-              {% if site.contact.phone-%}
+              {% if site.contact.phone != blank-%}
               <li class="icon solid fa-phone p-tel">{{-site.contact.phone-}}</li>
               {%-endif-%}
-              {% if site.contact.address-%}
+              {% unless site.contact.address.line1 == blank and site.contact.address.line2 == blank and site.contact.address.line3 == blank and site.contact.address.city == blank and site.contact.address.state == blank and site.contact.address.zipcode == blank-%}
               <li class="icon solid fa-home p-adr h-adr">
                 <address>
-                  {% if site.contact.address.line1-%}
+                  {% if site.contact.address.line1 != blank-%}
                   <span class="p-street-address">{{ site.contact.address.line1 }}</span><br />
                   {%-endif-%}
-                  {% if site.contact.address.line2 or site.contact.address.line3-%}
+                  {% unless site.contact.address.line2 == blank and site.contact.address.line3 == blank-%}
                   <span class="p-extended-address">
                     {{-site.contact.address.line2 }}
-                    {%-if site.contact.address.line3-%}{{ site.contact.address.line3 | prepend: "<br />" }}{%-endif-%}
+                    {%-if site.contact.address.line2 != blank and site.contact.address.line3 != blank-%}<br />{%-endif-%}
+                    {{ site.contact.address.line3-}}
                   </span><br />
-                  {%-endif-%}
-                  {% if site.contact.address.city or site.contact.address.state or site.contact.address.zipcode-%}
+                  {%-endunless-%}
+                  {% unless site.contact.address.city == blank and site.contact.address.state == blank and site.contact.address.zipcode == blank-%}
                   <span class="p-locality">{{ site.contact.address.city }}</span>
                   <span class="p-region">{{ site.contact.address.state }}</span>
                   <span class="p-postal-code">{{-site.contact.address.zipcode-}}</span><br />
-                  {%-endif %}
+                  {%-endunless %}
                 </address>
               </li>
-            {% endif-%}
+            {% endunless-%}
             </ul>
           </section> <!-- End Section - Contact -->

data/_includes/custom_head.html

@@ -2,5 +2,5 @@
   Placeholder to allow defining custom head, including analytics; in principle, you can add anything here, e.g. favicons:
 
   1. Head over to https://realfavicongenerator.net/ to add your own favicons.
-  2. Customize default _includes/custom-head.html in your source directory and insert the given code snippet.
+  2. Customize default _includes/custom_head.html in your source directory and insert the given code snippet.
 {% endcomment %}

data/_includes/item_authors.html

@@ -15,7 +15,7 @@ local:
 
     <ul class="inline csv authors">
     {%-for auth in authors-%}
-      {%-assign author = site.people | find: 'handle', auth-%}
+      {%-assign author = site.people | where: 'handle', auth | first-%}
       {%-if author.published-%}
         <li>{{-author.name-}}</li>
       {%-elsif auth-%}

data/_includes/menu.html

@@ -1,5 +1,5 @@
 {%-assign item_limit  = include.item_limit | default: 12-%}
-{%-assign peeps       = site.collections | find: "label", 'people'-%}
+{%-assign peeps       = site.collections | where: "label", 'people' | first-%}
 
 {%-if site.menus != nil and site.plugins contains 'jekyll-menus' %}
           {% comment-%} the following version of the menu depends on jekyll-menus {%-endcomment-%}

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 | where: 'identifier', 'projects' | first-%}
 {%-if published_projects != empty %}
           <!-- Section - Mini-posts -->
           <section>

data/_includes/page_header.html

@@ -1,4 +1,4 @@
-{%-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/pages.html

@@ -43,7 +43,7 @@ local:
                   <p class="byline">
                   {%-if site.show.authors %}
                     {%-for auth in pg.author-%}
-                      {%-assign author = site.people | find: 'handle', auth-%}
+                      {%-assign author = site.people | where: 'handle', auth | first-%}
                       {%-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-%}

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/archive.html

@@ -13,8 +13,8 @@ layout:           default
 
 {% assign formatted_date  = page.date       | date: date_format %}
 {% assign title           = formatted_date  | append: ' Archives' %}
-{%-assign projects        = site.projects   | where_exp: 'project', 'project.date == formatted_date and project.published == true'-%}
-{%-assign pages           = site.pages      | where_exp: 'pg',      'pg.date      == formatted_date and pg.published == true'-%}
+{%-assign projects        = site.projects   | where_exp: "project", "project.date == formatted_date" | where: "published", "true"-%}
+{%-assign pages           = site.pages      | where_exp: "pg",      "pg.date      == formatted_date" | where: "published", "true"-%}
 
 <section>
   {% include page_header.html page_title=title %}

data/_layouts/category.html

@@ -3,8 +3,9 @@ layout:           default
 ---
 
 {%-assign title     = page.title    | default: page.category | capitalize | prepend: 'Filed under "' | append: '"'-%}
-{%-assign projects  = site.projects | where_exp: 'project', 'project.categories contains page.title and project.published == true'-%}
-{%-assign pages     = site.pages    | where_exp: 'pg',      'pg.categories      contains page.title and pg.published == true'-%}
+{%-assign projects  = site.projects | where_exp: "project", "project.categories contains page.title" | where: "published", "true"-%}
+{%-assign pages     = site.pages    | where_exp: "pg",      "pg.categories      contains page.title" | where: "published", "true"-%}
+
 
 <section>
   {% include page_header.html page_title=title %}

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/_layouts/tag.html

@@ -1,10 +1,11 @@
 ---
 layout:           default
+excerpt:          ""                    # NOTE: this empty excerpt fixes liquid "'if' tag was never closed included" error: https://jekyllrb.com/docs/troubleshooting/#excerpts
 ---
 
 {%-assign title     = page.title    | default: page.tag | prepend: 'Tagged "' | append: '"'-%}
-{%-assign projects  = site.projects | where_exp: 'project', 'project.tags contains page.title and project.published == true'-%}
-{%-assign pages     = site.pages    | where_exp: 'pg',      'pg.tags      contains page.title and pg.published == true'-%}
+{%-assign projects  = site.projects | where_exp: "project", "project.tags contains page.title" | where: "published", "true"-%}
+{%-assign pages     = site.pages    | where_exp: "pg",      "pg.tags      contains page.title" | where: "published", "true"-%}
 
 <section>
   {% include page_header.html page_title=title %}

data/_pages/archives.html

@@ -38,8 +38,8 @@ excerpt:          ""      # NOTE: this empty excerpt fixes liquid "'if' tag was
           {%-for year in posts_by_year %}
             {%-assign year_url = site.jekyll-archives.permalinks.year | replace: ':year', year.name-%}
 {%-comment-%}
-            {%-assign year_projects = projects_by_year  | find: 'name', year.name-%}
-            {%-assign year_pages    = pages_by_year     | find: 'name', year.name-%}
+            {%-assign year_projects = projects_by_year  | where: 'name', year.name | first-%}
+            {%-assign year_pages    = pages_by_year     | where: 'name', year.name | first-%}
 {%-endcomment-%}
             <h2{%-if is_year_archive %} class="tight"{%-endif-%}>
               {% if archives_available and archived contains 'year'-%}
@@ -59,8 +59,8 @@ excerpt:          ""      # NOTE: this empty excerpt fixes liquid "'if' tag was
                   {%-assign month_name = month.name | date: '%m'-%}
                   {%-assign month_url = site.jekyll-archives.permalinks.month | replace: ':year', year.name | replace: ':month', month_name-%}
 {%-comment-%}
-                  {%-assign month_projects  = projects_by_month | find: 'name', month.name-%}
-                  {%-assign month_pages     = pages_by_month    | find: 'name', month.name-%}
+                  {%-assign month_projects  = projects_by_month | where: 'name', month.name | first-%}
+                  {%-assign month_pages     = pages_by_month    | where: 'name', month.name | first-%}
 {%-endcomment-%}
                   <h3 class="tight">
                     {% if archives_available and archived contains 'month'-%}

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.6
+  version: 1.0.11
 platform: ruby
 authors:
 - Middle Bear
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-04 00:00:00.000000000 Z
+date: 2020-08-15 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