[logo_color]

BD Tech Concepts llc

-HTML5 Generation — lwarp package

[lwarp_logo]

Lwarp technology whitepaper

For an introduction to the technology used to create the lwarp package, please see the publication Producing HTML directly from : the lwarp package.

Latest News
Sample Output
This website:

  • • Check the html code of these web pages for examples of the lwarp generator’s output.

  • • Download a 7 MB pdf print version of this website, to compare with the online html version.

Technical-book conversion:

Print PDF:

Introduction to Gear Design — Print — pdf

Tablet PDF:

Introduction to Gear Design — Tablet — pdf

HTML version:

Introduction to Gear Design — Website — html

Sample camping trailer manual:

PDF print version:

Camping Trailer Manual — pdf

HTML version:

Camping Trailer Manual — html

Download

Download the lwarp package from the lwarp page on CTAN — the Comprehensive Archive Network, or use your distribution’s update tools.

The lwarp v0.41 manual is also available here.

Supported Packages

Table 1 lists some of the various features which may be used. In addition, more than 140 packages have been adapted for lwarp, and many more work without modification.

Table 1: –HTML generation — lwarp package — Supported functions

Category

Status

Engines:

pdf, , Lua

Classes:

book, report, or article. memoir is planned.

Page layout:

Emulates geometry, fancyhdr, titleps, addlines, anysize, a4, a4wide, a5comb, textarea, zwpagelayout, typearea, ebook.

Sectioning:

Supported, with hyperlinks. Honors tocdepth and secnumdepth. Adds FileDepth for splitting the html output. Files may be numbered sequentially or named according to section name. Common short words and punctuation is removed from the filenames. Emulates titlesec, fncychap, sectsty, anonchap, quotchap.

Table of contents, figures, tables:

Supported, with hyperlinks. Supports tocbibind. Emulates titletoc and tocloft.

Title page:

\maketitle, titlepage, titling, authblk.

Front & back matter:

abstract, appendix

Indexing:

texindy is used, with hyperlinks. idxlayout is emulated.

Glossary:

glossaries and xindy are used.

Bibliography:

Supported text-only.

Cross-references:

Emulated, with hyperlinks. hyperref, cleveref, varioref, url.

Languages:

babel. (polyglossia is untested.)

Margin notes:

marginfit, marginfix.

Footnotes:

footnote, footmisc, marginnote, sidenote, pagenote, endnotes.

Math:

Supported. Converted to svg images with html ALT tags containing the source for the math expression. MathJax supported as an alternative. environments are supported. User-defined macros are available during converson, due to native processing.

Theorems:

Support for native theorems, plus theorem, amsthm, ntheorem.

Add’l math:

delarray, bm, math fonts via svg images.

Units and fractions:

siunitx, xfrac, nicefrac, units

Floats:

Appear where declared. float, rotfloat, newfloat, caption and subcaption, subfig, capt-of, placeins, trivfloat, floatrow, subfloat, keyfloat, wrapfig, cutwin, floatflt.

Tabular

tabular environment, array, tabularx, tabulary, threeparttable, multirow, longtable, supertabular, xtab, booktabs.

Graphics

graphics and graphicx are emulated. \includegraphics supports width, height, origin, angle, and scale tags, and adds class. References to pdf files are changed to svg, other image types are accepted as well. \rotatebox and \scalebox are supported as well as html can handle. grffile is supported.

rotating:

Emulated. All objects are displayed unrotated.

picture and tikz:

Converted to an svg image.

xcolor:

Supported. Full package color names, any color models, and mixing. \textcolor, \colorbox, \fcolorbox. Enhanced for html compatibility.

Lists:

Standard environments are supported, along with enumitem, enumerate, paralist. Spacing is still controlled by css.

Environments:

Standard environments are supported.

minipage:

Supported with some html5-imposed limitations. Nested minipages are supported. Footnotes appear at the bottom of the html page.

Quotations:

verse, csquotes, epigraph

Verbatim:

verbatim, moreverb, fancyvrb (except for verbatim footnotes).

Frames:

framed, fancybox, mdframed, boxedminipage2e, shadow.

multicol:

Emulated, with css3. Converted to up to three columns with an optional heading, per browser support. Single-column if unsupported.

fullwidth:

Emulated.

Direct formatting:

\emph, \textsuperscript, \textbf, etc are supported. \bfseries, etc. are not yet supported. lettrine, ulem, soul, relsize, scalefnt, and realscripts are supported.

Ordinals:

nth, fmtcount, and engord are supported.

Text ligatures:

Ligatures for symbols are supported. Ligatures for f, q, t are intentionally turned off because many simpler browsers do not display them correctly. Modern full-featured browsers re-create these ligatures on-the-fly.

Horizontal space:

html output for thin-unbreakable, unbreakable, \enskip, \quad, \qquad, \hspace.

Rules:

\rule with width, height, raise, text color.

html reserved characters:

\&, \textless, and \textgreater are converted to html entities.

Fonts:

Used as-is. Appear in math expressions or embedded image environments.

Symbols:

Native diacriticals, textcomp.

Working as-is:

Various utility, calculation, file, and text-only packags, such as calc, fileerr, somedefs, trace, xspace.

Where:

Supported:

The existing package is used.

Emulated:

The package is not used, but some/all of its functions are emulated. Null functions, lengths, and counters are provided for source compatibility.