jekyll-theme-open-project 2.1.10 → 2.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32130c0a3b12cf1e389be7d2d453f88f2f84d5936fd68e24714f7889dfca49f5
-  data.tar.gz: 3e882c476741d5f698e79aff328db7385a5bbd525ad1ace70e028ef2e6eca063
+  metadata.gz: 11678ab83694605f8e208bb9f2e0ed2aacb335313f7e2d67e02e3d285b756643
+  data.tar.gz: a3fb8118e5df1eb9e7e23f1b19054b8dfe847d3efae96377762a831b3e004690
 SHA512:
-  metadata.gz: 5432789a5e21986187b76b310edb3774399ef2345a24e15dd46942d4f9c921a77a57b34281e7618c8bd04bc5447c3db692a40fd42971da3ceef3d2fb0136c61f
-  data.tar.gz: 59debbfea2538ce740b37c96a58629ca7537acbcc7d70e753d5983feb42ecd363dc5cb1eb32d268cdb9d9d13a0766e1bd2d9304590d092045b5d5e55390f8f55
+  metadata.gz: 233efaa726d223d8e3ce6ab6e4d94c8350e2e3078da2f6d2d292b754dae63a742e9241c75fd06a03b54dfdc94cc753161fa3d5a84c0325a1589d3fbf81a778d6
+  data.tar.gz: ce5343194c2b4488971a4ac99ee343a19bdb35ec9880538ed414727c26f2d241b22cd8b0c7d8fa6b910c856119bccc5713394f0f71fc53d1b4715937cda978a0

data/README.md

@@ -140,6 +140,33 @@ There are 3 areas to configure when you first create an Open Site, namely:
 
 ## Common setup
 
+### Git repository branch behavior
+
+You’ll see many instances of document frontmatter
+referencing Git repository URLs.
+
+Note that, wherever a `[*_]repo_url` property is encountered,
+a sibling property `[*_]repo_branch` is supported.
+(This is new in 2.1.17, until that version branch “master” was used for all repositories.)
+
+If you reference repositories that don’t use branch name “main”,
+you must either:
+
+- use a sibling `[*_]repo_branch` property to specify your custom branch name
+  (you can search for `git_repo_branch`, `repo_branch`, `github_repo_branch`
+  in this document for examples), or
+
+- specify `default_repo_branch` property in `config.yml`
+
+  (in this case, in scenarios with project sites being used in conjunction
+  with a hub site, `default_repo_branch` must be the same
+  across all project sites’ and their hub site’s `config.yml`—otherwise you’re advised
+  to use the previous option to avoid site build failure).
+
+Note that, when a referenced Git repository doesn’t contain the necessary branch
+(either explicitly specified custom branch, or `default_repo_branch`, or branch called “main”),
+this will cause build failure of that project site, or a hub site using that project site.
+
 ### Common settings
 
 (mandatory)
@@ -175,10 +202,10 @@ These settings apply to both site types (hub and project).
 
   default_repo_branch: main
   # Optional, default is `main`.
-  # Whenever a branch name isn’t specified for some repository
-  # (such as project docs or specs), this name will be used.
-  # For configuration options that contain repository settings,
-  # search `git_repo_branch`, `repo_branch`, `github_repo_branch`.
+  # Whenever branch name isn’t specified for some repository
+  # (such as project docs or specs), this name will be used
+  # during site’s build.
+  # (See branch behavior section for details.)
 
   tagline: Because examples are very important
   # Used in hero unit on main page.
@@ -201,7 +228,13 @@ These settings apply to both site types (hub and project).
   # Without this setting, one-file FA distribution, all.js, is included from free FA CDN.
 
   theme: jekyll-theme-open-project
-  permalink: /blog/:month-:day-:year/:title/
+
+  permalink: /blog/:month-:day-:year-:title/
+  # It’s important that dash-separated permalink is used for blog posts.
+  # There’re no daily or monthly blog archive pages generated.
+  # Hub sites reference posts using that method, and it’s currently non-customizable.
+  # With `collections` configuration, specify permalink for posts
+  # correctly as well (for an example, see https://github.com/metanorma/metanorma.org/blob/d2b15f6d8c4cea73d45ad899374845ec38348ff1/_config.yml#L60).
   ```
 
 ### Logo
@@ -307,12 +340,13 @@ For project posts, see below the project site section.
 
 The hub represents your company or department, links to all projects
 and offers a software and specification index.
+ 
+Note that a hub site is expected to have at least one document
+in the `projects` collection (see below).
 
 Additional items allowed/expected in _config.yml:
 
 ```yaml
-is_hub: true
-
 # Since a hub would typically represent an organization as opposed
 # to individual, this would make sense:
 seo:

data/_layouts/default.html

@@ -93,8 +93,11 @@
 
   <div class="underlay footer">
     <footer>
-      {% if site.num_all_specs > 0 or site.num_all_software > 0 %}
+      {% if site.num_all_specs > 0 or site.num_all_software > 0 or site.extra_footer_links %}
       <nav class="links" aria-label="site links">
+        {% for link in site.extra_footer_links %}
+          <a href="{{ link.url }}">{{ link.title }}</a>
+        {% endfor %}
         {% if site.num_all_software > 0 %}
           <a href="/software/">All {{ site.title }} software</a>
         {% endif %}

data/_sass/jekyll-theme-open-project.scss

@@ -727,7 +727,7 @@ body.site--project {
           .logo-container {
             float: left;
             margin-left: -$logo-space;
-            padding: 8px (($logo-space - $logo-side) / 2);
+            padding: 8px calc(($logo-space - $logo-side) / 2);
           }
         }
       }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-open-project
 version: !ruby/object:Gem::Version
-  version: 2.1.10
+  version: 2.1.12
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-13 00:00:00.000000000 Z
+date: 2023-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -240,7 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Open Project Jekyll theme