From 9101ec3086460b28178bdb6ae955a134eada3471 Mon Sep 17 00:00:00 2001
From: Joseph Weston <joseph@weston.cloud>
Date: Fri, 15 Nov 2019 14:13:53 +0100
Subject: [PATCH] add longer timeout for linkcheck and remove specific
linkcheck ignore
The combination of longer timeout and larger number of retries should
make the linkcheck sufficiently specific again.
---
doc/source/conf.py | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 5c1c3ca4..f942ab56 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -270,12 +270,13 @@ def setup(app):
app.add_autodocumenter(BoundMethodDocumenter)
-# IOP times out on check but the link verified and correct.
-linkcheck_ignore = [r'https://iopscience.iop.org/1367-2630/16/6/063065/article']
# By default linkcheck only tries once, but experience has shown us that this test is
# very non-specific for detecting dead links. Trying a few times should significantly
# lower the probability of false positives.
linkcheck_retries = 5
+# Some websites (particularly IoP) take a long time to respond. The combination of
+# this timeout and the retries should make this check sufficiently specific.
+linkcheck_timeout = 10
nitpick_ignore = [('py:class', 'Warning'), ('py:class', 'Exception'),
('py:class', 'object'), ('py:class', 'tuple'),
--
GitLab