A flurry of fixes

- All output formats enabled
- Build instructions moved to new RtD system
- SBL Greek font implemented for both HTML and PDF
- Xetex package enabled for proper Unicode support
- custom.css moved to css subdir
- Added requirement for sphinx-rtd-theme

.readthedocs.yaml

@@ -1,15 +1,26 @@
 version: 2
 
+# Build instructions
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.7"
+  pre_build:
+    - mkdir -p $READTHEDOCS_OUTPUT/pdf
+    - wget https://www.sbl-site.org/Fonts/SBL_grk.ttf -O $READTHEDOCS_OUTPUT/pdf/SBL_grk.ttf
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
    configuration: content/conf.py
 
 # Optionally build your docs in additional formats such as PDF
-# formats: all
+formats:
+  - epub
+  - htmlzip
+  - pdf
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: "3.7"
   install:
   - requirements: docs/requirements.txt
 

content/_static/css/custom.css

@@ -0,0 +1,20 @@
+/*
+ * custom.css
+ * ~~~~~~~~~~
+ *
+ */
+
+body {
+    font-family: "SBL Greek","Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+}
+td,tr {
+    text-align: center;
+}
+
+@font-face {
+    font-family: "SBL Greek";
+    src: url(../fonts/SBL_grk.ttf) format("truetype"),
+         url(../fonts/SBL_grk.woff) format("woff");
+    unicode-range: U+0342-03FF; /* only applies to Greek characters */
+  }
+  

content/_static/custom.css

@@ -1,13 +0,0 @@
-/*
- * custom.css
- * ~~~~~~~~~~
- *
- */
-
-body {
-    font-family: "Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
-}
-td,tr {
-    text-align: center;
-}
-

content/conf.py

@@ -158,6 +158,10 @@ html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
+html_css_files = [
+    'css/custom.css',
+]
+
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
 # directly to the root of the documentation.
@@ -239,6 +243,8 @@ html_static_path = ['_static']
 htmlhelp_basename = 'UGG'
 
 # -- Options for LaTeX output ---------------------------------------------
+#       Use XeLaTex (to properly handle Unicode)
+latex_engine = 'xelatex'
 
 latex_elements = {
      # The paper size ('letterpaper' or 'a4paper').
@@ -248,14 +254,11 @@ latex_elements = {
      # The font size ('10pt', '11pt' or '12pt').
      #
      # 'pointsize': '10pt',
-
-     'label': '\\usepackage[english]{babel}',
-
+     #
      # Additional stuff for the LaTeX preamble.
      #
      'preamble': r'''
-\usepackage{xeCJK}
-\setmainfont{SBL Hebrew}
+\setmainfont{SBL_grk.ttf}
 \XeTeXlinebreaklocale "he"
 \XeTeXlinebreakskip = 0pt plus 1pt
 '''

docs/requirements.txt

@@ -1 +1,2 @@
 docutils<0.18
+sphinx-rtd-theme==1.3.0