Fix Read the Docs build failures (#29)

* Fix Read the Docs build failures

- Update deprecated Sphinx settings in docs/conf.py:
  - Replace source_suffix = '.rst' with dict format
  - Replace master_doc with root_doc
- Add build commands to .readthedocs.yaml to generate API docs
  - Generate modules.rst and multibase.rst before build
- Fixes missing 'modules' document warning that caused build to fail

* Add newsfragment for issue #31: Fix Read the Docs build failures

* doc: removed archived note

Author: acul71

.readthedocs.yaml

@@ -4,6 +4,9 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.10"
+  commands:
+    - rm -f docs/multibase.rst docs/modules.rst
+    - sphinx-apidoc -o docs/ multibase
 
 sphinx:
   configuration: docs/conf.py

README.rst

@@ -1,5 +1,3 @@
-**This project is no longer maintained and has been archived.**
-
 py-multibase
 ------------
 

docs/conf.py

@@ -50,13 +50,13 @@
 templates_path = ['_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = {'.rst': 'restructuredtext'}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
 
-# The master toctree document.
-master_doc = 'index'
+# The root toctree document.
+root_doc = 'index'
 
 # General information about the project.
 project = u'py-multibase'

newsfragments/31.docs.rst

@@ -0,0 +1 @@
+Fixed Read the Docs build failures by updating deprecated Sphinx settings and adding API documentation generation.