Jutoh - digital publishing for everyone
Home

The Product
Explore
Buy
Download
FAQ
What users say
Screenshots

News

Affiliates

Support

Jutoh Book

About Us

Contacts

Resources

Frequently Asked Questions

Please see also the Knowledge Base which is included in Jutoh for searching via Jutoh's toolbar.

About Jutoh | Licensing and Support | Technical Issues

Contents

About Jutoh

Licensing and Support

Technical Issues


About Jutoh

Who should use Jutoh?

Jutoh is suitable for creating ebooks for books with relatively simple formatting requirements. So, it's great for novels, self-improvement books, biographies, and so on, but not so good for mathematics textbooks.

What platforms are supported by Jutoh?

Unlike most software, Jutoh is cross-platform and runs on all popular desktop and laptop operating systems. So if you're thinking of switching platform in the future, you don't have to worry about your investment and files becoming obsolete. If you want, you can install the Windows, Mac and Linux versions on a USB memory key and switch machines as much you like, retaining all your settings. Specifically, we support:

  • All recent 32-bit and 64-bit desktop Microsoft Windows platforms - that's Windows XP, Windows Vista, Windows 7, Windows 8 and Windows 10.
  • Mac OS X 10.3.9 and above (PowerPC and Intel processors).
  • Most Linux distributions (32-bit or 64-bit). Debian, RPM and tarball packages are provided.
  • Intel Chromebooks, after installing a suitable Linux in developer mode.
  • Raspberry Pi 2 running Raspbian or other Linux. Jutoh is free on Raspberry Pi.
  • FreeBSD 7 and above (on request).

Jutoh does not run on Android or iOS devices.

What hardware is required by Jutoh?

Hardware requirements are modest: 1GB RAM, and 30MB-90MB of hard disk space depending on operating system.

What tools were used to develop Jutoh?

Built with wxWidgets Jutoh is programmed with the popular open source cross-platform GUI toolkit, wxWidgets, created in 1992 by Anthemion Software director, Julian Smart. Dialogs are edited with Anthemion's DialogBlocks. wxWidgets is being used by organisations large and small all over the world, including by Google for Google Drive. The more exotic applications include space telescope control, science at the South Pole, genetic research, Formula One racing, and the hunt for extra-terrestrial life.

How do you pronounce Jutoh?

We pronounce it "Joo-toe". The name is derived from three forenames - [Ju]lian, [To]ni, [H]arriet.

Licensing and Support

How much does Jutoh cost?

Please see the purchase page for pricing information. Jutoh is not subscription-based and there is no per-book cost - it's a one-off purchase and you can use it for as many books as you like.

Will upgrades be free?

Upgrades and bug fixes for each major version of Jutoh will be free. You can download new versions of Jutoh as many times as you like. We will sometimes make a small upgrade charge for major new versions, usually denoted by a change to the first version number. The upgrade from version 1 to version 2 is free.

Do I pay for each operating system I run Jutoh on?

Each separate user must buy a separate copy, one copy each. But if you want to run Jutoh on both Windows and Linux, for example, then you only pay once. The licence is not tied to a particular operating system.

What are the restrictions of the demo?

The demo is restricted to 20 documents, generated chapters have the line "CREATED BY JUTOH" at the top, and there are occasional registration reminders.

Can I use the same registration key for Jutoh both at home and at work?

Absolutely. You can use the same registered copy of Jutoh on multiple machines so long as only one copy is being used at a time.

How do I register to unlock the demo?

Run Jutoh and click on the Register toolbar button. Alternatively, click on the Help menu, followed by Register Jutoh. Now find the user name and registration key that you were sent when you paid for Jutoh. Copy and paste (or type) the information into the user name and registration key fields, and press OK. (Note that any '0' characters in the registration key are zeros, and not letter 'O's.) Your copy of Jutoh should now be registered.

What do I do if Jutoh doesn't accept my registration key?

Normally this is due to a typo. The most reliable method is to use copy and paste to transfer the user name and key (on Windows: select the text in the email, then Ctrl-C, then Ctrl-V in the registration dialog). If typing manually, please note that there are no letter Os in the key: only zeros. If your user name contains an accent, this could be a cause of registration failure. In this case, please email us for another user name and key. If all else fails, please email jutoh@anthemion.co.uk for further help. If you're using Windows I can create a registry file for you to run that usually solves the problem.

