Equation labels/references when converting from latex to markdown/other

Equation labels/references when converting from latex to markdown/other

[Ian Price]

[-- Attachment #1.1: Type: text/plain, Size: 2162 bytes --]


Hello,
My university is looking into the options for converting various notes, 
exercises sheets, presentations, etc. from latex generated pdf into a more 
accessible format. This basically means converting to html + mathjax 
because this tends to work better for screen readers. Converting beamer 
seems to be impossible, but for notes pandoc (and some others like latexml) 
is generally giving good output, however the major issue is cross 
referencing between text and maths blocks.

In short, mathjax can handle internal links from maths blocks to other 
maths blocks, and pandoc can handle links to other parts of pandoc 
documents, except when a document makes specific reference to an equation.
For example, suppose we have the following mwe.tex cut out from some 
electromagnetism notes
---
\documentclass[12pt]{article} 
\begin{document} 
\begin{equation} 
J \equiv \frac{dI}{da_{\perp}} =  \rho v.  
\label{volume-current-density} 
\end{equation} 
The total current crossing a surface $S$ can be calculated by integrating 
Eq. (\ref{volume-current-density}):  
\end{document}
---
When converted to markdown, we get the following
---
$$J \equiv \frac{dI}{da_{\perp}} =  \rho v.  
\label{volume-current-density}$$ 
 
The total current crossing a surface $S$ can be calculated by 
integrating Eq. 
([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
reference="volume-current-density"}):
---
The link to the label volume-current-density is clearly broken and when I 
get my html file it does nothing in particular.

One solution I've seen is to convert the label references to the syntax 
used by, e.g., pandoc-crossref, but this involves me editing the markdown 
by hand. Is there an automatic way to convert these? 

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 2677 bytes --]

Re: Equation labels/references when converting from latex to markdown/other

[John MacFarlane]

This isn't yet supported, really.  But you might be able to
work around it.

Note:

% pandoc -f latex -t native
\ref{foo}
^D
[Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) [Str "[foo]"] ("#foo","")]]

So when pandoc parses \ref{foo}, it doesn't just create a string
[foo]; it creates a link with attributes.  You could use a lua
filter to turn this into something that mathjax can consume
(raw tex, I would imagine).

Just let us know what you want to appear in the HTML, and we can
show you how to do it.

Ian Price <ianprice90-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> Hello,
> My university is looking into the options for converting various notes, 
> exercises sheets, presentations, etc. from latex generated pdf into a more 
> accessible format. This basically means converting to html + mathjax 
> because this tends to work better for screen readers. Converting beamer 
> seems to be impossible, but for notes pandoc (and some others like latexml) 
> is generally giving good output, however the major issue is cross 
> referencing between text and maths blocks.
>
> In short, mathjax can handle internal links from maths blocks to other 
> maths blocks, and pandoc can handle links to other parts of pandoc 
> documents, except when a document makes specific reference to an equation.
> For example, suppose we have the following mwe.tex cut out from some 
> electromagnetism notes
> ---
> \documentclass[12pt]{article} 
> \begin{document} 
> \begin{equation} 
> J \equiv \frac{dI}{da_{\perp}} =  \rho v.  
> \label{volume-current-density} 
> \end{equation} 
> The total current crossing a surface $S$ can be calculated by integrating 
> Eq. (\ref{volume-current-density}):  
> \end{document}
> ---
> When converted to markdown, we get the following
> ---
> $$J \equiv \frac{dI}{da_{\perp}} =  \rho v.  
> \label{volume-current-density}$$ 
>  
> The total current crossing a surface $S$ can be calculated by 
> integrating Eq. 
> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
> reference="volume-current-density"}):
> ---
> The link to the label volume-current-density is clearly broken and when I 
> get my html file it does nothing in particular.
>
> One solution I've seen is to convert the label references to the syntax 
> used by, e.g., pandoc-crossref, but this involves me editing the markdown 
> by hand. Is there an automatic way to convert these? 
>
> -- 
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com.

Re: Equation labels/references when converting from latex to markdown/other

[Leena Murgai]

