Structure "exercise" with "task", development by committee

[Rob Beezer]

I added a very simple "exercise", using "task" for sub-parts (below).  Held my breath, and, hah!, it Just Works (tm) in HTML and in PDF, with indentation, spacing. etc.  Then I renamed Project 4.10 in the sample article as an "exercise" and it looks fine, except the "prelude" did not migrate to beforehand (likely neither did the "postlude" migrate to afterwards).

Plan would be to retain "regular" inline, divisional, and worksheet "exercise" as

exercise
  statement
  hint
  answer
  solution

which is also a structure allowed for PROJECT-LIKE ("project", "exploration", etc.).  Then further structure would follow from what is allowed for PROJECT-LIKE, for example at one level of sub-parts (as tested)

exercise
  introduction
  task
    answer
  task
  ...
  conclusion

Here SOLUTION-LIKE would be children of "task" (and only *terminal* task, when divided further).

So, some development opportunities for the committee of interested authors who've wanted this for years.  This would be a great activity for tomorrow's drop-in development.

1.  Rename some complicated divisional PROJECT-LIKE as "exercise" and see what breaks as an inline ("Checkpoint") exercise.  (We know about "prelude" and "postlude")

2.  Add some new task-structured "exercise" to "exercises" and "worksheet" divisions.  I do not think this is a feature to add to reading questions, since it will complicate textboxes and scoring mechanisms for online versions.

See what you can break?  xref, solution knowls, solutions in appendix, numbering, solutions manual; HTML and PDF.  Contribute some gnarly test examples to the sample article.

Bonus points for reading this far and being first to reply with the cultural reference in the test exercise below.

Subsequent chore would be some XSL to unravel existing exercises using "ol" to structure sub-parts.

Rob

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

<exercise xml:id="exercise-with-tasks">
    <introduction>
        <p>Ready, go.</p>
    </introduction>
    <task>
        <p>Do this.</p>
    </task>
    <task>
        <p>And the other thing.</p>
    </task>
</exercise>

[Oscar Levin]

Nice!  

It appears that solution-like do not get included in solutions subdivisions.  Also, their status in the main text seems to be controlled by project.solution rather than exercise.division.solution.

Oscar.

[Rob Beezer]

Thanks, that is exactly the sleuthing I need. And with hindsight makes good sense.

Let's hope this is not a committee of one. ;-)

> --
> 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/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.com
> <https://groups.google.com/d/msgid/pretext-dev/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Mitch Keller]

Popping in here to say that the Vector Calculus materials for Active Calculus have started using task within (divisional) exercises to good effect. Hint/answer/solution are appearing as knowls where born right now with no publisher file or stringparams to send them anywhere else. I will report back as I go through the editing phase and start getting things into a format that we want to post for the public.

On Thursday, May 28, 2020 at 6:39:23 PM UTC-5, Rob Beezer wrote:

Thanks, that is exactly the sleuthing I need.  And with hindsight makes good sense.

Let's hope this is not a committee of one.  ;-)

On 5/28/20 4:06 PM, Oscar Levin wrote:
> Nice!
>
> It appears that solution-like do not get included in solutions subdivisions.  
> Also, their status in the main text seems to be controlled by project.solution
> rather than exercise.division.solution.
>
> Oscar.
>
> --
> 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 prete...@googlegroups.com
> <mailto:pretext-dev+unsub...@googlegroups.com>.

[Rob Beezer]

Pay attention to controlling visibility, especially in "solutions" divisions,
but maybe also at birth.

Oscar reports they seem to be influenced with switches for PROJECT-LIKE.

I tried to chase that down and could not figure where that control was happening
at all before I ran out of time and moved along. A bit unsettling. ;-)

Thanks for the report.

Rob

On 6/15/20 4:05 PM, Mitch Keller wrote:
> Popping in here to say that the Vector Calculus materials for Active Calculus
> have started using task within (divisional) exercises to good effect.
> Hint/answer/solution are appearing as knowls where born right now with no
> publisher file or stringparams to send them anywhere else. I will report back as
> I go through the editing phase and start getting things into a format that we
> want to post for the public.
>
> On Thursday, May 28, 2020 at 6:39:23 PM UTC-5, Rob Beezer wrote:
>
> Thanks, that is exactly the sleuthing I need.  And with hindsight makes good
> sense.
>
> Let's hope this is not a committee of one.  ;-)
>
> On 5/28/20 4:06 PM, Oscar Levin wrote:
> > Nice!
> >
> > It appears that solution-like do not get included in solutions subdivisions.
> > Also, their status in the main text seems to be controlled by
> project.solution
> > rather than exercise.division.solution.
> >
> > Oscar.
> >
> > --
> > 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 prete...@googlegroups.com <javascript:>
> > <mailto:pretext-dev...@googlegroups.com <javascript:>>.

> > To view this discussion on the web visit
> >
> https://groups.google.com/d/msgid/pretext-dev/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.com
> <https://groups.google.com/d/msgid/pretext-dev/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.com>
>
> >

> <https://groups.google.com/d/msgid/pretext-dev/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.com?utm_medium=email&utm_source=footer
> <https://groups.google.com/d/msgid/pretext-dev/6619b826-d296-4b27-a711-ad4630c365bc%40googlegroups.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...@googlegroups.com>.

> To view this discussion on the web visit

> https://groups.google.com/d/msgid/pretext-dev/1e86961f-197a-4f70-8ce1-a227163ce124o%40googlegroups.com
> <https://groups.google.com/d/msgid/pretext-dev/1e86961f-197a-4f70-8ce1-a227163ce124o%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Mitch Keller]

I can confirm Oscar’s testing. exercise.divisional.answer does nothing for exercises/exercise/task/answer (but does kill exercises/exercise/answer as I would expect). However, project.answer suppresses the answers to tasks in divisional exercises.

> 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/d01f6d39-5c02-b25b-2447-eedf03cdb099%40ups.edu.

--
Mitch Keller
mi...@rellek.net

http://www.rellek.net/

[Rob Beezer]

Thanks, I'll try to chase this down again once the UTMOST workshop is over.

[Rob Beezer]

"task" as a way to structure "exercise" should be operational now. Well, it
mostly was already, but controlling visibility of solutions needed work, which
is done now. This is all backward-compatible -- nothing you have now should
fail to render. You *will* want to migrate "parts" of an exercise from "ol/li"
to "task". A big improvement is that you can attach solutions to each task,
rather than the overall exercise.

I can't test every scenario for exercies, so please keep an eye on your output.
I expect any problems to be quickly fixed.

Next (after shaking out the bugs): add to schema, document, announce on
-announce. Express interest in a tool to convert "ol" inside "exercise" into a
collection of "task" if you want to see that.

Schematics of possibilities for any "exercise" (inline, divisional, worksheet)
follow. Note you can go three-deep on nested "task", and hint|answer|solution
only reside on the terminal "task" (leaves of the tree).

exercise
p

exercise
statement
p
hint
answer
solution

exercise
introduction
task
statement
hint
answer
solution
task
task
conclusion

exercise
introduction
task
introduction
task
statement
hint
answer
solution
conclusion
task
task
conclusion