Note that if you want to register with a different key, and the registration dialog is not available, you will need to reset the application as detailed below.

What do I do if I've lost my registration key?

Email jutoh@anthemion.co.uk and we'll find your key. Please quote your order reference number, name and preferably the email address you used when ordering Jutoh.

What happens to my work if I uninstall Jutoh before upgrading?

If you created new files, they won't be deleted. Your application settings will be preserved too.

How do I move Jutoh to another machine?

You can just download Jutoh onto the new computer, and enter your user name and key when Jutoh runs for the first time. You can obtain this information from the registration dialog (Help | Register Jutoh) on your existing computer, or from the original email sent to you when you purchased Jutoh. Note that you can install Jutoh on as many of your own computers as you like, since licensing is per user and not per computer.

How can I get support?

Please email us at jutoh@anthemion.co.uk if the Jutoh help and FAQ don't answer your query.

Are you responsive to suggestions?

Yes! Anthemion Software is a small, friendly company and we are delighted to receive feedback from our users. We strive to build the best-of-breed tools so getting back 'reports from the field' helps us to serve you better. A lot of customer suggestions make it into future versions of Jutoh.

Is there an affiliate programme?

Yes; if you sign into BlueSnap as an affiliate you can find "Jutoh - Full Download" (product 1943746). If you can't find it, try searching for Anthemion in the BlueSnap catalogue. Once set up, when visitors go to your site and then buy Jutoh, a percentage will go into your BlueSnap account. See also Be a Jutoh affiliate.

Technical Issues

How do I install Jutoh on Windows 8?

After you have clicked on the Windows Setup link in your web browser, and it has finished downloading, double-click on the downloaded file. You may get this screen, saying "Windows Protected Your PC":

Click on the small link More info, and you will see a screen with the choices Run anyway and Don't run. Click on Run anyway.

You will then get a User Account Control screen, with "Do you want to allow the following program from an unknown publisher to make changes to this computer?"

Click Yes to run the Jutoh setup program, which will guide you through the installation. The reason for these steps is that Jutoh does not come with a publisher certificate, so Windows 8 is being extra careful.

Does Jutoh run on a Chromebook?

If you have a suitable Intel Chromebook, it is possible if you're prepared for a bit of fiddling or know someone who can help. For more information, see Installing Jutoh on a Chromebook.

What import formats are supported?

Jutoh imports from a range of formats. You can import from Word DOCX, ODT, plain text, HTML, or an existing Epub ebook. (Note that complex CSS style definitions may not be preserved when importing from HTML or Epub.) Using an application such as OpenOffice.org, your existing word processor files can be saved in DOCX or ODT (Open Document Format) for import into Jutoh. Tables and images will be imported.

Jutoh does not support PDF import directly, but you could try converting your document from PDF to Word using an application such as Tweak PDF Converter.

What languages are supported?

Currently, the user interface is available in English, Dutch, French and German. However, Jutoh can be used to create books in any left-to-right language. RTL (right-to-left) languages are not supported.

Does Jutoh support Epub 3?

Jutoh supports some Epub 3 features. You can switch Epub 3 support on by setting the Epub version configuration property to 3. The adaptations to Epub 3 are currently as follows:

  • The new-style table of contents file is generated, while the old NCX file is included for backwards compatibility;
  • Epub 2 guide types are converted to Epub 3 equivalents where possible;
  • if documents contain guide types, a 'landmarks' table of contents is generated;
  • metadata is generated using the new Epub 3 syntax, with mandatory date metadata;
  • XHTML files have the correct preamble;
  • SMIL files can be generated for synchronisation of narration with content;
  • section structure and caption tags can be added by mapping from paragraph style names;
  • form controls and JavaScript can be added for making interactive content.

Jutoh is distributed with EpubCheck 3, which means it can check both Epub 2 and Epub 3 files if you have Java installed.

