Struct MathML 

pub struct MathML { /* private fields */ }

MathML post-processor.

Port of LaTeXML::Post::MathML. Handles both Presentation and Content MathML conversion.

Implementations

impl MathML

pub fn new_presentation() -> Self

Create a Presentation MathML processor.

pub fn new_content() -> Self

Create a Content MathML processor.

pub fn with_intent_literal(self, enable: bool) -> Self

Enable intent=“:literal” on all <math> elements. Perl: ar5iv.sty.ltxml monkey-patches outerWrapper for this.

pub fn with_linebreaking(self, width: u32) -> Self

Enable line-breaking with the given width.

pub fn with_keep_xmath(self, keep: bool) -> Self

Keep XMath nodes in the output alongside MathML.

pub fn with_invisible_times(self, emit: bool) -> Self

Set whether to emit invisible times (U+2062) in MathML output. When false, invisible times is replaced with zero-width space (U+200B). Perl: –noinvisibletimes

pub fn with_plane1(self, plane1: bool, hack_plane1: bool) -> Self

Set the Plane-1 remapping mode. plane1 off keeps ASCII text plus a mathvariant attribute; hack_plane1 remaps only the poorly-supported variants and implies plane1. Perl --plane1 / --hackplane1.

pub fn with_mathtex(self, enable: bool) -> Self

Enable TeX source annotation in MathML output (–mathtex).

pub fn secondary(self) -> Self

Mark this processor as a parallel-markup secondary (e.g. the Content-MathML format under a Presentation primary). Secondaries get their format-specific id_suffix and are folded into the primary’s <m:semantics> rather than emitted as a standalone <m:math>. Port of MathProcessor’s secondary role.

pub fn with_secondaries(self, secondaries: Vec<Box<dyn MathProcessor>>) -> Self

Attach parallel-markup secondaries to this (primary) processor. Their conversions are merged into one <m:semantics> by combine_parallel during the primary’s pass. Mirrors Perl MathProcessor’s primary holding its parallel secondaries.

Trait Implementations

impl MathProcessor for MathML

fn convert_node( &self, doc: &PostDocument, xmath: &Node, ) -> Option<MathConversion>

Convert an XMath node to this processor’s format.

fn combine_parallel( &self, _doc: &PostDocument, xmath: &Node, primary: MathConversion, secondaries: Vec<MathConversion>, ) -> MathConversion

Combine parallel markup from primary conversion + secondaries.

fn outer_wrapper( &self, _doc: &PostDocument, xmath: &Node, conversion: NodeData, ) -> NodeData

Wrap the converted XML in the appropriate outer element (e.g., m:math).

fn raw_id_suffix(&self) -> &str

Raw ID suffix for this format (e.g., “.pmml”, “.cmml”, “.om”). Primary format returns empty string; secondaries return their suffix.

fn is_secondary(&self) -> bool

Whether this processor is a secondary (parallel) processor.

fn can_convert(&self, _doc: &PostDocument, math: &Node) -> bool

Whether this processor can convert the given math node. Default: always true.

fn parallel_secondaries(&self) -> &[Box<dyn MathProcessor>]

Parallel-markup secondaries held by this (primary) processor. During the primary’s process_math_node, each secondary’s convert_node runs against the still-live XMath and the results are folded into one <m:semantics> via combine_parallel. Empty by default (standalone, single-format). Port of Perl MathProcessor’s primary→secondary parallel model.

fn preprocess(&self, _doc: &PostDocument, _nodes: &[Node])

Optional preprocessing before conversion begins.

fn id_suffix(&self) -> &str

ID suffix: empty for primary, raw_id_suffix for secondary.

impl Processor for MathML

fn get_name(&self) -> &str

Human-readable name for this processor.

fn to_process(&self, doc: &PostDocument) -> Vec<Node>

Return the nodes to be processed; by default the document element. This allows processors to focus on specific kinds of nodes, or to skip processing if there are none to process.

fn process(&mut self, doc: PostDocument, nodes: Vec<Node>) -> ProcessResult

Process the document given the nodes returned by to_process. Returns the resulting document(s) — splitting may produce multiple.

fn resource_directory(&self) -> Option<&str>

Resource directory for generated resources (images, etc.).

fn resource_prefix(&self) -> Option<&str>

Resource prefix for generated resource filenames.

fn desired_resource_pathname( &self, _doc: &PostDocument, _node: &Node, _source: Option<&str>, _type_ext: Option<&str>, ) -> Option<PathBuf>

Hint for a desired resource pathname.

fn generate_resource_pathname( &self, doc: &mut PostDocument, _node: &Node, _source: Option<&str>, type_ext: Option<&str>, ) -> PathBuf

Auto-generate a unique resource pathname using a counter from the doc cache.