jekyll-theme-open-project 2.1.0 → 2.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c764226a279b3264ca00a5053359d946233874e7794c05911ccc0ed09077c7e3
-  data.tar.gz: 2ebf77fba338697c4fcab8e326b31a92456e51d4cd5dc5c6edfd72a5bd7f5b12
+  metadata.gz: 807e0858636b8cbc04054d4ef89f2dc8c00464e193afaacbb82e8ff6ff484239
+  data.tar.gz: 3e5793f0956cf55c0d268db57f4a8df626fde73730ac3180b21edbf202534c04
 SHA512:
-  metadata.gz: 6238114e8630c606b2473f70f885060bcafc42a47789d4d95293fc81f0255c4d18a1902408fac85a294611be9199b6a1e625f8b651f87f8f7cca719fe15bfbe3
-  data.tar.gz: 2d3cddc1c10e4db1fd79f4eab70924b90e2bc77d8a921af57c005da2b47974d92d8c39ba74df6e90c7ba224b25250d1778404fb0df54c88baf9f368282a127a9
+  metadata.gz: 62a5a94d617c6e31b6c4a8727cc7f4d6705b5d42cbc182bcc65f0920bd01c43f63caa4e95ed0ac16719a1871e45e6a861be879e0f4569f1d85d13a7bc6f86ac1
+  data.tar.gz: e5caa2ca4cf959951e7fd678e488236456016c5b68b9c976c13c0ed1fb6cf90156f7a88b2ce7c4c48ecca19386bd8dd25475e02c0b145d86868195a8cb7b2f6f

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2018 Ribose
+Copyright (c) 2020 Ribose
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -5,9 +5,11 @@ aiming to help organizations and individuals present
 open-source software and specifications in a navigable and elegant way.
 
 Open Project fits two types of sites:
-that describe one individual project, and that combine projects into sort of an open hub.
 
