logo_color

BD Tech Concepts llc

-HTML5 Generation — lwarp package

lwarp_logo.svg

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.32 manual is also available here.

Supported Packages

Table 1 lists some of the various features which may be used. In addition, more than 90 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.

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.

Table of Contents, Figures, Tables:

Supported, with hyperlinks.

Title page:

\maketitle, titlepage, titling. Optional titling-based commands for published and subtitle.

abstract:

Supported

Cross-references:

Emulated, with hyperlinks.

hyperref:

Emulated. html hyperlinks are generated for toc, lof, lot, \nameref, \ref, the cleveref commands, and index entries.

Footnotes:

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

Indexing:

texindy is used, with hyperlinks.

Glossary:

glossaries and xindy are used.

Bibliography:

Supported, without hyperlinks so far.

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.

Floats:

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

tabular:

Emulated. \multirow and \multicolumn are available, but cannot be used at the same time. Nested tables are not supported.

array:

Supported inside math environments, emulated elsewhere.

tabularx, tabulary, threeparttable, multirow:

Emulated.

longtable:

Emulated. Converted to a tabular. Captions supported. Extra headings and \kill lines must be enclosed in \warpprintonly{}

booktabs:

Emulated. \toprule and \bottomrule form black rules, \midrule forms silver rules, as demonstrated on this table. \cmidrule, demonstrated at this line, does not use width or trim options.

graphics, graphicx:

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.

rotating:

Emulated. All objects are displayed unrotated.

Lists:

Supported

enumitem:

Supported, although spacing is still controlled by css.

Environments:

Standard environments are supported.

picture and tikz:

Converted to an svg image.

minipage:

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

fancyvrb:

Supported except for verbatim footnotes.

framed, mdframed:

Supported

multicol:

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

siunitx:

Supported except for per-mode=fraction.

xfrac:

Supported

Direct formatting:

\emph, \textsuperscript, \textbf, etc are supported. \bfseries, etc. are not yet supported. lettrine, ulem, and soul 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.

xcolor:

Supported. Full package color names, any color models, and mixing is converted to hex web colors via \convertcolorspec. Patched commands are \textcolor, \colorbox, and \fcolorbox. \pagecolor is not supported.

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.