executablebooks / sphinx-proof

A Sphinx extension for producing proof, theorem, lemma, definition, remark, conjecture, corollary and algorithm directives.
https://sphinx-proof.readthedocs.io/en/latest/
MIT License
32 stars 17 forks source link

Ability to cross-link references from inside of math boxes #92

Open ebridge2 opened 2 years ago

ebridge2 commented 2 years ago

Context

I often find myself when writing proofs having long chains of homogeneous ideas, and I want to reference back to why the next line follows from the previous. To do so, it is helpful to just have little links included in proof text. This can obviously be overcome by breaking up chains of equations with sentences, but I find this tends to be cumbersome and ends up kind of blotchy and hard to follow.

Proposal

The ability to do something like:

:label: sky:blue
The sky is blue.
    x &= y + 2,\,\,\,\,\text{{prf:ref}`sky:blue`} \\
     &= z

Tasks and updates

No response