Create .readthedocs.yaml and update ruamel.yaml usage (#26)

.readthedocs.yaml

@@ -0,0 +1,19 @@
+# Read the Docs configuration file for https://hdmf-schema-language.readthedocs.io/
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: source/conf.py
+
+# Optionally set the version of Python and requirements required to build your docs
+python:
+  install:
+    - requirements: requirements-doc.txt

source/conf.py

@@ -107,7 +107,8 @@
 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 with open('namespace_map.yml', 'r') as f:
-    namespace_map = yaml.safe_load(f)
+    yaml_obj = yaml.YAML(typ='safe', pure=True)
+    namespace_map = yaml_obj.load(f)
 
 
 def rstjinja(app, docname, source):