[BlindMath] New to LaTeX

Mon Oct 9 22:08:26 UTC 2023

Hello,

This tool is really quite nice for what it does do. I'm not getting any useful mathematics out of it though. Well not yet anyway.

My initial experiments show the mathematics as raw text. That is, it is not being converted at all. I've used both the pre-viewer that is part of the add-on and my default browser.

I'd like to see what the command line making the conversion is, but picking apart the code behind this add-on is outside my current skill set. Anyone wanting to tinker can reach out to me off-list with their findings.

I'm also primarily a JAWS user; I'd like to see a stand-alone tool deliver this conversion rather than it being only an NVDA add-on.

I have checked out the way it installs and is accessed in NVDA though. I like the results from the standard markdown to the standard HTML with a keypress which is a huge advantage over a command line conversion. The project is worth following.

Jonathan

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of ikrami via BlindMath
Sent: Monday, October 9, 2023 11:45 PM
To: 'Blind Math list for those interested in mathematics' <blindmath at nfbnet.org>
Cc: blindathlete6 at gmail.com
Subject: Re: [BlindMath] New to LaTeX

I am not sure if this nvda addon will suffice, but it uses pandoc to convert between html and markdown with simple keystrokes. I can type in markdown, highlight the text, press the conversion shortcut, and get the result in html. I am not sure though what it will do with your math content, but it is definitely worth a try.

https://github.com/aaclause/nvda-markdownForever

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Dana Ibrahim via BlindMath
Sent: Monday, October 9, 2023 12:41 AM
To: 'Blind Math list for those interested in mathematics'
<blindmath at nfbnet.org>
Cc: dana.mohsen.azim at gmail.com
Subject: Re: [BlindMath] New to LaTeX

Hello,
I am a bit unsure of how to use the command line. Is there any resource that provides detailed instructions?
Thank you,
Dana
-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Robin Williams via BlindMath
Sent: Monday, October 2, 2023 12:18 PM
To: Blind Math list for those interested in mathematics <blindmath at nfbnet.org>
Cc: Robin Williams <Robin.Williams at atass-sports.co.uk>
Subject: Re: [BlindMath] New to LaTeX

Hi Dana,

Either can be done. When converting, I typically specify a --mathjax argument when issuing the command, which ensures the page makes use of the MathJax library and is therefore accessible.

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Dana Ibrahim via BlindMath
Sent: Friday, September 29, 2023 9:53 PM
To: 'Blind Math list for those interested in mathematics'
<blindmath at nfbnet.org>
Cc: dana.mohsen.azim at gmail.com
Subject: Re: [BlindMath] New to LaTeX

Hello again,
I have another question.
Would it be possible to convert a document in .tex format into HTML, or will that make the equations unreadable? Would there be a difference if it was converted from .md to HTML or from .tex to html?
Thank you,
Dana

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Jonathan Godfrey via BlindMath
Sent: Sunday, September 24, 2023 11:03 PM
To: Blind Math list for those interested in mathematics <blindmath at nfbnet.org>
Cc: Jonathan Godfrey <A.J.Godfrey at massey.ac.nz>
Subject: Re: [BlindMath] New to LaTeX

Hello Dana,

I'm assuming you are using Windows. If not, you need to tell us, so that someone else can offer more OS-specific assistance.

LaTeX to Word is best avoided. There have been converters but there's just no point in using this workflow.

MS Word is supposed to handle equations typed in LaTeX form. Someone else is going to have to give you pointers on that because I haven't created an MS Word document in over 8 years, and things have changed a lot over that time.
This may be all you need at this stage so do consider it.

I believe you will get the greatest benefit if you use a tool that provides an accessible outcome. If you use markdown to HTML, the equations you create (using LaTeX notation) will be interpreted by the screen reader.

To write a markdown document is simple. Open a text editor, even Notepad will do. Now type anything you like; save this file using the extension md (short for markdown).

Conversion is not so simple. You need to use pandoc and a command line to do the conversion. On Windows, open a command prompt (Windows then type cmd and hit <enter>) At this prompt, type winget install pandoc That installs pandoc; look out for feedback which includes progress alerts. You should not need to choose folders or settings, but you may need to give permission to proceed

You will need a command prompt again to process the markdown files you write. I suggest putting them in a specific folder for the moment. Open a command prompt in that folder. There are a variety of ways to do this. Now type the command
   Pandoc MyFile.md -o MyFile.html

Your new file is ready to open in your browser. Now make changes to the starting file. You will need to process it over and over to see the impact your working has.

Equations are written in LaTeX and a lot of basic formatting is easily incorporated. I suggest using ChatGpt or your preferred AI tool to ask how to represent something in markdown. E.g. How do I write the equation for a straight line in LaTeX?