[-- Attachment #1.1: Type: text/plain, Size: 3720 bytes --]

Hi John,

Can you clarify your work around here? I wasn't able to follow.

I have a similar problem converting from LaTeX to HTML5 - \label and \ref 
for equations don't work. I'd be super grateful for any advice you could 
offer.

Thanks!
Leena

On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote:

>
> This isn't yet supported, really. But you might be able to
> work around it.
>
> Note:
>
> % pandoc -f latex -t native
> \ref{foo}
> ^D
> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) [Str 
> "[foo]"] ("#foo","")]]
>
> So when pandoc parses \ref{foo}, it doesn't just create a string
> [foo]; it creates a link with attributes. You could use a lua
> filter to turn this into something that mathjax can consume
> (raw tex, I would imagine).
>
> Just let us know what you want to appear in the HTML, and we can
> show you how to do it.
>
> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>
> > Hello,
> > My university is looking into the options for converting various notes, 
> > exercises sheets, presentations, etc. from latex generated pdf into a 
> more 
> > accessible format. This basically means converting to html + mathjax 
> > because this tends to work better for screen readers. Converting beamer 
> > seems to be impossible, but for notes pandoc (and some others like 
> latexml) 
> > is generally giving good output, however the major issue is cross 
> > referencing between text and maths blocks.
> >
> > In short, mathjax can handle internal links from maths blocks to other 
> > maths blocks, and pandoc can handle links to other parts of pandoc 
> > documents, except when a document makes specific reference to an 
> equation.
> > For example, suppose we have the following mwe.tex cut out from some 
> > electromagnetism notes
> > ---
> > \documentclass[12pt]{article} 
> > \begin{document} 
> > \begin{equation} 
> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
> > \label{volume-current-density} 
> > \end{equation} 
> > The total current crossing a surface $S$ can be calculated by 
> integrating 
> > Eq. (\ref{volume-current-density}): 
> > \end{document}
> > ---
> > When converted to markdown, we get the following
> > ---
> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
> > \label{volume-current-density}$$ 
> > 
> > The total current crossing a surface $S$ can be calculated by 
> > integrating Eq. 
> > 
> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
> > reference="volume-current-density"}):
> > ---
> > The link to the label volume-current-density is clearly broken and when 
> I 
> > get my html file it does nothing in particular.
> >
> > One solution I've seen is to convert the label references to the syntax 
> > used by, e.g., pandoc-crossref, but this involves me editing the 
> markdown 
> > by hand. Is there an automatic way to convert these? 
> >
> > -- 
> > You received this message because you are subscribed to the Google 
> Groups "pandoc-discuss" group.
> > To unsubscribe from this group and stop receiving emails from it, send 
> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> > To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 5148 bytes --]

Re: Equation labels/references when converting from latex to markdown/other

[John MacFarlane]

As I said:

Just let us know what you want to appear in the HTML, and we can
show you how to do it.



Leena Murgai <leenamurgai-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> Hi John,
>
> Can you clarify your work around here? I wasn't able to follow.
>
> I have a similar problem converting from LaTeX to HTML5 - \label and \ref 
> for equations don't work. I'd be super grateful for any advice you could 
> offer.
>
> Thanks!
> Leena
>
> On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote:
>
>>
>> This isn't yet supported, really. But you might be able to
>> work around it.
>>
>> Note:
>>
>> % pandoc -f latex -t native
>> \ref{foo}
>> ^D
>> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) [Str 
>> "[foo]"] ("#foo","")]]
>>
>> So when pandoc parses \ref{foo}, it doesn't just create a string
>> [foo]; it creates a link with attributes. You could use a lua
>> filter to turn this into something that mathjax can consume
>> (raw tex, I would imagine).
>>
>> Just let us know what you want to appear in the HTML, and we can
>> show you how to do it.
>>
>> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>>
>> > Hello,
>> > My university is looking into the options for converting various notes, 
>> > exercises sheets, presentations, etc. from latex generated pdf into a 
>> more 
>> > accessible format. This basically means converting to html + mathjax 
>> > because this tends to work better for screen readers. Converting beamer 
>> > seems to be impossible, but for notes pandoc (and some others like 
>> latexml) 
>> > is generally giving good output, however the major issue is cross 
>> > referencing between text and maths blocks.
>> >
>> > In short, mathjax can handle internal links from maths blocks to other 
>> > maths blocks, and pandoc can handle links to other parts of pandoc 
>> > documents, except when a document makes specific reference to an 
>> equation.
>> > For example, suppose we have the following mwe.tex cut out from some 
>> > electromagnetism notes
>> > ---
>> > \documentclass[12pt]{article} 
>> > \begin{document} 
>> > \begin{equation} 
>> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>> > \label{volume-current-density} 
>> > \end{equation} 
>> > The total current crossing a surface $S$ can be calculated by 
>> integrating 
>> > Eq. (\ref{volume-current-density}): 
>> > \end{document}
>> > ---
>> > When converted to markdown, we get the following
>> > ---
>> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>> > \label{volume-current-density}$$ 
>> > 
>> > The total current crossing a surface $S$ can be calculated by 
>> > integrating Eq. 
>> > 
>> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
>> > reference="volume-current-density"}):
>> > ---
>> > The link to the label volume-current-density is clearly broken and when 
>> I 
>> > get my html file it does nothing in particular.
>> >
>> > One solution I've seen is to convert the label references to the syntax 
>> > used by, e.g., pandoc-crossref, but this involves me editing the 
>> markdown 
>> > by hand. Is there an automatic way to convert these? 
>> >
>> > -- 
>> > You received this message because you are subscribed to the Google 
>> Groups "pandoc-discuss" group.
>> > To unsubscribe from this group and stop receiving emails from it, send 
>> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> > To view this discussion on the web visit 
>> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com
>> .
>>
>
> -- 
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com.

