Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add MathML examples #2463

Open
32 tasks
NiedziolkaMichal opened this issue Feb 27, 2023 · 2 comments
Open
32 tasks

Add MathML examples #2463

NiedziolkaMichal opened this issue Feb 27, 2023 · 2 comments
Labels
good first issue A good issue for newcomers to get started with. idle Issues and pull requests with no activity for three months.

Comments

@NiedziolkaMichal
Copy link
Member

NiedziolkaMichal commented Feb 27, 2023

It is now possible to add MathML interactive examples. Anyone interested is welcome to contribute. Ideally, we would have examples for all of those elements:

MathML element examples should be placed in live-examples/mathml-examples/elements. Each example should be included in meta.json, where it should have the following structure:

    "ELEMENT_NAME": {
      "exampleCode": "./live-examples/mathml-examples/elements/ELEMENT_NAME.html",
      "fileName": "ELEMENT_NAME.html",
      "title": "MathML Demo: <ELEMENT_NAME>",
      "type": "mathml",
      "height": "EXAMPLE_HEIGHT",
      "tabs": "html"
    }

The value of EXAMPLE_HEIGHT might be tabbed-shorter, tabbed-standard, or tabbed-taller. The smallest possible height should be chosen, in which the vertical scrollbar is not shown.

@fred-wang

@NiedziolkaMichal NiedziolkaMichal added the good first issue A good issue for newcomers to get started with. label Feb 27, 2023
@NiedziolkaMichal NiedziolkaMichal pinned this issue Feb 27, 2023
@github-actions github-actions bot added the idle Issues and pull requests with no activity for three months. label Mar 30, 2023
@yarusome
Copy link

Apart from the fact that a few elements listed here are deprecated / deferred to MathML 4 or have no visual effect, the crucial question is: In what form should these live examples be to make them useful?

Mathml markups are not like HTML ones in that one can make edits to the content enclosed by tags in HTML to see what differences they make, whereas even tiny edits to Mathml content can lead to semantically incorrect markups, e.g.

<mi>a</mi><mo>+</mo><mi>b</mi>

is correct, but

<mi>a</mi><mo>+</mo><mi>bc</mi>

is not. This is understandable as MathML contents are almost never manually authored.

Therefore, it seems better to provide some basic authoring tools to indirectly interact with these examples.

@github-actions github-actions bot removed the idle Issues and pull requests with no activity for three months. label Apr 1, 2023
@github-actions github-actions bot added the idle Issues and pull requests with no activity for three months. label May 1, 2023
@GELO1234567
Copy link

May what date?

@github-actions github-actions bot removed the idle Issues and pull requests with no activity for three months. label Oct 29, 2023
@github-actions github-actions bot added the idle Issues and pull requests with no activity for three months. label Nov 28, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue A good issue for newcomers to get started with. idle Issues and pull requests with no activity for three months.
Projects
None yet
Development

No branches or pull requests

3 participants