Implement PWA Support

Author: Daltz333

.github/workflows/CI.yml

@@ -16,7 +16,7 @@ jobs:
     - name: Install LaTeX
       run: |
         sudo apt-get update
-        sudo apt install -y texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra latexmk texlive-lang-greek texlive-luatex texlive-xetex texlive-fonts-extra dvipng librsvg2-bin
+        sudo apt install -y texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra latexmk texlive-lang-greek texlive-luatex texlive-xetex texlive-fonts-extra dvipng librsvg2-bin nodejs npm
     - name: Build HTML
       run: |
         make html

poetry.lock

@@ -31,6 +31,7 @@ sphinxext-rediraffe = "==0.2.5"
 sphinxext-remoteliteralinclude = "==0.3.0"
 sphinxext-toptranslators = "==0.1.2"
 urllib3 = ">=1.26.6, <2.0.0"
+sphinxext-pwa = {git = "https://github.com/wpilibsuite/sphinxext-pwa.git", rev = "main"}
 
 [tool.poetry.dev-dependencies]
 

pyproject.toml

@@ -9,7 +9,20 @@ formats:
   - htmlzip
   - pdf
 
+build:
+  tools:
+    nodejs: "16"
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.8"
+    # You can also specify other tool versions:
+    nodejs: "16"
+  apt_packages:
+    - librsvg2-bin
+
 python:
-  version: "3.8"
   install:
   - requirements: source/requirements.txt

readthedocs.yml

@@ -43,6 +43,7 @@
     "sphinxext.delta",
     "sphinxext.opengraph",
     "sphinxext.photofinish",
+    "sphinxext.pwa",
     "sphinxext.rediraffe",
     "sphinxext.remoteliteralinclude",
     "sphinxext.toptranslators",
@@ -177,6 +178,17 @@
 # Use MathJax3 for better page loading times
 mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
 
+# PWA Specific Settings
+pwa_name = "FRC Docs"
+pwa_short_name = "FRC Docs"
+pwa_theme_color = "#003974"
+pwa_background_color = "#003974"
+pwa_icons = [
+    ["first-logo-256px.png", "256x256"],
+    ["first-logo-512px.png", "512x512"],
+]
+pwa_apple_icon = "_static/touch-icon.png"
+pwa_maskable_icon = "first-logo-maskable.png"
 
 # -- Options for HTML output -------------------------------------------------
 
@@ -198,7 +210,10 @@
 
 # Specify canonical root
 # This tells search engines that this domain is preferred
-html_baseurl = "https://docs.wpilib.org/en/stable/"
+if os.getenv("TESTING"):
+    html_baseurl = "http://localhost:8000/"
+else:
+    html_baseurl = "https://frc-docs--1704.org.readthedocs.build/en/1704/"
 
 html_theme_options = {
     "collapse_navigation": True,

source/_static/first-logo-256px.png

@@ -13,6 +13,11 @@ Set Driver Station to Default
 
 Open the Driver Station software, click on the Setup tab and set the Dashboard setting to Default. **Then close the Driver Station!**
 
+Locate Dashboard JAR file
+-------------------------
+
+Find the location of the dashboard ``jar`` file.
+
 Open DS Data Storage file
 -------------------------