🌐 QGIS User Conference Website

👋 Welcome to the User Conference Website!

This repository hosts the source code for the official User Conference Website:
🌍 https://conference.qgis.org

Here you'll find everything you need to build, develop, and contribute to the User Conference Website.

⚠️ Note on Subdomain Websites

This repository is only for the main User Conference Website (conference.qgis.org).

If you are looking for the source code or want to contribute to QGIS subdomain websites, please visit their respective repositories below.
Each subdomain has its own codebase and contribution process:

• plugins.qgis.org (GitHub: QGIS-Plugins-Website) – QGIS Plugins Repository
• hub.qgis.org (GitHub: QGIS-Hub-Website) – QGIS Resources Hub
• feed.qgis.org (GitHub: qgis-feed) – QGIS Feed Manager
• qgis.org (GitHub: QGIS-Website) – QGIS Main Website
• members.qgis.org (GitHub: QGIS-Members-Website) – QGIS Sustaining Members Portal
• certification.qgis.org (GitHub: QGIS-Certification-Website) – QGIS Certification Programme Platform
• changelog.qgis.org (GitHub: QGIS-Changelog-Website) – QGIS Changelog Manager
• planet.qgis.org (GitHub: QGIS-Planet-Website) – QGIS Planet Website

📖 Table of Contents

Table of Contents

1. 🚀 Deployment Overview
2. 🚥 QA Status
3. 📜 License
4. 📂 Folder Structure
5. ✨ Contributing
6. 🧊 Using the Nix Shell
7. 🤖 Using 'AI' (Large Language Models)
8. 🙋 Have Questions?
9. 🧑‍💻👩‍💻 Contributors

🚀 Deployment Overview

The QGIS User Conference website is deployed through multiple channels to support live previews, yearly editions, and automatic redirects.

🌐 Main entry point

• https://conference.qgis.org
  Always redirects to the current conference edition (e.g. https://uc2026.qgis.org).

---

🧭 Current conference

• Branch: main
• URL: https://uc20XX.qgis.org
• Deployment:
  • Automatically deployed every 6 hours via a scheduled (cron) pull
  • Used for the active conference edition

This ensures production stays in sync with main even if no new commits are pushed.

---

📚 Past conferences

• Branches: uc20YY (e.g. uc2024, uc2025)
• URLs: https://uc20YY.qgis.org

Each past conference stays permanently available and frozen on its own branch and URL.

---

🔍 Preview & CI deployments

• Trigger: Any Pull Request or push to main
• URL:
  https://qgis.github.io/QGIS-UC-Website/

This is the live preview environment used for:

• Reviewing PRs
• Testing layout and content
• Verifying changes before they reach production

It is always built from the latest commit.

---

🧩 How it fits together

Purpose	Branch	URL	Update frequency
Public entry point	—	https://conference.qgis.org	Redirect only
Live conference	main	https://uc20XX.qgis.org	Every 6 hours
Past conferences	uc20YY	https://uc20YY.qgis.org	Static
PR / Preview	PR / main	https://qgis.github.io/QGIS-UC-Website/	Immediate

---

This setup provides:

• Stable, permanent archives for past conferences
• A robust production deployment for the current edition
• Instant previews for all changes before they go live

🚥 QA Status

🪪 Badges

Badge	Description
	End-to-end tests status (Playwright)
	Deployment status to GitHub Pages
	Website availability status
	Repository license
	Open issues count
	Closed issues count
	Open pull requests count
	Closed pull requests count

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

📂 Folder Structure

QGIS-UC-Website/
  ├── ⚙️  config/           # Hugo configuration files
  ├── 📄  content/          # Markdown content files (pages, posts)
  ├── 🖼️  img/              # Images files used by this README
  ├── 🧩  layouts/          # Hugo templates and partials
  ├── 🧪  playwright/       # Playwright end-to-end test scripts
  ├── 📦  public/           # Generated site output (after `hugo` build)
  ├── 🗂️  resources/        # Hugo-generated resources (e.g., minified assets)
  ├── 🛠️  scripts/          # Utility scripts for development/maintenance/harvesting
  ├── 📄  static/           # Static files served as-is (e.g., favicon, robots.txt)
  ├── 🎨  themes/           # Hugo themes
  ├── ⚙️  config.toml       # Main Hugo configuration file
  ├── 🤝  CONTRIBUTING.md   # Contribution guidelines
  ├── 📜  LICENSE           # Project license
  ├── ⚙️  Makefile          # Build/Deployment automation commands
  ├── 📖  README.md         # Project overview and instructions
  ├── 🐚  shell.nix         # Nix shell environment definition
  └── 💡  vscode.sh*        # VSCode helper script for Nix development environment

✨ Contributing

We welcome contributions! Please read the CONTRIBUTING.md for guidelines on how to get started.

🧊 Using the Nix Shell

Please refer to the Nix section in CONTRIBUTING.md.

🤖 Using 'AI' (Large Language Models)

We are fine with using LLM's and Generative Machine Learning to act as general assistants, but the following three guidelines should be followed:

1. Repeatability: Although we understand that repeatability is not possible generally, whenever you are verbatim using LLM or Generative Machine Learning outputs in this project, you must also provide the prompt that you used to generate the resource.
2. Declaration: Sharing the prompt above is implicit declaration that a machine learning assistant was used. If it is not obvious that a piece of work was generated, include the robot (🤖) icon next to a code snippet or text snippet.
3. Validation: Outputs generated by a virtual assistant should always be validated by a human and you, as contributor, take ultimate responsibility for the correct functionality of any code and the correct expression in any text or media you submit to this project.

🙋 Have Questions?

Have questions or feedback? Feel free to open an issue or submit a Pull Request!

🧑‍💻👩‍💻 Contributors

• Tim Sutton – Original author and lead maintainer of the QGIS Website project
• Kontur Team – Responsible for the design and development of the current website version
• Lova Andriarimalala – Core developer and ongoing maintainer
• Marco Bernasocchi – Core Developer
• QGIS Contributors – See the full list of amazing contributors who have helped make this website possible.

Made with ❤️ by Tim Sutton (@timlinux), Lova Andriarimalala (@Xpirix), Marco Bernasocchi (@mbernasocchi) and QGIS Contributors.