Annotating <activity> with a time estimate

[Steven Clontz]

When porting https://teambasedinquirylearning.github.io/linear-algebra/frontmatter.html we moved our time estimates for each activity into a custom @tbil-time attribute (see: https://github.com/TeamBasedInquiryLearning/linear-algebra/blob/main/source/01-E/01.ptx#L198 ).

Of course that attribute isn't used anywhere in our builds. Is there a canonical PreTeXt way to express this information so that it will appear (without putting it into the text of the activity or writing custom XSL)?

[Rob Beezer]

Dear Steven,

Been letting this one percolate. Designing and adding a template to the modal
"assembly" templates of the pre-perocessing step would be one way to make this
happen quickly, but your query already rules that out.

Who is the audience for this time estimate? Instructors or readers? I think
that makes a big difference in how to approach interpretation of the attribute.
(And what are the time units? Hours or days? ;-))

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-suppo...@googlegroups.com>.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pretext-support/1eb7647b-7521-4bd3-b805-b6d38a05a1dfn%40googlegroups.com
> <https://groups.google.com/d/msgid/pretext-support/1eb7647b-7521-4bd3-b805-b6d38a05a1dfn%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Steven Clontz]

Use-case is for instructors implementing synchronous class activities (units in minutes). In our previous LaTeX-based DSL, they were included in the generated slides like so:

Stop-gap solution is that I can edit my custom https://github.com/TeamBasedInquiryLearning/linear-algebra/blob/main/slides/extract-slides.xsl that converts my PreTeXt <book/> to a PreTeXt <slideshow/> to inject this info. But I'm aiming to not hard-code custom stuff since I want to contribute that functionality upstream this summer.

[Rob Beezer]

Thanks for the example - that always helps (even if it was just about what I
would have guessed).

"theorem" allows a "creator" (e.g. "Cayley") which is rendered similarly. You
can see in the XSL that it is a bit complicated for LaTeX.

So I think stopgap is best for right now - I'm not even sure inserting into the
"assembly" pass is going to produce a clean insertion into a heading.

Good news, of course, is that you've put the right information in the right place.

When you are read to contribute, we can discuss:

1. For readers, or only instructors?

2. Time units (in "docinfo"?). (You know I was kidding about hours v. days.)

3. Internationalize the time units.

4. Etc.

Sorry I don't have a better answer for now.

Rob

On 2/11/21 10:39 AM, Steven Clontz wrote:
> Use-case is for instructors implementing synchronous class activities (units in
> minutes). In our previous LaTeX-based DSL, they were included in the generated
> slides like so:

> https://groups.google.com/d/msgid/pretext-support/6a55c9da-f272-4887-bd21-3efc73b101f4n%40googlegroups.com
> <https://groups.google.com/d/msgid/pretext-support/6a55c9da-f272-4887-bd21-3efc73b101f4n%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Steven Clontz]

My instincts (which can be discussed later):

1. I generally don't believe in instructor-only material, and don't see any compelling reason to hide this info anyway

2-3. Minutes seems reasonable for measuring an in-class activity/exercise (and is an international unit I think?)

4. Should probably consider if we want to support this attribute on tasks...

[David Farmer]

So, the author adds that information, and the publisher decides
whether to show it?

> --
> 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 visithttps://groups.google.com/d/msgid/pretext-support/CAOWT6Tg0huEn9fHVAuHdrOgrrR2KUkA3P%2B2kkAOTnHcekGY1hA%40m
> ail.gmail.com.
>
>

[Steven Clontz]

Having the presentation/visibility of @estimated-time (or whatever @tbil-time is renamed to if added to PreTeXt) configured by publishers makes sense to me.