sidebar no longer scrolling to current chapter

[jonathanpallant]

Problem

We host an mdbook at https://rust-exercises.ferrous-systems.com/latest/book (https://github.com/ferrous-systems/rust-exercises). We also keep old copies of the book.

Back on https://rust-exercises.ferrous-systems.com/v1.27.0/book/, selecting a new chapter on the sidebar kept the sidebar scrolled to where it was. This is very useful when quickly moving through chapters.

As of https://rust-exercises.ferrous-systems.com/v1.28.0/book/, selecting a new chapter in the sidebar causes the sidebar to reset back to the top of the list, making it really difficult to move through the chapters.

This was when we changed from mdbook 0.4 to mdbook 0.5.2.

Is this expected behaviour? How can I get the old behaviour back?

I see this in Safari 26.4, Firefox 150 and Chrome 147, all on macOS.

Steps

No response

Possible Solution(s)

No response

Notes

No response

Version

[jonathanpallant]

Perhaps this is related to cloudflare, who strip the .html extension from all my URLs and issue 308 redirects to the URL without .html.

[ehuss]

Yea, I believe this is due to #3034. There are some PRs for that (like #3038 and #2993 and #2570), but it looks like they need some work (they also all seem to do different things, I haven't investigated why). Do you think you can help with testing and reviewing?

[jonathanpallant]

Yes I can help. It's an open source repo so you or I can set up PRs and cloudflare will build and host them on a unique URL.

[jonathanpallant]

Here's what it looks like if I build a custom mdbook containing #2993.

https://f74d75b4.ferrous-systems-rust-exercises.pages.dev/latest/book/nrf52/usb-exercise

This seems to solve my problem, and I think it's the cleanest fix of the three available (notes in #3034).

[jhult]

@ehuss and @jonathanpallant,

I believe this single PR will fix it all: #3047

@CattoYT indicated this works with Cloudflare Pages: #3047 (comment)

[ehuss]

I'm going to close as resolved by #3034 (and essentially a duplicate of #3034).

I realize #3047 may provide a nicer clean URL build, but I may not have the time to look at it right now, and it seems like it would have some problems in that it changes the URLs of existing books. I'll look at it when I can, but it may be a while.