From c5fb6d855c99d086e52b6caa333745011dd0618d Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Fri, 12 Dec 2025 20:14:29 +0100 Subject: [PATCH 01/29] Update `README.md` due to the site build on Hugo --- README.md | 81 ++++++++++++++++++---------- _hugo-site/config/_default/hugo.toml | 5 +- 2 files changed, 56 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 8972fc7c..d9b230da 100644 --- a/README.md +++ b/README.md @@ -1,73 +1,98 @@ spine.io site ====== + This repository contains the code of the [spine.io](https://spine.io) site. -It is based on [Jekyll](https://jekyllrb.com/) and is hosted on +It is based on [Hugo](https://gohugo.io/) and is hosted on [GitHub Pages](https://pages.github.com/). This project is two-headed: - * It is a Ruby project because of Jekyll. + * It is a Hugo project. * It is a Gradle project to for checking the source code embedded to the site. The code samples used on the site and in the framework documentation are added using -the [`embed-code`](https://github.com/SpineEventEngine/embed-code) Jekyll subcommand. +the [`embed-code`][embed-code] Hugo subcommand. The code resides under the `_code` directory. For instructions on embedding the code into the pages, please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file. -# Prerequisites +## Prerequisites - 1. Install Ruby 2.7 (as it's the latest version [supported by GitHub Pages](https://pages.github.com/versions/)). - 2. Install the `bundler` tool. - 3. Install the project dependencies by running `bundle install`. - -Now you should be able to run the site locally. +1. Install [Go][go] at least version `1.12`. +2. Install [Node.js][nodejs]. Its version should be `18+`. +3. Install [Hugo Extended][hugo-quick-start] at least version `v0.145` or higher. +4. Get access to the [`site-commons`][site-commons] repository from the admins + to be able to download the theme. +5. Make sure SSH is configured correctly and the passphrase is stored in the keychain. +6. Install project dependencies from the `_hugo-site` directory by running `npm install`. -# Running the site locally +## Running the site locally To build and launch the site on the local server: ``` ./gradlew :runSite ``` + To build the site without running the server: ``` ./gradlew :buildSite ``` + If you experience issues with this step, please check out the [Troubleshooting Guide](TROUBLESHOOTING.md). -# Documentation +## Documentation The documentation is located in a [separate repository](https://github.com/SpineEventEngine/documentation.git). -It is added to this site as a Git submodule. +It is added to this site as a Hugo Module. Any changes to the documentation must be made in its own [repository](https://github.com/SpineEventEngine/documentation.git). The `documentation` repository is made to be self-sustainable in terms of editing. A fully-fledged -Jekyll site has been set up for it. All the contents and links in it are working as intended. +Hugo site has been set up for it. All the contents and links in it are working as intended. It allows making changes to it more convenient for authors. -However, to make it all possible, the `documentation` repository has its own `docs` folder — -otherwise, all links would be broken. Therefore, to avoid any confusion, the submodule -in this “main” repository is named `_docs`. - -In terms of building the “main” site, the [Jekyll collections](https://jekyllrb.com/docs/step-by-step/09-collections/) -are used to embed the contents of the `_docs` submodule. +In terms of building the “main” site, the [Hugo Modules][hugo-modules] +are used to embed the contents. ### Steps to get updates -1. Update submodules: -``` -git submodule update --remote -``` -2. Add any new files pulled from the repository: -``` -git add . -``` +1. Clean the module cache: + + ```shell + hugo mod clean + ``` -3. Perform a commit and push back to origin to rebuild the site. +2. Get the documentation Hugo Module: + + ```shell + hugo mod get -u github.com/SpineEventEngine/documentation/_hugo-theme + ``` + +3. Commit and push changes from `go.mod` and `go.sum` files. + In the `go.sum` file keep only two last records to avoid file cluttering. + +## Common theme + +This project uses the [`site-commons`][site-commons] Hugo theme. + +1. To get theme updates: + + ```shell + hugo mod get -u github.com/TeamDev-Ltd/site-commons + ``` + +2. Commit and push changes from `go.mod` and `go.sum` files. + In the `go.sum` file keep only two last records to avoid file cluttering. # Authoring For instructions on adding the content to the site, please see the [`AUTHORING.md`](AUTHORING.md) file. + +[go]: https://go.dev/doc/install +[nodejs]: https://nodejs.org/en/download/current +[hugo-quick-start]: https://gohugo.io/getting-started/quick-start/#step-1-install-hugo +[site-commons]: https://github.com/TeamDev-Ltd/site-commons +[hugo-modules]: https://gohugo.io/hugo-modules/introduction +[embed-code]: https://github.com/SpineEventEngine/embed-code/tree/embed-code-go diff --git a/_hugo-site/config/_default/hugo.toml b/_hugo-site/config/_default/hugo.toml index 522110f0..a619a203 100644 --- a/_hugo-site/config/_default/hugo.toml +++ b/_hugo-site/config/_default/hugo.toml @@ -41,9 +41,10 @@ disableKinds = ['taxonomy', 'term'] # Version control config. # To change the current main version, update only the `path` parameter. -# Read more in the `SPINE_RELEASE.md` guide. +# Read more in the `SpineEventEngine/documentation/SPINE_RELEASE.md` guide. # -# The configuration is duplicated now due to the known issue with cascade arrays: +# The configuration is currently duplicated from the `SpineEventEngine/documentation` +# repository due to a known issue with cascading arrays: # https://github.com/gohugoio/hugo/issues/13869 [[cascade]] [cascade.params] From 76b046ebfceef82473dc3ade8b85c5fe2e537c58 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Fri, 12 Dec 2025 20:18:05 +0100 Subject: [PATCH 02/29] Update the site run and build commands --- _script/hugo-build | 41 +++++++++++++++++++++++++++++++++++++++++ _script/hugo-serve | 41 +++++++++++++++++++++++++++++++++++++++++ build.gradle.kts | 6 +++--- settings.gradle.kts | 6 +++--- 4 files changed, 88 insertions(+), 6 deletions(-) create mode 100755 _script/hugo-build create mode 100755 _script/hugo-serve diff --git a/_script/hugo-build b/_script/hugo-build new file mode 100755 index 00000000..9924c01a --- /dev/null +++ b/_script/hugo-build @@ -0,0 +1,41 @@ +#!/usr/bin/env bash +# +# Copyright 2025, TeamDev. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Redistribution and use in source and/or binary forms, with or without +# modification, must retain the above copyright notice and the following +# disclaimer. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# + +# Load environment variables for the case of execution from the Gradle build if they exist. +BASH_PROFILE=~/.bash_profile +BASH_RC=~/.bashrc + +if [ -f ${BASH_PROFILE} ]; then + echo "Using user's local bash profile." + . ${BASH_PROFILE} +elif [ -f ${BASH_RC} ]; then + echo "Using user's local bash runtime configuration." + . ${BASH_RC} +fi + +cd _hugo-site +hugo diff --git a/_script/hugo-serve b/_script/hugo-serve new file mode 100755 index 00000000..5a668439 --- /dev/null +++ b/_script/hugo-serve @@ -0,0 +1,41 @@ +#!/usr/bin/env bash +# +# Copyright 2025, TeamDev. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Redistribution and use in source and/or binary forms, with or without +# modification, must retain the above copyright notice and the following +# disclaimer. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# + +# Load environment variables for the case of execution from the Gradle build if they exist. +BASH_PROFILE=~/.bash_profile +BASH_RC=~/.bashrc + +if [ -f ${BASH_PROFILE} ]; then + echo "Using user's local bash profile." + . ${BASH_PROFILE} +elif [ -f ${BASH_RC} ]; then + echo "Using user's local bash runtime configuration." + . ${BASH_RC} +fi + +cd _hugo-site +hugo server diff --git a/build.gradle.kts b/build.gradle.kts index 5af2be7e..73860950 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -1,5 +1,5 @@ /* - * Copyright 2020, TeamDev. All rights reserved. + * Copyright 2025, TeamDev. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -28,14 +28,14 @@ * Builds and runs the site locally. */ task("runSite") { - commandLine("./_script/jekyll-serve") + commandLine("./_script/hugo-serve") } /** * Builds the site without starting the server. */ task("buildSite") { - commandLine("./_script/jekyll-build") + commandLine("./_script/hugo-build") } /** diff --git a/settings.gradle.kts b/settings.gradle.kts index 054d1156..06a30bd6 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -1,5 +1,5 @@ /* - * Copyright 2020, TeamDev. All rights reserved. + * Copyright 2025, TeamDev. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -26,6 +26,6 @@ rootProject.name = "spine.io" -includeBuild("./_code/samples") +//includeBuild("./_code/samples") -includeBuild("./_code/examples/hello") +//includeBuild("./_code/examples/hello") From 76badb86eae5f83e27d0969c9b0ccfd195fc1c93 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Fri, 12 Dec 2025 20:45:58 +0100 Subject: [PATCH 03/29] Prepare the release script --- .github/workflows/gh-pages.yml | 68 ++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 .github/workflows/gh-pages.yml diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml new file mode 100644 index 00000000..dd85b3b2 --- /dev/null +++ b/.github/workflows/gh-pages.yml @@ -0,0 +1,68 @@ +name: Deploy to GitHub Pages + +on: + push: + branches: + - master + +env: + HUGO_VERSION: 0.147.8 + GH_USER: cloud-cannon-teamdev-integration + +jobs: + deploy: + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + with: + token: ${{ secrets.GH_PAT }} + submodules: true + fetch-depth: 0 + + - name: Setup Hugo + uses: peaceiris/actions-hugo@v2 + with: + hugo-version: ${{ env.HUGO_VERSION }} + extended: true + + - name: Setup Node + uses: actions/setup-node@v3 + with: + node-version: '20' + + - name: Cache dependencies + uses: actions/cache@v4 + with: + path: ~/.npm + key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-node- + + - name: Cache Hugo Modules + uses: actions/cache@v4 + with: + path: /tmp/hugo_cache + key: ${{ runner.os }}-hugomod-${{ hashFiles('**/go.sum') }} + restore-keys: | + ${{ runner.os }}-hugomod- + + - name: Prepare Environment + run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com" + + - name: Install Dependencies + working-directory: _hugo-site + run: npm ci + + - name: Build Spine + working-directory: _hugo-site + run: hugo --minify + + - name: Deploy + uses: peaceiris/actions-gh-pages@v3 + if: github.ref == 'refs/heads/master' + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_branch: gh-pages + publish_dir: ./_hugo-site/public From dbf3516d3fc564b0a05cb01cd6ccc37bc938ed31 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 13:42:18 +0100 Subject: [PATCH 04/29] Add a note about Java version to build samples --- README.md | 3 ++- settings.gradle.kts | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d9b230da..6fa0018d 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,8 @@ please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file. ## Prerequisites -1. Install [Go][go] at least version `1.12`. +1. Install [Java JDK] version `11` to build the site. +2. Install [Go][go] at least version `1.12`. 2. Install [Node.js][nodejs]. Its version should be `18+`. 3. Install [Hugo Extended][hugo-quick-start] at least version `v0.145` or higher. 4. Get access to the [`site-commons`][site-commons] repository from the admins diff --git a/settings.gradle.kts b/settings.gradle.kts index 06a30bd6..b8d6fd96 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -26,6 +26,6 @@ rootProject.name = "spine.io" -//includeBuild("./_code/samples") +includeBuild("./_code/samples") -//includeBuild("./_code/examples/hello") +includeBuild("./_code/examples/hello") From 379fca0e6ca6e054211e76ae924d98c6a83472c9 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 13:42:54 +0100 Subject: [PATCH 05/29] Test the GitHub Action locally --- .github/workflows/gh-pages.yml | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index dd85b3b2..e88e687c 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -1,9 +1,7 @@ name: Deploy to GitHub Pages on: - push: - branches: - - master + pull_request: env: HUGO_VERSION: 0.147.8 @@ -60,8 +58,7 @@ jobs: run: hugo --minify - name: Deploy - uses: peaceiris/actions-gh-pages@v3 - if: github.ref == 'refs/heads/master' + uses: peaceiris/actions-gh-pages@v4 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_branch: gh-pages From f8c5bfd8abc743d52a37134555f057ddd3f833d1 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 15:59:14 +0100 Subject: [PATCH 06/29] Update the build settings due to the structure update --- .github/workflows/gh-pages.yml | 6 +++--- README.md | 13 +++++++------ _script/hugo-build | 2 +- _script/hugo-serve | 2 +- 4 files changed, 12 insertions(+), 11 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index e88e687c..edd92f8c 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -50,11 +50,11 @@ jobs: run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com" - name: Install Dependencies - working-directory: _hugo-site + working-directory: site run: npm ci - name: Build Spine - working-directory: _hugo-site + working-directory: site run: hugo --minify - name: Deploy @@ -62,4 +62,4 @@ jobs: with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_branch: gh-pages - publish_dir: ./_hugo-site/public + publish_dir: ./site/public diff --git a/README.md b/README.md index 6fa0018d..7ee306d7 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file. 4. Get access to the [`site-commons`][site-commons] repository from the admins to be able to download the theme. 5. Make sure SSH is configured correctly and the passphrase is stored in the keychain. -6. Install project dependencies from the `_hugo-site` directory by running `npm install`. +6. Install project dependencies from the `site` directory by running `npm install`. ## Running the site locally @@ -54,9 +54,9 @@ Hugo site has been set up for it. All the contents and links in it are working a It allows making changes to it more convenient for authors. In terms of building the “main” site, the [Hugo Modules][hugo-modules] -are used to embed the contents. +are used to embed the content. -### Steps to get updates +### Steps to get documentation updates 1. Clean the module cache: @@ -67,7 +67,7 @@ are used to embed the contents. 2. Get the documentation Hugo Module: ```shell - hugo mod get -u github.com/SpineEventEngine/documentation/_hugo-theme + hugo mod get -u github.com/SpineEventEngine/documentation/docs ``` 3. Commit and push changes from `go.mod` and `go.sum` files. @@ -75,9 +75,10 @@ are used to embed the contents. ## Common theme -This project uses the [`site-commons`][site-commons] Hugo theme. +This project uses the [`site-commons`][site-commons] Hugo theme for general components such +as anchor icons, snackbars, etc. -1. To get theme updates: +1. To get theme updates, run: ```shell hugo mod get -u github.com/TeamDev-Ltd/site-commons diff --git a/_script/hugo-build b/_script/hugo-build index 9924c01a..cc35453e 100755 --- a/_script/hugo-build +++ b/_script/hugo-build @@ -37,5 +37,5 @@ elif [ -f ${BASH_RC} ]; then . ${BASH_RC} fi -cd _hugo-site +cd site hugo diff --git a/_script/hugo-serve b/_script/hugo-serve index 5a668439..0180823e 100755 --- a/_script/hugo-serve +++ b/_script/hugo-serve @@ -37,5 +37,5 @@ elif [ -f ${BASH_RC} ]; then . ${BASH_RC} fi -cd _hugo-site +cd site hugo server From 1bdcc4dc2e4439cda9330cbbb9408b4e15dcac89 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 16:12:26 +0100 Subject: [PATCH 07/29] Enable `robots.txt` for production --- site/config/_default/hugo.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/site/config/_default/hugo.toml b/site/config/_default/hugo.toml index c2ddc56d..b07e86c5 100644 --- a/site/config/_default/hugo.toml +++ b/site/config/_default/hugo.toml @@ -1,6 +1,7 @@ baseURL = 'https://spine.io/' languageCode = 'en-us' title = 'Spine Event Engine' +enableRobotsTXT = true disableKinds = ['taxonomy', 'term'] [module] From 3b441d511fc90c024d3695868e5bdb3c08fe756d Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 18:14:43 +0100 Subject: [PATCH 08/29] Improve the guide about how to edit content in Hugo --- AUTHORING.md | 259 ++++++++++++++++----------------------------------- README.md | 8 ++ 2 files changed, 89 insertions(+), 178 deletions(-) diff --git a/AUTHORING.md b/AUTHORING.md index 7d8573de..79bf5d92 100644 --- a/AUTHORING.md +++ b/AUTHORING.md @@ -2,83 +2,88 @@ Content Author Guide ======== This document is a guide for adding content to the [spine.io](https://spine.io) site. -**Table of Contents** -- [Using URLs in Markdown](#using-urls-in-markdown) - + [Links to Blog Posts](#links-to-blog-posts) - - [Rule 1 -- Always concatenate Jekyll and Liquid tags](#rule-1----always-concatenate-jekyll-and-liquid-tags) - - [Rule 2 -- *(Almost)* Always start links with `{{ site.baseurl }}`](#rule-2----almost-always-start-links-with--sitebaseurl-) - - [Rule 3 -- Always use a trailing slash after `{{ site.baseurl }}`](#rule-3----always-use-a-trailing-slash-after--sitebaseurl-) -- [Adding collapsible list for sidebar navigation](#adding-collapsible-list-for-sidebar-navigation) -- [Adding code samples to the site](#adding-code-samples-to-the-site) -- [Testing broken links](#testing-broken-links) -- [Adding email links](#adding-email-links) -- [Managing the “Prev”/“Next” buttons in the documentation](#managing-the-prevnext-buttons-in-the-documentation) -- [Using a language switcher for source code samples](#using-a-language-switcher-for-source-code-samples) +**Table of Contents** +* [Using URLs](#using-urls) + * [URLs in markdown](#urls-in-markdown) + * [Rule 1](#rule-1----all-internal-links-must-not-start-with-a-slash) + * [Rule 2](#rule-2----each-link-should-end-with-a-slash-to-prevent-unnecessary-redirects) + * [Images](#images) + * [URLs in HTML](#urls-in-html) +* [Navigation](#navigation) + * [Main navigation](#main-navigation) + * [Documentation side navigation](#documentation-side-navigation) + * [Documentation “Next/Prev” buttons](#documentation-nextprev-buttons) + * [Adding code samples to the site](#adding-code-samples-to-the-site) +* [Testing broken links](#testing-broken-links) + * [Cloak email](#cloak-email) + * [Note blocks](#note-blocks) Table of contents generated with markdown-toc -# Using URLs in Markdown +# Using URLs -### Links to Blog Posts +To refer to another page, image, or asset in the Spine documentation, +use relative URLs. The site domain and product prefix are added automatically. -There are thee rules to follow: +### URLs in markdown -#### Rule 1 -- Always concatenate Jekyll and Liquid tags +There are two rules to follow: -| Good | Bad | -|-------------------------------------------|--------------------------------------------| -| `href="{{ site.baseurl }}{{ post.url }}"` | `href="{{ site.baseurl }}/{{ post.url }}"` | +#### Rule 1 -- All internal links **must not** start with a slash. -This removes the double-slash from your site's URLs. +| Good | Bad | +|--------------------------------------|--------------------------------------| +| `[Introduction](docs/introduction/)` | `[Introduction](/docs/introduction/)`| -#### Rule 2 -- *(Almost)* Always start links with `{{ site.baseurl }}` +#### Rule 2 -- Each link should **end with a slash** to prevent unnecessary redirects. -| Good | Bad | -|-------------------------------------------|-------------------------| -| `href="{{ site.baseurl }}{{ post.url }}"` | `href="{{ post.url }}"` | -This fixes almost all of the in-site links. The next rule covers the remainder. +| Good | Bad | +|--------------------------------------|-------------------------------------| +| `[Introduction](docs/introduction/)` | `[Introduction](/docs/introduction)`| -**Exception**: Start hyperlinks with `{{ site.url }}{{ site.baseurl }}` in feed pages, like `atom.xml`. +### Images -#### Rule 3 -- Always use a trailing slash after `{{ site.baseurl }}` +To render an image in markdown use: -| Good | Bad | -|-------------------------------------------|------------------------------------------| -| `href="{{ site.baseurl }}/" title="Home"` | `href="{{ site.baseurl }}" title="Home"` | - -| Good | Bad | -|------------------------------------------------|-----------------------------------------------| -| `href="{{ site.baseurl }}/public/favicon.ico"` | `href="{{ site.baseurl }}public/favicon.ico"` | +```markdown +![Image alt](img/articles/test.webp) +``` +Use anchors to specify image size: `#medium`, `#small`: -Visit [Configuring Jekyll for Project GitHub Pages and for User GitHub Pages](http://downtothewire.io/2015/08/15/configuring-jekyll-for-user-and-project-github-pages/) if you want to know why these rules should be followed. +```markdown +![Image alt](img/articles/test.webp#medium)` +``` -### URL rules +### URLs in HTML -All these URLs lead to the same page: `/docs`, `/docs/`, `/docs/index`, `/docs/index.html`. -But if you use them all throughout the site, it will create problems for search crawlers. +When working with layout partials, URLs should be specified using the following syntax: -Please stick to these rules for using links on the site. +```html +Requirements +``` -#### Use a trailing slash to refer to the directory containing the `index.html` file +```html + +``` -| Good | Bad | -|-----------------------------------------------|----------------------------------------------------| -|`{{ site.baseurl }}/docs/introduction/` | `{{ site.baseurl }}/docs/introduction/index` | +# Navigation -#### Drop the `.html` suffix. This will simplify the URL +### Main navigation -| Good | Bad | -|-----------------------------------------------|----------------------------------------------------| -|`{{ site.baseurl }}/docs/introduction/rules` | `{{ site.baseurl }}/docs/introduction/rules.html` | +To edit navigation items, modify `site/data/navbar.yml`. +The navigation template is located at `site/layouts/_partials/components/navbar/navigation.html`. +### Documentation side navigation -# Adding collapsible list for sidebar navigation +The documentation side navigation can be edited in the [SpineEventEngine/documentation](https://github.com/SpineEventEngine/documentation) +repository in the `docs/data/docs//sidenav.yml` file. -For collapsible categories we use the Bootstrap [Collapse](https://getbootstrap.com/docs/4.5/components/collapse/) component. +### Documentation “Next/Prev” buttons -For instructions on adding or changing sidebar navigation, please see the [Navigation Author Guide](_data/navigation/NAVIGATION.md). +The “Prev”/“Next” buttons are generated automatically for all document pages. +The implementation is inside the [SpineEventEngine/documentation](https://github.com/SpineEventEngine/documentation). # Adding code samples to the site @@ -111,147 +116,45 @@ After that, please use the following command: Also, we have a GitHub Action which tests the links when the pull request is created to the `master`. Please see the [`.github/workflows/proof-links.yml`](.github/workflows/proof-links.yml) file for details. -# Adding email links - -We use the [Jekyll Email Protect](https://github.com/vwochnik/jekyll-email-protect) to protect our -email addresses from spam bots. We store all email variables in the `_data/support.yml` file. +# Cloak email -### In HTML -``` -{{ 'example@example.com' | html_encode_email }} -``` +The `cloakemail` shortcode is used to cloak emails or phone numbers from +spamming bots. We store all email variables in the `site/data/spine.yml` file. -Or through a variable: -``` -{{ site.data.support.email | html_encode_email }} -``` +In markdown files, use the shortcode with a provided variable from a data file, for example: -The above code will yield: -``` -%65%78%61%6D%70%6C%65@%65%78%61%6D%70%6C%65.%63%6F%6D +```markdown +{{< cloakemail address_variable="spine.sales_email" >}} ``` -### In Markdown -In markdown files we cannot obfuscate the link text, so it would be safer to use something like `Contact us`. -``` -[{{ Contact us }}](mailto:{{ site.data.support.email | encode_email }}) -``` +or with the display text: -The above code will yield: -``` -Contact us +```markdown +{{< cloakemail address_variable="spine.sales_email" display="Contact us" >}} ``` -# Managing the “Prev”/“Next” buttons in the documentation - -The “Prev”/“Next” buttons are generated automatically for all document pages. The generation is -based on the [`doc_side_nav.yml`](_data/navigation/doc_side_nav.yml) navigation. +# Note blocks -To customize the automatically added “Prev”/“Next” buttons, add the appropriate variables to -the **front matter** block of the document page. +To add a note block with additional styles in markdown files, +use the predefined `note-block` shortcode. -### To hide the “Previous” or “Next” button: - -``` -prev_btn: false -``` +```markdown +{{% note-block class="note" %}} +This is some dummy text to show how a note block can look. Check this +[example link to guides][test-url] to see how links appear inside the block. -``` -next_btn: false -``` +You can add more lines or even lists: +- First item. +- Second item. +{{% /note-block %}} -### To customize the “Previous” or “Next” button name: -``` -prev_btn: - page: Development Process Overview +[test-url]: docs/guides/ ``` -``` -next_btn: - page: Development Process Overview -``` +You can use only predefined classes such as: `note`, `warning`, or `lead`. -### To customize the “Previous” or “Next” button name and URL: -``` -prev_btn: - page: Development Process Overview - url: /docs/introduction/ +```markdown +{{% note-block class="lead" %}} +The test lead block. +{{% /note-block %}} ``` - -``` -next_btn: - page: Architecture Overview - url: /docs/introduction/architecture.html -``` - -**Related files:** -- `_includes/doc-next-prev-nav.html` - the navigation template with the automatic button generation; -- `_sass/modules/_doc-next-prev-nav.scss` - navigation styles; -- `_layouts/docs.html` - the documentation layout where the `doc-next-prev-nav` is included. - -# Using a language switcher for source code samples - -The switch state will be saved globally so that the user can navigate between pages. - -### Usage - -To show language tabs use the structure below. -Add a `lang` attribute with `Java`, `Kotlin`, `JavaScript` or any other language value -for `div`s with content. If no language is provided, the content will not be displayed. -``` -
-
- Any Java content here -
-
- Any Kotlin content here -
-
- Any JavaScript content here -
-
-``` - -In **markdown**, all tags should be left-aligned. This way, the blocks -of code will not be broken: - -``` -
-
-Any Java content here -
-
-Any Kotlin content here -
-
-Any JavaScript content here -
-
-``` - -If you don't need to display the tabs, but only need to show a specific paragraph of text -or change the title depending on the language, just use this: -``` -
-# Getting started with Spine in Java -
- -
-# Getting started with Spine in Kotlin -
-``` - -To change only some of the words in a sentence, use the `` tag with the `.inline` class: -``` -A minimal client-server application in -Java -Kotlin -which handles one command to print some text... -``` - -**Related files** - -The files are stored in the [`documentation`](https://github.com/SpineEventEngine/documentation) -repository. -- `_sass/base/_code-tabs.scss` - styles for the code tabs; -- `tools/code-tabs.js` - code tab implementation. diff --git a/README.md b/README.md index 7ee306d7..54e64cc0 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,14 @@ To build the site without running the server: If you experience issues with this step, please check out the [Troubleshooting Guide](TROUBLESHOOTING.md). +Another way to run the site locally is to follow these steps: +1. Navigate to the `site` folder. +2. Start the local server with this command: + + ```shell + hugo server + ``` + ## Documentation The documentation is located in a [separate repository](https://github.com/SpineEventEngine/documentation.git). From d7988d075945bab607839d357c88921c0114096f Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Mon, 15 Dec 2025 18:37:54 +0100 Subject: [PATCH 09/29] Configure the link checker --- .github/workflows/check-links.yml | 113 ++++++++++++++++++++++++++++++ .github/workflows/gh-pages.yml | 2 +- lychee.toml | 47 +++++++++++++ 3 files changed, 161 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/check-links.yml create mode 100644 lychee.toml diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml new file mode 100644 index 00000000..ccfbb0b8 --- /dev/null +++ b/.github/workflows/check-links.yml @@ -0,0 +1,113 @@ +name: Broken links check +on: [pull_request, workflow_dispatch] + +env: + HUGO_VERSION: 0.147.8 + GH_USER: cloud-cannon-teamdev-integration + LYCHEE_RELEASE: "lychee-v0.15.1-x86_64-unknown-linux-gnu.tar.gz" + LYCHEE_VERSION_TAG: "v0.15.1" + +jobs: + check-links: + runs-on: ubuntu-latest + concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup Hugo + uses: peaceiris/actions-hugo@v3 + with: + hugo-version: ${{ env.HUGO_VERSION }} + extended: true + + - name: Setup Node + uses: actions/setup-node@v3 + with: + node-version: '20' + + - name: Cache dependencies + uses: actions/cache@v4 + with: + path: ~/.npm + key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-node- + + - name: Cache Hugo Modules + uses: actions/cache@v4 + with: + path: /tmp/hugo_cache + key: ${{ runner.os }}-hugomod-${{ hashFiles('**/go.sum') }} + restore-keys: | + ${{ runner.os }}-hugomod- + + - name: Prepare environment + run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com" + + - name: Install Dependencies + working-directory: site + run: npm ci + + - name: Build Spine + working-directory: site + run: hugo -e development + + # Cache Lychee results to avoid hitting rate limits. + - name: Cache Lychee results + uses: actions/cache@v4 + with: + path: .lycheecache + key: cache-lychee-results + + - name: Cache Lychee executable + id: cache-lychee + uses: actions/cache@v4 + with: + path: lychee + key: ${{ runner.os }}-${{ env.LYCHEE_RELEASE }} + + # We use Lychee directly instead of a GitHub Action because it + # must have access the local Hugo server, which is not visible + # from the Docker-based action. + - name: Download Lychee executable + uses: robinraju/release-downloader@v1.7 + if: steps.cache-lychee.outputs.cache-hit != 'true' + with: + repository: "lycheeverse/lychee" + tag: ${{ env.LYCHEE_VERSION_TAG }} + fileName: ${{ env.LYCHEE_RELEASE }} + + - name: Extract Lychee executable + if: steps.cache-lychee.outputs.cache-hit != 'true' + run: | + mkdir -p lychee && + tar -xf ${{ env.LYCHEE_RELEASE }} -C lychee + + # 1. In the generated HTML, some inner links will have absolute URLs and + # the link checker will attempt to fetch them. That's why we need + # a server. Sadly, link checkers have no settings to address this. + # 2. Output redirection is necessary for nohup in GitHub Actions. + # 3. Sleep makes sure the server is up before the next step. + - name: Start Hugo server + working-directory: site + run: | + nohup hugo server \ + --environment development \ + > nohup.out 2> nohup.err < /dev/null & + sleep 5 + + - name: Check if the cache file exists + run: | + if [ -f ".lycheecache" ]; then + echo "Lychee cache exists." + else + echo "No lychee cache file." + fi + + - name: Check links + run: | + ./lychee/lychee --config lychee.toml --timeout 60 \ + --base http://localhost:1313/ \ + 'site/public/**/*.html' diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index edd92f8c..313bc613 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -20,7 +20,7 @@ jobs: fetch-depth: 0 - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 + uses: peaceiris/actions-hugo@v3 with: hugo-version: ${{ env.HUGO_VERSION }} extended: true diff --git a/lychee.toml b/lychee.toml new file mode 100644 index 00000000..a8b8fd92 --- /dev/null +++ b/lychee.toml @@ -0,0 +1,47 @@ +# Exclude URLs and mail addresses from checking (supports regex). +exclude = [ + # Links that return errors during checks, but work for the user. + "fonts.googleapis.com/*", + "fonts.gstatic.com/*", + "chromium.googlesource.com/*", + "chromereleases.googleblog.com/*", + "clients4.google.com/", + "ssl.gstatic.com/", + "googletagmanager.com/*", + "x.com/*", + + "https://x/", + "stackoverflow.com/questions/*", + "openjdk.org/*", + "npmjs.com/*", + + # Temporarily broken links. +] + +# Exclude these filesystem paths from getting checked. +exclude_path = [] + +# Check links inside `` and `
` blocks as well
+# as Markdown code blocks.
+include_verbatim = false
+
+# Verbose program output
+verbose = "error"
+
+# Don't show interactive progress bar while checking links.
+no_progress = false
+
+# Comma-separated list of accepted status codes for valid links.
+accept = ["200..=204", "429"]
+
+# Link caching to avoid checking the same links on multiple runs.
+cache = true
+
+# Discard all cached requests older than this duration.
+max_cache_age = "3d"
+
+# Maximum number of allowed retries before a link is declared dead.
+max_retries = 3
+
+# Minimum wait time in seconds between retries of failed requests.
+retry_wait_time = 2

From 8dc170f4ed49e5014df1bd7b709efb36157edb55 Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 19:00:29 +0100
Subject: [PATCH 10/29] Add the source content link to ignore

---
 .github/workflows/check-links.yml | 2 +-
 lychee.toml                       | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml
index ccfbb0b8..f7e35b13 100644
--- a/.github/workflows/check-links.yml
+++ b/.github/workflows/check-links.yml
@@ -1,4 +1,4 @@
-name: Broken links check
+name: Check links
 on: [pull_request, workflow_dispatch]
 
 env:
diff --git a/lychee.toml b/lychee.toml
index a8b8fd92..e74b06fb 100644
--- a/lychee.toml
+++ b/lychee.toml
@@ -10,12 +10,10 @@ exclude = [
     "googletagmanager.com/*",
     "x.com/*",
 
-    "https://x/",
     "stackoverflow.com/questions/*",
     "openjdk.org/*",
     "npmjs.com/*",
-
-    # Temporarily broken links.
+    "raw.githubusercontent.com/SpineEventEngine/*"
 ]
 
 # Exclude these filesystem paths from getting checked.

From 1229fa05986ffe559771709ae8488455719847f0 Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 19:00:46 +0100
Subject: [PATCH 11/29] Add theme updates with the fixed links

---
 site/go.mod | 2 +-
 site/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/site/go.mod b/site/go.mod
index db4cdf8b..8362ca17 100644
--- a/site/go.mod
+++ b/site/go.mod
@@ -3,6 +3,6 @@ module github.com/SpineEventEngine/SpineEventEngine.github.io
 go 1.22.0
 
 require (
-    github.com/SpineEventEngine/documentation/docs v0.0.0-20251215141546-8a4bbba5b1e4 // indirect
+	github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f // indirect
 	github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff // indirect
 )
diff --git a/site/go.sum b/site/go.sum
index 82cb7442..f599b293 100644
--- a/site/go.sum
+++ b/site/go.sum
@@ -1,4 +1,4 @@
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215141546-8a4bbba5b1e4 h1:9PdrpO1Elll1u7I4gUy1rQ73zQRT/N9txtKAXlwM8Lg=
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215141546-8a4bbba5b1e4/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f h1:TONIMY1Pcb+eE/H6hK0T9RNBQqA/gqAv+BFaZj4h7CY=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff h1:8kjfGJhf6LeS+IlK9NRktxtcv6O/WDneBuQD3QLPGIs=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff/go.mod h1:atDeksDWBzsIidpW6Ivz2yYHwp2JPa1i1KXIxkctQ3c=

From 1eef12c1945c1e45516ebf1ca573e4be568c682a Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 19:02:21 +0100
Subject: [PATCH 12/29] Disable the test rule

---
 .github/workflows/gh-pages.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
index 313bc613..ba4df0f7 100644
--- a/.github/workflows/gh-pages.yml
+++ b/.github/workflows/gh-pages.yml
@@ -1,7 +1,9 @@
 name: Deploy to GitHub Pages
 
 on:
-  pull_request:
+  push:
+    branches:
+      - master
 
 env:
   HUGO_VERSION: 0.147.8

From bdf8ae9ff4ce8ccc8b146910943b52817317d81a Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 19:26:03 +0100
Subject: [PATCH 13/29] Remove the link to the previously used repository

---
 site/content/release-notes/2018/v1.0.0-pre1.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/site/content/release-notes/2018/v1.0.0-pre1.md b/site/content/release-notes/2018/v1.0.0-pre1.md
index 8ec968ff..bb8c678b 100644
--- a/site/content/release-notes/2018/v1.0.0-pre1.md
+++ b/site/content/release-notes/2018/v1.0.0-pre1.md
@@ -24,6 +24,7 @@ introducing a JUnit extension for muting redundant test output;
 - entity IDs are now always validated as if `(required) = true`.
 
 ## CoreJvm
+
 This is a preview release of the Spine 1.0 version.
 
 #### New Maven Repository
@@ -33,8 +34,6 @@ In this version one more artifact repository is introduced:
 - Releases: [https://spine.mycloudrepo.io/public/repositories/releases](https://spine.mycloudrepo.io/public/repositories/releases)
 - Snapshots: [https://spine.mycloudrepo.io/public/repositories/snapshots](https://spine.mycloudrepo.io/public/repositories/snapshots)
 
-The [previously used repository](https://maven.teamdev.com/repository/spine/) is also maintained.
-
 #### Features and Improvements
 
 Since 0.10.0 several significant features were introduced, making the framework near the 

From bf122dcbcfa1e51194ef99f916e8343413f3665a Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 19:27:30 +0100
Subject: [PATCH 14/29] Get documentation updates

---
 site/go.mod | 2 +-
 site/go.sum | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/site/go.mod b/site/go.mod
index 8362ca17..169e9160 100644
--- a/site/go.mod
+++ b/site/go.mod
@@ -3,6 +3,6 @@ module github.com/SpineEventEngine/SpineEventEngine.github.io
 go 1.22.0
 
 require (
-	github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f // indirect
+	github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036 // indirect
 	github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff // indirect
 )
diff --git a/site/go.sum b/site/go.sum
index f599b293..367a48cc 100644
--- a/site/go.sum
+++ b/site/go.sum
@@ -1,4 +1,4 @@
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f h1:TONIMY1Pcb+eE/H6hK0T9RNBQqA/gqAv+BFaZj4h7CY=
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215175234-fcb7c0cc7f7f/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036 h1:GaugXCtbW6TNbSFJiO/gYCAJ1NtAFMpkfcA9RcZh28g=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff h1:8kjfGJhf6LeS+IlK9NRktxtcv6O/WDneBuQD3QLPGIs=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff/go.mod h1:atDeksDWBzsIidpW6Ivz2yYHwp2JPa1i1KXIxkctQ3c=

From 0d5b8c437ea16f7c8441979b68846977615af073 Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Mon, 15 Dec 2025 20:20:32 +0100
Subject: [PATCH 15/29] Configure Lychee to test the site locally

---
 AUTHORING.md           |  21 +++----
 _script/jekyll-build   |  40 -------------
 _script/jekyll-serve   |  40 -------------
 _script/proof-links    |  10 +---
 site/package-lock.json | 125 +++++++++++++++++++++++++++++++++++++++++
 site/package.json      |   1 +
 6 files changed, 140 insertions(+), 97 deletions(-)
 delete mode 100755 _script/jekyll-build
 delete mode 100755 _script/jekyll-serve

diff --git a/AUTHORING.md b/AUTHORING.md
index 79bf5d92..6ab9eb16 100644
--- a/AUTHORING.md
+++ b/AUTHORING.md
@@ -91,30 +91,31 @@ Please see [this document](_code/EMBEDDING.md) for the instructions.
 
 # Testing broken links
 
-We use the [html-proofer](https://github.com/gjtorikian/html-proofer) tool to test broken links.
-To start test locally you may be required to install the Gem of the tool first:
+We use the [Lychee](https://github.com/lycheeverse/lychee) tool to test broken links.
+To start test locally you may be required to install the tool first from the `site` directory:
 
 ```bash
-bundle install
+npm install
 ```
-... and then build the site:
+... and then run the site:
  
 ```bash
-jekyll build
+hugo server
 ``` 
 
-After that, please use the following command:
+Make sure it runs on port `1313`. 
+After that, please use the following command from the root of the project:
 
 ```bash
 ./_script/proof-links
 ```
 
 > We only log errors falling within the 4xx status code range. 
-> Please note that links to GitHub are ignored by --http-status-ignore "429" command, because GitHub rejects the check
-> coming from htmlproofer. Details of this are described in [this issue](https://github.com/gjtorikian/html-proofer/issues/226). 
+> Please note that some of the links are added to excludes in the [`lychee.toml`](lychee.toml) file.
 
-Also, we have a GitHub Action which tests the links when the pull request is created to the `master`. 
-Please see the [`.github/workflows/proof-links.yml`](.github/workflows/proof-links.yml) file for details.
+Also, we have a GitHub Action which tests the links when a pull request is created. 
+Please see the [`.github/workflows/check-links.yml`](.github/workflows/check-links.yml) 
+file for details.
 
 # Cloak email
 
diff --git a/_script/jekyll-build b/_script/jekyll-build
deleted file mode 100755
index 4a09596d..00000000
--- a/_script/jekyll-build
+++ /dev/null
@@ -1,40 +0,0 @@
-#!/usr/bin/env bash
-#
-# Copyright 2020, TeamDev. All rights reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Redistribution and use in source and/or binary forms, with or without
-# modification, must retain the above copyright notice and the following
-# disclaimer.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-#
-
-# Load environment variables for the case of execution from the Gradle build if they exist.
-BASH_PROFILE=~/.bash_profile
-BASH_RC=~/.bashrc
-
-if [ -f ${BASH_PROFILE} ]; then
-  echo "Using user's local bash profile."
-  . ${BASH_PROFILE}
-elif [ -f ${BASH_RC} ]; then
-  echo "Using user's local bash runtime configuration."
-  . ${BASH_RC}
-fi
-
-bundle exec jekyll build
diff --git a/_script/jekyll-serve b/_script/jekyll-serve
deleted file mode 100755
index 99c0a8bc..00000000
--- a/_script/jekyll-serve
+++ /dev/null
@@ -1,40 +0,0 @@
-#!/usr/bin/env bash
-#
-# Copyright 2020, TeamDev. All rights reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Redistribution and use in source and/or binary forms, with or without
-# modification, must retain the above copyright notice and the following
-# disclaimer.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-#
-
-# Load environment variables for the case of execution from the Gradle build if they exist.
-BASH_PROFILE=~/.bash_profile
-BASH_RC=~/.bashrc
-
-if [ -f ${BASH_PROFILE} ]; then
-  echo "Using user's local bash profile."
-  . ${BASH_PROFILE}
-elif [ -f ${BASH_RC} ]; then
-  echo "Using user's local bash runtime configuration."
-  . ${BASH_RC}
-fi
-
-bundle exec jekyll serve
diff --git a/_script/proof-links b/_script/proof-links
index bc6dd4f2..c1e14bff 100755
--- a/_script/proof-links
+++ b/_script/proof-links
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# Copyright 2020, TeamDev. All rights reserved.
+# Copyright 2025, TeamDev. All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -37,9 +37,5 @@ elif [ -f ${BASH_RC} ]; then
   . ${BASH_RC}
 fi
 
-# Check the links used by the site.
-bundle exec htmlproofer \
-  --assume-extension ./_site \
-  --only_4xx \
-  --http-status-ignore "429" \
-  --url-ignore "/twitter.com/"
+cd site
+lychee --config ../lychee.toml --base http://localhost:1313 "public/**/*.html"
diff --git a/site/package-lock.json b/site/package-lock.json
index 11407c13..00ca1ea3 100644
--- a/site/package-lock.json
+++ b/site/package-lock.json
@@ -14,6 +14,7 @@
       "devDependencies": {
         "@fullhuman/postcss-purgecss": "^7.0.2",
         "autoprefixer": "^10.4.22",
+        "lychee": "^0.2.12",
         "postcss": "^8.5.6",
         "postcss-cli": "^11.0.1",
         "postcss-discard-comments": "^7.0.5"
@@ -195,6 +196,15 @@
         "node": ">= 8"
       }
     },
+    "node_modules/async": {
+      "version": "0.1.22",
+      "resolved": "https://registry.npmjs.org/async/-/async-0.1.22.tgz",
+      "integrity": "sha512-2tEzliJmf5fHNafNwQLJXUasGzQCVctvsNkXmnlELHwypU0p08/rHohYvkqKIjyXpx+0rkrYv6QbhJ+UF4QkBg==",
+      "dev": true,
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/autoprefixer": {
       "version": "10.4.22",
       "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.22.tgz",
@@ -316,6 +326,18 @@
         "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
       }
     },
+    "node_modules/buffalo": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/buffalo/-/buffalo-0.1.3.tgz",
+      "integrity": "sha512-LCN4KZKQ9tSTg2IMfq5Rrl8g3Vsx3D7X/iBhFjboUvwY0mgnngi/GkU9P7fQzkq0obFcTv4YHwgXyxGmfTIRzQ==",
+      "dev": true,
+      "dependencies": {
+        "tosource": "0.1.1"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/caniuse-lite": {
       "version": "1.0.30001757",
       "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001757.tgz",
@@ -532,6 +554,15 @@
         "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
       }
     },
+    "node_modules/generic-pool": {
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/generic-pool/-/generic-pool-1.0.12.tgz",
+      "integrity": "sha512-/FreBY2vliRCKXE+avFbi9pDEQFLPF1jqMM9EMHN7EgqrEUNYw8FOv26JJG3Sfw7THq3Kvk000PxkzjvAl510A==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.2.0"
+      }
+    },
     "node_modules/get-caller-file": {
       "version": "2.0.5",
       "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
@@ -666,6 +697,13 @@
         "graceful-fs": "^4.1.6"
       }
     },
+    "node_modules/juicy": {
+      "version": "0.2.5",
+      "resolved": "https://registry.npmjs.org/juicy/-/juicy-0.2.5.tgz",
+      "integrity": "sha512-mXr84tI+pKwMAnseKmSpPMVZ2KjkViPKo2i5eu5XQAacEXQrv80F1aIEecSZyQW2Ff1dPVsSNGPc1lEkVM/9Yg==",
+      "deprecated": "This package is no longer maintained",
+      "dev": true
+    },
     "node_modules/lilconfig": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz",
@@ -687,6 +725,20 @@
         "node": "20 || >=22"
       }
     },
+    "node_modules/lychee": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/lychee/-/lychee-0.2.12.tgz",
+      "integrity": "sha512-PdBo9+0mGIF7zSq/eY/h/7EIZIaFZI4AF9sHkz2sMjtTzpBoSc1jmrfgaXlzqqAFe4kwKcBo9CuytvehDOGuQw==",
+      "dev": true,
+      "dependencies": {
+        "async": "0.1.22",
+        "juicy": "0.2.5",
+        "mongolian": "0.1.18",
+        "pg": "0.8.3",
+        "request": "2.9.203",
+        "sanitizer": "0.0.15"
+      }
+    },
     "node_modules/minimatch": {
       "version": "10.1.1",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.1.1.tgz",
@@ -711,6 +763,20 @@
         "node": ">=16 || 14 >=14.17"
       }
     },
+    "node_modules/mongolian": {
+      "version": "0.1.18",
+      "resolved": "https://registry.npmjs.org/mongolian/-/mongolian-0.1.18.tgz",
+      "integrity": "sha512-gtEjtn5FfyKBslW0VjHf+hGqKU50NsGhDt4trPYfxlu3OqnWNSFkE0yJrTkwSaP1louLotFoWzKwUfOT9rOQ2w==",
+      "dev": true,
+      "dependencies": {
+        "buffalo": "0.1.3",
+        "taxman": "0.1.1",
+        "waiter": "0.1.1"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/nanoid": {
       "version": "3.3.11",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
@@ -784,6 +850,19 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
+    "node_modules/pg": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/pg/-/pg-0.8.3.tgz",
+      "integrity": "sha512-ablcQJGJmIx4y2muZSiyrPo1TyIFVGgz1smR8TyoVsdl1JU/g3+2aOAYJ0YQm+HRXBvHaSbG1y6fpBDSDtVxBA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "dependencies": {
+        "generic-pool": "1.0.12"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
     "node_modules/picocolors": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
@@ -1024,6 +1103,16 @@
         "node": ">=8.10.0"
       }
     },
+    "node_modules/request": {
+      "version": "2.9.203",
+      "resolved": "https://registry.npmjs.org/request/-/request-2.9.203.tgz",
+      "integrity": "sha512-OWtna9w7yRI/gcfu3VaURgIwE1FHgbz5+fHGQ9GJTHcJ4+uvHnDjXd+N7mVDOv5+1fp1CRPzUSY2wcM345Z2Fw==",
+      "deprecated": "request has been deprecated, see https://github.com/request/request/issues/3142",
+      "dev": true,
+      "engines": [
+        "node >= 0.3.6"
+      ]
+    },
     "node_modules/require-directory": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
@@ -1033,6 +1122,15 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/sanitizer": {
+      "version": "0.0.15",
+      "resolved": "https://registry.npmjs.org/sanitizer/-/sanitizer-0.0.15.tgz",
+      "integrity": "sha512-czIh3bPhxzhBUQsbJXMnvPClvh+tQTnY1bkQlHq1nUKyuCjcs/m6zG/gKU3CXet+xhS5vWKWkfZyCmL9/WFFKQ==",
+      "dev": true,
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/shebang-command": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
@@ -1141,6 +1239,15 @@
         "node": ">=8"
       }
     },
+    "node_modules/taxman": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/taxman/-/taxman-0.1.1.tgz",
+      "integrity": "sha512-woTa2sNzlGapMORbp1PDDeyMl6/2RudPV1z7Wtdx7nzI+FzEawi84yPGzrq57nrkA/kEpWVJZ9K6sXQ9TIhNNg==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/thenby": {
       "version": "1.3.4",
       "resolved": "https://registry.npmjs.org/thenby/-/thenby-1.3.4.tgz",
@@ -1204,6 +1311,15 @@
         "node": ">=8.0"
       }
     },
+    "node_modules/tosource": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/tosource/-/tosource-0.1.1.tgz",
+      "integrity": "sha512-hTnpPZBZP4DggtRpIAxQi74N4z5vs+Yx3Wcj2CNWLAKPRidZbLN2y5bPn1NI5EoojGzQ1btLzaj7poqsiRsmQA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/universalify": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
@@ -1249,6 +1365,15 @@
       "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
       "dev": true
     },
+    "node_modules/waiter": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/waiter/-/waiter-0.1.1.tgz",
+      "integrity": "sha512-OWMX6RloKF1S0uwF/czC08ZFTcksNFRSGeLu3mt7LhQ0daOvnJaKDtgGSULUvuFNfGe093VE9rRGbCo+ceyS+g==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/which": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
diff --git a/site/package.json b/site/package.json
index 52a5f174..d36f8a94 100644
--- a/site/package.json
+++ b/site/package.json
@@ -11,6 +11,7 @@
   "devDependencies": {
     "@fullhuman/postcss-purgecss": "^7.0.2",
     "autoprefixer": "^10.4.22",
+    "lychee": "^0.2.12",
     "postcss": "^8.5.6",
     "postcss-cli": "^11.0.1",
     "postcss-discard-comments": "^7.0.5"

From b2b672b75e0c6ec51d4b7ef56161b5d00902561b Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Tue, 16 Dec 2025 10:51:58 +0100
Subject: [PATCH 16/29] Rename `check-links` action to `proof-links` to be
 corresponding with the script

---
 .github/workflows/check-links.yml | 113 --------------------------
 .github/workflows/proof-links.yml | 128 ++++++++++++++++++++++++------
 AUTHORING.md                      |   4 +-
 README.md                         |   8 +-
 4 files changed, 109 insertions(+), 144 deletions(-)
 delete mode 100644 .github/workflows/check-links.yml

diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml
deleted file mode 100644
index f7e35b13..00000000
--- a/.github/workflows/check-links.yml
+++ /dev/null
@@ -1,113 +0,0 @@
-name: Check links
-on: [pull_request, workflow_dispatch]
-
-env:
-  HUGO_VERSION: 0.147.8
-  GH_USER: cloud-cannon-teamdev-integration
-  LYCHEE_RELEASE: "lychee-v0.15.1-x86_64-unknown-linux-gnu.tar.gz"
-  LYCHEE_VERSION_TAG: "v0.15.1"
-
-jobs:
-  check-links:
-    runs-on: ubuntu-latest
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v3
-        with:
-          hugo-version: ${{ env.HUGO_VERSION }}
-          extended: true
-
-      - name: Setup Node
-        uses: actions/setup-node@v3
-        with:
-          node-version: '20'
-
-      - name: Cache dependencies
-        uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-node-
-
-      - name: Cache Hugo Modules
-        uses: actions/cache@v4
-        with:
-          path: /tmp/hugo_cache
-          key: ${{ runner.os }}-hugomod-${{ hashFiles('**/go.sum') }}
-          restore-keys: |
-            ${{ runner.os }}-hugomod-
-
-      - name: Prepare environment
-        run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com"
-
-      - name: Install Dependencies
-        working-directory: site
-        run: npm ci
-
-      - name: Build Spine
-        working-directory: site
-        run: hugo -e development
-
-      # Cache Lychee results to avoid hitting rate limits.
-      - name: Cache Lychee results
-        uses: actions/cache@v4
-        with:
-          path: .lycheecache
-          key: cache-lychee-results
-
-      - name: Cache Lychee executable
-        id: cache-lychee
-        uses: actions/cache@v4
-        with:
-          path: lychee
-          key: ${{ runner.os }}-${{ env.LYCHEE_RELEASE }}
-
-      # We use Lychee directly instead of a GitHub Action because it
-      # must have access the local Hugo server, which is not visible
-      # from the Docker-based action.
-      - name: Download Lychee executable
-        uses: robinraju/release-downloader@v1.7
-        if: steps.cache-lychee.outputs.cache-hit != 'true'
-        with:
-          repository: "lycheeverse/lychee"
-          tag: ${{ env.LYCHEE_VERSION_TAG }}
-          fileName: ${{ env.LYCHEE_RELEASE }}
-
-      - name: Extract Lychee executable
-        if: steps.cache-lychee.outputs.cache-hit != 'true'
-        run: |
-          mkdir -p lychee &&
-          tar -xf ${{ env.LYCHEE_RELEASE }} -C lychee
-
-      # 1. In the generated HTML, some inner links will have absolute URLs and
-      #    the link checker will attempt to fetch them. That's why we need
-      #    a server. Sadly, link checkers have no settings to address this.
-      # 2. Output redirection is necessary for nohup in GitHub Actions.
-      # 3. Sleep makes sure the server is up before the next step.
-      - name: Start Hugo server
-        working-directory: site
-        run: |
-          nohup hugo server \
-          --environment development \
-          > nohup.out 2> nohup.err < /dev/null & 
-          sleep 5
-
-      - name: Check if the cache file exists
-        run: |
-          if [ -f ".lycheecache" ]; then
-            echo "Lychee cache exists."
-          else
-            echo "No lychee cache file."
-          fi
-
-      - name: Check links
-        run: |
-          ./lychee/lychee --config lychee.toml --timeout 60 \
-          --base http://localhost:1313/ \
-          'site/public/**/*.html'
diff --git a/.github/workflows/proof-links.yml b/.github/workflows/proof-links.yml
index f6e8df67..5e23e715 100644
--- a/.github/workflows/proof-links.yml
+++ b/.github/workflows/proof-links.yml
@@ -1,37 +1,113 @@
 name: Proof Links
+on: [pull_request, workflow_dispatch]
 
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
+env:
+  HUGO_VERSION: 0.147.8
+  GH_USER: cloud-cannon-teamdev-integration
+  LYCHEE_RELEASE: "lychee-v0.15.1-x86_64-unknown-linux-gnu.tar.gz"
+  LYCHEE_VERSION_TAG: "v0.15.1"
 
 jobs:
-  proof-links:
+  check-links:
     runs-on: ubuntu-latest
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: ${{ env.HUGO_VERSION }}
+          extended: true
+
+      - name: Setup Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Cache Hugo Modules
+        uses: actions/cache@v4
+        with:
+          path: /tmp/hugo_cache
+          key: ${{ runner.os }}-hugomod-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-hugomod-
+
+      - name: Prepare environment
+        run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com"
+
+      - name: Install Dependencies
+        working-directory: site
+        run: npm ci
+
+      - name: Build Spine
+        working-directory: site
+        run: hugo -e development
+
+      # Cache Lychee results to avoid hitting rate limits.
+      - name: Cache Lychee results
+        uses: actions/cache@v4
         with:
-          submodules: 'recursive'
+          path: .lycheecache
+          key: cache-lychee-results
 
-      - name: Set up Ruby and Bundler
-        uses: ruby/setup-ruby@v1
+      - name: Cache Lychee executable
+        id: cache-lychee
+        uses: actions/cache@v4
         with:
-          ruby-version: '2.7.4'
-
-      # Bundler version is restricted to `2.4.22`,
-      # as we want to use Ruby `2.7.4` to match GH Pages environment.
-      #
-      # Any newer versions of Bundler require Ruby 3.x,
-      # which are much newer than what's GH Pages has at the moment.
-      #
-      - name: Run Jekyll build
+          path: lychee
+          key: ${{ runner.os }}-${{ env.LYCHEE_RELEASE }}
+
+      # We use Lychee directly instead of a GitHub Action because it
+      # must have access the local Hugo server, which is not visible
+      # from the Docker-based action.
+      - name: Download Lychee executable
+        uses: robinraju/release-downloader@v1.7
+        if: steps.cache-lychee.outputs.cache-hit != 'true'
+        with:
+          repository: "lycheeverse/lychee"
+          tag: ${{ env.LYCHEE_VERSION_TAG }}
+          fileName: ${{ env.LYCHEE_RELEASE }}
+
+      - name: Extract Lychee executable
+        if: steps.cache-lychee.outputs.cache-hit != 'true'
         run: |
-          gem install bundler -v 2.4.22
-          bundle install
-          bundle exec jekyll build
+          mkdir -p lychee &&
+          tar -xf ${{ env.LYCHEE_RELEASE }} -C lychee
 
-      - name: Proof Links
-        run: ./_script/proof-links
+      # 1. In the generated HTML, some inner links will have absolute URLs and
+      #    the link checker will attempt to fetch them. That's why we need
+      #    a server. Sadly, link checkers have no settings to address this.
+      # 2. Output redirection is necessary for nohup in GitHub Actions.
+      # 3. Sleep makes sure the server is up before the next step.
+      - name: Start Hugo server
+        working-directory: site
+        run: |
+          nohup hugo server \
+          --environment development \
+          > nohup.out 2> nohup.err < /dev/null & 
+          sleep 5
+
+      - name: Check if the cache file exists
+        run: |
+          if [ -f ".lycheecache" ]; then
+            echo "Lychee cache exists."
+          else
+            echo "No lychee cache file."
+          fi
+
+      - name: Check links
+        run: |
+          ./lychee/lychee --config lychee.toml --timeout 60 \
+          --base http://localhost:1313/ \
+          'site/public/**/*.html'
diff --git a/AUTHORING.md b/AUTHORING.md
index 6ab9eb16..9459d711 100644
--- a/AUTHORING.md
+++ b/AUTHORING.md
@@ -103,7 +103,7 @@ npm install
 hugo server
 ``` 
 
-Make sure it runs on port `1313`. 
+Make sure it runs on port `1313`.
 After that, please use the following command from the root of the project:
 
 ```bash
@@ -114,7 +114,7 @@ After that, please use the following command from the root of the project:
 > Please note that some of the links are added to excludes in the [`lychee.toml`](lychee.toml) file.
 
 Also, we have a GitHub Action which tests the links when a pull request is created. 
-Please see the [`.github/workflows/check-links.yml`](.github/workflows/check-links.yml) 
+Please see the [`.github/workflows/proof-links.yml`](.github/workflows/proof-links.yml) 
 file for details.
 
 # Cloak email
diff --git a/README.md b/README.md
index 54e64cc0..a995dd0c 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file.
 3. Install [Hugo Extended][hugo-quick-start] at least version `v0.145` or higher.
 4. Get access to the [`site-commons`][site-commons] repository from the admins
    to be able to download the theme.
-5. Make sure SSH is configured correctly and the passphrase is stored in the keychain.
+5. Make sure [SSH][site-commons-ssh] is configured correctly and the passphrase is stored in the keychain.
 6. Install project dependencies from the `site` directory by running `npm install`.
 
 ## Running the site locally
@@ -51,11 +51,11 @@ Another way to run the site locally is to follow these steps:
 
 ## Documentation
 
-The documentation is located in a [separate repository](https://github.com/SpineEventEngine/documentation.git).
+The documentation is located in a [separate repository][documentation-repo].
 It is added to this site as a Hugo Module.
 
 Any changes to the documentation must be made in its own 
-[repository](https://github.com/SpineEventEngine/documentation.git).
+[repository][documentation-repo].
 
 The `documentation` repository is made to be self-sustainable in terms of editing. A fully-fledged 
 Hugo site has been set up for it. All the contents and links in it are working as intended. 
@@ -104,5 +104,7 @@ the [`AUTHORING.md`](AUTHORING.md) file.
 [nodejs]: https://nodejs.org/en/download/current
 [hugo-quick-start]: https://gohugo.io/getting-started/quick-start/#step-1-install-hugo
 [site-commons]: https://github.com/TeamDev-Ltd/site-commons
+[site-commons-ssh]: https://github.com/TeamDev-Ltd/site-commons/tree/master?tab=readme-ov-file#configure-go-to-use-ssh-for-github
 [hugo-modules]: https://gohugo.io/hugo-modules/introduction
 [embed-code]: https://github.com/SpineEventEngine/embed-code/tree/embed-code-go
+[documentation-repo]: https://github.com/SpineEventEngine/documentation.git

From cee3d173b8882556ad2b49c6004fe3c610201cb5 Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Tue, 16 Dec 2025 11:07:01 +0100
Subject: [PATCH 17/29] Move `gitignore` to the root

---
 .gitignore      | 27 ++++++++++---------
 site/.gitignore | 72 -------------------------------------------------
 2 files changed, 15 insertions(+), 84 deletions(-)
 delete mode 100644 site/.gitignore

diff --git a/.gitignore b/.gitignore
index 9a43667a..6b29beb2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,20 +1,21 @@
-# The result of Jekyll build
-_site/
+# Hugo cache files
+/site/resources
+public
 
-# Intermediate directory used by `embed-code` Jekyll subcommand
-.fragments
+# Cache folder for Hugo Modules
+/site/_vendor
 
-.sass-cache
-.jekyll-metadata
-.DS_Store
+# Node modules
+node_modules
 
-*/build/
+# Used to control concurrency between multiple Hugo instances
+/site/.hugo_build.lock
 
-**/*.jar
+# Needed for navigation help inside code editors
+jsconfig.json
 
-# Do not ignore the Gradle Wrapper at the top level and in the sub-projects that are
-# added as included builds. See `settings.gradle.kts` for details.
-!**/gradle/wrapper/*
+# The temporary Lychee cache obtained from local check
+.lycheecache
 
 # IntelliJ IDEA modules and interim config files
 *.iml
@@ -29,6 +30,8 @@ _site/
 !.idea/codeStyles/
 !.idea/copyright/
 
+.DS_Store
+
 # Gradle interim configs
 .gradle/
 
diff --git a/site/.gitignore b/site/.gitignore
deleted file mode 100644
index a72e6f71..00000000
--- a/site/.gitignore
+++ /dev/null
@@ -1,72 +0,0 @@
-# Hugo cache files
-/resources
-public
-
-# Cache folder for Hugo Modules
-_vendor
-
-# Node modules
-node_modules
-
-# Used to control concurrency between multiple Hugo instances
-.hugo_build.lock
-
-# Needed for navigation help inside code editors
-jsconfig.json
-
-# IntelliJ IDEA modules and interim config files
-*.iml
-.idea/*.xml
-.idea/.name
-.idea/artifacts
-.idea/libraries
-.idea/modules
-.idea/shelf
-
-!.idea/misc.xml
-!.idea/codeStyles/
-!.idea/copyright/
-
-.DS_Store
-
-# Gradle interim configs
-.gradle/
-
-# Generated source code
-generated/
-
-# Gradle build files
-build/
-
-# IDEA build files
-out/
-
-# Spine temporary artifact storage
-.spine/
-
-# Temporarily add the Spine Protoc plugin until this Base issue is fixed:
-#     https://github.com/SpineEventEngine/base/issues/552
-# Update the file when you bump Spine dependency in `samples` or `examples`.
-# The `.spine` directory must have all the versions of the plugin until the issue is fixed.
-!/.spine/spine-protoc-plugin-1.5.21.jar
-
-# Credentials to Maven repositories and Google Cloud Storage used for Travis build reports
-credentials.tar
-credentials.properties
-cloudrepo.properties
-deploy_key_rsa
-gcs-auth-key.json
-
-#
-# The gradle.properties file should contain settings specific to a developer's workstation.
-#
-# See sample file for a Mac OS X workstation below.
-# -------
-# # Set Java home to point to JDK8. This is need to generate classes working with Java8 API.
-# # Otherwise the following warning appears during the build:
-# #     warning: [options] bootstrap class path not set in conjunction with -source 1.8
-# #
-# # suppress inspection "UnusedProperty"
-# org.gradle.java.home=/Library/Java/JavaVirtualMachines/jdk1.8.0_51.jdk/Contents/Home/
-# -------
-gradle.properties

From 3298a1a529bebaf8864069e5de73004cf355ba97 Mon Sep 17 00:00:00 2001
From: "julia.evseeva" 
Date: Tue, 16 Dec 2025 11:56:31 +0100
Subject: [PATCH 18/29] Make the current year in the release notes
 automatically opened

---
 site/go.mod                                       | 2 +-
 site/go.sum                                       | 4 ++--
 site/layouts/_partials/release-notes/sidenav.html | 7 +++++++
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/site/go.mod b/site/go.mod
index 169e9160..1b895b3f 100644
--- a/site/go.mod
+++ b/site/go.mod
@@ -3,6 +3,6 @@ module github.com/SpineEventEngine/SpineEventEngine.github.io
 go 1.22.0
 
 require (
-	github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036 // indirect
+	github.com/SpineEventEngine/documentation/docs v0.0.0-20251216105126-d1da958b0294 // indirect
 	github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff // indirect
 )
diff --git a/site/go.sum b/site/go.sum
index 367a48cc..7d45f642 100644
--- a/site/go.sum
+++ b/site/go.sum
@@ -1,4 +1,4 @@
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036 h1:GaugXCtbW6TNbSFJiO/gYCAJ1NtAFMpkfcA9RcZh28g=
-github.com/SpineEventEngine/documentation/docs v0.0.0-20251215182647-e6ce64213036/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251216105126-d1da958b0294 h1:RXxaFO0x3zqteoJ5B5r3/JYltseNNorawAFBeHYttu8=
+github.com/SpineEventEngine/documentation/docs v0.0.0-20251216105126-d1da958b0294/go.mod h1:0lSB4kPZY9Qk429mepYiraNIEucYDIwiNVhJ3Wn3gKo=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff h1:8kjfGJhf6LeS+IlK9NRktxtcv6O/WDneBuQD3QLPGIs=
 github.com/TeamDev-Ltd/site-commons v0.0.0-20251202150534-a795438915ff/go.mod h1:atDeksDWBzsIidpW6Ivz2yYHwp2JPa1i1KXIxkctQ3c=
diff --git a/site/layouts/_partials/release-notes/sidenav.html b/site/layouts/_partials/release-notes/sidenav.html
index e287bbf9..4c9df53f 100644
--- a/site/layouts/_partials/release-notes/sidenav.html
+++ b/site/layouts/_partials/release-notes/sidenav.html
@@ -26,15 +26,22 @@
 
 {{ $page := . }}
 {{ $sidenavData := partial "release-notes/functions/get-releases.html" . }}
+{{ $yearNow := "nil" }}
+
+{{ if eq $.File.Path "release-notes/_index.md" }}
+    {{ $yearNow = now.Format "2006" }}
+{{ end }}
 
 {{ if $sidenavData }}
     {{ partial "docs/components/sidenav/mobile-header.html" . }}
     
    {{ range $sidenavData }} {{ if .children }} + {{ $isActive := eq .key $yearNow }} {{ partial "docs/components/sidenav/category.html" (dict "page_context" $page "item_context" . + "is_active" $isActive ) }} {{ else }} {{ partial "docs/components/sidenav/page.html" (dict From 39c4c6434a5b94fff7c50a6d04f4b3111ea1d471 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 12:25:31 +0100 Subject: [PATCH 19/29] Clean up `README` --- README.md | 12 +++++++----- _code/EMBEDDING.md | 22 +++++++++++++--------- 2 files changed, 20 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index a995dd0c..c793c587 100644 --- a/README.md +++ b/README.md @@ -66,19 +66,20 @@ are used to embed the content. ### Steps to get documentation updates -1. Clean the module cache: +1. Navigate to the `site` directory. +2. Clean the module cache: ```shell hugo mod clean ``` -2. Get the documentation Hugo Module: +3. Get the documentation Hugo Module: ```shell hugo mod get -u github.com/SpineEventEngine/documentation/docs ``` -3. Commit and push changes from `go.mod` and `go.sum` files. +4. Commit and push changes from `go.mod` and `go.sum` files. In the `go.sum` file keep only two last records to avoid file cluttering. ## Common theme @@ -86,13 +87,14 @@ are used to embed the content. This project uses the [`site-commons`][site-commons] Hugo theme for general components such as anchor icons, snackbars, etc. -1. To get theme updates, run: +1. Navigate to the `site` directory. +2. To get theme updates, run: ```shell hugo mod get -u github.com/TeamDev-Ltd/site-commons ``` -2. Commit and push changes from `go.mod` and `go.sum` files. +3. Commit and push changes from `go.mod` and `go.sum` files. In the `go.sum` file keep only two last records to avoid file cluttering. # Authoring diff --git a/_code/EMBEDDING.md b/_code/EMBEDDING.md index f727132a..b132749a 100644 --- a/_code/EMBEDDING.md +++ b/_code/EMBEDDING.md @@ -1,11 +1,12 @@ Embedding code ====== -Your actions for adding a code sample to the documentation may vary depending on the scenarios -described in this document. +We use the [embed-code][embed-code-repo] tool (Go version) to embed code snippets +to markdown pages. Take a look on its [README][embed-code-readme] file to know +how it works. - [The `_code` directory](#the---code--directory) -- [The Jekyll sub-command for embedding the code](#the-jekyll-sub-command-for-embedding-the-code) +- [The Go sub-command for embedding the code](#the-go-sub-command-for-embedding-the-code) - [Referencing existing code](#referencing-existing-code) - [Adding a new small piece](#adding-a-new-small-piece) - [Adding a new example project](#adding-a-new-example-project) @@ -20,24 +21,24 @@ There are two sub-directories under the `_code`: organization. These repositories added to this project as Git submodules. * `samples` — smaller pieces of code embedded to the site. -# The Jekyll sub-command for embedding the code +# The Go sub-command for embedding the code -We use the [`embed-code`](https://github.com/SpineEventEngine/embed-code) Jekyll subcommand for +We use the [`embed-code`](https://github.com/SpineEventEngine/embed-code) Go subcommand for adding the source code to Markdown pages. The tool allows inserting or updating a source code snippet using the specific instructions added to a Markdown page. -Please read the [`embed-code` documentation](https://github.com/SpineEventEngine/embed-code) to +Please read the [`embed-code` documentation][embed-code-readme] to familiarise with the syntax. -# Referencing existing code +# Referencing existing code -Just follow instructions from the [`embed-code` guide](https://github.com/SpineEventEngine/embed-code). +Just follow instructions from the [`embed-code` guide][embed-code-readme]. # Adding a new small piece 1. Add the code under `_code/samples/src` directory. 2. Make sure tests for the new code pass. - 3. Add the new piece using the [`embed-code` guide](https://github.com/SpineEventEngine/embed-code). + 3. Add the new piece using the [`embed-code` guide][embed-code-readme]. # Adding a new example project @@ -63,3 +64,6 @@ Just follow instructions from the [`embed-code` guide](https://github.com/SpineE file. After these steps you can embed the code into the pages of the site. + +[embed-code-repo]: https://github.com/SpineEventEngine/embed-code +[embed-code-readme]: https://github.com/SpineEventEngine/embed-code/blob/embed-code-go/embed-code-go/README.md From 3c0457af7f7f284f0e91536237ca6f6eb4ff0775 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 16:17:31 +0100 Subject: [PATCH 20/29] Check code samples in the `documentation` repository --- .github/workflows/check-code-embedding.yml | 50 ---------------- README.md | 4 +- TROUBLESHOOTING.md | 23 ------- _code/EMBEDDING.md | 70 ++-------------------- _script/check-samples | 40 ------------- _script/embed-code | 44 -------------- build.gradle.kts | 14 ----- settings.gradle.kts | 4 -- 8 files changed, 6 insertions(+), 243 deletions(-) delete mode 100644 .github/workflows/check-code-embedding.yml delete mode 100644 TROUBLESHOOTING.md delete mode 100755 _script/check-samples delete mode 100755 _script/embed-code diff --git a/.github/workflows/check-code-embedding.yml b/.github/workflows/check-code-embedding.yml deleted file mode 100644 index 2d5a46fd..00000000 --- a/.github/workflows/check-code-embedding.yml +++ /dev/null @@ -1,50 +0,0 @@ -name: Check Code Embedding - -on: - push: - branches: - - all - pull_request: - branches: - - master - -jobs: - - build-embedded-code: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v3 - with: - submodules: 'recursive' - - - uses: actions/setup-java@v3 - with: - java-version: 8 - distribution: zulu - - - run: ./gradlew :buildAll - - check-embedded-samples: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v3 - with: - submodules: 'recursive' - - - name: Set up Ruby - uses: ruby/setup-ruby@v1 - with: - ruby-version: '2.7.4' - - # Bundler version is restricted to `2.4.22`, - # as we want to use Ruby `2.7.4` to match GH Pages environment. - # - # Any newer versions of Bundler require Ruby 3.x, - # which are much newer than what's GH Pages has at the moment. - # - - run: | - gem install bundler -v 2.4.22 - bundle install - - - name: Check Embedding - run: ./_script/check-samples diff --git a/README.md b/README.md index c793c587..6d933e4c 100644 --- a/README.md +++ b/README.md @@ -38,10 +38,8 @@ To build the site without running the server: ./gradlew :buildSite ``` -If you experience issues with this step, please check out -the [Troubleshooting Guide](TROUBLESHOOTING.md). - Another way to run the site locally is to follow these steps: + 1. Navigate to the `site` folder. 2. Start the local server with this command: diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md deleted file mode 100644 index 7cf86d75..00000000 --- a/TROUBLESHOOTING.md +++ /dev/null @@ -1,23 +0,0 @@ -# Troubleshooting Ruby and Gem installation - -## Check the version of Ruby - -Jekyll, technically, works with Ruby 2.4.0. However, some of its dependencies may require a newer version of Ruby. -At the point of creating this memo, the 2.7.0 is the freshest version. Jekyll and its dependencies work with it fine. - -When installing Ruby via `brew`, the freshest version will be installed by default. It is still required to add the path -to the binary dist in the `$PATH`, for example: -``` -/usr/local/Cellar/ruby/2.7.0/bin/ -``` - -## Building native extensions - -In many cases, gems are provided with C-lang native extensions. The extensions are not compiled for all the combinations -of operating systems, operating system versions, and Ruby versions. If a pre-compiled extension artifact is missing, -`gem` will attempt to compile it locally. - -On MacOS of versions 10.14 and 10.15, the compilation may fail with a number of errors pointing at the `resource.h` -C-lang file. In this case, follow [this answer](https://stackoverflow.com/a/47401866/3183076) on StackOverflow: rename -the `/usr/local/include` directory to something else, e.g. `/usr/local/include_old`, so that the C compiler goes not -look there for the System API by default. diff --git a/_code/EMBEDDING.md b/_code/EMBEDDING.md index b132749a..841ec4be 100644 --- a/_code/EMBEDDING.md +++ b/_code/EMBEDDING.md @@ -1,69 +1,9 @@ Embedding code ====== -We use the [embed-code][embed-code-repo] tool (Go version) to embed code snippets -to markdown pages. Take a look on its [README][embed-code-readme] file to know -how it works. +The `embed-code` tool is currently not used in this project. +It is only used in the [documentation][documentation-repo] repository. +You can read more in the corresponding [EMBEDDING.md][embedding-readme]. -- [The `_code` directory](#the---code--directory) -- [The Go sub-command for embedding the code](#the-go-sub-command-for-embedding-the-code) -- [Referencing existing code](#referencing-existing-code) -- [Adding a new small piece](#adding-a-new-small-piece) -- [Adding a new example project](#adding-a-new-example-project) - -Table of contents generated with markdown-toc - -# The `_code` directory - -This directory contains the source code which is embedded into the pages of the spine.io site. -There are two sub-directories under the `_code`: - * `examples` — contains examples selected from the repositories under `spine-examples` - organization. These repositories added to this project as Git submodules. - * `samples` — smaller pieces of code embedded to the site. - -# The Go sub-command for embedding the code - -We use the [`embed-code`](https://github.com/SpineEventEngine/embed-code) Go subcommand for -adding the source code to Markdown pages. The tool allows inserting or updating a source code -snippet using the specific instructions added to a Markdown page. - -Please read the [`embed-code` documentation][embed-code-readme] to -familiarise with the syntax. - -# Referencing existing code - -Just follow instructions from the [`embed-code` guide][embed-code-readme]. - -# Adding a new small piece - - 1. Add the code under `_code/samples/src` directory. - 2. Make sure tests for the new code pass. - 3. Add the new piece using the [`embed-code` guide][embed-code-readme]. - -# Adding a new example project - - 1. Make sure the project you're going to add has a top-level `buildAll` Gradle task. - - See the [build of the Hello Example](https://github.com/spine-examples/hello/blob/master/build.gradle) - for the declaration of such a task. This task must present in both single- and multi-module - Gradle example projects that are going to be used for embedding into this site. - - If you are interested in the details on why the `buildAll` task is needed, please see - the `buildAll` task from the [`build.gradle.kts`](build.gradle.kts) of this project for - the links to discussions of the problem of building composite builds, and the solution we use. - - 2. Add the example code as a submodule for this project: - - ```bash - git submodule add https://github.com/spine-examples/ _code/examples/ - ``` - Please make sure the new submodule goes under the `_code/examples` directory, as shown in - the command line template above. - - 3. Include the build of the added project into the [`settings.gradle.kts`](settings.gradle.kts) - file. - -After these steps you can embed the code into the pages of the site. - -[embed-code-repo]: https://github.com/SpineEventEngine/embed-code -[embed-code-readme]: https://github.com/SpineEventEngine/embed-code/blob/embed-code-go/embed-code-go/README.md +[documentation-repo]: https://github.com/SpineEventEngine/documentation +[embedding-readme]: https://github.com/SpineEventEngine/documentation/tree/master/_code/EMBEDDING.md diff --git a/_script/check-samples b/_script/check-samples deleted file mode 100755 index f0d4fe47..00000000 --- a/_script/check-samples +++ /dev/null @@ -1,40 +0,0 @@ -#!/usr/bin/env bash -# -# Copyright 2020, TeamDev. All rights reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Redistribution and use in source and/or binary forms, with or without -# modification, must retain the above copyright notice and the following -# disclaimer. -# -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -# - -# Load environment variables for the case of execution from the Gradle build if they exist. -BASH_PROFILE=~/.bash_profile -BASH_RC=~/.bashrc - -if [ -f ${BASH_PROFILE} ]; then - echo "Using user's local bash profile." - . ${BASH_PROFILE} -elif [ -f ${BASH_RC} ]; then - echo "Using user's local bash runtime configuration." - . ${BASH_RC} -fi - -bundle exec jekyll checkCodeSamples diff --git a/_script/embed-code b/_script/embed-code deleted file mode 100755 index 93719072..00000000 --- a/_script/embed-code +++ /dev/null @@ -1,44 +0,0 @@ -#!/usr/bin/env bash -# -# Copyright 2020, TeamDev. All rights reserved. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Redistribution and use in source and/or binary forms, with or without -# modification, must retain the above copyright notice and the following -# disclaimer. -# -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -# - -# Load environment variables for the case of execution from the Gradle build if they exist. -BASH_PROFILE=~/.bash_profile -BASH_RC=~/.bashrc - -if [ -f ${BASH_PROFILE} ]; then - echo "Using user's local bash profile." - . ${BASH_PROFILE} -elif [ -f ${BASH_RC} ]; then - echo "Using user's local bash runtime configuration." - . ${BASH_RC} -fi - -# Ensure `_code` files are fetched. -git submodule update --remote --merge --recursive - -# Update code samples. -bundle exec jekyll embedCodeSamples diff --git a/build.gradle.kts b/build.gradle.kts index 73860950..42806e1e 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -38,13 +38,6 @@ task("buildSite") { commandLine("./_script/hugo-build") } -/** - * Embeds the code sames into pages of the site. - */ -task("embedCode") { - commandLine("./_script/embed-code") -} - /** * Verifies that the external links used by the site are available. */ @@ -52,13 +45,6 @@ task("checkLinks") { commandLine("./_script/proof-links") } -/** - * Verifies that the source code samples embedded into the pages are up-to-date. - */ -task("checkSamples") { - commandLine("./_script/check-samples") -} - /** * Builds all included projects via depending on the top-level "buildAll" tasks * declared in these projects. diff --git a/settings.gradle.kts b/settings.gradle.kts index b8d6fd96..b10de4e9 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -25,7 +25,3 @@ */ rootProject.name = "spine.io" - -includeBuild("./_code/samples") - -includeBuild("./_code/examples/hello") From c308e2a0baed7a76149f840f870b05ca598ce854 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 16:17:45 +0100 Subject: [PATCH 21/29] Remove the `_docs` submodule with Jekyll implementation --- .gitmodules | 3 --- 1 file changed, 3 deletions(-) diff --git a/.gitmodules b/.gitmodules index 598b1b9f..ff4eae4a 100644 --- a/.gitmodules +++ b/.gitmodules @@ -16,6 +16,3 @@ [submodule "_code/config"] path = config url = https://github.com/SpineEventEngine/config -[submodule "_docs"] - path = _docs - url = https://github.com/SpineEventEngine/documentation.git From 0a536093ed10e0232b0548f20812ac00eaa883aa Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 16:42:16 +0100 Subject: [PATCH 22/29] Clean up --- .github/workflows/proof-links.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/proof-links.yml b/.github/workflows/proof-links.yml index 5e23e715..00d00d53 100644 --- a/.github/workflows/proof-links.yml +++ b/.github/workflows/proof-links.yml @@ -8,7 +8,7 @@ env: LYCHEE_VERSION_TAG: "v0.15.1" jobs: - check-links: + proof-links: runs-on: ubuntu-latest concurrency: group: ${{ github.workflow }}-${{ github.ref }} From 7e93ae3a2267a99af925bc4e2695e1b72fe30ec5 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 17:49:20 +0100 Subject: [PATCH 23/29] Change the theme GH user --- .github/workflows/gh-pages.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index ba4df0f7..54eb7f6d 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -7,7 +7,7 @@ on: env: HUGO_VERSION: 0.147.8 - GH_USER: cloud-cannon-teamdev-integration + GH_USER: site-commons-machine-user jobs: deploy: @@ -17,7 +17,7 @@ jobs: steps: - uses: actions/checkout@v4 with: - token: ${{ secrets.GH_PAT }} + token: ${{ secrets.GH_SITE_COMMONS_PAT }} submodules: true fetch-depth: 0 @@ -49,7 +49,7 @@ jobs: ${{ runner.os }}-hugomod- - name: Prepare Environment - run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com" + run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_SITE_COMMONS_PAT }}@github.com".insteadOf "https://github.com" - name: Install Dependencies working-directory: site From 253824a2485c99aee3d5b12780178e49845d4047 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 17:49:43 +0100 Subject: [PATCH 24/29] Remove the `samples` that are now configured in `documentation` --- _code/samples/build.gradle | 80 -------- .../samples/gradle/wrapper/gradle-wrapper.jar | Bin 59203 -> 0 bytes .../gradle/wrapper/gradle-wrapper.properties | 5 - _code/samples/gradlew | 185 ------------------ _code/samples/gradlew.bat | 89 --------- _code/samples/settings.gradle | 27 --- .../spine/site/home/server/NanoPmContext.java | 49 ----- .../spine/site/home/server/TaskAggregate.java | 84 -------- .../site/home/server/TaskProjection.java | 65 ------ .../spine/site/home/server/package-info.java | 39 ---- .../src/main/proto/spine/example/events.proto | 41 ---- .../main/proto/spine/site/home/commands.proto | 55 ------ .../main/proto/spine/site/home/events.proto | 56 ------ .../proto/spine/site/home/identifiers.proto | 41 ---- .../src/main/proto/spine/site/home/task.proto | 59 ------ .../io/spine/example/CompiledProtobuf.java | 42 ---- .../site/home/server/TaskCreationTest.java | 122 ------------ 17 files changed, 1039 deletions(-) delete mode 100644 _code/samples/build.gradle delete mode 100644 _code/samples/gradle/wrapper/gradle-wrapper.jar delete mode 100644 _code/samples/gradle/wrapper/gradle-wrapper.properties delete mode 100755 _code/samples/gradlew delete mode 100644 _code/samples/gradlew.bat delete mode 100644 _code/samples/settings.gradle delete mode 100644 _code/samples/src/main/java/io/spine/site/home/server/NanoPmContext.java delete mode 100644 _code/samples/src/main/java/io/spine/site/home/server/TaskAggregate.java delete mode 100644 _code/samples/src/main/java/io/spine/site/home/server/TaskProjection.java delete mode 100644 _code/samples/src/main/java/io/spine/site/home/server/package-info.java delete mode 100644 _code/samples/src/main/proto/spine/example/events.proto delete mode 100644 _code/samples/src/main/proto/spine/site/home/commands.proto delete mode 100644 _code/samples/src/main/proto/spine/site/home/events.proto delete mode 100644 _code/samples/src/main/proto/spine/site/home/identifiers.proto delete mode 100644 _code/samples/src/main/proto/spine/site/home/task.proto delete mode 100644 _code/samples/src/test/java/io/spine/example/CompiledProtobuf.java delete mode 100644 _code/samples/src/test/java/io/spine/site/home/server/TaskCreationTest.java diff --git a/_code/samples/build.gradle b/_code/samples/build.gradle deleted file mode 100644 index 8b18b574..00000000 --- a/_code/samples/build.gradle +++ /dev/null @@ -1,80 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -plugins { - id "io.spine.tools.gradle.bootstrap" version "1.7.0" -} - -spine.enableJava().server() - -ext { - junitVersion = '5.7.0' -} - -dependencies { - testImplementation "org.junit.jupiter:junit-jupiter-api:$junitVersion" - testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:$junitVersion" -} - -test { - useJUnitPlatform { - includeEngines 'junit-jupiter' - } -} - -project.ext { - // The root for the generated source code. - generatedRootDir = "$projectDir/generated" - - // Directories for the code generated by the Protobuf Compiler and Spine plugins - // for the Compiler. - generatedJavaDir = "$generatedRootDir/main/java" - generatedTestJavaDir = "$generatedRootDir/test/java" - - // Directories for the Spine-specific code generated by the Spine Model Compiler, - // for example, rejections. - generatedSpineDir = "$generatedRootDir/main/spine" - generatedTestSpineDir = "$generatedRootDir/test/spine" -} - -apply plugin: 'idea' - -idea { - module { - // Add generated code directories to the source code of the module in IntelliJ IDEA. - generatedSourceDirs += file(generatedJavaDir) - generatedSourceDirs += file(generatedSpineDir) - testSourceDirs += file(generatedTestJavaDir) - testSourceDirs += file(generatedTestSpineDir) - } -} - -/** - * The task for composite builds to include this project and depend on this top-level task. - */ -task buildAll(type: GradleBuild) { - tasks = [ 'build' ] -} diff --git a/_code/samples/gradle/wrapper/gradle-wrapper.jar b/_code/samples/gradle/wrapper/gradle-wrapper.jar deleted file mode 100644 index e708b1c023ec8b20f512888fe07c5bd3ff77bb8f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59203 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

    K7UpUK$>l@ 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 E2O(~oYXATM diff --git a/_code/samples/gradle/wrapper/gradle-wrapper.properties b/_code/samples/gradle/wrapper/gradle-wrapper.properties deleted file mode 100644 index 4d9ca164..00000000 --- a/_code/samples/gradle/wrapper/gradle-wrapper.properties +++ /dev/null @@ -1,5 +0,0 @@ -distributionBase=GRADLE_USER_HOME -distributionPath=wrapper/dists -distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip -zipStoreBase=GRADLE_USER_HOME -zipStorePath=wrapper/dists diff --git a/_code/samples/gradlew b/_code/samples/gradlew deleted file mode 100755 index 4f906e0c..00000000 --- a/_code/samples/gradlew +++ /dev/null @@ -1,185 +0,0 @@ -#!/usr/bin/env sh - -# -# Copyright 2015 the original author or authors. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# https://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# - -############################################################################## -## -## Gradle start up script for UN*X -## -############################################################################## - -# Attempt to set APP_HOME -# Resolve links: $0 may be a link -PRG="$0" -# Need this for relative symlinks. -while [ -h "$PRG" ] ; do - ls=`ls -ld "$PRG"` - link=`expr "$ls" : '.*-> \(.*\)$'` - if expr "$link" : '/.*' > /dev/null; then - PRG="$link" - else - PRG=`dirname "$PRG"`"/$link" - fi -done -SAVED="`pwd`" -cd "`dirname \"$PRG\"`/" >/dev/null -APP_HOME="`pwd -P`" -cd "$SAVED" >/dev/null - -APP_NAME="Gradle" -APP_BASE_NAME=`basename "$0"` - -# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. -DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' - -# Use the maximum available, or set MAX_FD != -1 to use that value. -MAX_FD="maximum" - -warn () { - echo "$*" -} - -die () { - echo - echo "$*" - echo - exit 1 -} - -# OS specific support (must be 'true' or 'false'). -cygwin=false -msys=false -darwin=false -nonstop=false -case "`uname`" in - CYGWIN* ) - cygwin=true - ;; - Darwin* ) - darwin=true - ;; - MINGW* ) - msys=true - ;; - NONSTOP* ) - nonstop=true - ;; -esac - -CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar - - -# Determine the Java command to use to start the JVM. -if [ -n "$JAVA_HOME" ] ; then - if [ -x "$JAVA_HOME/jre/sh/java" ] ; then - # IBM's JDK on AIX uses strange locations for the executables - JAVACMD="$JAVA_HOME/jre/sh/java" - else - JAVACMD="$JAVA_HOME/bin/java" - fi - if [ ! -x "$JAVACMD" ] ; then - die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME - -Please set the JAVA_HOME variable in your environment to match the -location of your Java installation." - fi -else - JAVACMD="java" - which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. - -Please set the JAVA_HOME variable in your environment to match the -location of your Java installation." -fi - -# Increase the maximum file descriptors if we can. -if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then - MAX_FD_LIMIT=`ulimit -H -n` - if [ $? -eq 0 ] ; then - if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then - MAX_FD="$MAX_FD_LIMIT" - fi - ulimit -n $MAX_FD - if [ $? -ne 0 ] ; then - warn "Could not set maximum file descriptor limit: $MAX_FD" - fi - else - warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" - fi -fi - -# For Darwin, add options to specify how the application appears in the dock -if $darwin; then - GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" -fi - -# For Cygwin or MSYS, switch paths to Windows format before running java -if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then - APP_HOME=`cygpath --path --mixed "$APP_HOME"` - CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` - - JAVACMD=`cygpath --unix "$JAVACMD"` - - # We build the pattern for arguments to be converted via cygpath - ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` - SEP="" - for dir in $ROOTDIRSRAW ; do - ROOTDIRS="$ROOTDIRS$SEP$dir" - SEP="|" - done - OURCYGPATTERN="(^($ROOTDIRS))" - # Add a user-defined pattern to the cygpath arguments - if [ "$GRADLE_CYGPATTERN" != "" ] ; then - OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" - fi - # Now convert the arguments - kludge to limit ourselves to /bin/sh - i=0 - for arg in "$@" ; do - CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` - CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option - - if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition - eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` - else - eval `echo args$i`="\"$arg\"" - fi - i=`expr $i + 1` - done - case $i in - 0) set -- ;; - 1) set -- "$args0" ;; - 2) set -- "$args0" "$args1" ;; - 3) set -- "$args0" "$args1" "$args2" ;; - 4) set -- "$args0" "$args1" "$args2" "$args3" ;; - 5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; - 6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; - 7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; - 8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; - 9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; - esac -fi - -# Escape application args -save () { - for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done - echo " " -} -APP_ARGS=`save "$@"` - -# Collect all arguments for the java command, following the shell quoting and substitution rules -eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" - -exec "$JAVACMD" "$@" diff --git a/_code/samples/gradlew.bat b/_code/samples/gradlew.bat deleted file mode 100644 index 107acd32..00000000 --- a/_code/samples/gradlew.bat +++ /dev/null @@ -1,89 +0,0 @@ -@rem -@rem Copyright 2015 the original author or authors. -@rem -@rem Licensed under the Apache License, Version 2.0 (the "License"); -@rem you may not use this file except in compliance with the License. -@rem You may obtain a copy of the License at -@rem -@rem https://www.apache.org/licenses/LICENSE-2.0 -@rem -@rem Unless required by applicable law or agreed to in writing, software -@rem distributed under the License is distributed on an "AS IS" BASIS, -@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -@rem See the License for the specific language governing permissions and -@rem limitations under the License. -@rem - -@if "%DEBUG%" == "" @echo off -@rem ########################################################################## -@rem -@rem Gradle startup script for Windows -@rem -@rem ########################################################################## - -@rem Set local scope for the variables with windows NT shell -if "%OS%"=="Windows_NT" setlocal - -set DIRNAME=%~dp0 -if "%DIRNAME%" == "" set DIRNAME=. -set APP_BASE_NAME=%~n0 -set APP_HOME=%DIRNAME% - -@rem Resolve any "." and ".." in APP_HOME to make it shorter. -for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi - -@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. -set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" - -@rem Find java.exe -if defined JAVA_HOME goto findJavaFromJavaHome - -set JAVA_EXE=java.exe -%JAVA_EXE% -version >NUL 2>&1 -if "%ERRORLEVEL%" == "0" goto execute - -echo. -echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. -echo. -echo Please set the JAVA_HOME variable in your environment to match the -echo location of your Java installation. - -goto fail - -:findJavaFromJavaHome -set JAVA_HOME=%JAVA_HOME:"=% -set JAVA_EXE=%JAVA_HOME%/bin/java.exe - -if exist "%JAVA_EXE%" goto execute - -echo. -echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% -echo. -echo Please set the JAVA_HOME variable in your environment to match the -echo location of your Java installation. - -goto fail - -:execute -@rem Setup the command line - -set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar - - -@rem Execute Gradle -"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* - -:end -@rem End local scope for the variables with windows NT shell -if "%ERRORLEVEL%"=="0" goto mainEnd - -:fail -rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of -rem the _cmd.exe /c_ return code! -if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 -exit /b 1 - -:mainEnd -if "%OS%"=="Windows_NT" endlocal - -:omega diff --git a/_code/samples/settings.gradle b/_code/samples/settings.gradle deleted file mode 100644 index 55ac0f44..00000000 --- a/_code/samples/settings.gradle +++ /dev/null @@ -1,27 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -rootProject.name = "samples" diff --git a/_code/samples/src/main/java/io/spine/site/home/server/NanoPmContext.java b/_code/samples/src/main/java/io/spine/site/home/server/NanoPmContext.java deleted file mode 100644 index 6bdcb96e..00000000 --- a/_code/samples/src/main/java/io/spine/site/home/server/NanoPmContext.java +++ /dev/null @@ -1,49 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package io.spine.site.home.server; - -import io.spine.server.BoundedContext; -import io.spine.server.BoundedContextBuilder; - -/** - * Defines the Mini PM context. - */ -public final class NanoPmContext { - - static final String NAME = "Nano PM"; - - /** Prevents instantiation of this utility class. */ - private NanoPmContext() { - } - - /** Creates a builder for single-tenant context filled in with entity types. */ - public static BoundedContextBuilder newBuilder() { - return BoundedContext.singleTenant(NAME) - .add(TaskAggregate.class) - .add(TaskProjection.class); - } -} diff --git a/_code/samples/src/main/java/io/spine/site/home/server/TaskAggregate.java b/_code/samples/src/main/java/io/spine/site/home/server/TaskAggregate.java deleted file mode 100644 index 152f55f2..00000000 --- a/_code/samples/src/main/java/io/spine/site/home/server/TaskAggregate.java +++ /dev/null @@ -1,84 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package io.spine.site.home.server; - -import io.spine.core.CommandContext; -import io.spine.site.home.Task; -import io.spine.site.home.TaskId; -import io.spine.site.home.command.AssignTask; -import io.spine.site.home.command.CompleteTask; -import io.spine.site.home.command.CreateTask; -import io.spine.site.home.event.TaskAssigned; -import io.spine.site.home.event.TaskCompleted; -import io.spine.site.home.event.TaskCreated; -import io.spine.server.aggregate.Aggregate; -import io.spine.server.aggregate.Apply; -import io.spine.server.command.Assign; - -final class TaskAggregate extends Aggregate { - - @Assign - TaskCreated handle(CreateTask cmd, CommandContext ctx) { - return TaskCreated.newBuilder() - .setTask(cmd.getId()) - .setName(cmd.getName()) - .setDescription(cmd.getDescription()) - .setOwner(ctx.getActorContext().getActor()) - .vBuild(); // validate the event - } - - @Apply - private void event(TaskCreated e) { - builder().setName(e.getName()) - .setDescription(e.getDescription()) - .setOwner(e.getOwner()); - } - - @Assign - TaskCompleted handle(CompleteTask cmd) { - return TaskCompleted.newBuilder() - .setTask(cmd.getTask()) - .vBuild(); - } - - @Apply - private void event(TaskCompleted e) { - setArchived(true); - } - - @Assign - TaskAssigned handle(AssignTask cmd) { - return TaskAssigned.newBuilder() - .setAssignee(cmd.getAssignee()) - .vBuild(); - } - - @Apply - private void event(TaskAssigned e) { - builder().setAssignee(e.getAssignee()); - } -} diff --git a/_code/samples/src/main/java/io/spine/site/home/server/TaskProjection.java b/_code/samples/src/main/java/io/spine/site/home/server/TaskProjection.java deleted file mode 100644 index 03752f9c..00000000 --- a/_code/samples/src/main/java/io/spine/site/home/server/TaskProjection.java +++ /dev/null @@ -1,65 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package io.spine.site.home.server; - -import io.spine.core.EventContext; -import io.spine.core.Subscribe; -import io.spine.core.UserId; -import io.spine.site.home.TaskId; -import io.spine.site.home.TaskItem; -import io.spine.site.home.event.TaskAssigned; -import io.spine.site.home.event.TaskCompleted; -import io.spine.site.home.event.TaskCreated; -import io.spine.server.projection.Projection; - -final class TaskProjection extends Projection { - - @Subscribe - void on(TaskCreated e) { - builder().setName(e.getName()) - .setDescription(e.getDescription()) - .setOwner(toPersonName(e.getOwner())); - } - - @Subscribe - void on(TaskAssigned e) { - builder().setAssignee(toPersonName(e.getAssignee())); - } - - @Subscribe - void on(TaskCompleted e, EventContext ctx) { - builder().setWhenDone(ctx.getTimestamp()); - } - - /** - * Returns always the same mock name because this code is not going to be shown - * at the site pages. - */ - private static String toPersonName(@SuppressWarnings("unused") UserId user) { - return "John Doe"; - } -} diff --git a/_code/samples/src/main/java/io/spine/site/home/server/package-info.java b/_code/samples/src/main/java/io/spine/site/home/server/package-info.java deleted file mode 100644 index 13658d03..00000000 --- a/_code/samples/src/main/java/io/spine/site/home/server/package-info.java +++ /dev/null @@ -1,39 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -/** - * This package contains server-side implementation of the Mini PM example which is used - * at the site home page. - */ -@CheckReturnValue -@ParametersAreNonnullByDefault -@BoundedContext(NanoPmContext.NAME) -package io.spine.site.home.server; - -import com.google.errorprone.annotations.CheckReturnValue; -import io.spine.core.BoundedContext; - -import javax.annotation.ParametersAreNonnullByDefault; diff --git a/_code/samples/src/main/proto/spine/example/events.proto b/_code/samples/src/main/proto/spine/example/events.proto deleted file mode 100644 index ace437e0..00000000 --- a/_code/samples/src/main/proto/spine/example/events.proto +++ /dev/null @@ -1,41 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -syntax = "proto3"; - -package spine.example; - -import "spine/options.proto"; - -option (type_url_prefix) = "type.spine.io"; -option java_package = "io.spine.example"; -option java_outer_classname = "EventsProto"; -option java_multiple_files = true; - -// #docregion ProjectCreated -message ProjectCreated { - -} -// #enddocregion ProjectCreated diff --git a/_code/samples/src/main/proto/spine/site/home/commands.proto b/_code/samples/src/main/proto/spine/site/home/commands.proto deleted file mode 100644 index bd14cd4e..00000000 --- a/_code/samples/src/main/proto/spine/site/home/commands.proto +++ /dev/null @@ -1,55 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -syntax = "proto3"; - -package spine.site.home; - -import "spine/options.proto"; - -option (type_url_prefix) = "type.spine.io"; -option java_package = "io.spine.site.home.command"; -option java_outer_classname = "CommandsProto"; -option java_multiple_files = true; - -import "spine/site/home/identifiers.proto"; - -// Create a new task. -message CreateTask { - TaskId id = 1; // assumed `required` - string name = 2 [(required) = true]; - string description = 3; -} - -// Assign a task on a user. -message AssignTask { - TaskId task = 1; - spine.core.UserId assignee = 2 [(required) = true]; -} - -// Mark a task as completed. -message CompleteTask { - TaskId task = 1; -} diff --git a/_code/samples/src/main/proto/spine/site/home/events.proto b/_code/samples/src/main/proto/spine/site/home/events.proto deleted file mode 100644 index 379e1c72..00000000 --- a/_code/samples/src/main/proto/spine/site/home/events.proto +++ /dev/null @@ -1,56 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -syntax = "proto3"; - -package spine.site.home; - -import "spine/options.proto"; - -option (type_url_prefix) = "type.spine.io"; -option java_package = "io.spine.site.home.event"; -option java_outer_classname = "CommandsProto"; -option java_multiple_files = true; - -import "spine/site/home/identifiers.proto"; - -// A new task has been created. -message TaskCreated { - TaskId task = 1 [(required) = true]; - string name = 2 [(required) = true]; - string description = 3; - spine.core.UserId owner = 4 [(required) = true]; -} - -// A task was assigned to a user. -message TaskAssigned { - TaskId task = 1 [(required) = true]; - spine.core.UserId assignee = 2 [(required) = true]; -} - -// A task was marked as completed. -message TaskCompleted { - TaskId task = 1 [(required) = true]; -} diff --git a/_code/samples/src/main/proto/spine/site/home/identifiers.proto b/_code/samples/src/main/proto/spine/site/home/identifiers.proto deleted file mode 100644 index fee4bea5..00000000 --- a/_code/samples/src/main/proto/spine/site/home/identifiers.proto +++ /dev/null @@ -1,41 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -syntax = "proto3"; - -package spine.site.home; - -import "spine/options.proto"; - -option (type_url_prefix) = "type.spine.io"; -option java_package = "io.spine.site.home"; -option java_outer_classname = "IdentifiersProto"; -option java_multiple_files = true; - -import public "spine/core/user_id.proto"; - -message TaskId { - string uuid = 1; -} diff --git a/_code/samples/src/main/proto/spine/site/home/task.proto b/_code/samples/src/main/proto/spine/site/home/task.proto deleted file mode 100644 index 32aa1da0..00000000 --- a/_code/samples/src/main/proto/spine/site/home/task.proto +++ /dev/null @@ -1,59 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -syntax = "proto3"; - -package spine.site.home; - -import "spine/options.proto"; - -option (type_url_prefix) = "type.spine.io"; -option java_package = "io.spine.site.home"; -option java_outer_classname = "TaskProto"; -option java_multiple_files = true; - -import "google/protobuf/timestamp.proto"; -import "spine/site/home/identifiers.proto"; - -// A task which can be assigned to a user. -message Task { - option (entity).kind = AGGREGATE; - TaskId id = 1; // assumed `required` - string name = 2 [(required) = true]; - string description = 3; - spine.core.UserId owner = 4 [(required) = true]; - spine.core.UserId assignee = 5; -} - -// An item in a task list displayed in UI. -message TaskItem { - option (entity).kind = PROJECTION; - TaskId task = 1; - string name = 2 [(required) = true]; - string description = 3; - string owner = 4 [(required) = true]; - string assignee = 5; - google.protobuf.Timestamp when_done = 6; -} diff --git a/_code/samples/src/test/java/io/spine/example/CompiledProtobuf.java b/_code/samples/src/test/java/io/spine/example/CompiledProtobuf.java deleted file mode 100644 index 591de704..00000000 --- a/_code/samples/src/test/java/io/spine/example/CompiledProtobuf.java +++ /dev/null @@ -1,42 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -package io.spine.example; - -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; - -import static com.google.common.truth.Truth.assertThat; - -@DisplayName("Project should contain Protobuf types:") -class CompiledProtobuf { - - @Test - @DisplayName("ProjectCreated") - void projectCreated() { - assertThat(ProjectCreated.class) - .isNotNull(); - } -} diff --git a/_code/samples/src/test/java/io/spine/site/home/server/TaskCreationTest.java b/_code/samples/src/test/java/io/spine/site/home/server/TaskCreationTest.java deleted file mode 100644 index 5b7d0855..00000000 --- a/_code/samples/src/test/java/io/spine/site/home/server/TaskCreationTest.java +++ /dev/null @@ -1,122 +0,0 @@ -/* - * Copyright 2020, TeamDev. All rights reserved. - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Redistribution and use in source and/or binary forms, with or without - * modification, must retain the above copyright notice and the following - * disclaimer. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package io.spine.site.home.server; - -import io.spine.server.BoundedContextBuilder; -import io.spine.site.home.Task; -import io.spine.site.home.TaskId; -import io.spine.site.home.TaskItem; -import io.spine.site.home.command.CreateTask; -import io.spine.site.home.event.TaskCreated; -import io.spine.testing.server.blackbox.ContextAwareTest; -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; - -import static io.spine.testing.TestValues.randomString; - -@DisplayName("Handling `CreateTask` command should") -public class TaskCreationTest extends ContextAwareTest { - - private TaskId task; - private String name; - private String description; - - @Override - protected BoundedContextBuilder contextBuilder() { - return NanoPmContext.newBuilder(); - } - - private CreateTask generateCommand() { - task = TaskId.generate(); - name = randomString(); - description = randomString(); - return CreateTask.newBuilder() - .setId(task) - .setName(name) - .setDescription(description) - .vBuild(); - } - - @BeforeEach - void postCommand() { - CreateTask cmd = generateCommand(); - context().receivesCommand(cmd); - } - - @Test - @DisplayName("generate `TaskCreated` event") - void eventGenerated() { - TaskCreated expected = expectedEvent(); - context().assertEvent(TaskCreated.class) - .comparingExpectedFieldsOnly() - .isEqualTo(expected); - } - - private TaskCreated expectedEvent() { - return TaskCreated.newBuilder() - .setTask(task) - .setName(name) - .setDescription(description) - .buildPartial(); - } - - @Test - @DisplayName("create a `Task`") - void aggregateCreation() { - Task expected = expectedAggregateState(); - context().assertEntityWithState(task, Task.class) - .hasStateThat() - .comparingExpectedFieldsOnly() - .isEqualTo(expected); - } - - private Task expectedAggregateState() { - return Task.newBuilder() - .setId(task) - .setName(name) - .setDescription(description) - .buildPartial(); - } - - @Test - @DisplayName("create a `TaskItem`") - void projectionCreation() { - TaskItem expected = expectedProjectionState(); - context().assertEntityWithState(task, TaskItem.class) - .hasStateThat() - .comparingExpectedFieldsOnly() - .isEqualTo(expected); - } - - private TaskItem expectedProjectionState() { - return TaskItem.newBuilder() - .setName(name) - .setDescription(description) - .buildPartial(); - } -} From 70af64fe05c2f7eba434901afbe8ac4f47b1152a Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 17:55:33 +0100 Subject: [PATCH 25/29] Improve `README` --- AUTHORING.md | 3 +-- README.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/AUTHORING.md b/AUTHORING.md index 9459d711..032d1b16 100644 --- a/AUTHORING.md +++ b/AUTHORING.md @@ -23,7 +23,7 @@ This document is a guide for adding content to the [spine.io](https://spine.io) # Using URLs To refer to another page, image, or asset in the Spine documentation, -use relative URLs. The site domain and product prefix are added automatically. +use relative URLs. The site domain and documentation version are added automatically. ### URLs in markdown @@ -37,7 +37,6 @@ There are two rules to follow: #### Rule 2 -- Each link should **end with a slash** to prevent unnecessary redirects. - | Good | Bad | |--------------------------------------|-------------------------------------| | `[Introduction](docs/introduction/)` | `[Introduction](/docs/introduction)`| diff --git a/README.md b/README.md index 6d933e4c..cff1aae1 100644 --- a/README.md +++ b/README.md @@ -52,8 +52,7 @@ Another way to run the site locally is to follow these steps: The documentation is located in a [separate repository][documentation-repo]. It is added to this site as a Hugo Module. -Any changes to the documentation must be made in its own -[repository][documentation-repo]. +Any changes to the documentation must be made in its own [repository][documentation-repo]. The `documentation` repository is made to be self-sustainable in terms of editing. A fully-fledged Hugo site has been set up for it. All the contents and links in it are working as intended. From cce4c8a5c9305d5a38cb57f05123ae7bf5937749 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Tue, 16 Dec 2025 18:12:41 +0100 Subject: [PATCH 26/29] Update credentials for `proof-links` --- .github/workflows/proof-links.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/proof-links.yml b/.github/workflows/proof-links.yml index 00d00d53..502dd8b4 100644 --- a/.github/workflows/proof-links.yml +++ b/.github/workflows/proof-links.yml @@ -3,7 +3,7 @@ on: [pull_request, workflow_dispatch] env: HUGO_VERSION: 0.147.8 - GH_USER: cloud-cannon-teamdev-integration + GH_USER: site-commons-machine-user LYCHEE_RELEASE: "lychee-v0.15.1-x86_64-unknown-linux-gnu.tar.gz" LYCHEE_VERSION_TAG: "v0.15.1" @@ -44,7 +44,7 @@ jobs: ${{ runner.os }}-hugomod- - name: Prepare environment - run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_PAT }}@github.com".insteadOf "https://github.com" + run: git config --global url."https://${{ env.GH_USER }}:${{ secrets.GH_SITE_COMMONS_PAT }}@github.com".insteadOf "https://github.com" - name: Install Dependencies working-directory: site From 2282745d625c3cff31b5d42bb153b5df746db24c Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Wed, 17 Dec 2025 11:43:15 +0100 Subject: [PATCH 27/29] Do not install Lychee with `npm` --- AUTHORING.md | 10 ++-- _script/proof-links | 3 +- site/package-lock.json | 125 ----------------------------------------- site/package.json | 1 - 4 files changed, 5 insertions(+), 134 deletions(-) diff --git a/AUTHORING.md b/AUTHORING.md index 032d1b16..3e1375ee 100644 --- a/AUTHORING.md +++ b/AUTHORING.md @@ -91,19 +91,17 @@ Please see [this document](_code/EMBEDDING.md) for the instructions. # Testing broken links We use the [Lychee](https://github.com/lycheeverse/lychee) tool to test broken links. -To start test locally you may be required to install the tool first from the `site` directory: +To start test locally you may be required to [install the tool](https://github.com/lycheeverse/lychee?tab=readme-ov-file#installation). -```bash -npm install -``` -... and then run the site: +Then navigate to the `site` directory and run the site locally ```bash hugo server ``` Make sure it runs on port `1313`. -After that, please use the following command from the root of the project: + +To test broken links, run following command from the root of the project: ```bash ./_script/proof-links diff --git a/_script/proof-links b/_script/proof-links index c1e14bff..548fee71 100755 --- a/_script/proof-links +++ b/_script/proof-links @@ -37,5 +37,4 @@ elif [ -f ${BASH_RC} ]; then . ${BASH_RC} fi -cd site -lychee --config ../lychee.toml --base http://localhost:1313 "public/**/*.html" +lychee --config lychee.toml --base http://localhost:1313 "site/public/**/*.html" diff --git a/site/package-lock.json b/site/package-lock.json index 00ca1ea3..11407c13 100644 --- a/site/package-lock.json +++ b/site/package-lock.json @@ -14,7 +14,6 @@ "devDependencies": { "@fullhuman/postcss-purgecss": "^7.0.2", "autoprefixer": "^10.4.22", - "lychee": "^0.2.12", "postcss": "^8.5.6", "postcss-cli": "^11.0.1", "postcss-discard-comments": "^7.0.5" @@ -196,15 +195,6 @@ "node": ">= 8" } }, - "node_modules/async": { - "version": "0.1.22", - "resolved": "https://registry.npmjs.org/async/-/async-0.1.22.tgz", - "integrity": "sha512-2tEzliJmf5fHNafNwQLJXUasGzQCVctvsNkXmnlELHwypU0p08/rHohYvkqKIjyXpx+0rkrYv6QbhJ+UF4QkBg==", - "dev": true, - "engines": { - "node": "*" - } - }, "node_modules/autoprefixer": { "version": "10.4.22", "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.22.tgz", @@ -326,18 +316,6 @@ "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" } }, - "node_modules/buffalo": { - "version": "0.1.3", - "resolved": "https://registry.npmjs.org/buffalo/-/buffalo-0.1.3.tgz", - "integrity": "sha512-LCN4KZKQ9tSTg2IMfq5Rrl8g3Vsx3D7X/iBhFjboUvwY0mgnngi/GkU9P7fQzkq0obFcTv4YHwgXyxGmfTIRzQ==", - "dev": true, - "dependencies": { - "tosource": "0.1.1" - }, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/caniuse-lite": { "version": "1.0.30001757", "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001757.tgz", @@ -554,15 +532,6 @@ "node": "^8.16.0 || ^10.6.0 || >=11.0.0" } }, - "node_modules/generic-pool": { - "version": "1.0.12", - "resolved": "https://registry.npmjs.org/generic-pool/-/generic-pool-1.0.12.tgz", - "integrity": "sha512-/FreBY2vliRCKXE+avFbi9pDEQFLPF1jqMM9EMHN7EgqrEUNYw8FOv26JJG3Sfw7THq3Kvk000PxkzjvAl510A==", - "dev": true, - "engines": { - "node": ">= 0.2.0" - } - }, "node_modules/get-caller-file": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", @@ -697,13 +666,6 @@ "graceful-fs": "^4.1.6" } }, - "node_modules/juicy": { - "version": "0.2.5", - "resolved": "https://registry.npmjs.org/juicy/-/juicy-0.2.5.tgz", - "integrity": "sha512-mXr84tI+pKwMAnseKmSpPMVZ2KjkViPKo2i5eu5XQAacEXQrv80F1aIEecSZyQW2Ff1dPVsSNGPc1lEkVM/9Yg==", - "deprecated": "This package is no longer maintained", - "dev": true - }, "node_modules/lilconfig": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz", @@ -725,20 +687,6 @@ "node": "20 || >=22" } }, - "node_modules/lychee": { - "version": "0.2.12", - "resolved": "https://registry.npmjs.org/lychee/-/lychee-0.2.12.tgz", - "integrity": "sha512-PdBo9+0mGIF7zSq/eY/h/7EIZIaFZI4AF9sHkz2sMjtTzpBoSc1jmrfgaXlzqqAFe4kwKcBo9CuytvehDOGuQw==", - "dev": true, - "dependencies": { - "async": "0.1.22", - "juicy": "0.2.5", - "mongolian": "0.1.18", - "pg": "0.8.3", - "request": "2.9.203", - "sanitizer": "0.0.15" - } - }, "node_modules/minimatch": { "version": "10.1.1", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.1.1.tgz", @@ -763,20 +711,6 @@ "node": ">=16 || 14 >=14.17" } }, - "node_modules/mongolian": { - "version": "0.1.18", - "resolved": "https://registry.npmjs.org/mongolian/-/mongolian-0.1.18.tgz", - "integrity": "sha512-gtEjtn5FfyKBslW0VjHf+hGqKU50NsGhDt4trPYfxlu3OqnWNSFkE0yJrTkwSaP1louLotFoWzKwUfOT9rOQ2w==", - "dev": true, - "dependencies": { - "buffalo": "0.1.3", - "taxman": "0.1.1", - "waiter": "0.1.1" - }, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/nanoid": { "version": "3.3.11", "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", @@ -850,19 +784,6 @@ "url": "https://github.com/sponsors/isaacs" } }, - "node_modules/pg": { - "version": "0.8.3", - "resolved": "https://registry.npmjs.org/pg/-/pg-0.8.3.tgz", - "integrity": "sha512-ablcQJGJmIx4y2muZSiyrPo1TyIFVGgz1smR8TyoVsdl1JU/g3+2aOAYJ0YQm+HRXBvHaSbG1y6fpBDSDtVxBA==", - "dev": true, - "hasInstallScript": true, - "dependencies": { - "generic-pool": "1.0.12" - }, - "engines": { - "node": ">= 0.8.0" - } - }, "node_modules/picocolors": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", @@ -1103,16 +1024,6 @@ "node": ">=8.10.0" } }, - "node_modules/request": { - "version": "2.9.203", - "resolved": "https://registry.npmjs.org/request/-/request-2.9.203.tgz", - "integrity": "sha512-OWtna9w7yRI/gcfu3VaURgIwE1FHgbz5+fHGQ9GJTHcJ4+uvHnDjXd+N7mVDOv5+1fp1CRPzUSY2wcM345Z2Fw==", - "deprecated": "request has been deprecated, see https://github.com/request/request/issues/3142", - "dev": true, - "engines": [ - "node >= 0.3.6" - ] - }, "node_modules/require-directory": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", @@ -1122,15 +1033,6 @@ "node": ">=0.10.0" } }, - "node_modules/sanitizer": { - "version": "0.0.15", - "resolved": "https://registry.npmjs.org/sanitizer/-/sanitizer-0.0.15.tgz", - "integrity": "sha512-czIh3bPhxzhBUQsbJXMnvPClvh+tQTnY1bkQlHq1nUKyuCjcs/m6zG/gKU3CXet+xhS5vWKWkfZyCmL9/WFFKQ==", - "dev": true, - "engines": { - "node": "*" - } - }, "node_modules/shebang-command": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", @@ -1239,15 +1141,6 @@ "node": ">=8" } }, - "node_modules/taxman": { - "version": "0.1.1", - "resolved": "https://registry.npmjs.org/taxman/-/taxman-0.1.1.tgz", - "integrity": "sha512-woTa2sNzlGapMORbp1PDDeyMl6/2RudPV1z7Wtdx7nzI+FzEawi84yPGzrq57nrkA/kEpWVJZ9K6sXQ9TIhNNg==", - "dev": true, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/thenby": { "version": "1.3.4", "resolved": "https://registry.npmjs.org/thenby/-/thenby-1.3.4.tgz", @@ -1311,15 +1204,6 @@ "node": ">=8.0" } }, - "node_modules/tosource": { - "version": "0.1.1", - "resolved": "https://registry.npmjs.org/tosource/-/tosource-0.1.1.tgz", - "integrity": "sha512-hTnpPZBZP4DggtRpIAxQi74N4z5vs+Yx3Wcj2CNWLAKPRidZbLN2y5bPn1NI5EoojGzQ1btLzaj7poqsiRsmQA==", - "dev": true, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/universalify": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", @@ -1365,15 +1249,6 @@ "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", "dev": true }, - "node_modules/waiter": { - "version": "0.1.1", - "resolved": "https://registry.npmjs.org/waiter/-/waiter-0.1.1.tgz", - "integrity": "sha512-OWMX6RloKF1S0uwF/czC08ZFTcksNFRSGeLu3mt7LhQ0daOvnJaKDtgGSULUvuFNfGe093VE9rRGbCo+ceyS+g==", - "dev": true, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/which": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", diff --git a/site/package.json b/site/package.json index d36f8a94..52a5f174 100644 --- a/site/package.json +++ b/site/package.json @@ -11,7 +11,6 @@ "devDependencies": { "@fullhuman/postcss-purgecss": "^7.0.2", "autoprefixer": "^10.4.22", - "lychee": "^0.2.12", "postcss": "^8.5.6", "postcss-cli": "^11.0.1", "postcss-discard-comments": "^7.0.5" From a9d76fe01e13c3eb128e40fa7ea5c8ca437f404f Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Wed, 17 Dec 2025 11:49:57 +0100 Subject: [PATCH 28/29] Remove the `config` submodule until it is needed to build the samples for version 2 --- .gitmodules | 3 --- config | 1 - 2 files changed, 4 deletions(-) delete mode 160000 config diff --git a/.gitmodules b/.gitmodules index ff4eae4a..81c04cfe 100644 --- a/.gitmodules +++ b/.gitmodules @@ -13,6 +13,3 @@ [submodule "_code/examples/todo-list"] path = _code/examples/todo-list url = https://github.com/spine-examples/todo-list -[submodule "_code/config"] - path = config - url = https://github.com/SpineEventEngine/config diff --git a/config b/config deleted file mode 160000 index 24b53046..00000000 --- a/config +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 24b5304699ac2f60a464f1796d911aba871f66c2 From 4da7e376cad350262711f3beefe795350cb43c20 Mon Sep 17 00:00:00 2001 From: "julia.evseeva" Date: Wed, 17 Dec 2025 12:08:18 +0100 Subject: [PATCH 29/29] Clean up --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cff1aae1..645735be 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,10 @@ This project is two-headed: * It is a Gradle project to for checking the source code embedded to the site. The code samples used on the site and in the framework documentation are added using -the [`embed-code`][embed-code] Hugo subcommand. +the [`embed-code`][embed-code] tool (Go version). -The code resides under the `_code` directory. For instructions on embedding the code into the pages, -please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file. +The code resides under the `_code` directory. For instructions on embedding the code +into the pages, please see the [`_code/EMBEDDING.md`](_code/EMBEDDING.md) file. ## Prerequisites