This project is read-only.

These are the steps to use the Epub Export Feature of USFM Preprocessor:

First, make sure your .sfm files are formatted correctly or in a way that makes them compatible with Preprocessor requirements for .sfm files.

To do that click Open Folder […] button in the upper left corner and choose a folder containing your .sfm files. Then open Extra Tags Processor tab and click the button [Scan the Tags that will not be processed…]. Make sure that USFM File Extension drop down above has the right extension selected.


In this case scanning showed that there are a lot of closing \fr* tags (USFM Preprocessor uses one of the earlier versions of USFM Reference as a standard, which didn’t support closing tags for the \fr and some other tags).

In order for the program to process epub file correctly, you’ll need to get rid of these tags. To do that choose Remove Singular Tag from a drop down menu next to the tag:

Do this for each tag and then click [Process Tags and Create New Files] button in the bottom.

As a result you will have a new set of files with .utf extension, if you didn’t change the default.

Next switch to the Export as ePub tab and choose utf file extension in the USFM File Extension drop down above. Now you’re ready to import your .utf or .sfm (if you didn’t need to change anything on the previous step) files into epub format.

Now you need to set your books in the right order. To do that, click [Set Book Order] button in the upper right corner.

In the Set Book Order window that will open click [Grab Books] button. If your book name tag is not \h, then change it. As a result the grid will be filled out with your .utf or .sfm files in existing order. You can drag files up and down to put your books in desired order. Or you can click on [Load Existing Book Order] to load the order you saved previously. When you’re done putting your books in order, click [Save Order], in the bottom of the window.

A message will pop up with the name of your book order text file.

Now click [Load Books from book order file] button on the main screen. As a result the grid below the button will be filled with the names of the files. At this point you can select the files you would like to output in ePub format. You can also reorder the files if you are not satisfied with the order. You can select all the files by clicking on the grid header for the first column. It says [Select All].

Then fill out all the fields to the right of the grid. Check [Paragraph mode] checkbox in the bottom if you want the text come in paragraphs. Provide Cover Page Title, Bible Name, Description, ISBN, Publisher info and so on in the [Title Page info] text field.

If your Bible has introduction for each book of the bible, provide the name of this introduction in your language in the [Intro Name] field.

There are two more optional things that you will need for your epub file. They have to do with formatting: cover page image and css file. If you want to include them, go here and download two additional folders. Paste them into the folder with your .utf/.sfm files. Then go inside [images] folder and replace image with your own. Open common.css file inside css folder and modify it the way you like.

Now you’re ready to process your files. Click on [Generate ePub Export] and wait for the files to process. You will find your .epub files with the name you gave it in the [EPUB file name] field in the same folder with your original .sfm files.

Open it using Calibri or other Epub reader software. 

Last edited Nov 8, 2012 at 7:08 AM by anyalee, version 2


No comments yet.