From 4b48ebe86bc9063454b94a5d05eb53f94016dbe1 Mon Sep 17 00:00:00 2001 From: "Paul J. Dorn" Date: Wed, 31 Jul 2024 04:02:51 +0200 Subject: [PATCH 1/3] no docs/build in sdist alternate spelling _build covers new defaults of regenerated sphinx Makefile --- .gitignore | 1 + MANIFEST.in | 2 ++ 2 files changed, 3 insertions(+) diff --git a/.gitignore b/.gitignore index 2cc389249..581094b7f 100755 --- a/.gitignore +++ b/.gitignore @@ -7,6 +7,7 @@ .tox __pycache__ build +docs/_build coverage.xml dist examples/frameworks/django/testing/testdb.sql diff --git a/MANIFEST.in b/MANIFEST.in index edf1811ef..af8aae7e7 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -10,4 +10,6 @@ recursive-include examples * recursive-include docs * recursive-include examples/frameworks * recursive-exclude * __pycache__ +recursive-exclude docs/build * +recursive-exclude docs/_build * recursive-exclude * *.py[co] From 2669016abe5e8de0a5a3c21a53fbf330cf14a793 Mon Sep 17 00:00:00 2001 From: "Paul J. Dorn" Date: Wed, 31 Jul 2024 04:16:49 +0200 Subject: [PATCH 2/3] docs: https-capable sphinx homepage entry point --- docs/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/README.rst b/docs/README.rst index c9fe27756..9ec55d05a 100644 --- a/docs/README.rst +++ b/docs/README.rst @@ -6,8 +6,8 @@ Requirements To generate documentation you need to install: - - Python >= 3.4 - - Sphinx (http://sphinx-doc.org/) + - Python >= 3.7 + - Sphinx (https://www.sphinx-doc.org/) Generate html From 7c3e9c9c2be7a93a0c59c177ac9d3da7d73b4cb0 Mon Sep 17 00:00:00 2001 From: "Paul J. Dorn" Date: Wed, 31 Jul 2024 04:17:32 +0200 Subject: [PATCH 3/3] docs: clarify Makefile is generated --- docs/Makefile | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/Makefile b/docs/Makefile index 7c8d1938e..7fa4085e6 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -1,5 +1,7 @@ # Makefile for Sphinx documentation # +# if you want to compare this file to current sphinx defaults, recreate it: +# BUILDDIR=build sphinx-quickstart --sep --extensions=gunicorn_ext --templatedir=_templates --makefile --batchfile --no-use-make-mode --master=index # You can set these variables from the command line. PYTHON = python