Fix ReadTheDocs rendering (google#1256)

* Updates to rtd config

* Updates

* Updates

* Updates to docs

Author: jleaniz

.readthedocs.yaml

@@ -0,0 +1,25 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+   configuration: docs/conf.py
+
+# If using Sphinx, optionally build your docs in additional formats such as PDF
+# formats:
+#    - pdf
+
+# Optionally declare the Python requirements required to build your docs
+python:
+   install:
+   - requirements: docs/requirements.txt

docs/conf.py

@@ -15,16 +15,14 @@
 # sys.path.insert(0, os.path.abspath('.'))
 
 from __future__ import unicode_literals
-import re
 
-from recommonmark.parser import CommonMarkParser
 from recommonmark.transform import AutoStructify
 from docutils import nodes, transforms
 
 # -- Project information -----------------------------------------------------
 
 project = 'Turbinia'
-copyright = '2022, Google Inc'
+copyright = '2023, Google Inc'
 author = 'Turbinia maintainers'
 
 # -- General configuration ---------------------------------------------------
@@ -81,7 +79,7 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'turbiniadoc'
 
-html_logo = "images/turbinia-logo.jpg"
+html_logo = 'images/turbinia-logo.jpg'
 
 
 class ProcessLink(transforms.Transform):

docs/requirements.txt

@@ -1,5 +1,5 @@
-docutils
-pyparsing
-recommonmark
-sphinx
-sphinx_rtd_theme
+docutils==0.17.1
+pyparsing==2.4.7
+recommonmark==0.7.1
+sphinx==5.3.0
+sphinx_rtd_theme==1.1.1