Re: Equation labels/references when converting from latex to markdown/other

[Leena Murgai]

[-- Attachment #1.1: Type: text/plain, Size: 6562 bytes --]

Thanks for the reply John.

I've been playing around with an equation in LaTeX and seeing what comes 
out in HTML5 and also looking at what pandoc-crossref expects to find in 
the markdown. 

LaTeX equation format:
  \begin{equation} \label{eq:label}
  equation
  \end{equation}
Note: \label{eq:label} must be inside the equation environment, above is 
how I do it, but equally one can place the label after equation.

I tried moving label around in my LaTeX to see if it made a difference to 
the output HTML since pandoc-crossref expects to find the label after the 
equation environment 
<http://lierdakil.github.io/pandoc-crossref/#equation-labels>. Here's the 
HTML output in each case:

1. \label{eq:label} after \begin{equation}:

  <span class="math display">\label{eq:label}equation</span>

2. \label{eq:label} after equation:

  <span class="math display">equation\label{eq:label}</span>

3. \label{eq:label} after \end{equation}: Note that this will break the 
LaTeX code

  <span class="math display">equation</span><span>[eq:label]</span>

So, none of the above seem to give pandoc-crossref what it needs. Honestly, 
I'm not massively familiar with HTML and css - just figuring it out as I 
go. I imagine whatever pandoc-crossref would output (if I could get it to 
work) would be great. My quick and dirty approach (to get something like 
what LaTeX gives) would be to put the equation and its label in a table 
row. Something like

<div>
<table width=100% style="border: none;">
<tr>
<td style="text-align: center; border: none;"><span id="eq:label" 
class="math display">equation</span></td>
<td style="text-align: right; border: none; width: 5%;">(chap#.value{
eq:label})</td>
</tr>
</table>
</div>

I'm open to suggestions if hard coding 5% for the label width seems like a 
bad idea or some such.

Thanks,
Leena



On Wednesday, 21 July 2021 at 22:24:47 UTC-7 John MacFarlane wrote:

>
> As I said:
>
> Just let us know what you want to appear in the HTML, and we can
> show you how to do it.
>
>
>
> Leena Murgai <leena...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>
> > Hi John,
> >
> > Can you clarify your work around here? I wasn't able to follow.
> >
> > I have a similar problem converting from LaTeX to HTML5 - \label and 
> \ref 
> > for equations don't work. I'd be super grateful for any advice you could 
> > offer.
> >
> > Thanks!
> > Leena
> >
> > On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote:
> >
> >>
> >> This isn't yet supported, really. But you might be able to
> >> work around it.
> >>
> >> Note:
> >>
> >> % pandoc -f latex -t native
> >> \ref{foo}
> >> ^D
> >> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) [Str 
> >> "[foo]"] ("#foo","")]]
> >>
> >> So when pandoc parses \ref{foo}, it doesn't just create a string
> >> [foo]; it creates a link with attributes. You could use a lua
> >> filter to turn this into something that mathjax can consume
> >> (raw tex, I would imagine).
> >>
> >> Just let us know what you want to appear in the HTML, and we can
> >> show you how to do it.
> >>
> >> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
> >>
> >> > Hello,
> >> > My university is looking into the options for converting various 
> notes, 
> >> > exercises sheets, presentations, etc. from latex generated pdf into a 
> >> more 
> >> > accessible format. This basically means converting to html + mathjax 
> >> > because this tends to work better for screen readers. Converting 
> beamer 
> >> > seems to be impossible, but for notes pandoc (and some others like 
> >> latexml) 
> >> > is generally giving good output, however the major issue is cross 
> >> > referencing between text and maths blocks.
> >> >
> >> > In short, mathjax can handle internal links from maths blocks to 
> other 
> >> > maths blocks, and pandoc can handle links to other parts of pandoc 
> >> > documents, except when a document makes specific reference to an 
> >> equation.
> >> > For example, suppose we have the following mwe.tex cut out from some 
> >> > electromagnetism notes
> >> > ---
> >> > \documentclass[12pt]{article} 
> >> > \begin{document} 
> >> > \begin{equation} 
> >> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
> >> > \label{volume-current-density} 
> >> > \end{equation} 
> >> > The total current crossing a surface $S$ can be calculated by 
> >> integrating 
> >> > Eq. (\ref{volume-current-density}): 
> >> > \end{document}
> >> > ---
> >> > When converted to markdown, we get the following
> >> > ---
> >> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
> >> > \label{volume-current-density}$$ 
> >> > 
> >> > The total current crossing a surface $S$ can be calculated by 
> >> > integrating Eq. 
> >> > 
> >> 
> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
> >> > reference="volume-current-density"}):
> >> > ---
> >> > The link to the label volume-current-density is clearly broken and 
> when 
> >> I 
> >> > get my html file it does nothing in particular.
> >> >
> >> > One solution I've seen is to convert the label references to the 
> syntax 
> >> > used by, e.g., pandoc-crossref, but this involves me editing the 
> >> markdown 
> >> > by hand. Is there an automatic way to convert these? 
> >> >
> >> > -- 
> >> > You received this message because you are subscribed to the Google 
> >> Groups "pandoc-discuss" group.
> >> > To unsubscribe from this group and stop receiving emails from it, 
> send 
> >> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> >> > To view this discussion on the web visit 
> >> 
> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com
> >> .
> >>
> >
> > -- 
> > You received this message because you are subscribed to the Google 
> Groups "pandoc-discuss" group.
> > To unsubscribe from this group and stop receiving emails from it, send 
> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> > To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/5e86f41a-1515-4843-a4bc-2cb2ef1d63dan%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 10909 bytes --]

