From c538c151c7462ad0395ff2c15c5e11e89e362aa8 Mon Sep 17 00:00:00 2001
From: Striven <sg.striven@cutecat.club>
Date: Sat, 04 Apr 2026 19:47:16 +0000
Subject: [PATCH] Initial commit
---
docs/hosting.md | 48 ++++++++++++++++++++++++++++++++++--------------
1 files changed, 34 insertions(+), 14 deletions(-)
diff --git a/docs/hosting.md b/docs/hosting.md
index 6f31f82..7e50f6c 100644
--- a/docs/hosting.md
+++ b/docs/hosting.md
@@ -15,7 +15,7 @@
## Cloudflare Pages
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
-2. In Account Home, select **Workers & Pages** > **Create application** > **Pages** > **Connect to Git**.
+2. In Account Home, select **Compute (Workers)** > **Workers & Pages** > **Create application** > **Pages** > **Connect to Git**.
3. Select the new GitHub repository that you created and, in the **Set up builds and deployments** section, provide the following information:
| Configuration option | Value |
@@ -61,6 +61,8 @@
with:
fetch-depth: 0 # Fetch all history for git info
- uses: actions/setup-node@v4
+ with:
+ node-version: 22
- name: Install Dependencies
run: npm ci
- name: Build Quartz
@@ -180,37 +182,33 @@
## GitLab Pages
-In your local Quartz, create a new file `.gitlab-ci.yaml`.
+In your local Quartz, create a new file `.gitlab-ci.yml`.
-```yaml title=".gitlab-ci.yaml"
+```yaml title=".gitlab-ci.yml"
stages:
- build
- deploy
-variables:
- NODE_VERSION: "18.14"
+image: node:22
+cache: # Cache modules in between jobs
+ key: $CI_COMMIT_REF_SLUG
+ paths:
+ - .npm/
build:
stage: build
rules:
- if: '$CI_COMMIT_REF_NAME == "v4"'
before_script:
- - apt-get update -q && apt-get install -y nodejs npm
- - npm install -g n
- - n $NODE_VERSION
- hash -r
- - npm ci
+ - npm ci --cache .npm --prefer-offline
script:
- npx quartz build
artifacts:
paths:
- public
- cache:
- paths:
- - ~/.npm/
- key: "${CI_COMMIT_REF_SLUG}-node-${CI_COMMIT_REF_NAME}"
tags:
- - docker
+ - gitlab-org-docker
pages:
stage: deploy
@@ -249,6 +247,28 @@
}
```
+### Using Apache
+
+Here's an example of how to do this with Apache:
+
+```apache title=".htaccess"
+RewriteEngine On
+
+ErrorDocument 404 /404.html
+
+# Rewrite rule for .html extension removal (with directory check)
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_URI}.html -f
+RewriteRule ^(.*)$ $1.html [L]
+
+# Handle directory requests explicitly
+RewriteCond %{REQUEST_FILENAME} -d
+RewriteRule ^(.*)/$ $1/index.html [L]
+```
+
+Don't forget to activate brotli / gzip compression.
+
### Using Caddy
Here's and example of how to do this with Caddy:
--
Gitblit v1.10.0