[PD-dev] formatting HTML doc in Pd distro?

Wed Jul 3 08:14:03 CEST 2019

If the only show stopper for HTML is "typeset equations in native HTML" there's a workaround:

https://www.mathjax.org/<https://www.mathjax.org/#gettingstarted>

https://github.com/mathjax/MathJax

the only gotcha is that the "typeset equations" wont render on an offline browser.

Works by just including :

<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-MML-AM_CHTML' async></script>

in the <head> of the document.

Its fully documented and looks it is going to be there.  (if for some reason we need the local files it takes 40Mb)

It might be just what we want.

?

IOhannes ?

Test code:

'''''''

<!DOCTYPE html>
<html>
<head>
<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-MML-AM_CHTML' async></script>

</head>
<body>

<h1>big heading </h1>
<h2> h2 smaller heading </h2>

<p> paragraph ... when \( x < y \) we have ...

<p> paragraph 2 .. \[ \sum a b \]

<p> paragraph 3 .. \(\sum a b \)
</body>
</html>

''''''''

Mensaje telepatico asistido por maquinas.

On 7/2/2019 11:13 AM, Miller Puckette wrote:

Looks like the best thing will be to use either latex or markdown, and
include both the latex/markdown source and an HTML compiled version of
the doc in the git repo.  The doc will doubtless contain images of
patch fragments, taken from the help files, in a way similar to my
book (http://msp.ucsd.edu/techniques.htm).

cheers
M

for the images.  (Unless it's feasible to unify that with the help
On Tue, Jul 02, 2019 at 07:11:35AM +0000, Lucas Cordiviola wrote:

On 7/1/2019 5:46 AM, IOhannes m zmoelnig wrote:

i*strongly*  suggest to
- have **all** the sources (for*anything*  generated, including images)
in the git-repository
- allow to build all artifacts automatically?? (via the build-system)

I fail to see anything we can do to auto-generate single image files
from 1 or more LaTex file/s. This should be carefully and manually
handled by the author or the maintainer. There could be one master LaTex
file containing the code for each image if the source is to be stored:

''
figure 0.1.0
$saras \$whatever ...
figure 0.1.1
$ssgdsdg \$whatever ...
''

Since this is not automatic Miller should probably be in favor (and I
understand) of just writing everything on LaTex files instead of html.
Since I don't know how many "math formulas" are needed I don't know what
to say.

:)

Mensaje telepatico asistido por maquinas.

_______________________________________________
Pd-dev mailing list
Pd-dev at lists.iem.at<mailto:Pd-dev at lists.iem.at>
https://lists.puredata.info/listinfo/pd-dev

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puredata.info/pipermail/pd-dev/attachments/20190703/8c5388cc/attachment.html>