add docs build path for ci to check pdf and epub

.circleci/config.yml

@@ -85,9 +85,19 @@ windows-wheel-steps:
         - .tox
       key: cache-v1-{{ arch }}-{{ .Environment.CIRCLE_JOB }}-{{ checksum "setup.py" }}-{{ checksum "tox.ini" }}
         
+docs: &docs
+  docker:
+    - image: common
+  steps:
+    - run:
+        name: install latexpdf dependencies
+        command: |
+          sudo apt-get update
+          sudo apt-get install latexmk tex-gyre texlive-fonts-extra
+
 jobs:
   docs:
-    <<: *common
+    <<: *docs
     docker:
       - image: cimg/python:3.8
         environment:

Makefile

@@ -39,11 +39,17 @@ build-docs:
 	$(MAKE) -C docs html
 	$(MAKE) -C docs doctest
 	
-validate-docs:
+build-docs-ci:
+	$(MAKE) -C docs latexpdf
+	$(MAKE) -C docs epub
+
+validate-newsfragments:
 	python ./newsfragments/validate_files.py
 	towncrier build --draft --version preview
 
-check-docs: build-docs validate-docs
+check-docs: build-docs validate-newsfragments
+
+check-docs-ci: build-docs build-docs-ci validate-newsfragments
 
 docs: check-docs
 	open docs/_build/html/index.html

tox.ini

@@ -16,7 +16,7 @@ per-file-ignores=__init__.py:F401
 usedevelop=True
 commands=
     core: pytest {posargs:tests/core}
-    docs: make check-docs
+    docs: make check-docs-ci
 basepython=
     docs: python
     windows-wheel: python