Skip to content

improved HTML rendering of the ASL Reference with MathJax - #1906

Draft
Roman-Manevich wants to merge 1 commit into
masterfrom
alsreference-html
Draft

improved HTML rendering of the ASL Reference with MathJax#1906
Roman-Manevich wants to merge 1 commit into
masterfrom
alsreference-html

Conversation

@Roman-Manevich

Copy link
Copy Markdown
Collaborator

Improved the HTML version of the ASL Reference via MathJax.

This PR is AI-assisted.

@hrutvik

hrutvik commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

The HTML that renders correctly does indeed look much improved. However, a very brief inspection shows various bugs - e.g. in screenshots attached, missing quotes around the tokens "(" and ")", and bad rendering of listmap and rangelistop
image
image

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really want to check in all of this content?

Comment thread asllib/doc/Makefile
Comment on lines +41 to +43
python3 $(HEVEA_DIR)/generate_mathjax_config.py $(MATHJAX_CONFIG_JS) HTML/ASL.html
cd HTML && hacha ASL.html
python3 $(HEVEA_DIR)/generate_mathjax_config.py $(MATHJAX_CONFIG_JS) HTML/ASL[0-9][0-9][0-9].html

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we need to run the Python script twice? Could we not run it on the split-up output only?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is quite difficult to review, and I worry about our ability to maintain and stand behind it. Is all of it necessary? Can it be minimised somehow?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants