Static Astro site with a git-based CMS (Sveltia). Code lives here; editorial content lives in the separate ctao/content repository. Four Example pages are editable; all other pages are placeholders.

Live demo: https://astro.isl-dev.grid.cyfronet.pl
Editor: https://astro.isl-dev.grid.cyfronet.pl/admin/ (Gitea sign-in)

Run locally

Node 22.19 or newer. Clone the content repository next to this one:

git clone https://astro-git.isl-dev.grid.cyfronet.pl/ctao/content.git ../content
npm ci
npm run dev        # http://localhost:4321

The site reads ../content directly through links, so pull that repository for the latest content. To use a checkout elsewhere: npm run content:link -- <path>.

Before pushing code, run npm run check (types, build, internal links).

Edit content locally

With npm run dev running, open http://localhost:4321/admin/ in Chrome or Edge, choose Work with Local Repository and select the ../content folder. Saves write the Markdown files and show up on the local site on reload. They are not committed: commit and push in ../content to publish.

Publishing

Pushing to main of ctao/portal (code) or ctao/content (content) on Gitea rebuilds and publishes the live demo automatically; the online editor commits to ctao/content directly. Pushing to Bitbucket does not deploy. Server setup is in deploy/README.md.

Where things live

Path	Purpose
`src/layouts/Base.astro`	Header, navigation, footer, page shell
`src/pages/example/[slug].astro`	Template for the editable Example pages
`src/data/examples.json`	Example pages: menu labels, order, slugs
`src/data/placeholders.json`	Placeholder pages
`src/styles/global.css`	All site styles
`public/admin/config.yml`	CMS fields and Gitea connection
`scripts/preview-styles.mjs`	Builds the CMS preview styles from `global.css`
`scripts/content.mjs`	Links the content checkout into the site

To add an Example page, add it to src/data/examples.json and public/admin/config.yml, and commit its Markdown file to ctao/content.