xref knowls in an exercise that migrates to a Runestone assignment

[Alex Jordan]

Here's an issue with a PreTeXt exercise (in this case a reading question) that migrates to a Runestone assignment. What if there is an xref knowl in the exercise statement, like "Example 2" here?

I'm not surprised that we haven't prepared for this. When I click "Example 2", I get this:

Posting here to see if anyone wants to discuss it. If not, I'll file an issue.

[Rob Beezer]

Right. Another illustration of the dangers/risks/fiddle of duplicating content
and putting it somewhere else.

Do you think this is a case of the assignment page not having the relevant JS to
support knowls, or a case of the relative path to the knowl content starting
from a directory different than we assume?

Rob

On 10/13/23 22:10, Alex Jordan wrote:
> Here's an issue with a PreTeXt exercise (in this case a reading question) that
> migrates to a Runestone assignment. What if there is an xref knowl in the
> exercise statement, like "Example 2" here?
>

> Screenshot 2023-10-13 at 10.06.48 PM.png
>
> I'm not surprised that we haven't prepared for this. When I click "Example 2", I
> get this:
>

> Screenshot 2023-10-13 at 10.07.10 PM.png
>
> Posting here to see if anyone wants to discuss it. If not, I'll file an issue.
>

> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-dev...@googlegroups.com
> <mailto:pretext-dev...@googlegroups.com>.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com <https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com?utm_medium=email&utm_source=footer>.

[Alex Jordan]

I think it's both. That assignment page is at:

https://runestone.academy/assignment/student/doAssignment

And the href on the knowl is:

./knowl/example-parking-meter.html

But there is nothing at

https://runestone.academy/assignment/student/doAssignment/knowl/example-parking-meter.html

So it's at least the issue about not providing a path that goes back to where the knowl folder truly lives.

But also a PTX book page loads

https://pretextbook.org/js/lib/knowl.js

And I don't see the assignment page loading this.

A solution to this issue (that makes compromises with the user experience) would be that the RS manifest constructs these links as regular "in context" links that go back to the item in the book. I think that would be acceptable. Trying to provide access to the knowl HTML files from a place like the Assignment page where the exercise has migrated may be a heavy ask, not worth developer time to support. But that's my opinion only.

To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-dev/MTAwMDAzMi5iZWV6ZXI.1697309270%40quikprotect.

[Rob Beezer]

Yes, I've thought about making the knowl into a traditional hyperlink that
points to the location in the book proper. Might still be a relative link.
Similar, but not identical, to Andrew's question about ActiveCode behaving
poorly in a knowl. Letting the *author* say this should be a link is a
solution, but a very poor one in my opinion.

The link you see:

https://runestone.academy/assignment/student/doAssignment

cannot be book-specific - something is happening to put the student into an
assignment page for *their* book, and maybe *their* assigments. Runestone knows
where the knowls for the book lives, and any second now I am going to
drastically reduce the storage requirements for knowls (95% reduction).

Not to pass the buck, but perhaps Runestone can redirect to, or copy to a known
location, the book's knowls in a way they will be available to each student, for
their book, via exercises on the assignment page.

(Or we require authors to make interactive exercises self-contained with no
"xref". ;-) )

Rob

On 10/14/23 12:01, Alex Jordan wrote:
> I think it's both. That assignment page is at:
> https://runestone.academy/assignment/student/doAssignment
> <https://runestone.academy/assignment/student/doAssignment>
>
> And the href on the knowl is:
> ./knowl/example-parking-meter.html
>
> But there is nothing at

> https://runestone.academy/assignment/student/doAssignment/knowl/example-parking-meter.html <https://runestone.academy/assignment/student/doAssignment/knowl/example-parking-meter.html>

>
> So it's at least the issue about not providing a path that goes back to where
> the knowl folder truly lives.
>
> But also a PTX book page loads

> https://pretextbook.org/js/lib/knowl.js <https://pretextbook.org/js/lib/knowl.js>

> <mailto:pretext-dev%2Bunsu...@googlegroups.com>
> > <mailto:pretext-dev...@googlegroups.com
> <mailto:pretext-dev%2Bunsu...@googlegroups.com>>.

> > To view this discussion on the web visit
> >

> https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com <https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com> <https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com?utm_medium=email&utm_source=footer <https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrfrh3BsW-bs5Bv6oBsHTsZQdUxcL7DpDwjoZMBq0z5K1w%40mail.gmail.com?utm_medium=email&utm_source=footer>>.

>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pretext-dev...@googlegroups.com

> <mailto:pretext-dev%2Bunsu...@googlegroups.com>.

> To view this discussion on the web visit

> https://groups.google.com/d/msgid/pretext-dev/MTAwMDAzMi5iZWV6ZXI.1697309270%40quikprotect <https://groups.google.com/d/msgid/pretext-dev/MTAwMDAzMi5iZWV6ZXI.1697309270%40quikprotect>.

>
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email

> to pretext-dev...@googlegroups.com
> <mailto:pretext-dev...@googlegroups.com>.
> To view this discussion on the web visit

> https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrcw0mSifgQytL_TdyUHQLNNknCS7mb1E8ak%3DPyypgJH5Q%40mail.gmail.com <https://groups.google.com/d/msgid/pretext-dev/CA%2BR-jrcw0mSifgQytL_TdyUHQLNNknCS7mb1E8ak%3DPyypgJH5Q%40mail.gmail.com?utm_medium=email&utm_source=footer>.