MathJax TC Minutes September 2017

[Peter Krautzberger]

Hi mathjax-dev,

Below are the notes for the TC meeting in September (sorry for the delay).

If you have questions as to the notes, please FIRST check out the recording on youtube for details before posting here.

The next TC meeting is scheduled for Oct 7.

Thanks,

Peter.

# 2017-09-07 MathJax TC Minutes September 2017

The recording is available at https://youtu.be/nePweqo-y4w

## Status update v3

* IN PROGRESS

  * HTML output

    * first large chunk landed in master

    * token nodes (not mglyph)

    * roots

    * fractions (preliminary)

    * stretchy constructions

    * font data tables

    * stylesheet generator

    * major TODOs: sub/sup, under/over, tables

    * minor TODOs: menclose, maction

  * TeX parser

    * refactoring is making good progress

    * new approach is slowly taking over the legacy code

## Considerations for a first public alpha

* v3 code is now usable (e.g., easily packaged, usable in NodeJS or in page)

* HTML output is close enough to real life in terms of code complexity

  * identify layout issues due to incompleteness which should be ignored

  * code issues (errors etc) should not be ignored

  * performance is now worth tracking

* decide how to publish the modules

* decide how to publish some builds for casual users

* On performance

  * we can now start tracking performance in detail

  * cleaner separation of mathjax and browser/layout performance

    * i.e., mathjax is done and has injected output into DOM vs browser layout is actually done rendering that

  * as the HTML output gained features, the slow down was more on the browser-end

  * rough idea:

    * 1200 equation sample (but some with missing features)

    * mathjax is done in 6s

      * [Addendum: ~4s but browser layout takes considerably longer]

* what kind of feedback would be useful at this stage?

  * primarily: feedback on separation of parts

    * e.g., is this useful for what you want to build with MathJax.

  * any bugs, integration issues

  * not so much: layout issues

  * feedback on the general "feel" of v3 would be good, e.g.,

    * the APIs as far as they already exist

    * the developer workflow

    * also interference, e.g., with CSS

* Is this the right time to try adapting v3 to virtual dom implementation?

  * Yes!

  * for writing into vdoms directly, utility/htmlnodes and utility/DOM should be the only (small) pieces you need to reimplement

  * but just using e.g. react's dangerouslySetInnerHTML would be a good to try as well

* Other requests before first alpha?

  * ALL: TeX input (even if still partially shimmed)

    * ok if we just pull in all legacy code for the alpha

## Other development updates

* MathJax v2.7.2 is out

  * please switch to it

* Mathjax-node v1.2.0 is out

  * `typeset` is now a dual callback/promise API

  * bug fix release ready

    * minor issue with CDN URL for webfonts in stylesheet

## ACTION items

* Team: create demos

*  Team: notes on HTML utility classes

[Peter Krautzberger]

Hi,

Following up on the action items from the last TC.

Note: this is all pre-alpha. You might create a small black hole or something. 

You've been warned.

1. branch

For layout, the latest (again: unmerged/unreviewed) branch is "munderover-support".

2. your first build

I added minimal document to the v3 repository wiki. It hopefully explains how to build a MathML+HTML distribution.

https://github.com/mathjax/mathjax-v3/wiki/A-first-usable-demo-(using-webpack)

If you have questions, please post on this thread.

3. util/HTMLNode.ts

For Paul Dlug (mostly) or others interested in vdom output. 

It (hopefully?) is enough to look at mathjax3-ts/util/HTMLNodes.ts

4. live page

I've pushed a demo build to an orphan branch "demo" and you can got to https://rawgit.com/mathjax/mathjax-v3/demo/demo/index.html

(Note: I spotted issue on webkit browsers. Try zooming in to make them show you all glyphs.)

Best,

Peter.

[Peter Krautzberger]

Correction on the minutes: 

The next meeting is on October 5.

On Sep 28, 2017 18:08, "Peter Krautzberger" <peter.kra...@mathjax.org> wrote:

Hi,

Following up on the action items from the last TC.

Note: this is all pre-alpha. You might create a small black hole or something. 

You've been warned.

1. branch

For layout, the latest (again: unmerged/unreviewed) branch is "munderover-support".

2. your first build

I added minimal document to the v3 repository wiki. It hopefully explains how to build a MathML+HTML distribution.

https://github.com/mathjax/mathjax-v3/wiki/A-first-usable-demo-(using-webpack)

If you have questions, please post on this thread.

3. util/HTMLNode.ts

For Paul Dlug (mostly) or others interested in vdom output. 

It (hopefully?) is enough to look at mathjax3-ts/util/HTMLNodes.ts

4. live page

I've pushed a demo build to an orphan branch "demo" and you can got to https://rawgit.com/mathjax/mathjax-v3/demo/demo/index.html

(Note: I spotted issue on webkit browsers. Try zooming in to make them show you all glyphs.)

Best,

Peter.