Error in reference linking of code snippet

[kp992]

Description

In this section of the lecture, the link hovering shows the correct lecture code snippet in the preview. But when I click on the link, it does not take me back to the referred snippet.

I also see this error while building the pdf of the book:

rror: label `<firstloopprog>` does not exist in the document

    ┌─ _build/temp/mystiKB1Q8/quantecon-lecture-python-programming-python-by-example.typ:249:40
    │
249 │ Now let's consider the `for` loop from #link(<firstloopprog>)[the program above], which was
    │                                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: label `<firstloopprog>` does not exist in the document
    ┌─ _build/temp/mystiKB1Q8/quantecon-lecture-python-programming-python-by-example.typ:311:52
    │
311 │ But, for the purpose of illustration, let's modify #link(<firstloopprog

Proposed solution

By clicking on the link, I would expect it to scroll to the code snippet.

Additional notes

cc @mmcky

[kp992]

The experimental preview version is built in this PR: QuantEcon/lecture-python-programming.myst#345.

[mmcky]

@kp992 thanks for reporting this.

Would you mind also listing the label for the code-cell being used?

[agoose77]

I would be tempted on a content level to link to the code block that makes up the cell. You can do that with <label>-code, e.g. firstloopprog-code, in theory. Making this change, should it work, will also temporarily work-around the bug; notebook cells do not currently carry their ID to the page.

I have created a PR to fix this in myst-theme: jupyter-book/myst-theme#602

Aside — @rowanc1 is this suggestion leaning on an implementation detail? I've been taking it as read

[rowanc1]

If we document it, then it is no longer an implementation detail!

@mmcky @kp992 really awesome to see the quantecon theme in use. 🚀 At some point, we still need to transfer the repo into quantecon.

[kp992]

Thanks @agoose77 and @rowanc1.

You can do that with -code, e.g. firstloopprog-code, in theory

I tried doing that locally but didn't work.

[agoose77]

@kp992 does the following example work locally for you with myst start --execute? https://gist.github.com/agoose77/0b1eecede6043ca26c63f32983d17bfc

[kp992]

Yeah, got it working. Thanks for the example reference.

[kp992]

This does work in the generated HTML but stills fails while building pdf:

error: label `<firstloopprog-code>` does not exist in the document
    ┌─ _build/temp/mystG6clCA/quantecon-lecture-python-programming-python-by-example.typ:249:40
    │
249 │ Now let's consider the `for` loop from #link(<firstloopprog-code>)[
the program above], which was
    │                                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: label `<firstloopprog-code>` does not exist in the document
    ┌─ _build/temp/mystG6clCA/quantecon-lecture-python-programming-python-by-example.typ:311:52

For reference, this what I did: QuantEcon/lecture-python-programming.myst@aa403d4.