From 2525e8916570951a3aceaf9e922c8c1408ca101c Mon Sep 17 00:00:00 2001
From: HsiangNianian <i@jyunko.cn>
Date: Tue, 7 Oct 2025 03:02:45 +0800
Subject: feat: enhance documentation build process with rinoh support and
 update dependencies

---
 docs/source/conf.py   | 22 ++++++++++++++++++++++
 docs/source/index.rst |  6 +++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

(limited to 'docs/source')

diff --git a/docs/source/conf.py b/docs/source/conf.py
index b156ee0..72a569b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -4,6 +4,26 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 import os, sys
+from pathlib import Path
+
+# from rinoh.frontend.rst import ReStructuredTextReader
+# from rinoh.template import TemplateConfigurationFile
+
+# the parser builds a rinohtype document tree
+# parser = ReStructuredTextReader()
+# with open('index.rst') as file:
+#     document_tree = parser.parse(file)
+
+# load the article template configuration file
+# script_path = Path(sys.path[0]).resolve()
+# config = TemplateConfigurationFile(script_path / 'oneroll.rtt')
+
+# render the document to 'my_document.pdf'
+# document = config.document(document_tree)
+# document.render('my_document')
+
+# rinoh_documents = [dict(doc='index',        # top-level file (index.rst)
+#                         target='manual')]   # output file (manual.pdf)
 
 if sys.version_info >= (3, 11):
     import tomllib
@@ -55,6 +75,7 @@ extensions = [
     "sphinxcontrib.httpdomain",
     "sphinx.ext.ifconfig",
     "myst_parser",
+    "sphinx_click",
 ]
 
 doctest_global_setup = """
@@ -149,3 +170,4 @@ html_theme_options = {
 #    '**': ['globaltoc.html', 'sourcelink.html', 'searchbox.html', 'relations.html'],
 #    'using/windows': ['windowssidebar.html', 'searchbox.html'],
 # }
+latex_documents = {}
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 0a5fff9..b3610c4 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -8,4 +8,8 @@ OneRoll
    introduction
    usage
    api
-   examples
\ No newline at end of file
+   examples
+
+
+Indices and tables
+==================
\ No newline at end of file
-- 
cgit v1.2.3-70-g09d2