[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <d54415bb-9bad-6fd8-5636-218c04d5615a@gmail.com>
Date: Sat, 9 Jul 2022 00:27:25 +0900
From: Akira Yokosawa <akiyks@...il.com>
To: Mauro Carvalho Chehab <mchehab@...nel.org>
Cc: ksummit-discuss@...ts.linuxfoundation.org,
linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
mchehab+huawei@...nel.org, Jonathan Corbet <corbet@....net>,
Akira Yokosawa <akiyks@...il.com>
Subject: Re: Expectation to --no-pdf option (was Re: [PATCH v2 0/5] Address
some issues with sphinx detection)
On Fri, 8 Jul 2022 15:59:10 +0100,
Mauro Carvalho Chehab wrote:
> Em Fri, 08 Jul 2022 08:02:52 -0600
> Jonathan Corbet <corbet@....net> escreveu:
>
>> Akira Yokosawa <akiyks@...il.com> writes:
>>
>>> In my tests, the mathjax extension works with all the versions of Sphinx
>>> I tested (1.7.9, 2.4.4, 3.4.3 (debian bullseye), 4.2.0 (openSUSE LEAP 15.4),
>>> and 5.0.2).
>>> Note that math expressions should look much sharper (vector fonts)
>>> than those from imgmath (pixel images).
>>> The time for a browser to complete the rendering might be longer than
>>> with imgmath, especially for pages with a lot of math expressions,
>>> though. (Yes, I see some of media documents have a lot of them.)
>>>
>>> When you are detached from network connections, browsers will give
>>> up and show those expressions in mathjax source code.
>
>> -extensions.append("sphinx.ext.imgmath")
>> +extensions.append("sphinx.ext.mathjax")
>
> There are two problems with this:
>
> 1. mathjax doesn't work for PDF output - nor would work if we add support
> for man pages some day;
Hmm, if I understand what is written in the following page:
https://www.sphinx-doc.org/en/master/usage/extensions/math.html
, both imgmath and mathjax extensions are relevant only for HTML output.
It says:
Changed in version 1.8: Math support for non-HTML builders is integrated
to sphinx-core. So mathbase extension is no longer needed.
When did you see the issue of "mathjax doesn't work for PDF output" ?
> 2. Some Kernel developers disable javascript.
OK, mathjax has no chance, then...
Thanks, Akira
Powered by blists - more mailing lists