Re: Equation labels/references when converting from latex to markdown/other

[Leena Murgai]

[-- Attachment #1.1: Type: text/plain, Size: 7074 bytes --]

Oh and
\ref{eq:label}
in LaTeX should give
<a href ="#eq:label"data-reference-type="ref" data-reference="eq:label">
chap#.value(eq:label)</a>
in HTML.
On Friday, 23 July 2021 at 16:06:31 UTC-7 Leena Murgai wrote:

> Thanks for the reply John.
>
> I've been playing around with an equation in LaTeX and seeing what comes 
> out in HTML5 and also looking at what pandoc-crossref expects to find in 
> the markdown. 
>
> LaTeX equation format:
>   \begin{equation} \label{eq:label}
>   equation
>   \end{equation}
> Note: \label{eq:label} must be inside the equation environment, above is 
> how I do it, but equally one can place the label after equation.
>
> I tried moving label around in my LaTeX to see if it made a difference to 
> the output HTML since pandoc-crossref expects to find the label after the 
> equation environment 
> <http://lierdakil.github.io/pandoc-crossref/#equation-labels>. Here's the 
> HTML output in each case:
>
> 1. \label{eq:label} after \begin{equation}:
>
>   <span class="math display">\label{eq:label}equation</span>
>
> 2. \label{eq:label} after equation:
>
>   <span class="math display">equation\label{eq:label}</span>
>
> 3. \label{eq:label} after \end{equation}: Note that this will break the 
> LaTeX code
>
>   <span class="math display">equation</span><span>[eq:label]</span>
>
> So, none of the above seem to give pandoc-crossref what it needs. 
> Honestly, I'm not massively familiar with HTML and css - just figuring it 
> out as I go. I imagine whatever pandoc-crossref would output (if I could 
> get it to work) would be great. My quick and dirty approach (to get 
> something like what LaTeX gives) would be to put the equation and its label 
> in a table row. Something like
>
> <div>
> <table width=100% style="border: none;">
> <tr>
> <td style="text-align: center; border: none;"><span id="eq:label" 
> class="math display">equation</span></td>
> <td style="text-align: right; border: none; width: 5%;">(chap#.value{
> eq:label})</td>
> </tr>
> </table>
> </div>
>
> I'm open to suggestions if hard coding 5% for the label width seems like a 
> bad idea or some such.
>
> Thanks,
> Leena
>
>
>
> On Wednesday, 21 July 2021 at 22:24:47 UTC-7 John MacFarlane wrote:
>
>>
>> As I said: 
>>
>> Just let us know what you want to appear in the HTML, and we can 
>> show you how to do it. 
>>
>>
>>
>> Leena Murgai <leena...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>>
>> > Hi John, 
>> > 
>> > Can you clarify your work around here? I wasn't able to follow. 
>> > 
>> > I have a similar problem converting from LaTeX to HTML5 - \label and 
>> \ref 
>> > for equations don't work. I'd be super grateful for any advice you 
>> could 
>> > offer. 
>> > 
>> > Thanks! 
>> > Leena 
>> > 
>> > On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote: 
>> > 
>> >> 
>> >> This isn't yet supported, really. But you might be able to 
>> >> work around it. 
>> >> 
>> >> Note: 
>> >> 
>> >> % pandoc -f latex -t native 
>> >> \ref{foo} 
>> >> ^D 
>> >> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) 
>> [Str 
>> >> "[foo]"] ("#foo","")]] 
>> >> 
>> >> So when pandoc parses \ref{foo}, it doesn't just create a string 
>> >> [foo]; it creates a link with attributes. You could use a lua 
>> >> filter to turn this into something that mathjax can consume 
>> >> (raw tex, I would imagine). 
>> >> 
>> >> Just let us know what you want to appear in the HTML, and we can 
>> >> show you how to do it. 
>> >> 
>> >> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>> >> 
>> >> > Hello, 
>> >> > My university is looking into the options for converting various 
>> notes, 
>> >> > exercises sheets, presentations, etc. from latex generated pdf into 
>> a 
>> >> more 
>> >> > accessible format. This basically means converting to html + mathjax 
>> >> > because this tends to work better for screen readers. Converting 
>> beamer 
>> >> > seems to be impossible, but for notes pandoc (and some others like 
>> >> latexml) 
>> >> > is generally giving good output, however the major issue is cross 
>> >> > referencing between text and maths blocks. 
>> >> > 
>> >> > In short, mathjax can handle internal links from maths blocks to 
>> other 
>> >> > maths blocks, and pandoc can handle links to other parts of pandoc 
>> >> > documents, except when a document makes specific reference to an 
>> >> equation. 
>> >> > For example, suppose we have the following mwe.tex cut out from some 
>> >> > electromagnetism notes 
>> >> > --- 
>> >> > \documentclass[12pt]{article} 
>> >> > \begin{document} 
>> >> > \begin{equation} 
>> >> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>> >> > \label{volume-current-density} 
>> >> > \end{equation} 
>> >> > The total current crossing a surface $S$ can be calculated by 
>> >> integrating 
>> >> > Eq. (\ref{volume-current-density}): 
>> >> > \end{document} 
>> >> > --- 
>> >> > When converted to markdown, we get the following 
>> >> > --- 
>> >> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>> >> > \label{volume-current-density}$$ 
>> >> > 
>> >> > The total current crossing a surface $S$ can be calculated by 
>> >> > integrating Eq. 
>> >> > 
>> >> 
>> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
>> >> > reference="volume-current-density"}): 
>> >> > --- 
>> >> > The link to the label volume-current-density is clearly broken and 
>> when 
>> >> I 
>> >> > get my html file it does nothing in particular. 
>> >> > 
>> >> > One solution I've seen is to convert the label references to the 
>> syntax 
>> >> > used by, e.g., pandoc-crossref, but this involves me editing the 
>> >> markdown 
>> >> > by hand. Is there an automatic way to convert these? 
>> >> > 
>> >> > -- 
>> >> > You received this message because you are subscribed to the Google 
>> >> Groups "pandoc-discuss" group. 
>> >> > To unsubscribe from this group and stop receiving emails from it, 
>> send 
>> >> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>> >> > To view this discussion on the web visit 
>> >> 
>> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com 
>> >> . 
>> >> 
>> > 
>> > -- 
>> > You received this message because you are subscribed to the Google 
>> Groups "pandoc-discuss" group. 
>> > To unsubscribe from this group and stop receiving emails from it, send 
>> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>> > To view this discussion on the web visit 
>> https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com. 
>>
>>
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/7662f9b4-f4eb-45bb-bc0d-04d82bdf9505n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 11892 bytes --]

