docs: migrate documentation to Dockle

.gitignore

@@ -41,8 +41,9 @@
 build/
 cmake-*/
 
-# doxyconfig
-docs/doxyconfig*
+# Dockle
+/.dockle/
+/_site/
 
 # CTest
 Testing/

.gitmodules

@@ -1,6 +1,6 @@
-[submodule "third-party/doxyconfig"]
-	path = third-party/doxyconfig
-	url = https://github.com/LizardByte/doxyconfig.git
+[submodule "third-party/dockle"]
+	path = third-party/dockle
+	url = https://github.com/LizardByte/dockle.git
 	branch = master
 [submodule "third-party/lizardbyte-common"]
 	path = third-party/lizardbyte-common

.readthedocs.yaml

@@ -8,22 +8,23 @@ version: 2
 build:
   os: ubuntu-24.04
   tools:
+    nodejs: "24"
     python: "miniconda-latest"
-  commands:
-    - |
-      if [ -f readthedocs_build.sh ]; then
-        doxyconfig_dir="."
-      else
-        doxyconfig_dir="./third-party/doxyconfig"
-      fi
-      chmod +x "${doxyconfig_dir}/readthedocs_build.sh"
-      export DOXYCONFIG_DIR="${doxyconfig_dir}"
-      "${doxyconfig_dir}/readthedocs_build.sh"
+  jobs:
+    build:
+      html:
+        - |
+          if [ -f readthedocs_build.sh ]; then
+            dockle_dir="."
+          else
+            dockle_dir="./third-party/dockle"
+          fi
+          chmod +x "${dockle_dir}/readthedocs_build.sh"
+          export DOCKLE_DIR="${dockle_dir}"
+          "${dockle_dir}/readthedocs_build.sh"
 
-# using conda, we can get newer doxygen and graphviz than ubuntu provide
-# https://github.com/readthedocs/readthedocs.org/issues/8151#issuecomment-890359661
 conda:
-  environment: third-party/doxyconfig/environment.yml
+  environment: third-party/dockle/environment.yml
 
 submodules:
   include: all

CMakeLists.txt

@@ -31,7 +31,8 @@ endif()
 #
 if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
     if(BUILD_DOCS)
-        add_subdirectory(third-party/doxyconfig docs)
+        include(third-party/dockle/cmake/Dockle.cmake)
+        dockle_add_docs(docs TARGETS api)
     endif()
 
     if(BUILD_TESTS)

README.md

@@ -92,8 +92,3 @@ ninja -C build
 ## ❓ Support
 
 Our support methods are listed in our [LizardByte Docs](https://lizardbyte.readthedocs.io/latest/about/support.html).
-
-<details style="display: none;">
-  <summary></summary>
-  [TOC]
-</details>

dockle.toml

@@ -0,0 +1,30 @@
+[project]
+name = "libdisplaydevice"
+version = "0.0.0"
+description = "C++ library to modify display devices."
+repository = "https://github.com/LizardByte/libdisplaydevice"
+logo = "https://raw.githubusercontent.com/LizardByte/.github/refs/heads/master/branding/logos/logo.svg"
+
+[build]
+output = "_site"
+work = ".dockle"
+strict = true
+clean = true
+
+[[targets]]
+name = "api"
+title = "libdisplaydevice documentation"
+framework = "doxygen"
+source = "."
+home = true
+
+[targets.doxygen]
+inputs = ["README.md", "src"]
+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",
+  "docs/crowdin.js",
+]
+main_page = "README.md"

docs/crowdin.js

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