3.2 KiB
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
- notes:
Dependencies
- rtf.js requires:
- js-codepage (Apache 2.0 license, included in the rtf.js bundle)
- 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.
Build with watch mode
For development purposes you can start a watch, which will build the project, serve the sample pages on localhost:8080 and automatically recompile and reload the sample page if you make a code change. This can be started with:
$ npm run watch
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 and npm run build to build the code to be tested
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.
Releasing
See the Release Instructions for details.