uk.ac.ed.ph.snuggletex.upconversion

类 MathMLUpConverter

java.lang.Object

uk.ac.ed.ph.snuggletex.upconversion.MathMLUpConverter

public class MathMLUpConverter
extends java.lang.Object

Standalone utility class for "up-converting" MathML Documents created by either SnuggleTeX or ASCIIMathML as follows:

• Presentation MathML is "enhanced" with extra semantics
• Conversion to Content MathML is optionally attempted (assuming PMathML follows certain conventions)
• Conversion to Maxima input is optionally attempted (assuming PMathML follows certain conventions)

This can be invoked within the normal SnuggleTeX parsing process using by adding a UpConvertingPostProcessor to the List returned by DOMOutputOptions.getDOMPostProcessors().

Usage Notes

• If the up-conversion process fails because the input cannot be understood, you can find out what went wrong by passing the resulting Document to UpConversionUtilities.extractUpConversionFailures(Document), to get a List of UpConversionFailure Objects that can be inspected further.
• An implementation of this class is thread-safe
• If you use XSLT in your own application, consider using the constructor that takes a StylesheetCache to integrate with your own caching mechanism.
• If you don't use XSLT in your own application, you can use the default constructor that creates a cache used by the instance of this class. In this case, you'll want to ensure your instance has "application-wide" context to maximise performance.

从以下版本开始:

1.1.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ASCIIMATH_INPUT_ANNOTATION_NAME
static java.lang.String	BRACKETED_PRESENTATION_MATHML_ANNOTATION_NAME
static java.lang.String	CONTENT_FAILURES_ANNOTATION_NAME
static java.lang.String	CONTENT_MATHML_ANNOTATION_NAME
static java.lang.String	LATEX_ANNOTATION_NAME
static java.lang.String	MAXIMA_ANNOTATION_NAME
static java.lang.String	MAXIMA_FAILURES_ANNOTATION_NAME
static java.lang.String	SNUGGLETEX_ANNOTATION_NAME

构造器概要

构造器

构造器和说明
MathMLUpConverter() Creates a new up-converter using a simple internal cache, hard-coded to use Saxon for XSLT 2.0 support.
MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.StylesheetCache stylesheetCache) Creates a new up-converter using the given StylesheetCache to cache internal XSLT stylesheets, hard-coded to use Saxon for XSLT 2.0 support.
MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.StylesheetManager stylesheetManager) Creates a new up-converter using the given StylesheetManager for managing XSLT stylesheets and stuff.
MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.TransformerFactoryChooser transformerFactoryChooser, uk.ac.ed.ph.snuggletex.utilities.StylesheetCache stylesheetCache) Creates a new up-converter using the given TransformerFactoryChooser and StylesheetCache to cache internal XSLT stylesheets.

方法概要

限定符和类型	方法和说明
org.w3c.dom.Document	upConvertASCIIMathML(org.w3c.dom.Document asciiMathMLDocument, UpConversionOptions upConversionOptions) Up-converts the ASCIIMathML output represented by the given Document.
org.w3c.dom.Document	upConvertASCIIMathML(java.lang.String rawASCIIMathML, UpConversionOptions upConversionOptions) Convenience version of upConvertASCIIMathML(Document, UpConversionOptions) that takes the raw ASCIIMathML as a String.
org.w3c.dom.Document	upConvertSnuggleTeXMathML(org.w3c.dom.Document document, UpConversionOptions upConversionOptions) Up-converts the SnuggleTeX XHTML output Document (assumed to contain islands of MathML), creating a new result Document.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

SNUGGLETEX_ANNOTATION_NAME

public static final java.lang.String SNUGGLETEX_ANNOTATION_NAME

另请参阅:

常量字段值

LATEX_ANNOTATION_NAME

public static final java.lang.String LATEX_ANNOTATION_NAME

另请参阅:

常量字段值

BRACKETED_PRESENTATION_MATHML_ANNOTATION_NAME

public static final java.lang.String BRACKETED_PRESENTATION_MATHML_ANNOTATION_NAME

