Browse Source

Used GitHub actions for docs tests.

Co-Authored-By: Tom Forbes <tom@tomforb.es>
Mariusz Felisiak 4 years ago
parent
commit
9f125fce79
3 changed files with 41 additions and 1 deletions
  1. 35 0
      .github/workflows/docs.yml
  2. 3 1
      docs/conf.py
  3. 3 0
      docs/requirements.txt

+ 35 - 0
.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: Docs
+
+on:
+  pull_request:
+    paths:
+      - 'docs/**'
+  push:
+    branches:
+      - master
+    paths:
+      - 'docs/**'
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    name: docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('docs/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      - run: python -m pip install -r docs/requirements.txt
+      - name: Build docs
+        run: |
+          cd docs
+          sphinx-build -b spelling -n -q -W --keep-going -d _build/doctrees -D language=en_US -j auto . _build/spelling

+ 3 - 1
docs/conf.py

@@ -61,6 +61,8 @@ spelling_lang = 'en_US'
 # Location of word list.
 spelling_word_list_filename = 'spelling_wordlist'
 
+spelling_warning = True
+
 # Add any paths that contain templates here, relative to this directory.
 # templates_path = []
 
@@ -125,7 +127,7 @@ today_fmt = '%B %d, %Y'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build', '_theme']
+exclude_patterns = ['_build', '_theme', 'requirements.txt']
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 default_role = "default-role-error"

+ 3 - 0
docs/requirements.txt

@@ -0,0 +1,3 @@
+pyenchant
+sphinx
+sphinxcontrib-spelling