Skip to content

Extension for Ansible redirects #2418

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: devel
Choose a base branch
from

Conversation

oraNod
Copy link
Contributor

@oraNod oraNod commented Feb 14, 2025

Fixes #2147 and supercedes #2266

This PR extends the Sphinx reredirects extension to load redirects for Ansible documentation from a toml file. The purpose is to replace the httpd mod_rewrite rules in https://github.com/ansible/docsite/blob/main/ansible/11/.htaccess and https://github.com/ansible/docsite/blob/main/.htaccess in a way that is compatible with ReadTheDocs.

If this PR is accepted and merged, there are two follow on actions:

  • Create a robots.txt file to stop crawlers from indexing the generated HTML files. We can put the robots.txt file in the ansible/docsite repo and copy it across as part of the ReadTheDocs build.
  • Remove all the existing stub files from this repository. For example, all the files under the docs/docsite/rst/user_guide folder.

@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from 768cd3f to 1e48ae3 Compare March 7, 2025 14:25
@oraNod oraNod requested a review from webknjaz March 7, 2025 14:34
@oraNod oraNod marked this pull request as ready for review March 7, 2025 14:38
@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from 1e48ae3 to 5641adf Compare March 7, 2025 15:52
@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from 5641adf to 97be9ad Compare March 7, 2025 17:12
@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from 97be9ad to acdbce4 Compare March 11, 2025 14:37
@oraNod oraNod requested a review from webknjaz March 27, 2025 13:47
Copy link
Contributor

@samccann samccann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from 09a7683 to 910c941 Compare April 22, 2025 11:41
@oraNod
Copy link
Contributor Author

oraNod commented Apr 22, 2025

@webknjaz / @felixfontein / @gotmax23 Could we please get another round of reviews here? I've added all the redirects to the ReadTheDocs project and this PR is one of the last hurdles in the way of the docs.ansible.com migration. Thanks.

@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from efe854f to d9ac192 Compare April 29, 2025 18:54
@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from d9ac192 to de60b45 Compare April 29, 2025 19:36
make webdocs ANSIBLE_VERSION="${{
make webdocs ${{
inputs.generate-redirects && 'EXTRA_TAGS="-t redirects"' || ''
}} ANSIBLE_VERSION="${{
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@webknjaz Hey again, thanks for the previous comment that made me re-think this. What I had here before was garbage. I'm not sure how it got muddled up so my apologies.

When the generate-redirects input is true, the command is make webdocs EXTRA_TAGS="-t redirects" ANSIBLE_VERSION=""

When generate-redirects is false, the command is make webdocs ANSIBLE_VERSION="". It does look like there's an extra space between webdocs and ANSIBLE_VERSION but I don't think that has any effect in how the make command gets evaluated.

@oraNod oraNod requested a review from webknjaz April 29, 2025 19:42
oraNod and others added 14 commits April 29, 2025 21:43
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
@oraNod oraNod force-pushed the issue-2147/sphinx-redirects branch from de60b45 to 333b36b Compare April 29, 2025 20:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc builds Relates to building the documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Using stub pages to replace redirects
4 participants