Weird bug on Hackage: hackage 'turncoat' project does not display properly

Learn
1

This is my first time posting here, sorry if it is a weird problem no one cares about, just thought I would mention it.

I am on Ubuntu 26.04, and in Firefox and Chrome I cannot click any of the links or highlight any of the text for the ‘turncoat’ package:

But for comparison I have no problem with selecting/highlighting text for this other chess package or most other projects I have checked:

Hope everyone is having a nice weekend, and I wish a happy July 4th to all the cool American Haskell people here.

2

I can reproduce, it’s a funny one.

README.md for this project has a section called “Search”, which — once converted by Hackage from Markdown to HTML — becomes <h3 id="search">Search</h3>. The problem is however that Hackage thinks that it’s its own “Search” UI element for quick jump functionality with

#search {
  position: fixed;
  top: 3.2em;
  bottom: 0;
  left: calc(50% - 22em);
  width: 44em;
  z-index: 1000;
  overflow-y: auto;
}

which covers the entire viewport with an invisible modal window. That’s why you cannot click any links.

3

I wonder how we should address this. Maybe we should be name mangling generated ids during markdown rendering?

4

A quick fix to resolve this and similar cases involving header elements: change the quick-jump CSS#search selector to div#search. (And allow-list the digest of the updated quick-jump.css).

Addendum: except, that’s right, we still don’t serve a golden quick-jump implementation and use the version from the doc bundle. Changing hackage-server to serve its own quick-jump implementation would be simpler than mangling IDs in rendered markdown though (IMO).