configurations

.readthedocs.yaml

@@ -16,12 +16,13 @@ build:
     # golang: "1.19"
 
 # Build documentation in the docs/ directory with Sphinx
-#sphinx:
+sphinx:
-#   configuration: docs/conf.py
+   configuration: docs/conf.py
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF
-# formats:
+formats:
-#    - pdf
+    - pdf
+    - epub
 
 # Optionally declare the Python requirements required to build your docs
 #python:

docs/conf.py

@@ -0,0 +1,20 @@
+# conf.py
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+# https://docs.readthedocs.io/en/stable/guides/migrate-rest-myst.html
+
+
+extensions = [
+    # Your existing extensions
+    ...,
+    "myst_parser",
+]
+myst_enable_extensions = [
+     "amsmath",
+    "colon_fence",
+    "deflist",
+    "dollarmath",
+    "html_admonition",
+    "html_image",
+    "linkify",
+    "replacements",
+    "substitution"]

docs/requirements.txt

@@ -0,0 +1 @@
+linkify-it-py