docs: migrate documentation to Dockle

.gitignore

@@ -138,6 +138,10 @@ venv.bak/
 # mkdocs documentation
 /site
 
+# Dockle
+/.dockle/
+/_site/
+
 # mypy
 .mypy_cache/
 .dmypy.json

.readthedocs.yaml

@@ -3,27 +3,20 @@
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
-# Required
 version: 2
 
-# Set the version of Python
 build:
   os: ubuntu-24.04
   tools:
     python: "3.14"
   jobs:
-    post_build:
-      - rstcheck -r .  # lint rst files
-      # - rstfmt --check --diff -w 120 .  # check rst formatting
-
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-  builder: html
-  configuration: docs/source/conf.py
-  fail_on_warning: true
-
-# Using Sphinx, build docs in additional formats
-formats: all
+    build:
+      html:
+        - |
+          uv run --no-sync dockle check
+          uv run --no-sync dockle build
+          mkdir -p "${READTHEDOCS_OUTPUT}html/"
+          cp -r _site/. "${READTHEDOCS_OUTPUT}html/"
 
 python:
   install:

dockle.toml

@@ -0,0 +1,34 @@
+[project]
+name = "LizardByte"
+version = "0.0.0"
+description = "LizardByte organization documentation."
+repository = "https://github.com/LizardByte/.github"
+author = "LizardByte"
+logo = "branding/logos/logo-512x512.png"
+favicon = "branding/logos/favicon.ico"
+
+[build]
+output = "_site"
+work = ".dockle"
+strict = true
+clean = true
+
+[[targets]]
+name = "docs"
+title = "LizardByte documentation"
+framework = "sphinx"
+source = "docs/source"
+home = true
+
+[targets.sphinx]
+static_paths = ["docs/source/_static"]
+source_edit_link = "https://github.com/LizardByte/.github/blob/master/docs/source/{filename}"
+extra_stylesheets = [
+  "https://cdn.jsdelivr.net/npm/@lizardbyte/shared-web@2026.920.12131/dist/crowdin-dockle-css.css",
+]
+extra_javascript = [
+  "https://cdn.jsdelivr.net/npm/@lizardbyte/shared-web@2026.920.12131/dist/crowdin.js",
+  "https://cdn.jsdelivr.net/npm/@lizardbyte/shared-web@2026.920.12131/dist/ranking-sorter.js",
+  "js/crowdin.js",
+  "js/projects.js",
+]

docs/source/_static/js/crowdin.js

@@ -1 +1 @@
-globalThis.initCrowdIn('LizardByte-docs', 'sphinx')
+globalThis.initCrowdIn('LizardByte-docs', 'dockle')

docs/source/about/donate.md

@@ -0,0 +1,15 @@
+# Donate
+
+Want to support our work? You can donate to us via the following platforms:
+
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/lizardbyte?label=Github%20Sponsors&style=for-the-badge&color=green&logo=githubsponsors)](https://github.com/sponsors/LizardByte)
+
+[![Patreon](https://img.shields.io/badge/dynamic/json?color=green&label=Patreon&style=for-the-badge&query=patron_count&url=https%3A%2F%2Fapp.lizardbyte.dev%2Fdashboard%2Fpatreon%2FLizardByte.json&logo=patreon)](https://www.patreon.com/LizardByte)
+
+[![PayPal](https://img.shields.io/static/v1?style=for-the-badge&label=PayPal&message=Donate&color=green&logo=paypal)](https://www.paypal.com/paypalme/ReenigneArcher)
+
+If you'd like to support us without donating, please consider starring your favorite LizardByte repositories.
+
+Thank you to all our supporters!
+
+![Sponsors](https://raw.githubusercontent.com/LizardByte/contributors/refs/heads/dist/sponsors.svg)

docs/source/developers/repository_standards.md

@@ -0,0 +1,59 @@
+# Repository standards
+
+This document outlines the standards and best practices for LizardByte repositories to ensure consistency,
+maintainability, and quality across all projects.
+
+## Repository structure
+
+### File organization
+
+All repositories should follow a consistent structure:
+
+```text
+repository-name/
+├── .github/
+│   ├── matchers/  # custom problem matchers
+│   ├── workflows/
+│   │   ├── _codeql.yml
+│   │   └── _common-lint.yml
+│   ├── dependabot.yml
+│   └── semantic.yml
+├── branding/  # project specific branding assets
+├── docs/  # structure varies depending on the doc system used
+├── src/  # main source code
+├── tests/  # if there are tests
+├── third-party/  # location of submodules if any
+├── .gitignore
+├── LICENSE
+└── README.md or README.rst
+```
+
+### Required files
+
+Every repository must include:
+
+- **LICENSE**: All projects must use an appropriate license.
+- **README**: Primary documentation in reStructuredText (`.rst`) or Markdown (`.md`) format.
+- **.gitignore**: Appropriate for the project's language and framework. See [GitHub's collection](https://github.com/github/gitignore) for starter templates.
+- **.github/**: Contains GitHub-specific configurations such as workflows and issue templates.
+
+## Naming conventions
+
+### Repository names
+
+- Be descriptive and concise.
+- Avoid abbreviations unless widely understood.
+
+### Branch names
+
+- Use descriptive names with forward slashes for organization.
+- Format: `type/short-description`.
+- Types include `feat/`, `fix/`, `docs/`, and `refactor/`; see [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) for a full list.
+- Examples: `feat/user-authentication`, `fix/memory-leak`, `docs/api-reference`.
+
+### File and directory names
+
+- Be consistent within each project.
+- Avoid spaces and special characters.
+
+For questions about these standards or exceptions, open an issue in the [.github repository](https://github.com/LizardByte/.github) or contact the maintainers.