Scripta compiler

Compile Scripta markup to Html, and export it to LaTeX.

The package exposes two modules:

• Scripta — options, parsing (including incremental re-parsing after edits), rendering, and export to Html and LaTeX.
• Scripta.Document — questions about a parsed document: its title, whether it has sections, and the mapping between rendered ids and source text.

Rendering

import Scripta

-- One shot: parse and render.
view source =
    let
        output =
            Scripta.compile Scripta.defaultOptions source
    in
    Html.div [] (output.title :: output.body)

render and compile return an Output Event: the rendered title, body, toc and an optional banner. Event describes clicks on paragraphs, footnotes, citations, images and links; use Scripta.mapEvent to turn it into your own message type.

For an editor, parse once and keep the Document in your model. reparse, applyEdit and applyEdits bring it up to date after an edit, reusing the unchanged parts.

Options are built from defaultOptions with withTheme, withWindowWidth, withContentWidth, withTOC, withMaxLevel, withSizing and withFilter.

Export

• Scripta.exportHtml options document — a standalone Html page.
• Scripta.exportLaTeX { title, authors } document — a complete LaTeX document, ready for xelatex.
• Scripta.exportRawLaTeX document — the LaTeX body only, without the preamble.
• Scripta.prettyPrint source — Scripta source rewritten with standard indentation and spacing.

Math

Math is emitted as <math-text> custom elements with two properties: content (the TeX source) and display (True for display math). The host page must define math-text; without it, math is not typeset. Demo/index.html defines it with KaTeX.

Demo

Demo/ is a live-preview editor built on the package. It is an application with its own elm.json that compiles the package from ../src, so it always shows the current source:

cd Demo
elm make src/Main.elm --output=main.js
open index.html

Development

elm make --docs=docs.json   # build and check the documentation
elm-test                    # run the tests (elm-test 0.19.2-0 for elm 0.19.2)