HTH,
Jonathan

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Dana Ibrahim via BlindMath
Sent: Saturday, September 23, 2023 10:58 PM
To: peter.julien.rayner at gmail.com; 'Blind Math list for those interested in mathematics' <blindmath at nfbnet.org>
Cc: dana.mohsen.azim at gmail.com
Subject: Re: [BlindMath] New to LaTeX

Hello all,
Thank you for the feedback.
Where can I learn these tools?
Also, can Latex be processed into word?
Should I start by learning LaTex or markdown?
Best,
Dana

-----Original Message-----
From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Peter Rayner via BlindMath
Sent: Saturday, September 23, 2023 7:46 AM
To: Blind Math list for those interested in mathematics <blindmath at nfbnet.org>
Cc: peter.julien.rayner at gmail.com
Subject: Re: [BlindMath] New to LaTeX

For what it's worth I work in LaTeX i.e that's my internal format. I develop and notate my maths content in it, resorting to braille only when my memory can't manipulate the equations. I process to pdf only to communicate visually. markdown would probably do the same job. I've come to rely so much on LaTeX features like the extraordinary diagram-drawing environment tikz/pgf and haven't convinced myself equivalent functionality is available elsewhere. pdf/LaTeX also allows me split screen presentations where I have my notes on a braille display and the projector/conferencing application has the presentation. I've not found another way to do this though it must be possible in browser-based methods. My own summary is that markdown is an easier tool to grasp, LaTeX probably a better toolkit and you won't go far wrong learning either of these. Personally I'd start with markdown and, by the time you've done that, you've learned most of the hard stuff from LaTeX anyway.
cheers
Peter

