Adding options for CodeTailor on Runestone

[Aadarsh Padiyath]

Hello,

I recently spoke to Rob during office hours about how we can migrate CodeTailor problems from rst on Runestone into pretext.

He told me to craft to files, one without and one with the options required to activate CodeTailor on runestone so he can reverse engineer what is necessary for pretext. Please find them attached.

Please let me know if you need anything else!

Aadarsh Padiyath

[Rob Beezer]

Dear Aadarsh,

Implemented at:

https://github.com/PreTeXtBook/pretext/pull/2911

Notes:

* Ignore first commit, totally unrelated. Just cleaning up a mess.
* I'm getting the "Help Me" button locally, so it must be close.
* You will need to test a build on Runestone servers and get back to me, either
way. (Use a nightly CLI, most likely.)
* The PreTeXt markup looks nothing like the Runestone additions, since in part,
I have no idea what those attributes are talking about.
* Claude Code AI thinks the Parsons problem will have one line of code per
block? Is that right? (I don't think so?) But almost looks that way at:
https://arxiv.org/html/2401.12125v2. Documentation may need adjustment.

Rob

> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt support" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-suppo...@googlegroups.com <mailto:pretext-
> support+u...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-
> support/397f2d94-6669-49af-9d7e-3412107651b3n%40googlegroups.com <https://
> groups.google.com/d/msgid/pretext-
> support/397f2d94-6669-49af-9d7e-3412107651b3n%40googlegroups.com?
> utm_medium=email&utm_source=footer>.

[Rob Beezer]

Forgot to say: here is a "static" example, Checkpoint 5.4.5 in the sample book

Checkpoint 5.4.5: Coding Exercise, with CodeTailor Help
https://pretextbook.org/examples/sample-book/noparts/html/coding-exercises.html#coding-exercise-codetailor

[Aadarsh Padiyath]

Thanks for helping implement this!

A couple of modifications we might need if I understand correctly:

1. If @codetailor is set to yes, we want to give question authors a couple of options: the data-parsonspersonalize field should be either “movable” (the default - all the parsons blocks need to be moved by the student to assemble a correct solution) or “partial” (the student’s correct blocks are locked, and incorrect blocks are movable and must be assembled correctly), and data-parsonsexample should be either “LLM-example” (default) or the unique id of a parsons problem in runestone’s question database to be served as backup (the backup will show up if a course does not have an AI API key, or if AI fails to generate a personalized parsons problem).

2. Some parsons problems have multiple lines of code per block, especially “adaptable" parsons problems, which combine blocks together to alter the difficulty of the parsons problem.

Thanks again!

Aadarsh

You received this message because you are subscribed to a topic in the Google Groups "PreTeXt support" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/pretext-support/T271AE9xKqg/unsubscribe.
To unsubscribe from this group and all its topics, send an email to pretext-suppo...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/pretext-support/MTAwMDAzMS5iZWV6ZXI.1781128338%40pnsh.

[Aadarsh Padiyath]

Hi Rob! Just checking in to see if this modification would be possible?

Thanks!

Aadarsh

[Rob Beezer]

Dear Aardarsh,

* Earlier I asked if you would do a test build and report back either way. I
haven't seen that. Even if this needs more work, that would be worthwhile for
testing code as this continues to evolve, sooner rather than later.

* "the unique id of a parsons problem in runestone’s question database" - our
routine has been to use the value of a @xml:id as a reference, which presumes
the problem is in the book. Barb is figuring out how to get items into the
Runestone database while having them authored in a book, but not visible in a build.

* Markup proposal follows. Workable?

Rob

----

Two attributes on the "program" element.

codetailor

Adds CodeTailor's "Get Help" button. Omit the attribute for no
button; there is no longer a "no" value. The value says which
blocks the reader must place in the personalized Parsons problem.

all Every block is scrambled and movable, so the reader
assembles the entire solution. This is the current
behavior of codetailor="yes".

incorrect The blocks the reader already has right are locked in
place, and only the incorrect ones are movable.

codetailor-fallback

The xml:id of a Parsons problem elsewhere in the document, to be
used when a personalized problem cannot be generated, such as when
the course has no AI API key or when generation fails.

Omit the attribute to always request an automatically generated
problem. This is the default.

PreTeXt translates the xml:id into the Runestone database
identifier, and reports an error if there is no such problem.

On the Runestone side these become data-parsonspersonalize (movable or
partial) and data-parsonsexample (LLM-example or a question id).

>> exercises.html#coding-exercise-codetailor <https://pretextbook.org/
>> examples/sample-book/noparts/html/coding-exercises.html#coding-exercise-
>> codetailor>

>>
>>
>> On 6/10/26 14:33, 'Rob Beezer' via PreTeXt support wrote:
>>> Dear Aadarsh,
>>> Implemented at:

>>> https://github.com/PreTeXtBook/pretext/pull/2911 <https://github.com/
>>> PreTeXtBook/pretext/pull/2911>

>>> Notes:
>>> * Ignore first commit, totally unrelated.  Just cleaning up a mess.
>>> * I'm getting the "Help Me" button locally, so it must be close.
>>> * You will need to test a build on Runestone servers and get back to me,
>>> either way.  (Use a nightly CLI, most likely.)
>>> * The PreTeXt markup looks nothing like the Runestone additions, since in
>>> part, I have no idea what those attributes are talking about.
>>> * Claude Code AI thinks the Parsons problem will have one line of code
>>> per block?  Is that right?  (I don't think so?)  But almost looks that

>>> way at: https://arxiv.org/html/2401.12125v2 <https://arxiv.org/
>>> html/2401.12125v2>.  Documentation may need adjustment.

>>> Rob
>>> On 6/9/26 09:47, Aadarsh Padiyath wrote:
>>>> Hello,
>>>>
>>>> I recently spoke to Rob during office hours about how we can migrate
>>>> CodeTailor problems from rst on Runestone into pretext.
>>>>
>>>> He told me to craft to files, one without and one with the options
>>>> required to activate CodeTailor on runestone so he can reverse engineer
>>>> what is necessary for pretext. Please find them attached.
>>>>
>>>> Please let me know if you need anything else!
>>>> Aadarsh Padiyath
>>>>
>>>> --
>>>> You received this message because you are subscribed to the Google
>>>> Groups "PreTeXt support" group.
>>>> To unsubscribe from this group and stop receiving emails from it, send
>>>> an email to pretext-suppo...@googlegroups.com <mailto:pretext-
>>>> support+u...@googlegroups.com>.
>>>> To view this discussion visit https://groups.google.com/d/msgid/pretext-

>>>> <https://groups.google.com/d/msgid/pretext->
>>>> support/397f2d94-6669-49af-9d7e-3412107651b3n%40googlegroups.com
>>>> <http://40googlegroups.com> <https:// groups.google.com/d/msgid/pretext-
>>>> <http://groups.google.com/d/msgid/pretext->
>>>> support/397f2d94-6669-49af-9d7e-3412107651b3n%40googlegroups.com
>>>> <http://40googlegroups.com>? utm_medium=email&utm_source=footer>.

>>
>> --
>> You received this message because you are subscribed to a topic in the
>> Google Groups "PreTeXt support" group.
>> To unsubscribe from this topic, visit https://groups.google.com/d/topic/

>> pretext-support/T271AE9xKqg/unsubscribe <https://groups.google.com/d/
>> topic/pretext-support/T271AE9xKqg/unsubscribe>.

>> To unsubscribe from this group and all its topics, send an email to
>> pretext-suppo...@googlegroups.com.
>> To view this discussion visithttps://groups.google.com/d/msgid/pretext-

>> support/MTAwMDAzMS5iZWV6ZXI.1781128338%40pnsh <https://groups.google.com/
>> d/msgid/pretext-support/MTAwMDAzMS5iZWV6ZXI.1781128338%40pnsh>.
>
> --

> You received this message because you are subscribed to the Google Groups
> "PreTeXt support" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-suppo...@googlegroups.com <mailto:pretext-
> support+u...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-

> support/91d44252-8636-41dc-a205-135d1e976c72n%40googlegroups.com <https://
> groups.google.com/d/msgid/pretext-support/91d44252-8636-41dc-
> a205-135d1e976c72n%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Aadarsh Padiyath]

Hi Rob,

Thank you for getting back to us so quickly. I highly appreciate it.

* I tested the previous PR you made on a runestone pretext book and it looks to be working.

* Your markup proposal seems perfect!

Thanks again for working through this,

Aadarsh