From bc1cefcfb74a74928245acf9246494acd7b5b363 Mon Sep 17 00:00:00 2001 From: Jakob Aleksandrovich Date: Mon, 2 Oct 2023 14:52:28 +0000 Subject: [PATCH] Upgrade to new ReadTheDocs system (#744) - Fixate new settings in .readthedocs.yaml - Pin on Ubuntu 22.04 - Upgrade to Python 2.7 - Explicitly move to Xetex engine Reviewed-on: https://git.door43.org/unfoldingWord/en_uhg/pulls/744 Co-authored-by: Jakob Aleksandrovich Co-committed-by: Jakob Aleksandrovich --- .readthedocs.yaml | 7 ++++++- content/conf.py | 3 +++ docs/requirements.txt | 1 + 3 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index dea0a33..6a17980 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -1,5 +1,11 @@ version: 2 +# Build settings +build: + os: "ubuntu-22.04" + tools: + python: "3.7" + # Build documentation in the docs/ directory with Sphinx sphinx: configuration: content/conf.py @@ -12,7 +18,6 @@ formats: # Optionally set the version of Python and requirements required to build your docs python: - version: "3.7" install: - requirements: docs/requirements.txt diff --git a/content/conf.py b/content/conf.py index 69bdaea..c92121a 100644 --- a/content/conf.py +++ b/content/conf.py @@ -240,6 +240,9 @@ htmlhelp_basename = 'UHG' # -- Options for LaTeX output --------------------------------------------- +# Use XeLaTex (to properly handle Unicode) +latex_engine = 'xelatex' + latex_elements = { # The paper size ('letterpaper' or 'a4paper'). # diff --git a/docs/requirements.txt b/docs/requirements.txt index 93120e6..091854d 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1 +1,2 @@ docutils<0.18 +sphinx-rtd-theme==1.3.0 \ No newline at end of file