Persistent links for code line ranges?

[hellt]

It appears that code line ranges use the code block ID as they appear on the page when users select line ranges.

An issue with that approach is that when a new code block is added, the blocks under it get a new block ID, and hence the old links that were used to those code blocks are no longer valid.

I wonder, is it fair to suggest generating unique IDs for code blocks to alleviate this issue?

[squidfunk]

Perfectly reasonable request. For this to work, we need to tell the Highlight extension to allow for persistent code block ids. Thus, this would need to be supported upstream in Python Markdown Extensions. Envisioned sample use:

``` .py id="foobar"
print("Hello world")
``` 

[facelessuser]

Bah, I'll have to look. I think the question, when posed to me, wasn't very clear in the other issue. There may need to be some slight work there.

[facelessuser]

I've located what needs to change. It's a very, very small change. I'll get it out in the next release.

[squidfunk]

Awesome!

[squidfunk]

... please drop me a note when this is supported, we will update the docs then and recommend setting an identifier.

[facelessuser]

I'll try to remember 🙃. I imagine the next release you'll be aware of as formally we'll be adding the general purpose blocks publically. I imagine that is when I will formally poke about some of that support (collapsible code blocks, etc.). I just need to make sure the beta is relatively sound. With that said, I've migrated all Tabs, Admonitions, Definition, Details, and arbitrary HTML blocks in my documentation and it works quite well. So, this change will be in that release. I need to look over what else I want to pull into that incoming release.