Using Scribble for Course Notes?

59 views
Skip to first unread message

dyrueta

unread,
Dec 6, 2020, 1:39:04 PM12/6/20
to Racket Users
Hi All —

I have a set of course notes for a Calc I class that I routinely teach which includes links to Desmos graphs and pre-recorded videos on selected topics.  Recently, I began to think about producing a version of the notes that embed the graphs and lectures directly into the document and can be easily distributed to my students. 

To be clear, I have no experience using Scribble or with website design in general, but many years ago I did work through HtDP cover to cover, and have been searching for a reason to dip back into the Racket ecosystem.  I'm hoping this project might be it. 

To make this work, I'd need Scribble to render standard math notation, and to embed graphs and video players so that students can access these resources within the document.  Is Scribble the right tool for this job?  Any tips and advice from this community of experts would be extremely helpful!  

Thanks!
Dave Yrueta

Here's an example of a sample Desmos graph: https://www.desmos.com/calculator/wiirm0g5yj

William J. Bowman

unread,
Dec 6, 2020, 5:23:25 PM12/6/20
to dyrueta, Racket Users
I've been using Scribble for course notes with math. In particular using:
- https://docs.racket-lang.org/scribble-math/index.html

I haven't tried embedding videos, but it's not difficult to embed HTML directly.
- https://docs.racket-lang.org/scribble/core.html?q=literal#%28def._%28%28lib._scribble%2Fhtml-properties..rkt%29._xexpr-property%29%29

I haven't used the plot pacakge but I know people have done awesome things:
- https://docs.racket-lang.org/plot/renderer2d.html?q=graph#%28tech._graph%29

--
William J. Bowman

On Sun, Dec 06, 2020 at 10:39:04AM -0800, dyrueta wrote:
> Hi All —
>
> I have a set of course notes for a Calc I class that I routinely teach
> which includes links to Desmos graphs and pre-recorded videos on selected
> topics. Recently, I began to think about producing a version of the notes
> that embed the graphs and lectures directly into the document and can be
> easily distributed to my students.
>
> To be clear, I have *no experience *using Scribble or with website design
> in general, but many years ago I did work through HtDP cover to cover, and
> have been searching for a reason to dip back into the Racket ecosystem.
> I'm hoping this project might be it.
>
> To make this work, I'd need Scribble to render standard math notation, and
> to embed graphs and video players so that students can access these
> resources within the document. Is Scribble the right tool for this job?
> Any tips and advice from this community of experts would be extremely
> helpful!
>
> Thanks!
> Dave Yrueta
>
> Here's an example of a sample Desmos graph:
> https://www.desmos.com/calculator/wiirm0g5yj
>
> --
> You received this message because you are subscribed to the Google Groups "Racket Users" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to racket-users...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/racket-users/ebb8a42c-6f7f-475c-b877-ec76cfd5a34an%40googlegroups.com.

dyrueta

unread,
Dec 6, 2020, 7:23:53 PM12/6/20
to Racket Users
Thank you William!  That's super helpful.  I'll check out the links and follow up with questions as they arise. 

Cheers, 
Dave

plr...@uwaterloo.ca

unread,
Dec 7, 2020, 8:07:05 AM12/7/20
to Racket Users
I've been using Scribble for course notes, slides, and various PDF documents for distribution to students for about ten years. I got the idea from several Racket principals who have been doing it for even longer, but unlike them, I have only basic facility with the language. The scribble-math package is based on a short post I made to this list to describe how to use MathJax to render math within a Web page. Recently I incorporated "asciicasts", lightweight terminal recordings to illustrate livecoding. You can see various examples here: https://cs.uwaterloo.ca/~plragde/flaneries/ . I'm happy to consult and share techniques as needed. --PR

Enrique Comer

unread,
Dec 8, 2020, 9:30:18 PM12/8/20
to Racket Users, plr...@uwaterloo.ca
Hi Dave:

The use of the scribble-math package is great for the kind of documents that you plan to write in Scribble.

For embeddings I use the excellent package from Shriram, to include Google Forms and YouTube videos. You can check the link: https://github.com/shriram/scribble-embedding.

Congratulations for your project.
Please Keep Safe.
Enrique Cómer

--
You received this message because you are subscribed to the Google Groups "Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to racket-users...@googlegroups.com.
To view this discussion on the web visit
Reply all
Reply to author
Forward
0 new messages