Redirect full version archive files to {major}.{minor} (#498)

* Redirect full version archive files to ``{major}.{minor}``

* Add tests

Author: AA-Turner

salt/docs/config/nginx.docs-redirects.conf

@@ -12,11 +12,6 @@ location ~ ^/(es|fr|id|it|ja|ko|pl|pt-br|tr|uk|zh-cn|zh-tw)/$ {
     return 302 $scheme://$host/$1/3/;
 }
 
-# Pretty 404 for archives telling to wait for them to be built.
-location ~ \.(pdf|zip|epub|bz2)$ {
-    error_page 404 /404.html;
-}
-
 # Some doc download pages link to docs.python.org/ftp instead of www.python.org/ftp.
 location ^~ /ftp/python/doc {
     return 301 https://www.python.org$request_uri;
@@ -197,6 +192,11 @@ location ~ ^/(es|fr|id|it|ja|ko|pl|pt-br|tr|uk|zh-cn|zh-tw)/((2|3)(\.[0-9]+)?|de
     add_header Surrogate-Key $1/$2 always;
 }
 
+# Map archive URLs to {major}.{minor}
+location ~ ^/([a-z-]*/)?(3|3.12|3.13|3.14)/archives/python-(3.12|3.13|3.14)\.\d+((a|b|rc)\d)?-docs(-(html|pdf-a4|pdf-letter|texinfo|text)\.(zip|tar\.bz2)|\.epub)$ {
+    return 301 https://$host/$1$2/archives/python-$3-docs$6;
+}
+
 # Map old, 2.5-and-earlier directory names to 2.6-and-later names.
 location = /lib/ {
     return 301 https://$host/3/library/;
@@ -228,3 +228,8 @@ location = /doc/ {
 location = /ref/ {
     return 301 https://$host/3/reference/;
 }
+
+# Pretty 404 for archives telling to wait for them to be built.
+location ~ \.(pdf|zip|epub|bz2)$ {
+    error_page 404 /404.html;
+}