Port website from Hugo to Astro (#368)

.github/workflows/build-deploy.yml

@@ -12,11 +12,6 @@ jobs:
       - uses: actions/setup-node@v3
         with:
           node-version: "20"
-      - name: Hugo setup
-        uses: peaceiris/[email protected]
-        with:
-          hugo-version: 0.134.2
-          extended: true
       - name: NPM install
         run: npm ci
       - name: Build
@@ -27,5 +22,5 @@ jobs:
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./public
+          publish_dir: ./dist
           cname: maplibre.org

.github/workflows/build.yml

@@ -12,11 +12,6 @@ jobs:
       - uses: actions/setup-node@v3
         with:
           node-version: "20"
-      - name: Hugo setup
-        uses: peaceiris/[email protected]
-        with:
-          hugo-version: 0.134.2
-          extended: true
       - name: NPM install
         run: npm ci
       - name: Build

.gitignore

@@ -1,22 +1,24 @@
-# Generated files by hugo
-.DS_Store
-/public/
-/resources/_gen/
-/assets/jsconfig.json
-hugo_stats.json
+# build output
+dist/
 
-# Executable may be added to repository
-hugo.exe
-hugo.darwin
-hugo.linux
+# generated types
+.astro/
 
-# Temporary lock file while building
-/.hugo_build.lock
+# dependencies
+node_modules/
 
-node_modules
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
 
-static/files
+# environment variables
+.env
+.env.production
 
-public
+# macOS-specific files
+.DS_Store
 
-.hugo
+# jetbrains setting folder
+.idea/

.prettierignore

@@ -1,17 +1,5 @@
 # Generated files by hugo
 /public/
-/resources/_gen/
-/assets/jsconfig.json
-hugo_stats.json
-
-# Temporary lock file while building
-/.hugo_build.lock
-
+/dist/
+/.astro
 node_modules
-
-static/files
-
-public
-
-render-heading.html
-layouts/_default/_markup/render-link.html

.prettierrc.mjs

@@ -0,0 +1,12 @@
+/** @type {import("prettier").Config} */
+export default {
+  plugins: ["prettier-plugin-astro"],
+  overrides: [
+    {
+      files: "*.astro",
+      options: {
+        parser: "astro",
+      },
+    },
+  ],
+};

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode", "unifiedjs.vscode-mdx"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

README.md

@@ -6,35 +6,23 @@ Features:
 
 - News and blog posts can be published
 - External dependencies are handled via NPM
-- Hugo is bundling the CSS and JS
 
-## Building
+## 🧞 Commands
 
-1. [Install Hugo](https://gohugo.io/getting-started/installing/), which meets the version requirement `>=v0.97.3+extended` (the `+extended` indicates that the "extended" version of Hugo is required).
-   Alternative: If Hugo is not available in a recent version on your platform, then use the wrapper script `./hugow --get-extended`.
-2. Run `npm install` to setup the dependencies
-3. Run `npm run serve` or `./hugow --get-extended serve`
-4. Open the URL which is printed in the terminal
+All commands are run from the root of the project, from a terminal:
 
-After making any changes, make sure to run `npm run format` and `npm run format-check`.
-
-## Building for Production
-
-In order to build the website run `npm run build`. The built website is available in `public/`.
-
-## maplibre-rs weekly
-
-In order to create a news post for maplibre-rs do the following:
-
-```bash
-HUGO_SINCE=2022-05-26 hugo new -k maplibre-rs-news news/2022-05-23-maplibre-rs-weekly.md
-```
-
-This will fetch the last weeks issues and PRs and prepare a post for you.
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
 
 ## MapLibre community map
 
-The data for https://maplibre.org/community/ is managed at `data/community.json`.
+The data for https://maplibre.org/community/ is managed at `src/content/community.json`.
 It shows a map of the MapLibre community members.
 
 The map shows contributors to MapLibre projects as recorded in the public git committer history.
@@ -43,7 +31,7 @@ Location information was taken from people's public GitHub profiles.
 
 ### Please Add Me
 
-If you would like to be included in the MapLibre community map, fork this repo, edit `data/community.json`, and make a pull request. Or just open an issue...
+If you would like to be included in the MapLibre community map, fork this repo, edit `src/content/community.json`, and make a pull request. Or just open an issue...
 
 ### Please Remove Me