Merge pull request #1034 from wkliao/init_readthedocs

DOC: add a bare bones readthedocs yaml file

Author: wkliao

.readthedocs.yaml

@@ -0,0 +1,14 @@
+version: "2"
+
+build:
+  os: "ubuntu-22.04"
+
+  tools:
+    python: "3.10"
+
+python:
+  install:
+    - requirements: readthedocs/requirements.txt
+
+sphinx:
+  configuration: conf.py

conf.py

@@ -0,0 +1,29 @@
+# Configuration file for the Sphinx documentation builder.
+
+# -- Project information
+
+project = u'Darshan'
+copyright = u"2025, Argonne National Laboratory"
+author = u""
+
+release = '0.1'
+version = '0.1.0'
+
+# -- General configuration
+
+extensions = [
+    'sphinx.ext.duration',
+    'sphinx.ext.doctest',
+    'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
+    'sphinx.ext.intersphinx',
+]
+
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3/', None),
+    'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
+}
+intersphinx_disabled_domains = ['std']
+
+templates_path = ['_templates']
+

index.rst

@@ -0,0 +1,7 @@
+Welcome to Darshan's documentation!
+===================================
+
+.. note::
+
+   This project is under active development.
+

readthedocs/requirements.txt

@@ -0,0 +1,6 @@
+sphinx==8.1.3
+sphinx-rtd-theme==3.0.2
+cffi
+numpy
+pandas
+matplotlib