1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## What this repo is
Web frontend for `packages.danix.xyz` — an Apache autoindex-based Slackware package repository. Apache serves directory listings; this repo provides the HTML chrome injected around them.
## How header/footer injection works
Apache's `HeaderName` / `ReadmeName` directives (in `.htaccess`) point to `_header.html` and `_footer.html`. These static files are generated by `gen_web_hook.sh`, which walks `$PKGREPO/{category}/{package}/` and writes a pair at each level. Run standalone or as a slackrepo `HOOK_FINISH` hook.
## Repository directory structure (on server)
```
/var/www/pkgs/ ← REPO_ROOT (depth 0)
category/ ← depth 1
pkgname/ ← depth 2
pkgname-ver.txz
pkgname-ver.txt ← parsed for title/description/Homepage
pkgname-ver.meta ← parsed for compressed/uncompressed sizes
```
## CSS design system
CSS variables defined on `:root`:
- Colors: `--bg`, `--bg-card`, `--bg-hover`, `--border`, `--accent`, `--accent-dim`, `--accent2`, `--green`, `--text`, `--text-dim`, `--text-head`
- Fonts: `--mono` (IBM Plex Mono), `--sans` (IBM Plex Sans) — loaded from Google Fonts
## Static assets
Asset layout under `$PKGREPO/.assets/` (served from `/.assets/`, hidden via `IndexIgnore .assets`):
- `.assets/js/matrix-rain.js` — matrix rain canvas animation. Loaded via `<script defer>` in every `_header.html`. Not regenerated by `gen_web_hook.sh`; copy manually to server when updating.
- `.assets/img/favicon.png` — site favicon. Referenced via `<link rel="icon">` in every `_header.html`. Copy manually to server.
## Apache configuration
- `vhost.conf`: VirtualHost for `packages.danix.xyz:443`, DocumentRoot `/var/www/pkgs`, delegates all index config to `.htaccess`
- `htaccess`: `IndexOptions HTMLTable SuppressHTMLPreamble ...` — `SuppressHTMLPreamble` is critical; it tells Apache not to emit its own `<html>` so our header file controls the full document
## Running the hook
```bash
# Standalone against a local repo path
bash gen_web_hook.sh /path/to/pkgrepo
# Via slackrepo (picks up SR_PKGREPO automatically)
HOOK_FINISH=/path/to/gen_web_hook.sh slackrepo build pkgname
```
|
