Fix the site url.

- Add default url for docs.twinbasic.com

- Use JEKYLL_SITE_CONFIG to provide site-specific configuration, e.g. url.

This fixes 404 errors on redirect_from pages.

If you're hosting this repository for your development purposes, the `url` will not be `https://docs.twinbasic.com`, obviously. But there's no way to override the url from `jekyll build`'s command line. Thus, the `JEKYLL_SITE_CONFIG` site variable (on GitHub's repo configuration), should contain any configuration overrides that take over the default config file.

At the very least, that should be `url: https://mysite.github.io`.

This will get echoed into a temporary `_site_config.yml`, and passed to `jekyll build`.

Author: KubaO

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

@@ -37,8 +37,14 @@ jobs:
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
+      - name: Write secondary config if available
+        run: |
+          echo "${{ vars.JEKYLL_SITE_CONFIG }}" > _site_config.yml
+          echo "SITE_CONFIG=_site_config.yml" >> "$GITHUB_ENV"
+        if: ${{ vars.JEKYLL_SITE_CONFIG != '' }}
+        working-directory: ./docs
       - name: Build with Jekyll
-        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        run: bundle exec jekyll build --config _config.yml,$SITE_CONFIG --baseurl "${{ steps.pages.outputs.base_path }}"
         working-directory: ./docs
         env:
           JEKYLL_ENV: production

docs/_config.yml

@@ -1,7 +1,7 @@
 title: twinBASIC Documentation
 logo: favicon.png
 logo_with_title: true
-baseurl: /
+url: "https://docs.twinbasic.com"
 
 # note: redcarpet is not supported on github pages
 markdown: kramdown