Skip to content

Fix tile images linking to themselves instead of their pages #1513

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.

Sign up for GitHub

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

Closed
deepusnath wants to merge 2 commits into from
Closed

Fix tile images linking to themselves instead of their pages #1513

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
db41f89
Fix tile images linking to themselves instead of their pages
claude Aug 18, 2026
bb22c81
Make homepage tiles clickable instead of disabling image links
claude Aug 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions source/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -230,6 +230,12 @@
html_favicon = "https://logos.openedx.org/open-edx-favicon.ico"
release = "Latest"

# Sphinx defaults to hyperlinking scaled images (any `.. image::` with a
# `:height:`, `:width:`, or `:scale:` option) to their own unscaled file.
# Our role-guide tiles use `:height:` purely for layout, so this made
# clicking a tile image open the raw image instead of the linked page.
html_scaled_image_link = False

@sarina sarina Aug 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This fixes the clicking the tile linking to a raw image issue, but doesn't actually fix the problem of the homepage images linking to the page (now clicking the image just does nothing; see https://docsopenedxorg--1513.org.readthedocs.build/en/1513/)

I also don't actually think we want this, though. There are plenty of images within docs pages that have text that's a bit hard to see when you are looking at the docs page, and being able to click on the image to enlarge it is really helpful.

Do you think there's a way to fix, very specifically, the images on the homepage linking to the pages - so here,

Image

clicking on the image would link to the "Educator's Home", without destroying the ability to enlarge other site images?


html_static_path = ["_static"]

html_css_files = [
Expand Down