worksheets

[Katherine Yoshiwara]

Where can I find information about writing a worksheet? Section 4.7.3 is blank.

[Thomas Judson]

See https://pretextbook.org/doc/guide/html/overview-worksheet.html and https://pretextbook.org/examples/sample-article/html/worksheets.html.

On Sep 3, 2022, at 10:51 AM, Katherine Yoshiwara <kyosh...@gmail.com> wrote:

Where can I find information about writing a worksheet? Section 4.7.3 is blank.

--
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.
To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/0bc661f4-f7c0-40db-a281-2a3119f195ffn%40googlegroups.com.

[Katherine Yoshiwara]

Thank you, Tom. The sample article was minimally helpful, but I still don't see how to prescribe whitespace.  So is there a way to see the code for the sample?  Also, are you supposed to use the heading <worksheet> or <subsection> or both? And where is worksheet in the schema so I know what I can put in it? Tasks? Sidebysides? 

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/cKvkGzWQWw8/unsubscribe.
To unsubscribe from this group and all its topics, send an email to pretext-suppo...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/317F7762-AEAA-4499-8F11-475CF9956D49%40gmail.com.

[Sean Fitzpatrick]

Others have done a much better job with this than me, but here is the source for a book of mine with worksheets:

https://github.com/sean-fitzpatrick/Math3410

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CAJczGctmw9Z3R%3DRnuJT_pA6Zgv%2BDqC%2BvdHsD%2Bd_yANggsRtCyQ%40mail.gmail.com.

[Katherine Yoshiwara]

Thank you, Sean.  Beautiful work.  I see that you used sage cells in your worksheets for students to work in. If I don't use sage, is there a way to leave blank space for students to write in?

[Alex Jordan]

> is there a way to leave blank space for students to write in?

Each exercise in a worksheet can have a "workspace" attribute. This
should be measured in some absolute physical length, like "2in" or
"10cm". That is supposed to lead to workspace under the exercise whose
height is *at least* what you specified. It may actually be larger to
space out excess vertical space on a page.

Note that you may end up allocating more vertical space for workspace
than is possible on a page. So you should monitor that in output.

Last I checked, we want this same feature for a task element within an
exercise. But I believe in print, it was not working. That should be
viewed as a short term bug.

[Katherine Yoshiwara]

Thank you, Alex!  (Bruce found it for me, too.) So: inside a worksheet you can put exercises, and an exercise can have a workspace.

Now can you tell me how a task is different from an exercise? Does a task just give you (a), (b), (c), etc.? And how would that be different from putting in a list?

Okay, now I will try to write worksheets with embedded instructor commentary.

--
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/cKvkGzWQWw8/unsubscribe.
To unsubscribe from this group and all its topics, send an email to pretext-suppo...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CA%2BR-jrdNCxL-nhV4TRjpRSE91uvxd_S77Y3FtPh4JX1ndEaJ1w%40mail.gmail.com.

[Sean Fitzpatrick]

The blank space is controlled by the worksheet="2cm" attribute on an exercise or task.

The Sage cells are they're so that these also work as Jupyter notebooks.

