You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Currently, I can get the directives referenced under two scenarios:
The exercise directive is enumerable, the directive can be referenced through the numfig role. The following options are supported:
{numfig}`label` displays "Exercise #"
{numref}`some text %s <label>` displays "some text #"
{numref}`some text {number} <label>` displays "some text #" which is identical to the example in (i)
The directive is unenumerable - either :nonumber: has been introduced in the exercise directive or referencing a solution directive. There is no default href text because the only option supported is the following:
{ref}`some text <label>` .
I'm looking at the possibility of fixing/debugging {ref}`label` which currently doesn't work. It looks like this option works for figure if you set a caption which is set only by increasing the line number (still a bit confused about this implementation 👀)
These options are also identical to the options for referencing math typesets in sphinxcontrib-proof. They are made available through the std (Standard) domain which is where ref and numref roles reside. In order to control the behavior of ref for exercises and solution, it is my understanding that we'd have to override the ref role with a new one. I'm not sure if this can be done or whether it is a good idea.
If we would like to keep the behavior described in sphinxcontrib-prettyproof#18, I think the best way forward would be to create a new role specific to referencing exercise and solution directives.
Would appreciate suggestions and feedback on this one.
The text was updated successfully, but these errors were encountered:
Decided to go with the default ref and numref instead. There's no need to go with a specific role since the behavior mentioned above has already been taken care of through the default roles.
Currently, I can get the directives referenced under two scenarios:
exercise
directive is enumerable, the directive can be referenced through thenumfig
role. The following options are supported:{numfig}`label`
displays "Exercise #"{numref}`some text %s <label>`
displays "some text #"{numref}`some text {number} <label>`
displays "some text #" which is identical to the example in (i):nonumber:
has been introduced in theexercise
directive or referencing a solution directive. There is no default href text because the only option supported is the following:{ref}`some text <label>`
.I'm looking at the possibility of fixing/debugging
{ref}`label`
which currently doesn't work. It looks like this option works forfigure
if you set a caption which is set only by increasing the line number (still a bit confused about this implementation 👀)These options are also identical to the options for referencing math typesets in
sphinxcontrib-proof
. They are made available through thestd
(Standard) domain which is whereref
andnumref
roles reside. In order to control the behavior ofref
for exercises and solution, it is my understanding that we'd have to override theref
role with a new one. I'm not sure if this can be done or whether it is a good idea.If we would like to keep the behavior described in sphinxcontrib-prettyproof#18, I think the best way forward would be to create a new role specific to referencing
exercise
andsolution
directives.Would appreciate suggestions and feedback on this one.
The text was updated successfully, but these errors were encountered: