- 
+ 
@@ -57,6 +57,7 @@ Blog post directory names should not contain non-alphanumeric characters other t
Blog post directories should always contain a markdown file named `index.md` which will hold the blog post content and metadata.
Additionally, you can provide a cover image in jpg format named `cover.jpg`.
Optionally, any images you want to include into the blog post should be in jpg format and included in the blog post directory.
+Images referenced with markdown syntax (``) are optimized at build time; files referenced from raw HTML (`
`) are copied as-is.
### Blog Post Template
@@ -104,60 +105,35 @@ THe lower part is your blog post content. You'll also see an example of how to i
## Development
-The Terasology website is built with [Gatsby](https://www.gatsbyjs.org/).
-A respective development environment can be installed on macOS, Windows, and Linux (Debian or Ubuntu recommended).
-Youβll need at least 1GB of available RAM.
-
-Make sure that you install the following tools to be able to build and serve the website locally:
-* [Node.js](https://nodejs.org/en/)
-* [Yarn](https://yarnpkg.com/en/)
-
-
-To install all dependencies, run
+The Terasology website is built with [Astro](https://astro.build/) and a few React islands for the interactive parts (blog search, module search, gallery lightbox, download picker).
+You need [Node.js](https://nodejs.org/en/) 24 or newer; npm ships with it.
```sh
-yarn install
+npm install # install dependencies
+npm run dev # dev server with live reload on http://localhost:4321
+npm run build # static build into dist/
+npm run preview # serve the last build
+npm run check # type-check Astro/TS files
+npm run lint:js # ESLint; lint:css = Stylelint, format = Prettier
+npm run clean # remove build output and caches
```
-You can then use the [Gatsby CLI commands](https://www.gatsbyjs.com/docs/reference/gatsby-cli/) `build`, `clean`, `develop` and `serve`.
-
-Our custom source plugin fetches information from GitHub, and therefore needs a GitHub [personal access token] in the environment named `GITHUB_TOKEN`.
+Module and "Good First Issue" data come from the GitHub GraphQL API and need a GitHub [personal access token] (no extra scopes) in the environment as `GITHUB_TOKEN`.
+Without it the build still completes: it warns and renders module pages from previously cached data, or empty if there is none.
+Fetched data is cached for 12 hours in `.astro/`; `npm run clean` forces a refetch.
+Contributor program topics and mentors come from public Trello boards and need no token.
[personal access token]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
> π§° Access Tokens in CI
>
> If the token expires, you can follow the ["How to fix an expired GitHub Action token"](https://terasology.org/Terasology/#/Maintenance?id=how-to-fix-an-expired-github-action-token) instructions with the following adjustments:
-> * the token required for the custom source plugin does not require additional scopes, which means you can skip step 2
+> * the token required for the module data does not require additional scopes, which means you can skip step 2
> * steps 4 and 5 should be performed in the [repository settings for actions] and in the [repository settings for dependabot] on the respective `MODULE_FETCH_GITHUB_TOKEN` secrets
[repository settings for actions]: https://github.com/MovingBlocks/movingblocks.github.com/settings/secrets/actions
[repository settings for dependabot]: https://github.com/MovingBlocks/movingblocks.github.com/settings/secrets/dependabot
-To build the website, run
-
-```sh
-yarn run build
-```
-
-To serve the website from a previous build, run
-
-```sh
-yarn run serve
-```
-
-To compile and serve a preview of the website that reflects your source code changes in the browser in real time, run
-
-```sh
-yarn run develop
-```
-
-To clean up built assets and caches, run
-
-```sh
-yarn run clean
-```
-
> To learn more about the project structure and working of the project please refer to our [docs](docs/project-structure.md).
diff --git a/astro.config.mjs b/astro.config.mjs
new file mode 100644
index 00000000..b885eeab
--- /dev/null
+++ b/astro.config.mjs
@@ -0,0 +1,17 @@
+// @ts-check
+import react from "@astrojs/react";
+import sitemap from "@astrojs/sitemap";
+import { defineConfig } from "astro/config";
+import blogAssets from "./src/integrations/blog-assets.ts";
+
+export default defineConfig({
+ site: "https://terasology.org",
+ integrations: [react(), sitemap(), blogAssets()],
+ image: {
+ // mentor avatars: trello.com attachment URLs redirect to signed files.trello.com URLs
+ remotePatterns: [
+ { protocol: "https", hostname: "trello.com" },
+ { protocol: "https", hostname: "files.trello.com" },
+ ],
+ },
+});
diff --git a/blog/2017-07-14-gsoc-2017-an-overview/index.md b/blog/2017-07-14-gsoc-2017-an-overview/index.md
index 0583ef09..88888c8f 100644
--- a/blog/2017-07-14-gsoc-2017-an-overview/index.md
+++ b/blog/2017-07-14-gsoc-2017-an-overview/index.md
@@ -3,7 +3,7 @@ posttype: "blog"
title: "GSOC 2017 - An Overview"
cover: "./cover.jpg"
description: "The first hurdle of Google Summer of Code is already over for our students, so it's about time to happily announce
-that all ten students have passed the first evaluation."
+ that all ten students have passed the first evaluation."
author: "Skaldarnar"
date: "2017-07-14"
tags: ["GSoC"]
diff --git a/blog/2021-07-31-terasaturday-15-a-summer-of-code/index.md b/blog/2021-07-31-terasaturday-15-a-summer-of-code/index.md
index 266a807c..e4f25355 100644
--- a/blog/2021-07-31-terasaturday-15-a-summer-of-code/index.md
+++ b/blog/2021-07-31-terasaturday-15-a-summer-of-code/index.md
@@ -70,9 +70,9 @@ We are happy to announce that all five students passed their halftime evaluation
Check out [TeraSpotlight: GSOC 2021 Halftime Show & Tell] to find out about the students' achievements over the past few weeks. Below are some canapΓ©s:
{formatDate(current.date)}
+- An open source voxel world - imagine the possibilities! -
-- The Terasology project was born from a Minecraft-inspired tech demo - in 2011. Over the years it has been a playground for different kinds - of technical experiments and proof of concepts. The community - strives to make Terasology a stable platform for various types of - gameplay settings in a voxel world. -
-- The project was founded in 2011 by {`Benjamin "Begla" Glatzel `} - while researching procedural terrain generation and effective - rendering techniques. He succeeded in creating a minecraft-like - demo engine, the foundation stone for what Terasology is today. -
-- We are always on the lookout for contributors with expertise in - rendering, networking and concurrency, as well as in-game - physics and AI technology. -
-- If you are interested in game engine development, come check out - our{" "} - - Terasology Engine & Module Land - - . -
-- From the ground up, Terasology was built to be very modular and - support different kinds of gameplay ideas. We still host a large - number of modules under the {`"Terasology" `}GitHub organization - providing basic and advanced gameplay content as well as world - generation options and technical libraries. -
-- Combining these modules allows to create very different kinds of - gameplay in our voxel worlds. The possibilities are manifold and - range from crafting- or trading-oriented survival over - capture-the-flag to puzzle-style experiences and tower defenses. -
-- We especially appreciate expertise or interest in UI/UX, world - generation or well-thought out gameplay mechanics, but also - always have an open ear for crazy ideas for existing or new - modules and gameplay content. -
-- If you are interested in gameplay development, come check out - our{" "} - - Terasology Engine & Module Land - - . -
-- The Terasology community is a diverse mix of software - developers, designers, game testers, graphic artists, musicians - and other open source loving {`"Gooeys"`}. We value a positive, - inclusive and respectful environment without harassment, attacks - or inappropriate activities of any form. -
-- We encourage and appreciate contributions from everybody, and - try to accept constructive criticism even by newcomers as - gracefully and warmly as possible. and welcoming as possible to - newcomers. -
-- If you want to talk to us or be the next in our group of Gooeys, - come join us on our{" "} - - Terasology Discord - - . -
-
+ )}
+ {name}
+ {message}
+{excerpt}
+ {author ? ( +
+