Migrate to Hugo

.editorconfig

@@ -3,16 +3,7 @@ root = true
 [*]
 charset = utf-8
 end_of_line = lf
-indent_style = tab
+indent_style = space
 insert_final_newline = true
 trim_trailing_whitespace = true
-
-# YAML requires indentation with spaces instead of tabs.
-[*.{yml,yaml}]
-indent_style = space
-indent_size = 2
-
-# Ruby scripts and plugins for Jekyll
-[*.rb]
-indent_style = space
 indent_size = 2

.github/workflows/build-pr.yml

@@ -7,27 +7,39 @@ concurrency:
   group: pr-${{github.actor}}-${{github.head_ref || github.run_number}}-${{github.ref}}-ci
   cancel-in-progress: true
 
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
 jobs:
   build:
     name: Build sources from the PR branch
     runs-on: ubuntu-latest
-
+    env:
+      HUGO_VERSION: 0.123.0
     steps:
-    - uses: actions/checkout@v3
-
-    # Configure the build environment.
-
-    - name: Install Ruby 3.1
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: '3.1'
-        # Runs 'bundle install' and caches installed gems automatically
-        bundler-cache: true
-
-    - name: Install Minify
-      run: sudo apt-get update && sudo apt-get install minify
-
-    # Build the website.
-
-    - name: Build the static website
-      run: bundle exec jekyll build
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
+
+      - name: Install Node.js dependencies
+        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+
+      - name: Build with Hugo
+        env:
+          # For maximum backward compatibility with Hugo modules
+          HUGO_ENVIRONMENT: production
+          HUGO_ENV: production
+        run: make build

.github/workflows/build-website.yml

@@ -5,47 +5,67 @@ on:
   push:
     branches: [ master ]
 
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
 # Make sure jobs cannot overlap (e.g. one from push and one from schedule).
 concurrency:
   group: published-ci
   cancel-in-progress: true
 
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
 jobs:
   build:
     name: Build and deploy to the published branch
     runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.123.0
+    steps:
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: 'master'
+          submodules: recursive
+          fetch-depth: 0
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
 
+      - name: Install Node.js dependencies
+        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+
+      - name: Build with Hugo
+        env:
+          # For maximum backward compatibility with Hugo modules
+          HUGO_ENVIRONMENT: production
+          HUGO_ENV: production
+        run: make build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: ./public
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
     steps:
-    - uses: actions/checkout@v3
-      with:
-        ref: 'master'
-
-    # Configure the build environment.
-
-    - name: Install Ruby 3.1
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: '3.1'
-        # Runs 'bundle install' and caches installed gems automatically
-        bundler-cache: true
-
-    - name: Install Minify
-      run: sudo apt-get update && sudo apt-get install minify
-
-    # Build the website.
-
-    - name: Build the static website
-      run: bundle exec jekyll build
-
-    # Publish the build results
-
-    - name: Deploy to the published branch 🚀
-      uses: JamesIves/github-pages-deploy-action@v4
-      with:
-        branch: published
-        folder: _site
-        # Configure the commit author.
-        git-config-name: 'Godot Organization'
-        git-config-email: '<>'
-        # Remove outdated files from the target directory.
-        clean: true
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v3

.gitignore

@@ -1,9 +1,7 @@
 # Build artifacts and cache
-.bundle/
-.jekyll-cache
-.jekyll-metadata
-_site
-vendor/
+public
+tools/generators/node_modules
+resources
 
 # Code editors
 .vscode/
@@ -12,6 +10,7 @@ vendor/
 .htaccess
 asset-library/
 mirrorlist/
+content/**/download/archive/
 qa/
 
 # OS-specific files

Makefile

@@ -0,0 +1,31 @@
+build: build-hugo index-articles
+
+build-hugo: install-tools update-mirrorList update-download-archive
+	hugo --gc --minify
+
+serve:
+	hugo server -D
+
+serve-minify:
+	hugo server -D --minify
+
+serve-nocache:
+	hugo server -D --ignoreCache --disableFastRender
+
+serve-profile:
+	hugo server --templateMetrics --templateMetricsHints
+
+serve-no-reload:
+	hugo server --disableLiveReload
+
+install-tools:
+	cd ./tools/generators && npm install
+
+update-mirrorList: install-tools
+	node ./tools/generators/src/mirror_list_generator.js
+
+update-download-archive: install-tools
+	node ./tools/generators/src/download_archive_generator.js
+
+index-articles:
+	npx --yes pagefind --site "public" --glob "**/article/*/*.{html}"

README.md

@@ -33,11 +33,9 @@ To build the website locally, follow these steps:
 
 1. Install [Jekyll prerequisites](https://jekyllrb.com/docs/installation/).
    - Make sure `bundle` is available from the command line.
-2. Install [Minify](https://github.com/tdewolff/minify/tree/master/cmd/minify).
-	- Make sure `minify` is available from the command line.
-3. Clone this repository.
-4. Install the necessary dependencies: `bundle install`.
-5. Build the site: `bundle exec jekyll build`.
+2. Clone this repository.
+3. Install the necessary dependencies: `bundle install`.
+4. Build the site: `bundle exec jekyll build`.
    - Append `--config _config.yml,_config.development.yml` to use the development config with your build.
 
 For simplicity, these two commands are also available as a `build.sh` script in this repository.