Jutoh supports audio and video tags in both Epub 2 and 3. Let us know if you need other Epub 3 features not currently supported. Since Epub 3 encompasses many features, it will be a gradual process adding support for it.

How do I changes styles, for example to add indentation?

Apply styles using the formatting palette (left), which you can switch on with Format | Formatting Palette or Alt+P if not already shown. This shows the available styles in a list, and you can double-click to apply a style, or right-click to choose from handy style-related commands including Edit Style and Clear Formatting. Jutoh will also describe the current style, either the one at the cursor or the style you clicked on in the palette.

You can also apply styles using the Format | Styles menu command, and by using the context menu. You can edit, add and delete styles via the Styles page of the Project Properties dialog - click Edit on the toolbar to see this dialog. Editing the style won't apply it to the current paragraph, unless that paragraph already uses the style.

For more information, see the chapter on styles in the Jutoh book.

The OpenOffice.org Writer desktop icon isn't working. How do I fix it?

Jutoh may add a desktop item for OpenOffice.org Writer that doesn't initially work, if the application isn't installed or it guesses the location wrongly. First, check your system to see if OpenOffice.org is installed. It's not distributed with Jutoh since it's very large. You can download it from www.openoffice.org.

Once you have OpenOffice.org installed, you can fix the desktop command. Right-click on the OpenOffice.org Writer icon on the Jutoh desktop, choose Properties, click on the Location text box, and clear it. Now click on Browse and find the OpenOffice.org or swriter program. On a Windows system the command might be:

"C:\Program Files\OpenOffice.org 3\program\soffice.exe"  -writer
On Mac, it might be:
/Application/OpenOffice.org.app

(The .app extension must be present on Mac.) Now click on OK, and OpenOffice.org should launch when you double-click the shortcut.

How do I reset Jutoh?

On rare occasions, for example if Jutoh starts behaving strangely, you may wish to try resetting the application back to the installation state. First try removing the application preferences, and then if necessary the folder containing the application data, such as report templates, sample files, toolbar customization and other data that may be saved by Jutoh between sessions. Note that by removing the application data you will lose some of the customizations you have made, though not your project data.

How you achieve reset Jutoh differs according to operating system. First, quit Jutoh.

On Microsoft Windows, to reset the application preferences, you need to delete the relevant registry entries.

  1. click the Windows Start button, click on Run, type regedit and hit the return (enter) key.
  2. Navigate to HKEY_CURRENT_USER\Software\Anthemion Software, and select the Jutoh entry for Jutoh 1, or the Jutoh2 entry for Jutoh 2. Press the Del key and confirm the deletion.
  3. Quit regedit.

This deletes the preferences. You can optionally delete the application data that Jutoh stores, by navigating to \Users\<your user name>\AppData\Roaming and deleting the folder Jutoh for Jutoh 1, or Jutoh 2 for Jutoh 2. Note that the AppData folder may be hidden unless you have enabled Show hidden files and folders in the Folder Options dialog (available from Tools | Folder Options in Windows Explorer).

On Linux, you need to remove the file ~/.config/jutoh/Jutoh or ~/.config/jutoh2/Jutoh2, and optionally, the application data folder ~/.config/jutoh or ~/.config/jutoh2.

On Mac OS X, you need to remove the file /Users/<your user name>/Library/Preferences/Jutoh Preferences or Jutoh2 Preferences. Using Finder, you can click on the Home icon and then navigate to Library/Preferences, from where you can delete the Jutoh Preferences or Jutoh2 Preferences file. You can optionally delete the folder /Users/<your user name>/Library/Application Support/Jutoh or Jutoh 2.

Is Jutoh compatible with Dropbox and Google Drive?

There have been reports of project file corruption when using Dropbox and Google Drive. Synchronisation services do not seem to be able to cope with the SQLite format used by Jutoh for project files.

From Jutoh 1.67, there is an experimental setting to allow projects to be copied to the system temporary folder, and then copied back when the project is closed. In Preferences/Projects, check 'Edit in temporary folder' and specify a pattern that will match your sync folders. If this option is enabled, whenever you open a project in a matching folder, Jutoh will automatically copy the project to a temporary file for editing, and copy it back to the original folder when the project has been closed.

