rtf.js

rtf.js

Render RTF documents in HTML. This also includes rendering WMF and EMF images which are often contained in RTF documents.

License

The code of this project is licensed under the MIT license. See the file LICENSE for details.

Using the library

For information on how to use the library see the Getting Started Guide

Live samples:

• RTF document rendering
• WMF image rendering
• EMF image rendering
• RTF document with external WMF image imports
  • notes:
    • this example uses a WinHelp (.hlp) file borrowed from an old Windows application
    • all of the data files are generated by WinHelp decompiler with the command-line:
      • HELPDECO.EXE HOMEAUDIOMETER.HLP /r /y /n

Dependencies

• rtf.js requires:
  • jquery
  • js-codepage (Apache 2.0 license, included in the rtf.js bundle)
• wmf.js and emf.js require:
  • jquery
  • jquery.svg.js plugin with the jquery.svgfilter.js extension.
• Rendering WMF and EMF images is accomplished by using HTML5's <svg> feature.
• Rendering RTF documents often requires rendering embedded WMF and EMF images, however rtf.js can be used without wmf.js and emf.js or with just one of them, if rendering such images is not required.

See the Getting Started Guide for details.

Developing

To develop first install the dependencies using npm install.

Building

To build the entire project and create the bundles run:

$ npm run build

Tests

Please run npm run lint first to make sure your code adheres to the style guide.

To run the test suite run:

$ npm run test

To create a new test (type is rtf, emf or wmf):

$ npm run generate-testcase type test-name /path/to/test.rtf

To regenerate the expected result for an existing test:

$ npm run regenerate-testcase type test-name

Code Coverage

To generate code coverage metrics run:

$ npm run coverage

Afterwards you can generate a nice html report in the coverage directory:

$ npm run coverage-html

Warning: creating coverage reports instruments the bundles in the dist directory. Don't forget to build the project again before committing.