First commit

Delete exampleSite
Add initial content, images & docker-compose.yml
Use extend-head.html for analytics
Set remote url to gitea.novicelab.io
Remove original .git due to "shallow update not allowed" error

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @nunocoracao

.github/ISSUE_TEMPLATE/01-bug-report.yml

@@ -0,0 +1,121 @@
+name: Bug Report
+description: Create a report to help us improve
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for raising a bug report! Please fill out the following template to help us understand the issue you are experiencing.
+
+        You can view the contributing guidelines for this project at: <https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md>
+
+        - 🐛 **Bug reports & issues:** Use [GitHub Issues](https://github.com/nunocoracao/blowfish/issues)
+        - 💡 **Ideas for new features:** Open a discussion on [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
+        - 🙋‍♀️ **General questions:** Head to [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
+  - type: checkboxes
+    id: issue-check
+    attributes:
+      label: Issue Check
+      description: We ask that you [check existing Issues](https://github.com/nunocoracao/blowfish/issues) to see if your bug report has already been raised.
+      options:
+        - label: I have checked existing Issues and I feel this bug has not been raised
+          required: true
+  - type: checkboxes
+    id: hugo-version-check
+    attributes:
+      label: Hugo Version Check
+      description: Please confirm that your Hugo version is within the supported range specified in the [config](https://github.com/nunocoracao/blowfish/blob/main/config.toml)
+      options:
+        - label: My Hugo version is within the supported range
+          required: true
+  - type: textarea
+    id: describe-bug
+    attributes:
+      label: Describe the Bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: To Reproduce
+      description: |
+        Please provide the steps to reproduce the behaviour.
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Scroll down to '...'
+        4. *See error*
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behaviour
+      description: A clear and concise description of what you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: |
+        If applicable, add screenshots to help explain your problem.
+
+        *Click inside the textbox to highlight it, then you can upload screenshots by dragging them in.*
+        *Alternatively, you can click on "Paste, drop or click to add files" or "Add files" below the textbox.*
+    validations:
+      required: false
+  - type: textarea
+    id: platform
+    attributes:
+      label: Platform
+      description: |
+        Add information associated with the platform you are experience this bug on.
+
+        Example:
+          - OS: [e.g. iOS, MacOS, Windows, Linux]
+          - Browser: [e.g. chrome, safari, edge, firefox]
+          - Version [e.g. 22, Version 138.0.3351.77]
+      value: |
+          - OS:
+          - Browser:
+          - Version:
+    validations:
+      required: true
+  - type: textarea
+    id: hugo-version
+    attributes:
+      label: Hugo Version
+      description: Run `hugo version` and paste the output below.
+      placeholder: hugo v0.147.6-0a5fd8ebb8e2ca798515e8c564c14e32db3b4127 linux/amd64 BuildDate=2025-05-27T11:17:16Z VendorInfo=gohugoio
+      render: console
+    validations:
+      required: true
+  - type: textarea
+    id: blowfish-version
+    attributes:
+      label: Blowfish Version
+      description: Log the version of Blowfish you are running.
+      placeholder: v2.88.1
+      render: console
+    validations:
+      required: true
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: |
+        Add any other context about the problem here. Are there existing GitHub Issues/Discussions that you feel are related?
+    validations:
+      required: false
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/nunocoracao/blowfish?tab=coc-ov-file#readme).
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true
+

.github/ISSUE_TEMPLATE/02-feature-request.yml

@@ -0,0 +1,60 @@
+name: Feature Request
+description: Suggest an idea for this project
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for raising a feature request! Please fill out the following template to help us understand the feature you are requesting.
+
+        You can view the contributing guidelines for this project at: <https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md>
+
+        - 🐛 **Bug reports & issues:** Use [GitHub Issues](https://github.com/nunocoracao/blowfish/issues)
+        - 💡 **Ideas for new features:** Open a discussion on [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
+        - 🙋‍♀️ **General questions:** Head to [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
+  - type: checkboxes
+    id: issue-check
+    attributes:
+      label: Issue Check
+      description: We ask that you [check existing Issues](https://github.com/nunocoracao/blowfish/issues) to see if your feature request has already been raised.
+      options:
+        - label: I have checked existing Issues and I feel this feature request has not been raised
+          required: true
+  - type: textarea
+    id: related-problem
+    attributes:
+      label: Is your feature request related to a problem?
+      description: A clear and concise description of what the problem is.
+      placeholder: Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe the alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: false
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here. Are there existing GitHub Issues/Discussions that you feel are related?
+    validations:
+      required: false
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/nunocoracao/blowfish?tab=coc-ov-file#readme).
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,22 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Contributing Guidelines
+    url: https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md
+    about: Read the contributing guidelines for this project.
+
+  - name: Blowfish Code of Conduct
+    url: https://github.com/nunocoracao/blowfish?tab=coc-ov-file#readme
+    about: View the Code of Conduct for this project.
+
+  - name: Ideas for New Features
+    url: https://github.com/nunocoracao/blowfish/discussions
+    about: Open a discussion using GitHub Discussions.
+
+  - name: General Questions
+    url: https://github.com/nunocoracao/blowfish/discussions
+    about: Open a discussion using GitHub Discussions.
+
+  - name: Blowfish Homepage
+    url: https://blowfish.page/
+    about: Visit the homepage for more information about Blowfish.
+

.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

@@ -0,0 +1,7 @@
+## Describe your changes
+
+## Issue ticket number and link
+
+## Checklist before requesting a review
+- [ ] I have performed a self-review of my code
+- [ ] Will this be part of a product update? If yes, please write one phrase about this update.

.github/dependabot.yml

@@ -0,0 +1,25 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    target-branch: "dev"
+    schedule:
+      interval: "weekly"
+      day: "wednesday"
+    commit-message:
+      prefix: "📌"
+    labels:
+      - "dependencies"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    target-branch: "dev"
+    schedule:
+      interval: "weekly"
+      day: "wednesday"
+    commit-message:
+      prefix: "👷"
+    labels:
+      - "dependencies"

.github/workflows/build.yml

@@ -0,0 +1,54 @@
+name: Build Theme
+
+on: [pull_request_target]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: ${{ github.actor == 'dependabot[bot]' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          ref: "${{ github.head_ref }}"
+      - name: Install dependencies and Build Theme
+        uses: actions/setup-node@v6
+      - run: npm install
+      - run: npm run assets
+      - name: Commit and push Chart.js changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          branch: "${{ github.head_ref }}"
+          push_options: "--dry-run"
+          file_pattern: "assets/lib/chart/*"
+          commit_message: "📦 Update packaged ChartJS"
+      - name: Commit Fuse changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          branch: "${{ github.head_ref }}"
+          push_options: "--dry-run"
+          file_pattern: "assets/lib/fuse/*"
+          commit_message: "📦 Update packaged FuseJS"
+      - name: Commit KaTeX changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          branch: "${{ github.head_ref }}"
+          push_options: "--dry-run"
+          file_pattern: "assets/lib/katex/*"
+          commit_message: "📦 Update packaged KaTeX"
+      - name: Commit Mermaid changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          branch: "${{ github.head_ref }}"
+          push_options: "--dry-run"
+          file_pattern: "assets/lib/mermaid/*"
+          commit_message: "📦 Update packaged Mermaid"
+      - run: npm run build
+      - name: Commit CSS changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          branch: "${{ github.head_ref }}"
+          push_options: "--dry-run"
+          file_pattern: "assets/css/compiled/main.css"
+          commit_message: "💄 Rebuild CSS"
+      - run: git push

.github/workflows/create-config-zip.yml

@@ -0,0 +1,21 @@
+name: Create ZIP
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  zip:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - run: zip -r config-default.zip config/_default
+      - uses: actions/upload-artifact@v6
+        with:
+          name: config-default
+          path: config-default.zip
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: config-default.zip
+          tag_name: ${{ github.event.release.tag_name }}

.github/workflows/greetings.yml

@@ -0,0 +1,16 @@
+name: Greetings
+
+on: [pull_request_target, issues]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/first-interaction@v3
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          issue-message: "Thanks for contributing to Blowfish"
+          pr-message: "Thanks for contributing to Blowfish"

.github/workflows/hugo-version-update.yml

@@ -0,0 +1,54 @@
+name: Update Hugo version
+
+on:
+  schedule:
+    - cron: "0 6 * * *"
+
+  workflow_dispatch:
+
+jobs:
+  updateBlowfish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v6
+        with:
+          ref: dev
+          submodules: true # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Fetch release version
+        id: fetch-release
+        run: |
+          curl -sL https://api.github.com/repos/gohugoio/hugo/releases/latest | \
+          jq -r ".tag_name" > release-versions/hugo-latest.txt
+
+      - name: Check for modified files
+        id: git-check
+        run:
+          echo ::set-output name=modified::$([ -z "`git status --porcelain`" ]
+          && echo "false" || echo "true")
+
+      - name: Update config.toml
+        id: update-config
+        if: steps.git-check.outputs.modified == 'true'
+        run: |
+          cat release-versions/hugo-latest.txt | \
+          while read version; do sed -i'' -E "s/(max = \")[0-9]+\.[0-9]+\.[0-9]+(\")/\1${version#v}\2/g" config.toml; done
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.modified == 'true'
+        uses: peter-evans/create-pull-request@v8
+        with:
+          commit-message: Update Hugo supported version
+          title: ⚙️ Update Hugo supported version
+          body: |
+            Updates [Hugo][1] support
+
+            Auto-generated by [create-pull-request][2]
+
+            [1]: https://github.com/gohugoio/hugo
+            [2]: https://github.com/peter-evans/create-pull-request
+          labels: dependencies, automated pr
+          branch: hugo-new-version
+          base: dev

.github/workflows/pages.yml

@@ -0,0 +1,68 @@
+# Sample workflow for building and deploying a Hugo site to GitHub Pages
+name: Blowfish Docs Deploy
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.102.3
+    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-64bit.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Hugo
+        env:
+          # For maximum backward compatibility with Hugo modules
+          HUGO_ENVIRONMENT: production
+          HUGO_ENV: production
+        run: |
+          hugo --minify -s exampleSite --themesDir ../.. -d ../docs --baseURL https://nunocoracao.github.io/blowfish/
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: ./docs
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: https://nunocoracao.github.io/blowfish/
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/stale.yml

@@ -0,0 +1,35 @@
+# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
+#
+# You can adjust the behavior by modifying this file.
+# For more information, see:
+# https://github.com/actions/stale
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+    - cron: "0 1 * * *"
+  workflow_dispatch:
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/stale@v10
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          stale-issue-message:
+            "This issue will be closed since it has been stale for 60 days."
+          stale-pr-message:
+            "This pull request will be closed since it has been stale for 60
+            days."
+          stale-issue-label: "no-issue-activity"
+          stale-pr-label: "no-pr-activity"
+          days-before-stale: 60
+          days-before-close: 0
+          remove-stale-when-updated: true
+          operations-per-run: 100
+          exempt-issue-labels: 'keep,security'

.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Test Build
+
+on: [push]
+
+jobs:
+  build:
+    name: Build Example Site
+    runs-on: ubuntu-latest
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          submodules: true
+          fetch-depth: 0
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3.0.0
+        with:
+          hugo-version: "latest"
+
+      - name: Build
+        working-directory: ./exampleSite
+        run:
+          hugo --minify --themesDir ../.. --baseURL
+          https://nunocoracao.github.io/blowfish/