[ANN] unpackaged/imenu-eww-headings: Offer HTML headings in EWW buffers with Imenu

What a good idea! Once you see it, you wonder why it wasn't standard already.

Do any of you actually use eww for browsing? I'm just curious. I occasionally open eww from elfeed, but that's about it. And only those sites that I know look well with it.

I have a slightly different take on this in my configuration, in library [shr-heading.el](https://github.com/oantolin/emacs-config/blob/master/my-lisp/shr-heading.el). In addition to imenu support I wanted next and previous heading navigation commands. It turns out you then get imenu support for free, since one way you can specify imenu entries is by providing a "goto previous imenu entry" function. I renamed it shr-heading.el instead of eww-heading because I realized it's useful in other places that use shr too, not just in eww. I use it in elfeed-show-mode too, and am considering using it in gnus-article-mode.

I don't use it for all browsing, but I do like it for websites where I expect to basically just read text. First, I configure shr to ignore website colors, `(setq shr-use-colors nil)`. That alone makes a small but significant fraction of websites more readable: there is some weird trend of using very thin gray letters against a slightly lighter gray background (I suspect it's gate-keeping to make sure only young people with very good eyes can read the website). Second, it's sad how many websites that really just serve text improve a lot without JavaScript. Third, plenty of websites have no regard for reasonable line widths, and my Emacs frame and font size are chosen to make lines readable. For webpages with lots of images, or with video or audio files, or that use MathJax I do use a normal browser.

Could you please raise a feature request for this upstream? It sounds like a no-brainer enhancement for these standard features.

If it makes you feel any younger, I find most websites have poor contrast (especially the dark themed ones). The annoyance with "light" theme extends to Emacs themes as well unfortunately. I wonder if I am the only person in their early twenties that struggles with this...

I do when I know i'm where to go and that i'm just going to copy paste one or more things into emacs. Sometimes I try research and searching but my mind isn't used to the text interface enough yet or something. If I get used to this imenu interface that could change.

I probably will eventually, but I have a lot of other Emacs projects at the moment. :) I have FSF copyright assignment for Emacs, so feel free to pitch the code at them (or maybe someone else will find a better solution).

Sometimes, sure. As you said, it depends on the content. It happens to work very well for, e.g. https://spec.matrix.org/v1.2/client-server-api

That looks great! Would you consider upstreaming it? Or even contributing it to `unpackaged` to replace this would be nice. :)

The [shrface](https://melpa.org/#/shrface) package also has exposes headings to Imenu.

Good point. One of these ought to be upstreamed...