Click the following links to view the same source document in several web-friendly WebWorks ePublisher output formats.
We generated all the samples in a single WebWorks ePublisher project. Each output generation required only a couple button clicks, and less than two minutes of processing time. Following generation, we uploaded the raw outputs to this site. We did not post-edit the outputs in any way.
We deliberately selected conservative formatting options for most of the samples, typical for technical documentation websites. Add some bright colors or a designer theme, and these formats can be suitable for the snazziest website. In addition to the illustrated output formats, WebWorks can generate outputs such as wiki content, Eclipse Help, JavaHelp, and EPUB for e-book readers.
Reverb 2 and Reverb 1 are fast-performing web-friendly formats based on HTML 5 and CSS 3 technology. They feature a responsive user interface that auto-adapts to the display environment. As you view the samples, try changing the size of the browser window. In a large window, Reverb displays a TOC on the left. In a small window, users can click the Contents button to view the TOC. Users can view Reverb on any operating system or browser, from desktop to iPhone or Android. You can deploy Reverb to a web server, or you can install Reverb locally on the user's computer.
Optionally, Reverb integrates with Google Site Search, Google Analytics, and social media. Users can click the Disqus button to enter comments and questions about the pages, or they can link to Facebook and Tweeter to discuss your product. They can even use the Google Translate integration to read your content in French or Japanese!
For an additional sample, see the WebWorks documentation in the Reverb 2 format on the webworks.com site.
The WebWorks Help format has a classic tripane appearance. Users can view WebWorks Help in any browser from a website, or in most browsers when the help is installed locally on the user's computer. WebWorks Help is recommended for content that users will view on desktop or laptop monitors.
The DHTML format provides single-frame pages suitable for posting on any site. With an optional TOC and Index, it is suitable for both technical documentation and general websites. Users can view DHTML in any browser, either locally or on a remote server.
Microsoft HTML Help 1.x (CHM)
For comparison with the web-friendly formats described above, click here to download a CHM output of the same source document. To overcome Windows security restrictions on CHM files, unzip to a local drive, not to a network drive. You might need to right-click the CHM file, and choose Properties > General > Unblock. You can then double-click and view the CHM.
CHM is an excellent tripane help format for applications that are installed locally on Windows computers. CHMs cannot be viewed over a network or from a web server.
PDF in WYSIWYG or Configurable Formats
If you author in Word or FrameMaker, ePublisher can generate WYSIWYG PDF output. In the example illustrated here, the PDF is ready for professional two-sided printing. It has the original layout, fonts, blank pages, cropmarks, and odd/even headers and footers that exist in the Word source document. It has a bookmark tree, visible by clicking a navigation icon. We could have generated the same PDF in Adobe Acrobat. If we intended to display the WYSIWYG PDF on a product web page, we would take an extra minute to open the generated file in Acrobat and crop it to the marks.
If you author in DITA XML, you must configure how the XML elements will be displayed in the PDF output. Even if you author in Word or FrameMaker, you might want to generate PDFs that look different from the source. For example, you might want to generate PDFs in the style of an OEM partner who resells your product. Here is a sample configurable PDF that we generated in ePublisher. Notice that the layout, fonts, page size, headers, and footers are totally different from the WYSIWYG PDF of the same Microsoft Word source. There are no blank pages or cropmarks. The configurable PDF is ready for web display.
For More Information
For more information about WebWorks ePublisher, call AlmondWeb at +972-2-5712246 (Israel, GMT+2 hours) or write to .