The Jupyter conversion is somewhat fragile, so I've avoided certain structure that I'd otherwise use. (In particular, I can't put a Sage cell inside an exercise.)

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/6f29dc6b-e052-48d4-99bc-afc5f837d139n%40googlegroups.com.

[Alex Jordan]

One practical difference between using tasks and using a list is that with tasks, each item may have its own hint, answer, and solution.

But at a more basic level, we came to view a simple list as something distinct from the parts of an exercise.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZsGdJN6OkeJKsxvUqG42PaB_RSeLF56Y_zBaJ7eeBkgA%40mail.gmail.com.

[Alex Jordan]

Also it's not the right comparison to think task versus exercise. There are exercises structured with tasks and exercises not structured with tasks.

exercise

    introduction?

    task

    task

    task

    conclusion?

exercise

    statement

    hint?

    answer?

    solution?

Each task can likewise be structured with tasks, or without, exactly as with "exercise" above. In case you need subtasks.

[Katherine Yoshiwara]

So if I want an exercise to have parts, I should call the parts tasks? Or should I just use tasks instead of exercises? Can I put workspace in a task?

Is there somewhere that tells me all this so I don't have to keep bugging people?

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CA%2BR-jrfWi%2Bm%3DON-602mbzOJTuWciDPLF6WBZ%3Dcy%3DFYPT5k8PGA%40mail.gmail.com.

[Sean Fitzpatrick]

If you want an exercise with parts, you should use task.

I would just experiment with putting "workspace" in tasks to see what happens. I think I discovered by accident that if you have

<exercise workspace="3cm">

followed by several tasks, each task is allotted 3 cm of whitespace.

Note that you can build HTML, and then in the worksheet, click the A4 or US button to get a page where paper dimensions are reflected.

If you use more whitespace than fits on a page, you'll see something that looks like caution tape around the exercise.

If you don't use enough, you'll see a box with two colours (blue, and then grey, I think?) to indicate the space you have used, and the space you *should* use.

And of course you can look at the PDF output.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CAJczGcsxurqQji64bO5AMK1sbCGpt1KiRoQirExSuDXmYafM%2BA%40mail.gmail.com.

[Katherine Yoshiwara]

I want my worksheet to have two or three  "activities," each of which has several parts, and some of the parts, but not all, should be sidebyside with a graph. Some of the parts should have space for students to show their work.

I have tried various terms for these elements, but none of them work. In particular, it won't put several tasks in a sidebyside, with or without <stack>. 

Should I call my activity an Activity? a section? a subsection? Where does <page> go: inside or outside a subsection?

Should I just give up until someone develops worksheets a little better, with documentation?

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZxRoQ-WUrSph9h1uHC51W3VLVR7-mWdVe_96DpCvrhuQ%40mail.gmail.com.

[Rob Beezer]

Dear Kathy,

Worksheets are not documented since some aspects have not been finalized.

Never give up. You are getting some good assistance here from others who are leading the way in working out the best ways to implement this feature. Your experience can lead to suggestions that will make this feature even better for other authors and students.

Rob

>>>>>>>>> <https://groups.google.com/d/msgid/pretext-support/0bc661f4-f7c0-40db-a281-2a3119f195ffn%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/cKvkGzWQWw8/unsubscribe
>>>>>>>>> .
>>>>>>>>> To unsubscribe from this group and all its topics, send an email to
>>>>>>>>> pretext-suppo...@googlegroups.com.
>>>>>>>>> To view this discussion on the web visit
>>>>>>>>> https://groups.google.com/d/msgid/pretext-support/317F7762-AEAA-4499-8F11-475CF9956D49%40gmail.com

>>>>>>>>> <https://groups.google.com/d/msgid/pretext-support/317F7762-AEAA-4499-8F11-475CF9956D49%40gmail.com?utm_medium=email&utm_source=footer>
>>>>>>>>> .

>>>>>>>>>
>>>>>>>> --
>>>>>>>> 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.
>>>>>>>>
>>>>>>> To view this discussion on the web visit

>>>>>>>> https://groups.google.com/d/msgid/pretext-support/CAJczGctmw9Z3R%3DRnuJT_pA6Zgv%2BDqC%2BvdHsD%2Bd_yANggsRtCyQ%40mail.gmail.com
>>>>>>>> <https://groups.google.com/d/msgid/pretext-support/CAJczGctmw9Z3R%3DRnuJT_pA6Zgv%2BDqC%2BvdHsD%2Bd_yANggsRtCyQ%40mail.gmail.com?utm_medium=email&utm_source=footer>
>>>>>>>> .

>>>>>>>>
>>>>>>> --
>>>>>> 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.
>>>>>> To view this discussion on the web visit

>>>>>> https://groups.google.com/d/msgid/pretext-support/6f29dc6b-e052-48d4-99bc-afc5f837d139n%40googlegroups.com
>>>>>> <https://groups.google.com/d/msgid/pretext-support/6f29dc6b-e052-48d4-99bc-afc5f837d139n%40googlegroups.com?utm_medium=email&utm_source=footer>
>>>>>> .

>>>>>>
>>>>> --
>>>>> 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.
>>>>> To view this discussion on the web visit

>>>>> https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZsGdJN6OkeJKsxvUqG42PaB_RSeLF56Y_zBaJ7eeBkgA%40mail.gmail.com
>>>>> <https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZsGdJN6OkeJKsxvUqG42PaB_RSeLF56Y_zBaJ7eeBkgA%40mail.gmail.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/cKvkGzWQWw8/unsubscribe
>>>> .
>>>> To unsubscribe from this group and all its topics, send an email to
>>>> pretext-suppo...@googlegroups.com.
>>>> To view this discussion on the web visit

>>>> https://groups.google.com/d/msgid/pretext-support/CA%2BR-jrfWi%2Bm%3DON-602mbzOJTuWciDPLF6WBZ%3Dcy%3DFYPT5k8PGA%40mail.gmail.com
>>>> <https://groups.google.com/d/msgid/pretext-support/CA%2BR-jrfWi%2Bm%3DON-602mbzOJTuWciDPLF6WBZ%3Dcy%3DFYPT5k8PGA%40mail.gmail.com?utm_medium=email&utm_source=footer>
>>>> .

>>>>
>>> --
>>> 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.
>>> To view this discussion on the web visit

>>> https://groups.google.com/d/msgid/pretext-support/CAJczGcsxurqQji64bO5AMK1sbCGpt1KiRoQirExSuDXmYafM%2BA%40mail.gmail.com
>>> <https://groups.google.com/d/msgid/pretext-support/CAJczGcsxurqQji64bO5AMK1sbCGpt1KiRoQirExSuDXmYafM%2BA%40mail.gmail.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/cKvkGzWQWw8/unsubscribe.
>> To unsubscribe from this group and all its topics, send an email to
>> pretext-suppo...@googlegroups.com.
>> To view this discussion on the web visit

>> https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZxRoQ-WUrSph9h1uHC51W3VLVR7-mWdVe_96DpCvrhuQ%40mail.gmail.com
>> <https://groups.google.com/d/msgid/pretext-support/CAH%2BNcPZxRoQ-WUrSph9h1uHC51W3VLVR7-mWdVe_96DpCvrhuQ%40mail.gmail.com?utm_medium=email&utm_source=footer>
>> .
>>
>

[Katherine Yoshiwara]

Thanks, Rob.  Sorry to sound frustrated.  It's very hot here. I'll try not to be a pest.

To view this discussion on the web visit https://groups.google.com/d/msgid/pretext-support/MTAwMDAzNC5iZWV6ZXI.1662466812%40quikprotect.

[kcri...@gmail.com]

Worksheets are not documented since some aspects have not been finalized.

Never give up. You are getting some good assistance here from others who are leading the way in working out the best ways to implement this feature. Your experience can lead to suggestions that will make this feature even better for other authors and students.

Just curious as to whether any of the last year's workshops may have produced some additional samples for worksheets, or whether worksheets have been more finalized at this time.  

[My particular question is whether (in a book) worksheets have an option that allows it to print as "independent" of chapters, in the sense that it wouldn't have pagination relative to a book showing, nor the running title/chapter heading.  My operating assumption is that this continues to be not finalized and so I shouldn't mess with worksheets too much at this time if I don't want to use experimental features yet, but I figured it's possible some work has been done since the last few posts on this topic.]