另请参阅:

常量字段值

CONTENT_MATHML_ANNOTATION_NAME

public static final java.lang.String CONTENT_MATHML_ANNOTATION_NAME

另请参阅:

常量字段值

CONTENT_FAILURES_ANNOTATION_NAME

public static final java.lang.String CONTENT_FAILURES_ANNOTATION_NAME

另请参阅:

常量字段值

MAXIMA_ANNOTATION_NAME

public static final java.lang.String MAXIMA_ANNOTATION_NAME

另请参阅:

常量字段值

MAXIMA_FAILURES_ANNOTATION_NAME

public static final java.lang.String MAXIMA_FAILURES_ANNOTATION_NAME

另请参阅:

常量字段值

ASCIIMATH_INPUT_ANNOTATION_NAME

public static final java.lang.String ASCIIMATH_INPUT_ANNOTATION_NAME

另请参阅:

常量字段值

构造器详细资料

MathMLUpConverter

public MathMLUpConverter()

Creates a new up-converter using a simple internal cache, hard-coded to use Saxon for XSLT 2.0 support.

Use this constructor if you don't use XSLT yourself. In this case, you'll want your instance of this class to be reused as much as possible to get the benefits of caching.

MathMLUpConverter

public MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.StylesheetCache stylesheetCache)

Creates a new up-converter using the given StylesheetCache to cache internal XSLT stylesheets, hard-coded to use Saxon for XSLT 2.0 support.

Use this constructor if you do your own XSLT caching that you want to integrate in, or if the default doesn't do what you want.

MathMLUpConverter

public MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.TransformerFactoryChooser transformerFactoryChooser,
                         uk.ac.ed.ph.snuggletex.utilities.StylesheetCache stylesheetCache)

Creates a new up-converter using the given TransformerFactoryChooser and StylesheetCache to cache internal XSLT stylesheets.

Use this constructor if you do your own XSLT caching that you want to integrate in, or if the default doesn't do what you want and/or if you want to override the choice of Saxon for XSLT 2.0 support (which is currently a bad idea!)

参数:

transformerFactoryChooser - TransformerFactoryChooser to use, which must not be null.

stylesheetCache - StylesheetCache to use, which may be null to avoid caching.

MathMLUpConverter

public MathMLUpConverter(uk.ac.ed.ph.snuggletex.utilities.StylesheetManager stylesheetManager)

Creates a new up-converter using the given StylesheetManager for managing XSLT stylesheets and stuff.

方法详细资料

upConvertSnuggleTeXMathML

public org.w3c.dom.Document upConvertSnuggleTeXMathML(org.w3c.dom.Document document,
                                                      UpConversionOptions upConversionOptions)

Up-converts the SnuggleTeX XHTML output Document (assumed to contain islands of MathML), creating a new result Document.

参数:

document - DOM Document, assumed to have been generated by SnuggleSession.buildDOMSubtree() or similar.

upConversionOptions - UpConversionOptions to use, or null to use defaults.

upConvertASCIIMathML

public org.w3c.dom.Document upConvertASCIIMathML(org.w3c.dom.Document asciiMathMLDocument,
                                                 UpConversionOptions upConversionOptions)

Up-converts the ASCIIMathML output represented by the given Document. This would normally consist of a single MathML element, but can be arbitrary XML containing MathML islands.

参数:

asciiMathMLDocument - DOM Document, assumed to have been generated by ASCIIMathML

upConversionOptions - UpConversionOptions to use, or null to use defaults.

upConvertASCIIMathML

public org.w3c.dom.Document upConvertASCIIMathML(java.lang.String rawASCIIMathML,
                                                 UpConversionOptions upConversionOptions)

Convenience version of upConvertASCIIMathML(Document, UpConversionOptions) that takes the raw ASCIIMathML as a String. You would normally extract this from ASCIIMathML using some of our JavaScript helper functions.

参数:

rawASCIIMathML - ASCIIMathML output string

upConversionOptions - UpConversionOptions to use, or null to use defaults.