Highlighting syntactic analysis in HTML

arsgrammatica includes utility functions to display a text in HTML with highlighting of its syntactic structure. First analyze a string or a passage.

Coloring by verbal expression

Once you have an analysis result, you can compose an HTML string that colors tokens by the verbal expression they belong to, using the same colors as arsgramamtica’s Mermaid diagrams.

from arsgrammatica import tokengraph_to_html
html = tokengraph_to_html(result.tokengraph)

(Use this in a web environment (like a Marimo notebook) to see the real results.)

Add indentation by depth of subordination

The tokengraph_to_depth_html function uses the same color highlighting as tokengraph_to_html, but instead of laying out the text in a single paragaph, it indents sequences of tokens by their level of subordination.

from arsgrammatica import tokengraph_to_depth_html
html, warnings = tokengraph_to_depth_html(result.tokengraph)

Limiting display by syntactic depth

Both tokengraph_to_html and tokengraph_to_depth_html accept an optional depth parameter. tokengraph_to_html will highlight only tokens at or below the specified syntactic depth; tokengraph_to_html entirely omits tokens above the cutoff depth. (These features are used interactively in the marimo notebooks to analyze passages and review analyses.)

# depth=0 limits the display to root/independent clauses only:
html, warnings = tokengraph_to_depth_html(result.tokengraph, depth=0)