From ecad933f963041d9967bc257e3c8e4a4063e1dd5 Mon Sep 17 00:00:00 2001 From: Kozo Nishida Date: Wed, 27 Aug 2025 18:43:39 +0900 Subject: [PATCH 1/2] Add initial MkDocs configuration file Introduces mkdocs.yml with site metadata, navigation structure, theme, plugins, and markdown extensions for Hatchling project documentation. --- mkdocs.yml | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 mkdocs.yml diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..12681d1 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,39 @@ +site_name: Hatchling Docs +site_description: Documentation for the Hatchling project +site_url: https://crackingshells.github.io/Hatchling/ + +repo_name: CrackingShells/Hatchling +repo_url: https://github.com/CrackingShells/Hatchling + +docs_dir: docs + +theme: + name: mkdocs + +nav: + - Home: index.md + - Users: + - Chat Commands: articles/users/chat_commands.md + - Settings: articles/users/settings.md + - Settings Reference: articles/users/settings_reference.md + - Language Support: articles/users/language_support.md + - Developers: + - Versioning: articles/devs/versioning.md + - Settings Architecture: articles/devs/settings_architecture.md + - Event System Architecture: articles/devs/event_system_architecture.md + - i18n Support: articles/devs/i18n_support.md + - Contributing: articles/devs/CONTRIBUTING.md + - Appendices: + - Glossary: articles/appendices/glossary.md + - Changelog: CHANGELOG.md + +plugins: + - search + +markdown_extensions: + - admonition + - toc: + permalink: true + - tables + - footnotes + - codehilite From 10443a09d454210a9dde812b6785013110939e89 Mon Sep 17 00:00:00 2001 From: Kozo Nishida Date: Fri, 29 Aug 2025 19:22:15 +0900 Subject: [PATCH 2/2] Add Read the Docs configuration file --- .readthedocs.yaml | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 .readthedocs.yaml diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 0000000..9666533 --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,22 @@ +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +# Set the OS, Python version, and other tools you might need +build: + os: ubuntu-24.04 + tools: + python: "3.13" + +# Build documentation with Mkdocs +mkdocs: + configuration: mkdocs.yml + +# Optionally, but recommended, +# declare the Python requirements required to build your documentation +# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html +# python: +# install: +# - requirements: docs/requirements.txt