-**Demo**: See [Ribose Open](https://open.ribose.com/) project sites—for example,
+* a site that describes one individual project
+* a site that combine projects into sort of an open hub.
+
+**Demo**: See [Ribose Open](https://open.ribose.com/) project sites -- for example,
 [Metanorma](https://www.metanorma.com),
 [RNP](https://www.rnpgp.com),
 [Cryptode](https://www.cryptode.com),
@@ -38,9 +40,9 @@ to AWS S3.
   * [Includes](#theme-includes)
 
 
-## Starting a site with this theme
+## Getting started
 
-### Getting started with Ruby and Jekyll
+### Set up Ruby and Jekyll
 
 The currently recommended Ruby version is 2.6.
 (In case you aren’t using Ruby often, the easiest way to install one may be with RVM.)
@@ -48,10 +50,10 @@ The currently recommended Ruby version is 2.6.
 The currently recommended Jekyll version is 3 or newer
 (read about [Jekyll installation](https://jekyllrb.com/docs/#instructions)).
 
-Note: this theme is known to not work with Ruby older than 2.3,
+NOTE: this theme is known to not work with Ruby older than 2.3,
 and hasn’t been tested on newer versions.
 
-### Start new Jekyll site
+### Start a new Jekyll site
 
     jekyll new my-open-site
 
@@ -59,7 +61,7 @@ If you use Git for site source version management,
 see the “Extra .gitignore rules” section below
 for additional lines you should add to your `.gitignore`.
 
-### Installing theme
+### Install Open Site theme into the Jekyll site
 
 Add this line to your Jekyll site's `Gemfile`,
 replacing default theme requirement:
@@ -91,15 +93,32 @@ Execute the following to install dependencies:
 
     $ bundle
 
-### Configuring site
+### Configure your Open Site for the first time
 
-Edit _config.yml to add necessary site-wide configuration options,
+Edit `_config.yml` to add necessary site-wide configuration options,
 and add files and folders to site contents. This step depends
 on the type of site you’re creating: hub or individual project site.
 
 Further sections explain core concepts of open project and hub, and go
 into detail about how to configure a project or hub site.
 
+Before building the first time you must do this:
+
+1. Configure [common settings](#common-settings)
+2. Add your logo(s) according to [logo](#logo)
+
+Please see the [configuration section](#configuration) for more details.
+
+NOTE: It may be required to copy the following properties from
+this theme’s `_config.yaml` to your site’s: `collections`, `includes_dir`.
+
+This is likely caused by changed behavior of jekyll-data gem in recent versions,
+which is responsible for “inheritance” of `_config.yaml` between theme and site.
+
+You can add any custom collections for your site
+after collections copied from theme’s config.
+
+
 ### Building site
 
 Execute to build the site locally and watch for changes:
@@ -110,17 +129,30 @@ This assumes you have mysite.local mapped in your hosts file,
 otherwise omit --host and it’ll use “localhost” as domain name.
 
 
-## General setup
+## Configuration
+
+There are 3 areas to configure when you first create an Open Site, namely:
+
+* [Common setup](#common-setup), settings that apply to both Hub and Project sites;
+* [Hub site](#hub-site);
+* [Project site](#project-site)
+
+
+## Common setup
+
+### Common settings
+
+(mandatory)
 
 These settings apply to both site types (hub and project).
 
-- You may want to remove the default about.md page added by Jekyll,
+- You may want to remove the default `about.md` page added by Jekyll,
   as this theme does not account for its existence.
 
 - Add `hero_include: home-hero.html` to YAML frontmatter
   in your main `index.md`.
 
-- Add following items to site’s _config.yml
+- Add following items to site’s `_config.yml`
   (and don’t forget to remove default theme requirement there):
 
   ```yaml
@@ -165,6 +197,8 @@ These settings apply to both site types (hub and project).
 
 ### Logo
 
+(mandatory)
+
 By “logo” is meant the combination of site symbol as a graphic
 and name as word(s).
 
@@ -172,10 +206,10 @@ and name as word(s).
   Should look OK in dimensions of 30x30px, and fit inside a square.
   Should be in SVG format (see also the SVG guidelines section).
 
-  - Drop your site-wide symbol in <site root>/assets/symbol.svg.
+  - Provide your site-wide symbol in <site root>/assets/symbol.svg.
 
-  - Drop PNG renders of the symbol as favicon.png and favicon-192x192.png
-    under <site root>/assets/; use transparent background.
+  - Provide the symbol as PNG renders as `favicon.png` and `favicon-192x192.png`
+    under `<site root>/assets/`; use transparent background.
 
 - **Site name** displayed to the right of the symbol.
   Limit the name to 1-3 words.
@@ -222,7 +256,7 @@ hero_include: index-page-hero.html
 In general, posts are authored as per usual Jekyll setup.
 
 It is recommended that you provide explicit hand-crafted post excerpts,
-as automatically-generated excerpts may break post card markup.
+as automatically-generated excerpts may break the post card layout.
 
 Theme also anticipates author information within frontmatter.
 Together with excerpts, here’s how post frontmatter (in addition to anything
@@ -520,7 +554,7 @@ description: A sentence.
 # but used for HTML metadata if jekyll-seo-tag is enabled
 
 tags: [Ruby, Python, RFC, "<some_namespace_id>:<appropriate_tag>"]
-# Note: Avoid whitespaces and other characters that may make Jekyll
+# NOTE: Avoid whitespaces and other characters that may make Jekyll
 # percent-encode the tag in URLs. Replace " " (a regular space)
 # with "_" (underline); underlines will be rewritten as spaces when tags
 # are presented to site users.

data/_includes/legal.html

@@ -1,5 +1,5 @@
 <span class="copyright">
-  <span class="copyright-head">Copyright © 2018 {{ site.legal.name }} —</span>
+  <span class="copyright-head">Copyright © {{ site.time | date: '%Y' }} {{ site.legal.name }} —</span>
   <span class="copyright-tail">All rights reserved.</span>
 </span>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-open-project
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.6
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-14 00:00:00.000000000 Z
+date: 2021-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: 4.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: 4.1.1
 - !ruby/object:Gem::Dependency
   name: jekyll-seo-tag
   requirement: !ruby/object:Gem::Requirement
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 2.1.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.1.0
+        version: 2.1.5
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -240,7 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: Open Project Jekyll theme