rootiest/fish-config

Fork 0

Files

T

History

rootiest f9086bd2ca

Generate documentation / build-docs (push) Successful in 5m27s

Details

ci(build-docs): fix baseless non-critical warnings in build log

- Eliminate the warning about the generic 404 page being replaced, it
was intentional.
- Add a flag to the cloudflare deploy task to approve pushes from dirty
git repos, it was intentional for the dynamic build.

2026-07-28 00:20:16 -04:00

.vscode

feat(docs-site): scaffold Astro Starlight site

2026-07-25 22:27:55 -04:00

public

feat(site): add starlight logo and favicon

2026-07-27 19:33:16 -04:00

src

docs(site): improve UI, add catppuccin theme, fix MDX bugs

2026-07-27 23:27:09 -04:00

.gitignore

feat(docs-site): scaffold Astro Starlight site

2026-07-25 22:27:55 -04:00

astro.config.mjs

ci(build-docs): fix baseless non-critical warnings in build log

2026-07-28 00:20:16 -04:00

package-lock.json

docs(site): improve UI, add catppuccin theme, fix MDX bugs

2026-07-27 23:27:09 -04:00

package.json

docs(site): improve UI, add catppuccin theme, fix MDX bugs

2026-07-27 23:27:09 -04:00

README.md

docs(site): replace starter README and title synopsis fences

2026-07-26 05:01:01 -04:00

tsconfig.json

feat(docs-site): scaffold Astro Starlight site

2026-07-25 22:27:55 -04:00

README.md

fish-config docs site

Starlight site for the fish-config manual.

Generated, not authored

Everything under src/content/docs/ is generated — do not edit it directly, changes will be overwritten. The sources are:

docs/manual/** — prose for every section except the functions reference
functions/*.fish comment headers — the functions reference (Section 5)

Regenerate from the repo root:

python3 docs/build-manual.py --site

docs/verify-manual.py validates both sources before you build; run it first if you've touched a header or a manual page.

Development

cd docs/site
npm install
npm run dev

Deploy

Built and deployed to Cloudflare Pages by the Gitea Actions workflow on every push to main — there's no manual deploy step.