Re: Equation labels/references when converting from latex to markdown/other

[Leena Murgai]

[-- Attachment #1.1: Type: text/plain, Size: 7486 bytes --]

Currently
\ref{eq:label}
in LaTeX gives
<a href="#eq:label" data-reference-type="ref" data-reference="eq:label">[
eq:label]</a>
in HTML.

On Friday, 23 July 2021 at 16:22:24 UTC-7 Leena Murgai wrote:

> Oh and
> \ref{eq:label}
> in LaTeX should give
> <a href ="#eq:label"data-reference-type="ref" data-reference="eq:label">
> chap#.value(eq:label)</a>
> in HTML.
> On Friday, 23 July 2021 at 16:06:31 UTC-7 Leena Murgai wrote:
>
>> Thanks for the reply John.
>>
>> I've been playing around with an equation in LaTeX and seeing what comes 
>> out in HTML5 and also looking at what pandoc-crossref expects to find in 
>> the markdown. 
>>
>> LaTeX equation format:
>>   \begin{equation} \label{eq:label}
>>   equation
>>   \end{equation}
>> Note: \label{eq:label} must be inside the equation environment, above is 
>> how I do it, but equally one can place the label after equation.
>>
>> I tried moving label around in my LaTeX to see if it made a difference to 
>> the output HTML since pandoc-crossref expects to find the label after 
>> the equation environment 
>> <http://lierdakil.github.io/pandoc-crossref/#equation-labels>. Here's 
>> the HTML output in each case:
>>
>> 1. \label{eq:label} after \begin{equation}:
>>
>>   <span class="math display">\label{eq:label}equation</span>
>>
>> 2. \label{eq:label} after equation:
>>
>>   <span class="math display">equation\label{eq:label}</span>
>>
>> 3. \label{eq:label} after \end{equation}: Note that this will break the 
>> LaTeX code
>>
>>   <span class="math display">equation</span><span>[eq:label]</span>
>>
>> So, none of the above seem to give pandoc-crossref what it needs. 
>> Honestly, I'm not massively familiar with HTML and css - just figuring it 
>> out as I go. I imagine whatever pandoc-crossref would output (if I could 
>> get it to work) would be great. My quick and dirty approach (to get 
>> something like what LaTeX gives) would be to put the equation and its label 
>> in a table row. Something like
>>
>> <div>
>> <table width=100% style="border: none;">
>> <tr>
>> <td style="text-align: center; border: none;"><span id="eq:label" 
>> class="math display">equation</span></td>
>> <td style="text-align: right; border: none; width: 5%;">(chap#.value{
>> eq:label})</td>
>> </tr>
>> </table>
>> </div>
>>
>> I'm open to suggestions if hard coding 5% for the label width seems like 
>> a bad idea or some such.
>>
>> Thanks,
>> Leena
>>
>>
>>
>> On Wednesday, 21 July 2021 at 22:24:47 UTC-7 John MacFarlane wrote:
>>
>>>
>>> As I said: 
>>>
>>> Just let us know what you want to appear in the HTML, and we can 
>>> show you how to do it. 
>>>
>>>
>>>
>>> Leena Murgai <leena...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>>>
>>> > Hi John, 
>>> > 
>>> > Can you clarify your work around here? I wasn't able to follow. 
>>> > 
>>> > I have a similar problem converting from LaTeX to HTML5 - \label and 
>>> \ref 
>>> > for equations don't work. I'd be super grateful for any advice you 
>>> could 
>>> > offer. 
>>> > 
>>> > Thanks! 
>>> > Leena 
>>> > 
>>> > On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote: 
>>> > 
>>> >> 
>>> >> This isn't yet supported, really. But you might be able to 
>>> >> work around it. 
>>> >> 
>>> >> Note: 
>>> >> 
>>> >> % pandoc -f latex -t native 
>>> >> \ref{foo} 
>>> >> ^D 
>>> >> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) 
>>> [Str 
>>> >> "[foo]"] ("#foo","")]] 
>>> >> 
>>> >> So when pandoc parses \ref{foo}, it doesn't just create a string 
>>> >> [foo]; it creates a link with attributes. You could use a lua 
>>> >> filter to turn this into something that mathjax can consume 
>>> >> (raw tex, I would imagine). 
>>> >> 
>>> >> Just let us know what you want to appear in the HTML, and we can 
>>> >> show you how to do it. 
>>> >> 
>>> >> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>>> >> 
>>> >> > Hello, 
>>> >> > My university is looking into the options for converting various 
>>> notes, 
>>> >> > exercises sheets, presentations, etc. from latex generated pdf into 
>>> a 
>>> >> more 
>>> >> > accessible format. This basically means converting to html + 
>>> mathjax 
>>> >> > because this tends to work better for screen readers. Converting 
>>> beamer 
>>> >> > seems to be impossible, but for notes pandoc (and some others like 
>>> >> latexml) 
>>> >> > is generally giving good output, however the major issue is cross 
>>> >> > referencing between text and maths blocks. 
>>> >> > 
>>> >> > In short, mathjax can handle internal links from maths blocks to 
>>> other 
>>> >> > maths blocks, and pandoc can handle links to other parts of pandoc 
>>> >> > documents, except when a document makes specific reference to an 
>>> >> equation. 
>>> >> > For example, suppose we have the following mwe.tex cut out from 
>>> some 
>>> >> > electromagnetism notes 
>>> >> > --- 
>>> >> > \documentclass[12pt]{article} 
>>> >> > \begin{document} 
>>> >> > \begin{equation} 
>>> >> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>>> >> > \label{volume-current-density} 
>>> >> > \end{equation} 
>>> >> > The total current crossing a surface $S$ can be calculated by 
>>> >> integrating 
>>> >> > Eq. (\ref{volume-current-density}): 
>>> >> > \end{document} 
>>> >> > --- 
>>> >> > When converted to markdown, we get the following 
>>> >> > --- 
>>> >> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>>> >> > \label{volume-current-density}$$ 
>>> >> > 
>>> >> > The total current crossing a surface $S$ can be calculated by 
>>> >> > integrating Eq. 
>>> >> > 
>>> >> 
>>> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
>>> >> > reference="volume-current-density"}): 
>>> >> > --- 
>>> >> > The link to the label volume-current-density is clearly broken and 
>>> when 
>>> >> I 
>>> >> > get my html file it does nothing in particular. 
>>> >> > 
>>> >> > One solution I've seen is to convert the label references to the 
>>> syntax 
>>> >> > used by, e.g., pandoc-crossref, but this involves me editing the 
>>> >> markdown 
>>> >> > by hand. Is there an automatic way to convert these? 
>>> >> > 
>>> >> > -- 
>>> >> > You received this message because you are subscribed to the Google 
>>> >> Groups "pandoc-discuss" group. 
>>> >> > To unsubscribe from this group and stop receiving emails from it, 
>>> send 
>>> >> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>> >> > To view this discussion on the web visit 
>>> >> 
>>> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com 
>>> >> . 
>>> >> 
>>> > 
>>> > -- 
>>> > You received this message because you are subscribed to the Google 
>>> Groups "pandoc-discuss" group. 
>>> > To unsubscribe from this group and stop receiving emails from it, send 
>>> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>> > To view this discussion on the web visit 
>>> https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com. 
>>>
>>>
>>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/0a0f727f-8001-40f9-84e6-4e60574b2af1n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 12571 bytes --]

