nsidc / qgreenland

Source code for generating the QGreenland package hosted at https://qgreenland.org/
https://qgreenland.readthedocs.io
Other
36 stars 9 forks source link

Promote "Troubleshooting" page to a first-class thing in the docs #786

Closed MattF-NSIDC closed 10 months ago

MattF-NSIDC commented 10 months ago
MattF-NSIDC commented 10 months ago

For redirects, I used sphinxext-rediraffe. This one is on conda-forge and has more downloads than alternatives like sphinx-reredirects. I don't have many other reason to choose this one.

It generates an HTML file like this at the old location, pointing to the new one:

<html>
    <head>
        <noscript>
            <meta http-equiv="refresh" content="0; url=../troubleshooting.html"/>
        </noscript>
    </head>
    <body>
        <script>
            window.location.href = '../troubleshooting.html' + (window.location.search || '') + (window.location.hash || '');
        </script>
        <p>You should have been redirected.</p>
        <a href="../troubleshooting.html">If not, click here to continue.</a>
    </body>
</html>