No description
  • Astro 43.5%
  • MDX 36.6%
  • CSS 15.8%
  • TypeScript 3.9%
  • JavaScript 0.2%
Find a file
2026-10-02 12:05:27 +02:00
public small moves 2026-05-25 20:32:34 +02:00
src blog post: The cost of not being able to walk away 2026-10-02 12:05:27 +02:00
.gitignore small moves 2026-05-25 20:32:34 +02:00
astro.config.mjs Adds support for mdx files 2026-05-25 23:30:42 +02:00
LICENSE-CODE.md feat: add bilingual static site and licensing docs 2026-05-24 17:47:03 +02:00
LICENSE-CONTENT.md feat: add bilingual static site and licensing docs 2026-05-24 17:47:03 +02:00
NOTICE.md feat: add bilingual static site and licensing docs 2026-05-24 17:47:03 +02:00
package-lock.json Updates Astro 2026-10-02 12:04:56 +02:00
package.json Updates Astro 2026-10-02 12:04:56 +02:00
README.md feat(blog): add bilingual publishing support 2026-08-17 22:52:08 +02:00
STYLEGUIDE.md small moves 2026-05-25 20:32:34 +02:00
tsconfig.json small moves 2026-05-25 20:32:34 +02:00

ABC - AI per il Bene Comune

Static Astro website for ABC - AI per il Bene Comune.

Website: https://abc.olisti.co
Contact: abc@olisti.co

Local Development

Install dependencies:

npm install

Start the local development server:

npm run dev

Astro will print the local URL, usually:

http://localhost:4321/

The Italian site is available at /, the English site at /en/, and the localized blogs at /blog/ and /en/blog/.

Blog

Blog posts are plain Markdown or MDX files organized by language in:

src/content/blog/it/
src/content/blog/en/

Each post uses Astro Content Collections frontmatter:

---
title: "Post title"
description: "Short description for cards, SEO and RSS."
pubDate: 2026-05-25
tags: ["AI", "bene comune"]
lang: it
translationKey: example-post
draft: false
---

Use lang: it for Italian posts and lang: en for English posts. To pair two translations, give both files the same translationKey; the language switcher will then link directly between them. Keep the files in their language directories. Their filenames determine their URL slugs and may differ between translations:

src/content/blog/it/articolo-esempio.md  → /blog/articolo-esempio/
src/content/blog/en/example-post.md      → /en/blog/example-post/

For example, the English file would contain:

---
title: "Post title"
description: "Short description."
pubDate: 2026-05-25
tags: ["AI", "common good"]
lang: en
translationKey: example-post
draft: false
---

The author field is optional. When omitted, it defaults to the localized organization name. If a post does not yet have a translation, its language switch takes readers to the other language's blog index.

Use draft: true for posts that should be hidden from production builds. Posts are sorted newest first within their language. Individual post slugs come from their Markdown filename.

The Italian and English RSS feeds are generated at:

/rss.xml
/en/rss.xml

Build And Preview

Build the static site:

npm run build

Astro writes the generated static files to:

dist/

Preview the production build locally:

npm run preview

Static Deployment

Deploy the contents of dist/ to any static host. The site does not require a server runtime, CMS or database.

Public routes use clean trailing slashes, for example:

  • /
  • /en/
  • /blog/
  • /en/blog/
  • /style-guide/
  • /license/

The previous .html support-page URLs are not generated by this clean-route migration.

Design Notes

The site keeps the original visual identity: minimal editorial layout, warm off-white background, purple primary color, teal accent details, Atkinson Hyperlegible, restrained cards and accessible focus states.

See STYLEGUIDE.md and /style-guide/ for the maintained design notes.

License

This repository uses separate licenses for content and source code.

Unless otherwise noted:

  • Website content is licensed under Creative Commons Attribution-ShareAlike 4.0 International.
  • Website source code is licensed under the GNU Affero General Public License v3.0 or later.

See:

  • LICENSE-CONTENT.md
  • LICENSE-CODE.md
  • NOTICE.md

SPDX identifiers:

  • Content: CC-BY-SA-4.0
  • Code: AGPL-3.0-or-later