No description

Find a file

ZDDC e7678e3c4d All checks were successful Deploy content to live site / deploy (push) Successful in 2s Details docs(index): order zddc-server bullets general → specific; simplify run Re-sort the zddc-server feature list so the most-immediately-useful behaviours (lazy folder creation, virtual .archive URLs, basic ACL, roles, WORM, cascade tracer) come first, then the operational table stakes (per-request logging, TLS hygiene), and the federal/regulated bullets (OPA decider, designed-for-regulated-environments) last. Within each tier the simpler item leads. Strip the explicit ZDDC_ROOT=/srv/zddc from the run example. The binary defaults to the current working directory, so for a quick start "./zddc-server" is all that's needed. Add a follow-on note that the listener defaults to https://localhost:8443/ with a self-signed cert and that --root / --addr / --tls-* override the defaults. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-05-07 10:05:59 -05:00
.forgejo/workflows	ci: drop /avatar.png exclude (file removed)	2026-05-02 21:44:26 -05:00
css	fix: dark-mode contrast on blue pills, brand logo, stable channel chip	2026-05-02 21:27:20 -05:00
img	Initial commit: hand-edited content from the prior orphan branch.	2026-05-02 08:53:11 -05:00
js	Initial commit: hand-edited content from the prior orphan branch.	2026-05-02 08:53:11 -05:00
CLAUDE.md	docs: add Publishing and Editing notes to README; stub CLAUDE.md	2026-05-02 21:27:10 -05:00
federal.html	docs: lead with folder purpose; surface RBAC + WORM on federal page	2026-05-07 09:42:45 -05:00
index.html	docs(index): order zddc-server bullets general → specific; simplify run	2026-05-07 10:05:59 -05:00
LICENSE	Initial commit: hand-edited content from the prior orphan branch.	2026-05-02 08:53:11 -05:00
pubkey.pem	docs: publish Ed25519 pubkey for apps signing	2026-05-04 21:59:20 -05:00
README.md	docs: add Publishing and Editing notes to README; stub CLAUDE.md	2026-05-02 21:27:10 -05:00
reference.html	docs: lead with folder purpose; surface RBAC + WORM on federal page	2026-05-07 09:42:45 -05:00

README.md

ZDDC website

Hand-edited content for zddc.varasys.io. Two files:

index.html — landing page + install snippets.
reference.html — the ZDDC file-naming convention specification.

Plus css/, js/, img/ for shared styles and assets.

This repo intentionally does not contain release artifacts. The ZDDC tools (archive, transmittal, classifier, mdedit, landing) and the zddc-server binary are built from the source repo at https://codeberg.org/VARASYS/ZDDC and deployed to the live site by its build pipeline. They live on the deploy host under /srv/zddc/releases/, never in this repo's git history.

Preview locally

git clone https://codeberg.org/VARASYS/ZDDC-website
cd ZDDC-website
python3 -m http.server 8000
# open http://localhost:8000/

The preview won't have a /releases/ directory unless you also have the source repo and run its build pipeline. That's expected — the two repos are intentionally decoupled.

Publishing

.forgejo/workflows/deploy-content.yml rsyncs the working tree into /srv/zddc/ on the deploy host on every push to main. The rsync uses --delete-after and excludes /releases/, /.git*, /.forgejo*, /README.md, and /LICENSE — anything else added at the repo root will be published.

Editing notes

js/layout.js queries the header for .header-nav, .dropdown, .dropdown-toggle, .dropdown-menu, and .theme-toggle. Both HTML pages need to keep those classes or the theme toggle and Tools dropdown silently break.
Page-specific CSS goes in an inline <style> in <head> (see index.html); only shared rules go in css/style.css. Design tokens (--color-accent, spacing scale, etc.) live at the top of css/style.css — prefer those over hardcoded values.

Contributing

Issues + PRs welcome. For changes to the tool source code (not the website), file them at https://codeberg.org/VARASYS/ZDDC.

License

AGPL-3.0.