feat(routing): redirect section landings + harden 404 / no directory listings
All checks were successful
Build and deploy / deploy (push) Successful in 23s

- astro.config.mjs: section-only URLs now redirect to the first article in
  that section. /whp/admin/ used to render Apache's directory listing
  because no index.html existed; now it serves a meta-refresh to
  /whp/admin/overview/. Same for /whp/, /whp/getting-started/,
  /whp/how-to/, /whp/site-builder/, /whp/reference/, /whp/add-ons/.
- public/.htaccess: ships in dist, disables Options Indexes + MultiViews
  (defense in depth so any future section without a redirect doesn't
  leak a listing), and routes 404/403 to /404.html.
- src/content/docs/404.md: replaces the bare 'check the URL' tagline
  with two explicit actions — 'Go to the knowledge base home' and
  'WHP getting started'.
This commit is contained in:
2026-05-18 11:18:35 -07:00
parent 119d376029
commit aeb033bae5
3 changed files with 44 additions and 0 deletions

View File

@@ -7,6 +7,18 @@ import { fileURLToPath } from 'node:url';
// https://astro.build/config
export default defineConfig({
site: 'https://kb.anhonesthost.com',
// Send section-only URLs to the first article in that section. Without these,
// hitting e.g. /whp/admin/ would render the Apache directory listing because
// there is no index.html in that folder.
redirects: {
'/whp/': '/whp/getting-started/welcome/',
'/whp/getting-started/': '/whp/getting-started/welcome/',
'/whp/how-to/': '/whp/how-to/add-a-domain/',
'/whp/site-builder/': '/whp/site-builder/overview/',
'/whp/reference/': '/whp/reference/service-hostnames/',
'/whp/add-ons/': '/whp/add-ons/overview/',
'/whp/admin/': '/whp/admin/overview/',
},
vite: {
resolve: {
alias: {

15
public/.htaccess Normal file
View File

@@ -0,0 +1,15 @@
# Static-HTML site hardening for kb.anhonesthost.com.
# Lands in dist/ at build time and is uploaded with the rest of the site.
# Never expose a directory listing to visitors.
Options -Indexes
# Astro emits both /path/ (with index.html) and /path.html for every route.
# Default to the trailing-slash form; Apache MultiViews can sometimes serve
# /path.html for /path/, which Pagefind doesn't index — disable it.
Options -MultiViews
# Send anything that doesn't resolve to a file to /404.html.
# Starlight builds a real 404 page; this just makes Apache serve it.
ErrorDocument 404 /404.html
ErrorDocument 403 /404.html

17
src/content/docs/404.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: Page not found
description: That URL doesn't exist on our knowledge base.
template: splash
editUrl: false
hero:
title: '404'
tagline: That URL doesn't exist on our knowledge base.
actions:
- text: Go to the knowledge base home
link: /
icon: right-arrow
variant: primary
- text: WHP getting started
link: /whp/getting-started/welcome/
variant: secondary
---