Please let us know how you get on with this option.

What is the PortableApps.com version of Jutoh?

PortableApps.com provides a way to install Windows applications on a USB drive to allow them to be run on any Windows machine, saving settings and data to the USB drive. Jutoh is available in a .paf.exe installer that is compatible with PortableApps.com and allows easy integration with your existing PortableApps.com applications. To use it, download the .paf.exe installer to a temporary location on your desktop hard drive and then from the PoprtableApps.com Options menu, choose 'Install a New App' and select the .paf.exe file. Follow the instructions, and the Jutoh icon will appear on the PortableApps.com menu.

Note that this method is in addition to the portability built into Jutoh. Normally you install Jutoh to a USB drive by invoking the Mobile Preferences dialog from the View menu, and then clicking on 'Install Jutoh on External Drive' (see the appropriate FAQ. This installs the application using locations and conventions that differ from those employed by PortableApps.com, and allows you to use multiple platforms (Windows, Linux and Mac OS X). But if you only use Windows, the PortableApps.com method may be preferable since it comes with a set of free applications and can be used to launch Jutoh as well.

The regular and PortableApps.com installers both contain the same version of Jutoh, but with a different directory layout. The PortableApps.com version includes a startup.cnf file that tells Jutoh where to look for its data, and that an external drive is being used.

Do I need a 64-bit version?

On Windows, the 32-bit version should be fine for the most users. Some people like to have 64-bit versions of applications if they are running a 64-bit Windows, but the performance difference is neglible. If you have extremely large projects, then the 64-bit version will cope with them since it can address more of your computer's available RAM. You can run the 32-bit version of Jutoh on both 32-bit and 64-bit versions of Windows.

On Linux, it's best to choose the version that matches your version of Linux.

On Mac, there is no 64-bit version of the official, Carbon version of Jutoh, but the experimental Cocoa version for Mac OS 10.7 and above is 64-bit only.

Can I store my Jutoh data files on a USB drive?

Yes, you can store your own data files, and Jutoh settings, on an external drive. You can do this without any change to Jutoh's preferences but it's easier if you configure the application to look on an external drive and if appropriate, store settings on this drive.

To do this, go to the View menu and select Mobile Preferences. On this dialog, check Store your data on the external drive and (recommended), Store all settings on an external drive. Click OK and restart the application. Jutoh will now prompt you to enter the name of the external drive, for data and settings. It's useful to store the settings on the drive so that it can remember what files to load automatically, regardless of what machine you're currently using, but if you sometimes wish to use Jutoh without the external drive connected, then don't check this option.

Note that until you explicitly open files on the external drive and restart the application, Jutoh will probably have loaded the last files from the computer's hard drive. So you need to be careful that you are really editing the files you think you are editing. It's handy to type Alt+Enter to see the location of the current file.

This FAQ has dealt with storing only data and/or settings on the external drive. See the next FAQ for how to run the program itself from the external drive, in addition to settings and data files.

How do I run Jutoh from a USB drive?

You can install Jutoh to a USB drive by first installing it on your computer as normal. Then, go to the View menu and select Mobile Preferences. On this dialog, click on Install Jutoh on External Drive. This installs the application to the USB drive so that you can switch machines and Jutoh will use settings and data stored on the USB drive.

If you're using different operating systems (for example two or more of Windows, Linux and Mac OS X), do this installation on each operating system that you are using. Your shared settings and documents will be used regardless of operating system.

If you will only be using Windows, consider using the PortableApps.com installer as mentioned in the previous FAQ.

On Linux, you may find that you don't have execute permission on the external drive, particularly if the drive is formatted with a Windows file system such as FAT32. In this case, you need to mount the drive with different options, and you can do that by editing the file /etc/fstab as root. You should add a line that tells the system to use special options. Here's an example:

/dev/sdb1 /media/usbdisk vfat rw,shortname=mixed,uid=1000,gid=1000,user,auto,exec 0 0

To find out the device name and mount point (the first two entries in this file), insert your drive and when automounted, type mount in a terminal window. You should see an entry for the external drive. The exec option causes all files on the drive to be seen as executable, and auto causes the drive to be mounted automatically when the device is inserted.

It's worth remembering that USB drives can easily be lost, and data corrupted more easily, so remember to back up frequently to a hard drive or other external drive. Also, use the 'Safely Remove Hardware' icon or equivalent operating system functionality before removing any external drive.

For more details, please see the topic Using Jutoh with an external drive, under Topics/Miscellaneous topics in the manual. It explains how you can configure Jutoh to run from your computer's regular hard drive but take settings from the USB drive, as an alternative to complete installation on the USB drive.

How can I synchronize files between multiple computers?

Jutoh doesn't directly support synchronization of files, but you can use a USB drive as above, or you could use an internet backup service with synchronization, for example:

How do I install Kindlegen and Kindle Previewer?

Jutoh will help you install Kindlegen from the Setup Wizard and Preferences/Helpers page. On Windows, Jutoh will install and configure Kindle Previewer from the Setup Wizard. For details, Windows users can see Installing Kindlegen and Kindle Previewer. Users on other platforms can refer to the Configuring Jutoh chapter in the Jutoh book.

Why are .mobi files larger than Epub files?

Mobipocket files generated by Kindlegen (as opposed to Calibre) also incorporate the original source files, so that Amazon has the option to later recompile the ebook with newer software. However, the customer is likely to be sent a smaller file from the Kindle store.

Note also that Amazon recommends Kindlegen for the creation of Mobipocket (Kindle) files. Using an unapproved Kindle file compiler, such as Calibre, may produce poor results or cause ebooks to be rejected from the Kindle store.

Does Jutoh run on 64-bit Windows Vista and Windows 7/8?

Yes; although Jutoh is provided as a 32-bit Windows executable, it runs fine on 64-bit Vista and Windows 7 and 8.

Does Jutoh run on both Intel and PowerPC Macs?

Jutoh for Mac OS X runs on both Intel and PowerPC machines. However, we will be withdrawing support for PowerPC in the near future; older distributions will still be available and we can build newer versions for PowerPC on request.

On Mac OS X, why does kindlegen fail with "cannot create the temp file"?

You probably didn't install Jutoh properly - you may still be running it from the read-only disk image that you got after you downloaded the .dmg file and opened it. You need to drag the Jutoh application to a suitable folder, such as /Applications, and then when you run Jutoh again kindlegen will be able to create a temporary file. If Jutoh is already installed correctly then you need to check that the kindlegen application is placed directly in /Applications since users report that it won't run correctly unless in this folder.

On Mac OS X, I can't save to certain filenames. What's the problem?

You may have accented characters in your filename; try choosing a name with no accents.

On Mac OS X, how can I improve small text display?

If you see badly spaced text for small fonts, you can switch on antialiasing (smoothing) for these fonts. Go to the Mac OS X System Preferences, click on Appearance, and in the item Turn off text smoothing for font sizes ... and smaller, select 8. Now fonts at 9 point and above will use antialiasing which vastly improves spacing, and gives dialogs a more consistent look too.

How do I install Jutoh on Linux?

Jutoh supports three distribution methods for Linux:

  • Debian package (.deb);
  • RPM package (.rpm);
  • Tarball (.tar.gz).

Each of these methods will install suitable desktop entries and MIME types, adding a menu entry to the KDE or GNOME menu in the Office or Word Processor group. Jutoh will also be available by typing jutoh in a terminal window. The application is normally installed to /usr/share/jutoh, and the 'jutoh' startup script to /usr/bin.

Debian packages

To install a .deb, you may be able to simply double-click it in the file manager. If this doesn't work, you can use the dpkg command-line tool. Type something like the following in a terminal window:

dpkg -i jutoh_1.00-1_i386.deb

You need to have root permissions to do this, so either type su followed by the root password, or prefix the command with sudo and type your own password when prompted.

To remove the package, use:

dpkg -r jutoh

RPM packages

To install an RPM package, you may be able to simply double-click it in the file manager. If this doesn't work, you can use the rpm command-line tool. Type something like the following in a terminal window:

rpm -i jutoh-1.00-1.i386.rpm

You need to have root permissions to do this, so either type su followed by the root password, or prefix the command with sudo and type your own password when prompted.

To upgrade the package (if an existing one is already installed), use -U instead of -i.

To remove the package, use:

rpm -e jutoh

Tarballs

The tarball method is the only one currently supported on FreeBSD. With this method, you run a script in a terminal and you will be prompted to install either system-wide or locally. If installing system-wide, you may wish to login as super user (type su) or run the script with sudo, for example sudo ./installjutoh.

First, unarchive Jutoh-x.yz.tar.gz to a suitable location in your filesystem. This will create two files, JutohData.tar.gz and installjutoh. Run installjutoh and follow the instructions: it will install Jutoh in one directory, and a script 'jutoh' in another, so you can invoke Jutoh without having to set the JUTOHDIR environment variable. The script will install the appropriate MIME types and desktop entries, and if installed locally, will also add a Jutoh icon to your desktop.

With the tarball method, you can uninstall by running the uninstalljutoh-x.yz script generated by the installation process.

Opening project files

If you try to open a Jutoh project file outside of Jutoh, from a file manager, you may get an error message:

Could not display MyFile.jutoh
There is no application installed for SQLite3 database files.
Do you want to search for an application to open this file?
You need to click No to dismiss this dialog.

You can still open the projects from within Jutoh. The Welcome window on the Jutoh Desktop provides a quick way to open recently-edited files.

To fix it, bring up a terminal window and type this:

sudo update-mime-database /usr/share/mime
If you now press F5 in the file manager window to refresh it, you should see the icons change, and you can now double-click the file to open it in Jutoh.

If a default application is still not associated with the Jutoh Project type, type this in a terminal:

jutoh finishinstall
which (from Jutoh 1.71) makes Jutoh the default application for the Jutoh Project type by executing the command:
xdg-mime default jutoh.desktop application/x-jutohproject

After updating the mime database, you may still be getting the error:

Could not display "MyFile.jutoh"
There is no application installed for Jutoh Project Files.
The association between the Jutoh project mime type and the Jutoh program may have been broken.

On Gnome, you can fix it as follows:

  1. Right-click over the Jutoh file and click Properties.
  2. Click the Open With tab and click Show Other Applications (or press Add on some systems).
  3. Click on Jutoh, and then on Set As Default if available.
  4. Click Close.

On KDE, it's a similar procedure, using Open With on the context menu.

You should now be able to double-click on Jutoh project files to open them with Jutoh.

How do I install Jutoh on Mageia Linux 2?

You can install Jutoh on Mageia Linux 2 using the RPM.

On 32-bit Mageia Linux 2, if you get a message about libpng1.2 not being found, install libpng12_0 via your package manager and try again. You may find that some icons are missing when browsing files; currently there isn't a fix for this except to contact us and request a special build for Mageia.

On 64-bit Mageia Linux 2, you can use the 64-bit version of Jutoh and install lib64png12_0. This will unfortunately result in some broken PNG icons, but Jutoh will otherwise run fine.

Another method is to run the 32-bit version of Jutoh in 64-bit Mageia Linux; this method, at least in my experience, will not result in broken PNG icons. Install the following packages using the Software Management tool:

  • libpng12_0 (architecture i586)
  • libgtk+-x11-2.0_0 (architecture i586)
  • libgnomeprintui (architecture i586)
  • liboxygen-gtk (architecture i586)
  • libcanberra-gtk0 (architecture i586)

When offered a choice of packages to install, choose the default option. It will take a few minutes to install all dependencies.

How do I install Jutoh on Fedora?

You can install Jutoh on Fedora using the RPM, but you will need to install libpng 1.2. You will see a message about this missing library if you run jutoh2 from a terminal window.

To fix this, on older versions of Fedora, go to "Add/Remove Software" and add "Temporary backwards-compatibility copy of old libpng" (libpng-compat-2:1.5.10-1fc17).

Or, on more recent versions of Fedora, do this in a terminal window:

sudo dnf install libpng12

How do I install Jutoh on Ubuntu 16.10+?

Ubuntu 16.10 and above come with a newer version of the libpng library; Jutoh requires 1.2. The 64-bit 1.2 library can be downloaded from one of the mirrors listed at packages.ubuntu.com/xenial/amd64/libpng12-0/download, for example here.

Open the file to install it, or save the .deb to your computer and then in a terminal window, change directory to where the file was downloaded, and type this:

sudo dpkg -i libpng12-0_1.2.54-1ubuntu1_amd64.deb

After installing this library, Jutoh will be able to run.

What are the workarounds for Jutoh not running correctly on Linux?

If you get a message about libpng1.2 not being found, install it via your package manager and try again.

If there is a crash on startup or buttons and other graphical elements are not displaying correctly, there may be a conflict with a specific theme. Please change the theme or just the icon set.

How can I improve printing under Ubuntu 9.10 and above?

Some Linux distributions don't install a library that Jutoh needs, so please go to the Synaptic Package Manager and install the libgnomeprintui2.2-0 package. Without this, only a fall-back PostScript printer will be used, and it will not be possible to select alternate printers.

On Windows, why does Jutoh not always find Adobe Acrobat Reader?

Sometimes there is a problem with the PDF file association, resulting in advice from Jutoh, despite the fact that Reader is installed on your system and PDF files can be launched from Explorer. This is caused by the absence of certain registry keys and can usually be fixed by re-installing Acrobat Reader.

If the problem persists, you can still read the PDF files by locating them on your system either from within Explorer or from the Reader file dialog.

Why do Jutoh and Windows explorer sometimes use different shortcuts?

When you choose a document in a shortcut and launch it, sometimes the application that opens the document is not the one you expected (or the one used by Windows Explorer). This is because you have overridden the standard associations with different associations in Explorer - but this is not reflected in the basic association that Jutoh uses.

You can fix this by making the association more pervasive. In Explorer (while browsing a drive, for example), go to the Tools menu and select Folder Options. Click on the File Types tab and scroll down to the extension you're interested in. Click on the extension. If there is button Restore, click it, and it will change to Advanced. Now click on Advanced and you will be able to select the application you want to associate with the extension. Click on open in the list of actions, and then click on Edit. Enter the program path in the second text field. If you browse for it, don't forget to add %1 to the end, to represent the data file to be opened. Press OK to confirm the changes, and then OK again to confirm the association changes.

You may wish to make a note of the original settings in case you want to restore them.

Why does HTML/Epub import not preserve all my styles?

Jutoh only parses a subset of CSS (the style information provided with HTML and Epub), so if the original file has complex formatting, you may need to edit the styles and/or text after import. It is recommended that you import from DOCX or ODT if possible.

Why does ODT import ignore some images?

When some images are pasted into OpenDocument files (instead of inserting from a file), or the file is converted from another format, OpenOffice saves the images in an obscure and little-used format (SVM, or StarView Metafile). Unfortunately Jutoh (and all image conversion applications that I know of) cannot convert this file, and so there will be a warning message during import. The workaround is to paste the images into Jutoh after import. Also you may have greater success if you insert the images into OpenDocument from files instead pasting from the clipboard. Another alternative is to use DOCX as your import format, although pasted metafile images in a DOCX document will only be imported when Jutoh is running on Microsoft Windows.

Does Jutoh support encryption/DRM?

Jutoh does not add any encryption for Digital Rights Management. By its nature, DRM has to be integrated with the distribution and sale of a book and therefore must be performed by the publishing system, for example the Amazon Kindle publishing site, Apple iBooks via iTunes, or Smashwords. None of these book submission systems can take an encrypted book from the user, so encryption in Jutoh would be of little use. Encryption should only be a concern if you intend to distribute the book yourself. In that case, you can use a service such as www.e-junkie.com or www.payloadz.com that can serve up a link to the ebook file after payment, from its own servers, so that the book is not freely available.

Whether a book is protected from clipboard copying is down to the reader software, there's nothing in the generated ebook files that can determine this.

In general I advise authors to stop worrying about encryption/DRM and simply add a request in their book for the reader to not distribute the book. This will discourage a good proportion of people from breaking the law. But a little piracy is good for publicity anyway. Note also that most readers hate DRM since it prevents them from reading the book that they bought on different readers. So you can make a lack of DRM into a selling point.

Does Jutoh support justification?

Yes; it just doesn't show up in the Jutoh editor. You can set the alignment to Justified in the properties for a named paragraph style, via the Project Properties dialog (click Edit on the toolbar). Then apply this style to one or more paragraphs. It won't appear justified within Jutoh but it will appear justified in ebooks where supported (not all readers support justification).

How can I improve formatting after importing from DOCX or ODT?

If you imported from a DOCX or ODT file and you need to make improvements to formatting spacing, indentation and so on, make sure you have applied consistent named styles throughout. If you have used ad-hoc formatting in your original file instead of a consistent set of named styles, then this poor formatting will also be imported. You can tell if you have used ad-hoc formatting by clicking on a paragraph and observing if the style in the toolbar shows a long name containing "+" symbols. Instead, decide what styles you need, go into the Project Properties, click on the Styles page, and edit or create styles that reflect the formatting you need. Apply these styles to the paragraphs in your document. Then, if you need to make changes to the whole document, you can edit the style definitions and not every single relevant paragraph in your entire book. It may seem a hassle to set this up, but it will save you aggravation and time in the long run.

Note that you can save time applying styles to your document by assigning shortcuts to named styles. Press Ctrl+. to start defining some new shortcuts.

It's worth remembering that the Document Cleanup dialog available from the Book menu can help clean up your project, for example removing colour formatting, extraneous spaces, blank lines and more.

What do I do if Jutoh complains about missing styles?

Jutoh will tell you during book compilation if you have paragraphs or objects that use styles that are not in your style sheet. You might have deleted the original styles from your style sheet, for example, or you may have copied and pasted styles using an earlier version of Jutoh that didn't copy the styles. If named styles are missing, you can choose another style from the drop-down style list in the editor, or you can recreate the style in the style sheet, in Project Properties. If automatic styles are missing, you can normally trigger their recreation by reapplying the styles either to the existing content, or to some dummy content that you subsequently delete.

Can I edit the HTML and CSS directly?

The short answer is 'kind of'. Jutoh will never support direct editing of all the generated HTML and CSS, except via a third-party application such as Sigil. This is because it would be impossible for Jutoh to reconcile your edits with Jutoh's internal representation; in other words, there is a one-way conversion to the target format, and there is no possibility of conversion from the target to the original project. If there was, there would probably be no need for you to edit the HTML in the first place, since you would have full control within Jutoh. And if Jutoh allowed you to make arbitrary edits to the target format, they would be overwritten the next time you hit the Compile button.

However, there are two features in Jutoh that can let you customise HTML.

  1. You can enter some HTML code and format it with the "HTML" paragraph style to have that code sent directly to the ebook. Or, format a range of text with the "HTML Text" character style. To customise CSS, select a style in the Styles page of the Project Properties dialog and click Properties; then check "Use custom CSS" and enter the CSS for this style. To add global CSS, edit the properties for the style sheet (the third button at the top of the Styles page). You can also add extra styles per section in the Document Properties.
  2. You can use the HTML template system in Jutoh Plus to replace some or all of the HTML that Jutoh generates. You can specify a template for the whole project, or per document, or a combination; and you can embed and edit arbitrary JavaScript and CSS files that are referenced by the custom HTML templates. You can even specify what templates and embedded code files should be used for specific configurations, letting you create variations of your ebook suited to different target capabilities and audiences.

How can I create a Greek Epub?

You can download the free Gentium font, add it as a font document to your Jutoh project, and then follow the instructions in the Jutoh manual or book to embed the font in your ebook.

How do I migrate from Jutoh 1 to Jutoh 2?

The Jutoh 2 upgrade from version 1 is free. You can install Jutoh 2 on your computer without first installing Jutoh 1, so long as you use a different installation folder. Jutoh 2 uses the same user name and key as Jutoh 1; you will need to enter it again as Jutoh 2 stores its settings separately.

When you open a Jutoh 1 project in Jutoh 2, you will be warned that you may not be able to open it again in Jutoh 1. Jutoh 2 will save the project in the newer format; make a backup of your old file if you will need to open it again in Jutoh 1.

Back to the top


© 2017 Anthemion Software Ltd.