Re: Equation labels/references when converting from latex to markdown/other

[Leena Murgai]

[-- Attachment #1.1: Type: text/plain, Size: 7906 bytes --]

For others who might find it helpful this was resolved in pandoc-crossref 
issue 319 <https://github.com/lierdakil/pandoc-crossref/issues/319>.

On Friday, 23 July 2021 at 18:36:13 UTC-7 Leena Murgai wrote:

> Currently
> \ref{eq:label}
> in LaTeX gives
> <a href="#eq:label" data-reference-type="ref" data-reference="eq:label">[
> eq:label]</a>
> in HTML.
>
> On Friday, 23 July 2021 at 16:22:24 UTC-7 Leena Murgai wrote:
>
>> Oh and
>> \ref{eq:label}
>> in LaTeX should give
>> <a href ="#eq:label"data-reference-type="ref" data-reference="eq:label">
>> chap#.value(eq:label)</a>
>> in HTML.
>> On Friday, 23 July 2021 at 16:06:31 UTC-7 Leena Murgai wrote:
>>
>>> Thanks for the reply John.
>>>
>>> I've been playing around with an equation in LaTeX and seeing what comes 
>>> out in HTML5 and also looking at what pandoc-crossref expects to find in 
>>> the markdown. 
>>>
>>> LaTeX equation format:
>>>   \begin{equation} \label{eq:label}
>>>   equation
>>>   \end{equation}
>>> Note: \label{eq:label} must be inside the equation environment, above 
>>> is how I do it, but equally one can place the label after equation.
>>>
>>> I tried moving label around in my LaTeX to see if it made a difference 
>>> to the output HTML since pandoc-crossref expects to find the label 
>>> after the equation environment 
>>> <http://lierdakil.github.io/pandoc-crossref/#equation-labels>. Here's 
>>> the HTML output in each case:
>>>
>>> 1. \label{eq:label} after \begin{equation}:
>>>
>>>   <span class="math display">\label{eq:label}equation</span>
>>>
>>> 2. \label{eq:label} after equation:
>>>
>>>   <span class="math display">equation\label{eq:label}</span>
>>>
>>> 3. \label{eq:label} after \end{equation}: Note that this will break the 
>>> LaTeX code
>>>
>>>   <span class="math display">equation</span><span>[eq:label]</span>
>>>
>>> So, none of the above seem to give pandoc-crossref what it needs. 
>>> Honestly, I'm not massively familiar with HTML and css - just figuring it 
>>> out as I go. I imagine whatever pandoc-crossref would output (if I could 
>>> get it to work) would be great. My quick and dirty approach (to get 
>>> something like what LaTeX gives) would be to put the equation and its label 
>>> in a table row. Something like
>>>
>>> <div>
>>> <table width=100% style="border: none;">
>>> <tr>
>>> <td style="text-align: center; border: none;"><span id="eq:label" 
>>> class="math display">equation</span></td>
>>> <td style="text-align: right; border: none; width: 5%;">(chap#.value{
>>> eq:label})</td>
>>> </tr>
>>> </table>
>>> </div>
>>>
>>> I'm open to suggestions if hard coding 5% for the label width seems like 
>>> a bad idea or some such.
>>>
>>> Thanks,
>>> Leena
>>>
>>>
>>>
>>> On Wednesday, 21 July 2021 at 22:24:47 UTC-7 John MacFarlane wrote:
>>>
>>>>
>>>> As I said: 
>>>>
>>>> Just let us know what you want to appear in the HTML, and we can 
>>>> show you how to do it. 
>>>>
>>>>
>>>>
>>>> Leena Murgai <leena...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>>>>
>>>> > Hi John, 
>>>> > 
>>>> > Can you clarify your work around here? I wasn't able to follow. 
>>>> > 
>>>> > I have a similar problem converting from LaTeX to HTML5 - \label and 
>>>> \ref 
>>>> > for equations don't work. I'd be super grateful for any advice you 
>>>> could 
>>>> > offer. 
>>>> > 
>>>> > Thanks! 
>>>> > Leena 
>>>> > 
>>>> > On Tuesday, 29 June 2021 at 11:23:40 UTC-7 John MacFarlane wrote: 
>>>> > 
>>>> >> 
>>>> >> This isn't yet supported, really. But you might be able to 
>>>> >> work around it. 
>>>> >> 
>>>> >> Note: 
>>>> >> 
>>>> >> % pandoc -f latex -t native 
>>>> >> \ref{foo} 
>>>> >> ^D 
>>>> >> [Para [Link ("",[],[("reference-type","ref"),("reference","foo")]) 
>>>> [Str 
>>>> >> "[foo]"] ("#foo","")]] 
>>>> >> 
>>>> >> So when pandoc parses \ref{foo}, it doesn't just create a string 
>>>> >> [foo]; it creates a link with attributes. You could use a lua 
>>>> >> filter to turn this into something that mathjax can consume 
>>>> >> (raw tex, I would imagine). 
>>>> >> 
>>>> >> Just let us know what you want to appear in the HTML, and we can 
>>>> >> show you how to do it. 
>>>> >> 
>>>> >> Ian Price <ianpr...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes: 
>>>> >> 
>>>> >> > Hello, 
>>>> >> > My university is looking into the options for converting various 
>>>> notes, 
>>>> >> > exercises sheets, presentations, etc. from latex generated pdf 
>>>> into a 
>>>> >> more 
>>>> >> > accessible format. This basically means converting to html + 
>>>> mathjax 
>>>> >> > because this tends to work better for screen readers. Converting 
>>>> beamer 
>>>> >> > seems to be impossible, but for notes pandoc (and some others like 
>>>> >> latexml) 
>>>> >> > is generally giving good output, however the major issue is cross 
>>>> >> > referencing between text and maths blocks. 
>>>> >> > 
>>>> >> > In short, mathjax can handle internal links from maths blocks to 
>>>> other 
>>>> >> > maths blocks, and pandoc can handle links to other parts of pandoc 
>>>> >> > documents, except when a document makes specific reference to an 
>>>> >> equation. 
>>>> >> > For example, suppose we have the following mwe.tex cut out from 
>>>> some 
>>>> >> > electromagnetism notes 
>>>> >> > --- 
>>>> >> > \documentclass[12pt]{article} 
>>>> >> > \begin{document} 
>>>> >> > \begin{equation} 
>>>> >> > J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>>>> >> > \label{volume-current-density} 
>>>> >> > \end{equation} 
>>>> >> > The total current crossing a surface $S$ can be calculated by 
>>>> >> integrating 
>>>> >> > Eq. (\ref{volume-current-density}): 
>>>> >> > \end{document} 
>>>> >> > --- 
>>>> >> > When converted to markdown, we get the following 
>>>> >> > --- 
>>>> >> > $$J \equiv \frac{dI}{da_{\perp}} = \rho v. 
>>>> >> > \label{volume-current-density}$$ 
>>>> >> > 
>>>> >> > The total current crossing a surface $S$ can be calculated by 
>>>> >> > integrating Eq. 
>>>> >> > 
>>>> >> 
>>>> ([\[volume-current-density\]](#volume-current-density){reference-type="ref" 
>>>> >> > reference="volume-current-density"}): 
>>>> >> > --- 
>>>> >> > The link to the label volume-current-density is clearly broken and 
>>>> when 
>>>> >> I 
>>>> >> > get my html file it does nothing in particular. 
>>>> >> > 
>>>> >> > One solution I've seen is to convert the label references to the 
>>>> syntax 
>>>> >> > used by, e.g., pandoc-crossref, but this involves me editing the 
>>>> >> markdown 
>>>> >> > by hand. Is there an automatic way to convert these? 
>>>> >> > 
>>>> >> > -- 
>>>> >> > You received this message because you are subscribed to the Google 
>>>> >> Groups "pandoc-discuss" group. 
>>>> >> > To unsubscribe from this group and stop receiving emails from it, 
>>>> send 
>>>> >> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>>> >> > To view this discussion on the web visit 
>>>> >> 
>>>> https://groups.google.com/d/msgid/pandoc-discuss/733e0d35-b1c4-4380-bf9f-7d6523c55162n%40googlegroups.com 
>>>> >> . 
>>>> >> 
>>>> > 
>>>> > -- 
>>>> > You received this message because you are subscribed to the Google 
>>>> Groups "pandoc-discuss" group. 
>>>> > To unsubscribe from this group and stop receiving emails from it, 
>>>> send an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>>> > To view this discussion on the web visit 
>>>> https://groups.google.com/d/msgid/pandoc-discuss/d3a1fa02-147c-45c2-8ee1-462db48baa44n%40googlegroups.com. 
>>>>
>>>>
>>>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/35c2cafd-f1e2-401a-803b-ea8bac75753en%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 13033 bytes --]