feat(build): use jekyll and restyle website

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master

.dockerignore

@@ -0,0 +1,8 @@
+# ignore hidden files
+.*
+
+!.well-known/
+
+third-party/beautiful-jekyll/_posts/
+
+_site/

.gitattributes

@@ -0,0 +1,3 @@
+# ensure dockerfiles are checked out with LF line endings
+Dockerfile text eol=lf
+*.dockerfile text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+---
+name: Jekyll CI
+
+on:
+ pull_request:
+ branches:
+ - master
+ types:
+ - opened
+ - synchronize
+ - reopened
+ push:
+ branches:
+ - master
+
+concurrency:
+ group: "${{ github.workflow }}-${{ github.ref }}"
+ cancel-in-progress: true
+
+jobs:
+ call-jekyll-build:
+ uses: ./.github/workflows/jekyll-build.yml
+ with:
+ target_branch: gh-pages
+ clean_gh_pages: true
+ secrets:
+ GH_BOT_EMAIL: ${{ secrets.GH_BOT_EMAIL }}
+ GH_BOT_NAME: ${{ secrets.GH_BOT_NAME }}
+ GH_BOT_TOKEN: ${{ secrets.GH_BOT_TOKEN }}
+
+ release:
+ if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+ runs-on: ubuntu-latest
+ steps:
+ - name: Setup Release
+ id: setup-release
+ uses: LizardByte/setup-release-action@v2024.919.143601
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+
+ - name: Create Release
+ id: action
+ uses: LizardByte/create-release-action@v2024.919.143026
+ with:
+ allowUpdates: false
+ artifacts: ''
+ body: ${{ steps.setup-release.outputs.release_body }}
+ generateReleaseNotes: ${{ steps.setup-release.outputs.release_generate_release_notes }}
+ name: ${{ steps.setup-release.outputs.release_tag }}
+ prerelease: true
+ tag: ${{ steps.setup-release.outputs.release_tag }}
+ token: ${{ secrets.GH_BOT_TOKEN }}

.github/workflows/jekyll-build.yml