Jonathan Godfrey via BlindMath writes:
>Hello,
>
>Yes, the most common end-product for LaTeX documents is the dreaded pdf.
>
>It doesn't have to be that way though, but the tools to create HTML are
>not
well-known to authors.
>
>I recommend thinking about using markdown instead. You use the same
commands to generate equations and mathematical symbols, but you don't need to learn all the stuff that LaTeX includes.
>
>You will need a program called pandoc to process the markdown file into
HTML. You edit the markdown file (just a plain text file with a different
extension) in your chosen text editor.
>The hardest part is the command to process the file into the HTML.
>
>I have not used any specific markdown editors, but I do understand some
have been reviewed by notable blind people.
>
>I hope others share their views.
>Jonathan
>
>
>
>
>
>-----Original Message-----
>From: BlindMath <blindmath-bounces at nfbnet.org> On Behalf Of Dana
>Ibrahim via BlindMath
>Sent: Friday, September 22, 2023 9:38 AM
>To: 'Blind Math list for those interested in mathematics'
><blindmath at nfbnet.org>
>Cc: dana.mohsen.azim at gmail.com
>Subject: [BlindMath] New to LaTex
>
>Hello all,
>
>I hope everyone is doing great.
>
>I recently heard about the concept of LaTex, but I want to learn more
>about
it.
>From what I've heard, you can type math symbols using letters. For
>example,
typing a fraction would mean that one would type "frac."
>
>I also heard that one can compile these LaTex files into a PDF file,
>but I
also know that math PDFs are terrible with screen-readers.
>
>So, what are your experiences with LaTex? How do you read it? What are
>the
most accessible applications one can use?
>
>Sorry for the long email.
>
>Best,
>Dana
>
>_______________________________________________
>BlindMath mailing list
>BlindMath at nfbnet.org
>http://nfbnet/
>.org%2Fmailman%2Flistinfo%2Fblindmath_nfbnet.org&data=05%7C01%7Ca.j.god
>frey%40massey.ac.nz%7C9b4b20b9c80e491186fa08dbbc242909%7C388728e1bbd043
>7898dcf8682e644300%7C1%7C0%7C638310635743547774%7CUnknown%7CTWFpbGZsb3d
>8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3
>000%7C%7C%7C&sdata=orcHVsB24EimlHjz%2FdUY5iac4Lpxh8rGjWma2Di%2FfC4%3D&r
>eserved=0 To unsubscribe, change your list options or get your account
>info for
BlindMath:
>http://nfbnet/
>.org%2Fmailman%2Foptions%2Fblindmath_nfbnet.org%2Fa.j.godfrey%2540ma&da
>ta=05%7C01%7Ca.j.godfrey%40massey.ac.nz%7C9b4b20b9c80e491186fa08dbbc242
>909%7C388728e1bbd0437898dcf8682e644300%7C1%7C0%7C638310635743547774%7CU
>nknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haW
>wiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=QW4o92NAoEepAdXOGCalT7hfP4Vl7rR1
>dlaEYb%2BW5HU%3D&reserved=0 ssey.ac.nz BlindMath Gems can be found at
><http://www.b/
>%2F&data=05%7C01%7Ca.j.godfrey%40massey.ac.nz%7Cb303761f48854316420108d
>bc8b50f63%7C388728e1bbd0437898dcf8682e644300%7C1%7C0%7C6383244522312418
>78%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6
>Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=LsZbZJ9gTTS2MYo8c24Ux3qVl%
>2FY4vIEH5QAySzcTFcc%3D&reserved=0
>lindscience.org%2Fblindmath-gems-home&data=05%7C01%7Ca.j.godfrey%40mass
>ey.ac.nz%7C9b4b20b9c80e491186fa08dbbc242909%7C388728e1bbd0437898dcf8682
>e644300%7C1%7C0%7C638310635743547774%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC
>4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7
>C&sdata=fwt%2F7quL1xmlQBmLzskN31X1ULj69DSg2o8fgX2byxE%3D&reserved=0>
>
>_______________________________________________
>BlindMath mailing list
>BlindMath at nfbnet.org
>http://nfbnet/
>.org%2Fmailman%2Flistinfo%2Fblindmath_nfbnet.org&data=05%7C01%7Ca.j.god
>frey%40massey.ac.nz%7C9b4b20b9c80e491186fa08dbbc242909%7C388728e1bbd043
>7898dcf8682e644300%7C1%7C0%7C638310635743547774%7CUnknown%7CTWFpbGZsb3d
>8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3
>000%7C%7C%7C&sdata=orcHVsB24EimlHjz%2FdUY5iac4Lpxh8rGjWma2Di%2FfC4%3D&r
>eserved=0 To unsubscribe, change your list options or get your account
>info for
BlindMath:
>http://nfbnet/
>.org%2Fmailman%2Foptions%2Fblindmath_nfbnet.org%2Fpeter.julien.ray&data
>=05%7C01%7Ca.j.godfrey%40massey.ac.nz%7C9b4b20b9c80e491186fa08dbbc24290
>9%7C388728e1bbd0437898dcf8682e644300%7C1%7C0%7C638310635743547774%7CUnk
>nown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwi
>LCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=QN%2Bw5OLHZg%2FDP5y6aVIseNkQHSO8Hu
>3T5xYI5SM0dtE%3D&reserved=0 ner%40gmail.com BlindMath Gems can be found
>at
><http://www.b/
>%2F&data=05%7C01%7Ca.j.godfrey%40massey.ac.nz%7Cb303761f48854316420108d
>bc8b50f63%7C388728e1bbd0437898dcf8682e644300%7C1%7C0%7C6383244522312418
>78%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6
>Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=LsZbZJ9gTTS2MYo8c24Ux3qVl%
>2FY4vIEH5QAySzcTFcc%3D&reserved=0
>lindscience.org%2Fblindmath-gems-home&data=05%7C01%7Ca.j.godfrey%40mass
>ey.ac.nz%7C9b4b20b9c80e491186fa08dbbc242909%7C388728e1bbd0437898dcf8682
>e644300%7C1%7C0%7C638310635743547774%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC
>4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7
>C&sdata=fwt%2F7quL1xmlQBmLzskN31X1ULj69DSg2o8fgX2byxE%3D&reserved=0>

--
Peter Rayner (he/him), Honorary Professorial Fellow, University of Melbourne mobile +61 402 752 379 zoom id 4431343191, join at <https://unimelb.zoom.us/j/4431343191?pwd=a1E5Z3JEOTRVQUJsaVdRbVUvR1QyZz09>
mail-to: peter.julien.rayner at gmail.com
google scholar:
<https://scholar.google.com.au/citations?user=H3up71wAAAAJ&hl=en>
I acknowledge the Traditional Custodians of the land on which I work, the Wurundjeri people of the Kulin nation, and pay my respect to their Elders, past and present I am sending this email when convenient for me, please only respond when convenient for you

_______________________________________________
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/dana.mohsen.azim%40gm
ail.com
BlindMath Gems can be found at
<http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
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>

_______________________________________________
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/dana.mohsen.azim%40gm
ail.com
BlindMath Gems can be found at
<http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
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/robin.williams%40atas
s-sports.co.uk
BlindMath Gems can be found at
<http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
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/dana.mohsen.azim%40gm
ail.com
BlindMath Gems can be found at
<http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
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/blindathlete6%40gmail
.com
BlindMath Gems can be found at
<http://www.blindscience.org/blindmath-gems-home>

_______________________________________________
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>