qgis / QGIS-Website

🌐 QGIS Website > ## 👋 Welcome to QGIS.org! > > **This repository hosts the source code for the official QGIS Project website:** > 🌍 https://qgis.org > > Here you'll find everything you need to **build, develop, and contribute** to the QGIS website. > > ### ⚠️ Note on Subdomain Websites > > **This repository is _only_ for the main QGIS website (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 > - planet.qgis.org (GitHub: QGIS-Planet-Website) – QGIS Planet Blog Aggregator > - 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 > - conference.qgis.org (GitHub: QGIS-UC-Website) – QGIS User Conference Website 📖 Table of Contents Table of Contents 🚀 Project Overview 🚥 QA Status 📜 License 📂 Folder Structure 🤖 Using 'AI' (Large Language Models) 🛠️ Scripts Overview 🧊 Using the Nix Shell ✨ Contributing 🙋 Have Questions? 🧑‍💻👩‍💻 Contributors 🚀 Project Overview 🚥 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 | ⭐️ Project Stars 📜 License This project is licensed under the MIT License. See the LICENSE file for details. 📂 Folder Structure 🤖 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: • **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. • **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. • **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. 🛠️ Scripts Overview The folder contains utility scripts to assist with data loading, and project maintenance. Below is a summary of each script: | Script Name | Description | Affected Website Parts | |-----------------------------------|----------------------------------------------------------------------------------------------|------------------------| | | Simple script to get sustaining members and other feeds and update our web site with them | 🏢 Sustaining Members page ( ), 📰 News feeds ( ), 🎨 Flickr gallery ( ) | | | Launch VSCode with all settings and extensions needed to productively work on this project | 🛠️ Development environment only | | | Get the current commit hash of this repository and write it in for the website version display | 📄 Footer version info across all pages | | | Will create/update visual-changelogs at based on the data at | 📋 Visual Changelogs pages ( ) | | | Harvest maps/screenshots images from https://hub.qgis.org and update showcase content | 🗺️ Maps and Screenshots showcase section ( and ) | | | Contains utilities to optimize images (resize, transform to webp, check validity) | 🖼️ Images fetched automatically | | | Checks each supporter's URL and removes invalid ones from commercial support listings | 🏪 Commercial Support page ( ) | | | Updates ordered alphabetically by first name based on input file | 💰 Donors page ( ) | | | Updates ordered alphabetically by first name based on Stripe donations | 💰 Donors page ( ) | | | Updates and with release schedule information | 📅 Download page, Release schedule, LTR/LT version info | | | Aggregates GitHub stats for individual contributors across QGIS repositories | 👥 Individual Contributors section ( ) | | | Aggregates GitHub stats for contributing organizations across QGIS repositories | 🏢 Contributing Organizations section ( ) | | | Matches commercial support organizations with contributing organizations based on domain/name | 🏪 Commercial Support badges, 🏢 Contributing Organizations links | | **GitHub Actions (Automated)** | **Scheduled workflows for content updates** | **Multiple areas** | | | Updates GitHub Sponsors list twice daily | 💖 GitHub Sponsors page ( ) | | | Updates Stripe donors list twice daily | 💰 Donors page ( ) | | | Updates feeds and hub maps twice daily | 🏢 Funders, 📰 News feeds, 🗺️ Hub maps | | | Sanitizes commercial support links weekly | 🏪 Commercial Support page | | | Updates commercial support contributor matches daily | 🏪 Commercial Support badges ( ) | > ✏️ **Note:** Run each script from the project root. Some scripts may require environment variables or configuration—see comments within each script for usage details. 🧊 Using the Nix Shell Please refer to the Nix section in CONTRIBUTING.md. ✨ Contributing We welcome contributions! Please read the CONTRIBUTING.md for guidelines on how to get started. 🙋 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 Tea…