@@ -0,0 +1,241 @@
+---
+name: Build Jekyll
+
+on:
+ workflow_call:
+ inputs:
+ site_artifact:
+ description: 'Artifact name to download'
+ required: false
+ default: ''
+ type: string
+ extract_archive:
+ description: |
+ Name of nested archive to extract. In some cases you may want to upload a zip of files to reduce
+ upload size and time. If you do this, you must specify the name of the archive to extract.
+ required: false
+ default: ''
+ type: string
+ config_file:
+ description: 'Configuration file to use, relative to the site source directory'
+ required: false
+ default: '_config.yml'
+ type: string
+ target_branch:
+ description: 'Branch to deploy to. Branch must already exist.'
+ required: false
+ default: 'gh-pages'
+ type: string
+ clean_gh_pages:
+ description: 'Clean gh-pages before deploying'
+ required: false
+ default: true
+ type: boolean
+ theme_ref:
+ description: 'Branch, tag, or commit SHA of the theme repository to use'
+ required: false
+ default: 'master'
+ type: string
+ secrets:
+ GH_BOT_EMAIL:
+ description: 'Email address of the bot account'
+ required: true
+ GH_BOT_NAME:
+ description: 'Name of the bot account'
+ required: true
+ GH_BOT_TOKEN:
+ description: 'Personal access token of the bot account'
+ required: true
+
+jobs:
+ build:
+ name: Build Jekyll
+ runs-on: ubuntu-latest
+ steps:
+ - name: Input validation
+ run: |
+ error=false
+ if [ "${{ inputs.site_artifact }}" == 'site' ]; then
+ echo "Artifact name cannot be 'site'"
+ error=true
+ fi
+
+ if [ "$error" = true ]; then
+ exit 1
+ fi
+
+ - name: Checkout theme
+ uses: actions/checkout@v4
+ with:
+ repository: LizardByte/LizardByte.github.io
+ ref: ${{ github.repository == 'LizardByte/LizardByte.github.io' && github.ref || inputs.theme_ref }}
+ submodules: recursive
+ path: theme
+
+ - name: Download input artifact
+ if: ${{ inputs.site_artifact != '' }}
+ uses: actions/download-artifact@v4
+ with:
+ name: ${{ inputs.site_artifact }}
+ path: project
+
+ - name: Extract archive
+ if: ${{ inputs.site_artifact != '' && inputs.extract_archive != '' }}
+ working-directory: project
+ run: |
+ case "${{ inputs.extract_archive }}" in
+ *.tar.gz|*.tgz)
+ tar -xzf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.tar)
+ tar -xf ${{ inputs.extract_archive }} -C .
+ ;;
+ *.zip)
+ unzip ${{ inputs.extract_archive }} -d .
+ ;;
+ *)
+ echo "Unsupported archive format"
+ exit 1
+ ;;
+ esac
+ rm -f ${{ inputs.extract_archive }}
+
+ - name: Setup project
+ if: ${{ github.repository == 'LizardByte/LizardByte.github.io' }}
+ run: |
+ mkdir -p ./project
+ cp -RT ./theme/ ./project/
+ rm -rf ./project/third-party
+
+ - name: Create site
+ env:
+ TMPDIR: /home/runner/work/tmp
+ run: |
+ mkdir -p ${TMPDIR}
+
+ base_dirs=(
+ ./theme/third-party/beautiful-jekyll
+ ./theme
+ )
+
+ targets=(
+ *.gemspec
+ _data
+ _includes
+ _layouts
+ _sass
+ assets
+ 404.html
+ _config_theme.yml
+ favicon.ico
+ feed.xml
+ Gemfile
+ staticman.yml
+ tags.html
+ )
+
+ for base_dir in "${base_dirs[@]}"; do
+ for target in "${targets[@]}"; do
+ if [ -e "$base_dir/$target" ]; then
+ cp -rf "$base_dir/$target" ${TMPDIR}/
+ fi
+ done
+ done
+
+ # copy project directory, they should only come from the project repo
+ cp -RTf ./project/ ${TMPDIR}/
+
+ # remove the workspace
+ cd ..
+ rm -rf ${GITHUB_WORKSPACE}
+
+ # move the temporary directory to the workspace
+ mv ${TMPDIR} ${GITHUB_WORKSPACE}
+ cd ${GITHUB_WORKSPACE}
+
+ # debug contents recursively
+ ls -Ra
+
+ - name: Setup Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: '3.3'
+
+ - name: Install dependencies
+ run: |
+ bundle install
+
+ - name: Setup Pages
+ id: configure-pages
+ uses: actions/configure-pages@v5
+
+ - name: Setup CI config
+ run: |
+ echo "---" > _config_ci.yml
+ echo "baseurl: ${{ steps.configure-pages.outputs.base_path }}" >> _config_ci.yml
+
+ - name: Build site
+ env:
+ JEKYLL_ENV: production
+ PAGES_REPO_NWO: ${{ github.repository }}
+ run: |
+ # if inputs.config_file exists
+ config_files="_config_ci.yml,_config_theme.yml"
+ if [ -e "${{ inputs.config_file }}" ]; then
+ config_files="${config_files},${{ inputs.config_file }}"
+ fi
+
+ bundle exec jekyll build --future --config ${config_files}
+
+ - name: Upload artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: site
+ path: _site
+ if-no-files-found: error
+ include-hidden-files: true
+ retention-days: 1
+
+ deploy:
+ name: Deploy to Pages
+ if: >-
+ (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+ (github.event_name == 'schedule') ||
+ (github.event_name == 'workflow_dispatch')
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Checkout gh-pages
+ uses: actions/checkout@v4
+ with:
+ ref: ${{ inputs.target_branch }}
+ path: gh-pages
+ persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of the personal token
+ fetch-depth: 0 # otherwise, will fail to push refs to dest repo
+
+ - name: Clean
+ if: ${{ inputs.clean_gh_pages }}
+ run: |
+ # empty contents of gh-pages
+ rm -f -r ./gh-pages/*
+
+ - name: Download artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: site
+ path: gh-pages
+
+ - name: no-jekyll
+ run: |
+ touch gh-pages/.nojekyll
+
+ - name: Deploy to gh-pages
+ uses: actions-js/push@v1.5
+ with:
+ github_token: ${{ secrets.GH_BOT_TOKEN }}
+ author_email: ${{ secrets.GH_BOT_EMAIL }}
+ author_name: ${{ secrets.GH_BOT_NAME }}
+ directory: gh-pages
+ branch: ${{ inputs.target_branch }}
+ force: false
+ message: "Deploy site from ${{ github.sha }}"

.gitignore

@@ -1,10 +1,4 @@
 # ignore JetBrains project
 .idea/
 
-# ignore node modules
-node_modules/
-package-lock.json
-
-# ignore duplicated dist folder for localization
-dist/en
-dist/es-ES
+_site/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "third-party/beautiful-jekyll"]
+	path = third-party/beautiful-jekyll
+	url = https://github.com/ReenigneArcher/beautiful-jekyll.git
+	branch = master