From 390123d4d7593d991938e4be662f775f5ba6bfb5 Mon Sep 17 00:00:00 2001
From: Jacobus Geluk <jacobus.geluk@ekgf.org>
Date: Mon, 30 Dec 2024 22:33:21 +0000
Subject: [PATCH] chore(docs): fix build issue

---
 .github/workflows/pages.yml |   1 +
 docs/.gitignore             |   5 +++++
 docs/.jekyll-metadata       | Bin 173664 -> 173759 bytes
 docs/Gemfile                |   1 +
 docs/_config.yml            |  43 +++++++++++++++++++-----------------
 5 files changed, 30 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index e4ad867..c77fb32 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -59,6 +59,7 @@ jobs:
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
         env:
           JEKYLL_ENV: production
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Upload artifact
         # Automatically uploads an artifact from the './_site' directory by default
diff --git a/docs/.gitignore b/docs/.gitignore
index ff94fce..bcc4a4c 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -4,3 +4,8 @@ Gemfile.lock
 .sass-cache
 .ssl
 .gems
+.jekyll-cache/
+.jekyll-assets-cache/
+.sass-cache/
+vendor/
+.jekyll-metadata
diff --git a/docs/.jekyll-metadata b/docs/.jekyll-metadata
index ee9ad5ba820a3877239942b445b33ca7a05af8ca..50283c8de03560fbd986f0f332045dee1765c3d9 100644
GIT binary patch
delta 88
zcmaEGhHL*>E*2J!>V(MxvsD{4TQwQCYBHHG1M#eiQ;W({^@=mttQkV8*&R4MORd>>
qFX_uSyz%mp<FaPYWU^wk=E!8T=2T)gbg<^iWU%IT;Bw%JW&i-o_ZN-;

delta 25
hcmdmgmg~V8E*2J!>iEe5vsD{4TQwQCYBHHG0|0!(2(SPE

diff --git a/docs/Gemfile b/docs/Gemfile
index c502713..a99d41c 100644
--- a/docs/Gemfile
+++ b/docs/Gemfile
@@ -22,5 +22,6 @@ group :jekyll_plugins do
   gem "jekyll-sitemap"
   gem "jekyll-default-layout"
   gem "jekyll-gfm-admonitions"
+  gem "jekyll-optional-front-matter"
 end
 
diff --git a/docs/_config.yml b/docs/_config.yml
index 3ce7076..99c1612 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -1,5 +1,7 @@
 theme: just-the-docs
 title: "GraphArch Documentation"
+description: >-
+  GraphArch, a tool for generating documentation from Graph databases, including OWL Ontologies and SHACL shapes.
 title_separator: "-"
 repository: EKGF/grapharch
 source: .
@@ -30,8 +32,8 @@ author:
       url: "https://github.com/ekgf/grapharch"
 
 # Handling Reading
-safe                : false
-strict_front_matter : false
+safe: false
+strict_front_matter: false
 include:
   - contribute
   - design-goal
@@ -40,8 +42,10 @@ include:
 exclude:
   - .asset-cache
   - .bundle
-  - .jekyll-assets-cache
-  - .sass-cache
+  - .jekyll-cache/
+  - .jekyll-assets-cache/
+  - .sass-cache/
+  - vendor/
   - .gems
   - Capfile
   - Gemfile
@@ -49,7 +53,8 @@ exclude:
   - Rakefile
   - README.md
   - tmp
-  - serve.sh
+  - "**/*.sh"
+  - _config_dev.yml
 encoding: UTF-8
 markdown_ext: "md"
 
@@ -69,6 +74,7 @@ plugins:
   - jekyll-sitemap
   - jekyll-default-layout
   - jekyll-gfm-admonitions
+  - jekyll-optional-front-matter
 
 # Conversion
 markdown: kramdown
@@ -76,6 +82,8 @@ highlighter: rouge
 lsi: false
 excerpt_separator: "\n\n"
 incremental: false
+optional_front_matter:
+  remove_originals: true
 
 # Serving
 detach: false
@@ -85,13 +93,9 @@ baseurl: "" # does not include hostname
 show_dir_listing: false
 
 # Outputting
-# permalink: :path/:basename
 permalink: pretty
-# paginate: 5 # amount of posts to show
-# paginate_path: /page:num/
 timezone: "Europe/London" # http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
 
-
 # Markdown Processing
 kramdown:
   input: GFM
@@ -110,28 +114,27 @@ sass:
   sass_dir: _sass
   style: compressed # http://sass-lang.com/documentation/file.SASS_REFERENCE.html#output_style
 
-
 defaults:
   - scope:
       path: contribute
-      type: "pages"
+      type: pages
     values:
       layout: default
   - scope:
-      path: "design-goal"
-      type: "pages"
+      path: design-goal
+      type: pages
     values:
-      layout: "default"
+      layout: default
   - scope:
-      path: "feature"
-      type: "pages"
+      path: feature
+      type: pages
     values:
-      layout: "default"
+      layout: default
   - scope:
-      path: "ontology"
-      type: "pages"
+      path: ontology
+      type: pages
     values:
-      layout: "default"
+      layout: default
 
 # Search
 # Enable or disable the site search