ICU-22194 Add CI job to generate Github Pages using Github Actions

.github/workflows/jekyll-gh-pages.yml

@@ -0,0 +1,78 @@
+# Copyright (C) 2023 and later: Unicode, Inc. and others.
+# License & terms of use: http://www.unicode.org/copyright.html
+#
+# Note: the workflow here is based on the Github Actions workflow used
+# by the Jekyll theme we are using:
+# https://github.com/just-the-docs/just-the-docs/blob/main/.github/workflows/deploy.yml
+#
+# The Jekyll theme (just-the-docs) configured its Github CI to manually run the Jekyll
+# build instead of relying on the default behavior from
+# https://github.com/actions/jekyll-build-pages . The default behavior of 
+# actions/jekyll-build-pages seems to be causing errors with this theme.
+
+name: Deploy User Guide
+
+on:
+  # Runs on pushes targeting the default branch and only if in the `docs/` directory
+  push:
+    branches: ["main"]
+    paths: ["docs/**"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '2.7.4' # Not needed with a .ruby-version file
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+          cache-version: 0 # Increment this number if you need to re-download cached gems
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v3
+        with:
+          generator_config_file: docs/_config.yml
+      - name: Build with Jekyll
+        # Outputs to the './_site' directory by default
+        run: |
+          cd docs  # root directory of markdown, also contains Jekyll configs, etc.
+          bundle install
+          # The baseurl arg is parsed from the `baseurl` field of _config.yml.
+          bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: docs/_site
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

docs/Gemfile

@@ -11,15 +11,10 @@ source "https://rubygems.org"
 # This will help ensure the proper Jekyll version is running.
 # Happy Jekylling!
 
-# gem "jekyll", "~> 3.8.7"
-
-# This is the default theme for new Jekyll sites. You may change this to anything you like.
 gem "minima", "~> 2.5"
-# If you aren't using GitHub Pages, then uncomment out the line above that starts with
-# 'gem "jekyll"' and then comment out the line below that starts with 'gem "github-pages"'.
-# To upgrade, run `bundle update github-pages`.
-gem "github-pages", "~> 213", group: :jekyll_plugins
 gem "just-the-docs"
+
+gem "github-pages", "228", group: :jekyll_plugins
 # If you have any plugins, put them here!
 group :jekyll_plugins do
   gem "jekyll-feed", "~> 0.12"
@@ -34,4 +29,3 @@ end
 
 # Performance-booster for watching directories on Windows
 gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
-

docs/_config.yml

@@ -14,7 +14,7 @@ url: "https://unicode-org.github.io" # the base hostname & protocol for your sit
 twitter_username: unicode
 github_username:  unicode-org
 
-remote_theme: pmarsceill/just-the-docs
+theme: just-the-docs
 
 # GitHub uses its own markdown renderer called CommonMarkGhPages.
 #

docs/_sass/color_schemes/light.scss

@@ -1,8 +0,0 @@
-// © 2020 and later: Unicode, Inc. and others.
-// License & terms of use: http://www.unicode.org/copyright.html
-
-// Increase the side bar width as some of the page titles don't fit in the default size.
-$nav-width: 284px;
-
-// Increase the main content area width as some tables assume a larger size.
-$content-width: 900px;