Jutoh - digital publishing for everyone

The Product
What users say




Jutoh Books

About Us



About Jutoh Plus

What is Jutoh Plus?
What can scripting be used for?
What operations are possible in a script?
Where is scripting documented?
What can I use HTML templates for?
Can I edit HTML templates within Jutoh?
Can I test Jutoh Plus with the standard demo?
Do I need to download a separate Jutoh version?
Sample scripts

What is Jutoh Plus?

Jutoh Plus is an enhanced edition that has several extra features:

  • Simple scripts for automating Jutoh operations;
  • an HTML template system;
  • support for creating application help files (HTB and CHM);
  • support for showing custom messages during compilation.
These features are not needed by the majority of authors, and so are omitted from the standard Jutoh user interface; Jutoh Plus is aimed particularly at publishers who edit a large number of books.

Scripts allow automation of tasks such as creating a Jutoh project, replacing content, setting metadata and configuration properties, and ebook generation. Scripts are not procedural and instead comprise groups of property/value pairs.

The HTML template system allows you customise ebook sections per section or project-wide, with the ability to edit and include JavaScript code and extra CSS.

The HTB/CHM creation feature lets developers add application help to wxWidgets or Windows applications as well as export Epub/Kindle/ODT files from the same project.

The custom compile messages feature lets you create libraries of presets that can match against issues in your projects, alerting you of issues such as blank paragraphs, suboptimal formatting, clichés and over-used words, commonly-used double words, and so on. This is a powerful proofing tool for saving time and increasing the quality of your books.

This page gives a flavour of what you can do with Jutoh Plus; for more details, you can read the full Jutoh Plus Guide.

What can scripting be used for?

These capabilities are especially useful when you are dealing with many ebooks. One scenario is coordinating incoming content that is formatted in DOCX or ODT to your specifications. You can outsource the editing to people who just use a regular word processor and who don't have to know how Jutoh works. You can then use scripts to convert the files you receive into Jutoh projects and various ebook formats, adding standard copyright notices, extra content, and covers; all without a lot of time-consuming manual operations.

Another use is to stamp a book with the customer's name to discourage redistribution or to make it more personal. This could be done on a web server, if necessary using a virtual X server such as Xvfb since Jutoh still needs a notional display to be present.

What operations are possible in a script?

This is what you can do in a script:

  • import from DOCX, ODT, HTML, Epub or text;
  • open an existing Jutoh project for modification;
  • specify how the input will be split into sections;
  • generate ebooks;
  • check the Epub after generation;
  • create multiple configurations, including more than one for the same basic format;
  • change section titles;
  • specify a cover or a different cover per configuration;
  • insert DOCX and ODT fragments into sections, putting the fragment at the start or end of a section or using a keyword to position it;
  • insert images from files;
  • replace text or paragraph styles based on a search for text or paragraph style;
  • merge an external style sheet with the default style sheet;
  • set string table values, for one configuration per command or all configurations at once;
  • set image properties.

Where is scripting documented?

Scripting is documented solely in the Jutoh Plus Guide, which you can find here.

What can I use HTML templates for?

These are some of the uses for the template system:
  • Adding JavaScript code;
  • replacing an entire section with manually written HTML;
  • adding pieces of HTML, such as a copyright notice, at the start or end of each section;
  • adding custom CSS to change the appearance of a particular section.

Can I edit HTML templates within Jutoh?

Yes, Jutoh has a built-in code editor. HTML templates are organised as 'assets' (fragments of text) which means you can divide up your code into parts that are then spliced into the main HTML template using special block markers. Code can come from the document assets or the project assets, and can be configuration-dependent, allowing a lot of flexibility for modular organisation and the reuse of a single project for targeting platforms with differing capabilities.

There is a new type of document, the source code document, which will embed files into the ebook that you can then reference from HTML templates. It too can be configuration-dependent.

Note that you can't edit the HTML that Jutoh generates, except by replacing it on a permanent basis. Normally, the generated HTML is inserted into the template when the ebook compilation. You can choose to remove the block marks and edit the HTML directly but it won't be regenerated.

Can I test Jutoh Plus using the standard demo?

Yes, you can use the demo to try scripting and HTML templates, but if you currently have a Jutoh licence, you will need to turn Jutoh back into the demo first by entering blank or invalid information into the registration dialog. You can enter your original user name and key when you have finished testing Jutoh Plus.

Do I need to download a separate Jutoh version?

No, you simply unlock the extra facilities by purchasing a licence for Jutoh Plus or for the upgrade to Jutoh Plus. You can then enter the registration details via Help | Register Jutoh.

Sample scripts

Jutoh sample script

The Jutoh sample script can be found here. It demonstrates a variety of import and replacement operations.

Greg Pietrangelo's interactive Epub 3 demo

This sample Jutoh project containing custom JavaScript can be found here.

To view the JavaScript components, use the Format | Asset Editor command.

It has been tested on the following Epub 3 readers:

  • iPad and iPhone (with iBooks 2)
  • Readium add-on for Chrome Browser
  • SIGIL (Mac and Windows)
  • Calibre (Mac and Windows)

Back to the top

© 2019 Anthemion Software Ltd.