EuroPython Website 🌍🐍

Introduction 👋

Welcome to the repository for the EuroPython website! We use Astro in combination with pnpm to manage dependencies.

Setup 🛠️

Local dev env

To get started, clone the repository and run pnpm install to fetch all the dependencies. Then, use pnpm run dev to start the development server.

The website will be available at http://localhost:4321.

Pre-commit Setup

To ensure code quality and consistency, we use pre-commit hooks. Follow these steps to set up pre-commit on your local environment:

1. Install pre-commit. You can follow the instructions from pre-commit.com.
2. Run pre-commit install in the root of your local repository.
3. Now, pre-commit will run automatically on git commit. You can also run it manually on all files using pre-commit run --all-files.

This will help maintain a consistent coding style and catch common issues before submission.

Docker

If you want to run this in docker, run:

$ docker compose build
$ docker compose up

The website will be available at http://localhost:4321.

Docker Troubleshooting

Docker Compose mounts volumes from your file system to enable live reload. If you're having problems starting the container, try this:

# Clean everything
docker compose down -v  # Remove volumes
docker image rmi website-web # Clean unused images
docker rm website-web # Clean unused containers

# Remove local pnpm store if it exists
rm -rf .pnpm-store

# Rebuild from scratch
docker compose build --no-cache
docker compose up

Content Structure 🗂️

The content of the site is store in this repository. We are using Astro's content collections to manage the content. The collections are configure inside src/content/config.ts.

Pages

Pages are stored in the src/content/pages directory. Each page is a md file with frontmatter.

Deadlines

Meanwhile, our important deadlines ⏰ are located inside the src/content/deadlines directory.