Welcome Mat

screenshot of Welcome Mat
mkdocs

This is the code for the OpenStreetMap Welcome Mat website

Overview

The Welcome Mat project is a reimagined website designed using Material for MkDocs, aimed at providing a visually appealing and user-friendly experience. This initiative retains the aesthetic qualities of the previous design while incorporating out-of-the-box features from MkDocs. Notably, the project supports multilingual capabilities, allowing users to switch between light and dark themes, ensuring accessibility for everyone involved.

As a collaborative platform, Welcome Mat welcomes contributions from developers and content creators alike. Whether it's extending styling, adding new content, or integrating additional languages, the project encourages a community-driven approach to enhance the website's functionality and reach.

Features

  • Multilingual Support: Easily add translations in various languages, ensuring a broader audience can access the content.
  • Light and Dark Themes: Provides users with the flexibility to choose a theme that suits their preferences and improves readability.
  • Easy Contribution: Open invitation for users to clone the repository, experiment with changes, and submit pull requests for any suggestions.
  • Local Development with Docker: Simple setup for running the website locally using Docker, making it easier for developers to test modifications.
  • Automatic Content Reflection: Changes made while the mkdocs serve script is running will be automatically updated, allowing for seamless development.
  • Structured Translation Process: Well-defined steps for adding translations ensure consistency and ease of use for contributors.
  • Markdown Formatting Preservation: Maintains original Markdown formatting during translations, simplifying the editing process.
mkdocs
MkDocs

MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.