[BlindMath] quarto as substitute for jupyter notebook

Wed Apr 17 15:46:38 UTC 2024

Actually, this is very nice. To get this setup using quarto and 
observable (a javascript runtime which works particularly well for 
notebook type environments), do the following:

1. download quarto:

https://github.com/quarto-dev/quarto-cli/releases/tag/v1.4.553

2. Paste the following simple document into a file with extension ".qmd" 
and run the command "quarto preview simple.qmd"

This will create an html document, run a local web server and run your 
default browser with that document loaded from the server, and watch 
source files for changes. You can modify the document in your favorite 
text editor, or whatever tool you use for document creation and it will 
be reflected in the browser upon save.

Use the render command to render to a file, but note that it must be 
viewed through a web server, rather than a local file:// URL.

Here is a very simple source doc (cut here):

---
title: "Quarto Basics"
format:
   html:
     code-fold: true
---

The exponentiation operator in javascript is written as shown below:

```{ojs}
a = 27;
b = 7;
a ** b;
```

On 4/16/2024 4:19 PM, Jonathan Godfrey wrote:
> Hello.
>
> If it isn't HTML, then what alternatives do you propose? MS Word files can't be made as accessible; pdf from LaTeX is not even close, leaving you with the source files or HTML as the only viable alternatives.
>
> If you use HTML, then you can use MathJax for equations, it is easy to protect code blocks with useful tools to play with the code, and so much more.
>
> You could investigate Quarto as a markdown flavour which is a substitute for Jupyter notebooks. It is also great for R as well.
>
> Quarto is not the only way to make use of markdown based tools such as mermaid for flow charts.
>
>
> Perhaps the major advantage HTML has is that you do not need everything to be in one file. Elements that need a different workflow (such as flow charts) could be put on a separate page (HTML document) and hyperlinked.
>
> HTH,
> Jonathan
>
>
> -----Original Message-----
> From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Ketty Ombadykow via BlindMath
> Sent: Wednesday, April 17, 2024 6:38 AM
> To: blindmath at nfbnet.org
> Cc: Ketty Ombadykow <mko30 at echo.rutgers.edu>; RADR AFT <radr.aft at echo.rutgers.edu>; Jason Khurdan <jkhurdan at oit.rutgers.edu>; Michelle Meyer <michelle.meyer at rutgers.edu>
> Subject: [BlindMath] Need help with recommendations for Comp Sci course requirements
>
> Hello Everyone,
> I work at Rutgers University responsible for remediating course materials for accessibility for students who use screen readers.  I joined this listserv a little while ago to learn from you all about what tools, preferences, methods, and whatever I can glean from your discussions to help provide accessible materials for our students.
>
> This Fall 2024 I have a new transfer student who is taking 3 math and computer science courses (which I have handled before with the Professors providing their Latex files for handouts, homework and exams which we converted to HTML with Mathjax, and ppt files early to alt text).
>
> The Fall Comp Sci course requires learning HTML and flowcharting. The syllabus asks for
> Flowcharting software:
>
>    *   Draw.io is available free online (https://app.diagrams.net/ )
>    *   Optional: Flowcharting software Flowgorithm is available for free download only for Windows machines (http://flowgorithm.org/)
>    *   MS Word can also generate flowcharts, but some students find it more cumbersome to utilize
> JavaScript software
> (You will be writing JavaScript programs so you will need software to do that!)
>
>    *   https://js.do/ on-line JavaScript Editor
>    *   Other JavaScript/HTML Editors to download if you prefer:
>       *   Visual Studio Code
>       *   Atom Text Editor
>       *   Sublime
>       *   Codepen.io
>       *   Notepad++ (Windows only) - Available in Rutgers' Computer Labs
>
> QUESTIONS:
>
>    1.  What do you use to build a flowchart, say for designing code?
>    2.  Would any of you have any input on which, if any, of these flowcharting software above are accessible for the screen reader student? Is there a preference? Are there "watch out" tips?
>    3.  For a JavaScript Editor, are any provided in the list above accessible? If not, what do you use?
>    4.  For Calculus and Statistics courses, do you prefer getting them in HTML? MS Word with math equation editors?
>
> Any and all input would be greatly appreciated!
>
> Best Regards,
> Ketty
>
> M. Ketty Ombadykow, M. Ed., M.S.| Alternate Format Text/Assistive Technology
> Rutgers University | Rutgers Access & Disability Resources (RADR)
> Liberty Plaza, Suite 1250, 335 George Street, New Brunswick, NJ 08901
> Office: (848)-445-4431 | RADR main:  (848)-445-4499
> radr.aft at echo.rutgers.edu<mailto:radr.aft at echo.rutgers.edu> | https://radr.rutgers.edu/<https://radr.rutgers.edu/>
>
> This e-mail message and any attachment to this e-mail message contains confidential information that may be legally privileged.  If you are not the intended recipient, you must not review, retransmit, or convert to hard copy, copy, use or disseminate this e-mail or any attachments to it.  If you have received this e-mail in error, please immediately notify us by return e-mail and delete this message.  Please note that if this e-mail message contains a forwarded message or is a reply to a prior message, some or all of the contents of this message or any attachments may not have been produced by the sender.  This notice is automatically appended to each e-mail message from the sender.
>
> _______________________________________________
> BlindMath mailing list
> BlindMath at nfbnet.org
> http://nfbnet.org/mailman/listinfo/blindmath_nfbnet.org
> To unsubscribe, change your list options or get your account info for BlindMath:
> http://nfbnet.org/mailman/options/blindmath_nfbnet.org/a.j.godfrey%40massey.ac.nz
> BlindMath Gems can be found at <http://www.blindscience.org/blindmath-gems-home>
>
>
-- 
Rich Caloggero
Accessibility Specialist
Disability and Access Services
Massachusetts Institute of Technology