Sigil-Create An

Create an EPUB
http://web.sigil.googlecode.com/git/files/OEBPS/Text/tutorial_create_...
Sigil User Guide

0.6.0 draft
previous page next page
This tutorial shows you how to take your manuscript and turn it into an EPUB ebook. Of course, you can do all kinds of other things with Sigil, but creating your first EPUB is a good way to see the features of Sigil. Creating an EPUB can be done with a the following steps: Loading your document into Sigil Adding Author and Title information Adding a cover Adding a table of contents Checking your EPUB for errors
If you already have an HTML or EPUB file you can skip this step. If you are starting with a document created by one of the many available word processor programs, the first thing you need to do is convert your document to HTML so that you can import it into Sigil.
Sigil only supports importing HTML files since converting from other formats is actually quite specialized and best left to other tools.
Although conversion is not part of Sigil, here are some suggestions for converting files to HTML: Microsoft Word file: use the MS Word menu option FileSave As Filtered HTML. Or use the MS Word Macro @ MobileRead. Both approaches try to reduce the amount of extra code included by MS Word so that your HTML file is cleaner and simpler to edit in Sigil. You really want to have your code as clean as possible. Text file: try renaming the file to end in .html, or load into into MS Word, OpenOffice or LibreOffice and save as HTML. Text files usually don't convert well due to difficulty in identify the start and end of paragraphs. RTF file: try the rtf2epub tool at http://code.google.com/p/epub-tools/downloads/list. PDF file: use Adobe Acrobat FileSave as HTML menu option, or use
1 of 24
13/1/2013 1:31
Create an EPUB
http://pdftohtml.sourceforge.net/. PDF files usually don't convert well since they were built for a fixed layout. Avoid if possible. Mobi file: Unzip the .azw or .prc into a directory. Then open the HTML file in Sigil.
When you first start Sigil you will be shown a screen with several windows. The Book Browser window is on the left (which is used to access all the files in your EPUB), an editor Window is in the center and set to Book View (to edit your book as it appears), and a Table of Contents window is on the right (to show you any chapter titles you've defined).
See the User Interface chapter for more details.
To open your EPUB or HTML file, use the menu option FileOpen:
2 of 24
13/1/2013 1:31
Create an EPUB
Select the file you want to open from your file manager. You will now see your file in the Book Browser window under the Text folder on the left, and the file will be opened in the Book View editor in the middle with its filename showing on the tab header:
3 of 24
13/1/2013 1:31
Create an EPUB
Your HTML file is now part of the EPUB ebook. From now on you you are editing your EPUB and not just an HTML file.
If your file includes any images or stylesheets, Sigil will attempt to load them as well. When converting your file to EPUB or loading an EPUB Sigil may add some necessary details and re-organize your files into standard folder names but it won't change your text.
Now that you've loaded your file, you should save your new EPUB. You should do this right after loading your file to make sure there are no problems. To save your EPUB, use the menu option FileSave As:
Enter a name for you file in your file manager. It will be given a .epub extension since it will be saved as an EPUB file.
You can now use the button
to save your EPUB at any time and you should save often.
To make sure your ebook conforms to EPUB standards, you need to add a bit more information.
If you need to make any basic changes to your text, you can just edit your book in the Book
4 of 24
13/1/2013 1:31
Create an EPUB
View editor. To open specific pages in your book, just double-click them in the Book Browser. You can then follow the remaining steps to create a complete EPUB ebook. You can always make more changes once you've created your EPUB read through the User Guide for more details on editing, working with files, images and formatting.
In addition to the actual content of your book, EPUB files also contain information that is useful for your readers such as book details like Title and Author. To add details about your book (called metadata) to your EPUB, use the button menu option ToolsMetadata Editor: or the
The Metadata Editor window will be displayed:
5 of 24
13/1/2013 1:31
Create an EPUB
You can now add your Title, Author, and Language to your book: Title: the full title of your book Author: for example enter Carroll, Lewis Language: the language the book was written in
Once you have updated the information, you can select OK and then save your EPUB
6 of 24
13/1/2013 1:31
Create an EPUB
again.
You may have noticed that there is a lot of room for other values in the Metadata Editor. Only the Title, Author, and Language are required for EPUBs, but if you want to add more values using the Add Basic or Add Role buttons you can. See the Metadata Editor chapter for more details.
Every book should have a cover image, and Sigil can help you add one to your EPUB. You'll need to have an existing cover image available to use (and have permission to use it). In order to define an EPUB cover you will need to import the image into your EPUB, create a file to hold your cover, and mark the image and file as covers as described below.
To select the image you want as your cover, use FileNewAdd Existing Files:
Select your cover image from your file manager. Your EPUB now contains your cover image:
7 of 24
13/1/2013 1:31
Create an EPUB
You can double click your image file to display it in the main window.
However, there are still a few steps needed to identify it as a cover.
You need to create an HTML file and insert your cover image into the file. Create a new HTML file in your EPUB by right clicking on a file name in the Book Browser and selecting the menu option Add Blank Section:
A new HTML file will be created in your Text folder:
8 of 24
13/1/2013 1:31
Create an EPUB
Rename the file so you know what it is by right-clicking on the filename and selecting Rename from the menu:
Enter cover.xhtml as the new name (you can just type cover the extension will not change by default):
9 of 24
13/1/2013 1:31
Create an EPUB
Move the file to the top of the Text folder since a cover should be the first file of a book. You can drag-and-drop the file to its new position (click on the filename and hold the mouse down while you move it to its new position):
Now that we have an HTML file, we need to put your cover image into it. Double-click on the cover.xhtml file to open it in the Book View editor window (you will see cover.xhtml as the title of the open tab in the editor window), click somewhere in the blank window to start editing.
10 of 24
13/1/2013 1:31
Create an EPUB
Use EditInsert Image to select your image from the Images folder, or use the Insert Image icon on the toolbar:
This will display the Insert Images window:
11 of 24
13/1/2013 1:31
Create an EPUB
Select your image from the list of images in your EPUB. Your cover image will now appear in the file:
12 of 24
13/1/2013 1:31
Create an EPUB
Now that you have both a cover image and an HTML file with a cover in it, you need to mark both as Covers to make sure the various ereaders can recognize the cover: To mark the HTML file as a cover right-click on cover.xhtml in the Book Browser window, select the menu item Add Semantics, then choose the Cover entry:
13 of 24
13/1/2013 1:31
Create an EPUB
And to mark the image as a cover image right-click on the cover image in the Book Browser window, select the menu item Add Semantics, then choose the Cover entry. You must set both the image and the HTML file to type Cover to make sure all ereaders recognize the cover.
14 of 24
13/1/2013 1:31
Create an EPUB
Your EPUB now has a cover defined (if you look at the Add Semantics menu again for the files you will see the Cover items now have a checkmark next to them). You should save your book if you haven't already.
See the Images chapter for more details.
EPUBs support an interactive Table of Contents (abbreviated as TOC) to help readers find their way around your ebook. In an EPUB, the TOC is stored in a separate file in your book and readers can usually open it with a menu entry or button on their ereader at any time. You don't have to directly edit the TOC file since Sigil provides a way to generate it automatically from your ebook. Sigil will display the current TOC in a separate window. If you haven't defined any text as a chapter heading, then the Table of Contents window will be blank except for the Start placeholder text and two buttons for generating a new Table of Contents:
15 of 24
13/1/2013 1:31
Create an EPUB
In order to tell Sigil what your chapter headings are you need to highlight the text in your files (e.g. Chapter 1) and then click on the Paragraph Format icon (which will probably list Normal on the button if you have selected some standard text) at the top of the Book View window:
16 of 24
13/1/2013 1:31
Create an EPUB
Select Heading 1 for a top level heading. This will mark the the text as a heading at level 1 you can see that the format of the text and the dropdown menu has changed:
17 of 24
13/1/2013 1:31
Create an EPUB
When you click on a heading in your text the Paragraph Format menu will change to show the heading level.
You should now mark all the chapter headings in your document in the same way.
Once you have marked all your chapter headings you can click the Generate Table Of
Contents button on the Table of Contents window:
This will open the Heading Selector dialog:
The dialog allows you to mark which headings to include or not include in your Table of Contents. Click OK when you are finished. The Table of Contents window has now been updated to show your current TOC which includes the headings you selected:
18 of 24
13/1/2013 1:31
Create an EPUB
You should save your book if you haven't already.
You can also use Sigil to create create an inline TOC page using the Generate Inline HTML TOC button. This is not required or usually used in EPUBs, but if you convert to other formats or want a fancy TOC then its available.
See the Table of Contents chapter for more details.
This is an optional step you can skip this if you don't want separate files for your chapters. If you loaded an HTML file into Sigil, this usually means all of your text and chapters are in one large file. This is okay, but the standard practice with EPUBs is to put each chapter in your book into a separate HTML file. This makes it much easier to edit.
Since most ereaders start a new file in the EPUB on a new page, it means your chapters will also start on a new page.
The easiest way to split your book into one chapter per file is to do a bulk update by marking all the locations of your chapters and then have Sigil split at those points.
19 of 24
13/1/2013 1:31
Create an EPUB
You should save your book now, in case you want to undo any changes.
For each chapter heading in your book, click just to the left of the chapter heading so that your cursor is at the start of the line:
Now select EditInsert Chapter Marker to insert a marker in your text:
The marker will appear as a horizontal line:
20 of 24
13/1/2013 1:31
Create an EPUB
Do this for every chapter in your book.
Once you have inserted all your Chapter Markers into your file, you need to run EditSplit at Chapter Markers:
Your book will now be split into separate files as shown in the Book Browser:
21 of 24
13/1/2013 1:31
Create an EPUB
You can rename the chapters, and you should save your book once you have made your changes.
See the Splitting and Merging chapter for more details.
Your book is almost ready. You just need to check your EPUB to see if there are any issues that might cause problems for ereaders. This can range from missing or extra files, or broken links, etc. This may be unlikely for your first file, but its good practice to do the checks to make sure your EPUB is standard. To check or validate your book, use FileValidate. This will open a window just below your document and list any problems that were found. For instance, if you forgot to enter the Title of the book in the Metadata Editor you might see:
It can be difficult to interpret exactly what the issues are sometimes, but you should read through them to see if there is anything that you recognize and can fix. Once you've fixed all the errors Validate will confirm everything is okay:
22 of 24
13/1/2013 1:31
Create an EPUB
See the Validate and Clean chapter for more details.
All you need to do now is save your EPUB and you're done. Congratulations!
Table of contents
Cover Titlepage Copyright Introduction What's New About Sigil About EPUB Installation Windows Mac Linux Features User Interface Preferences Opening and Saving Files Book View Code View Preview View Book Browser Table of Contents (TOC) Metadata Validation Spellcheck Images Special Characters Splitting and Merging Find & Replace Saved Searches Clips Clipboard History Links and IDs Styles Indexes
23 of 24
13/1/2013 1:31
Create an EPUB
Reports External Editors Tutorials Create an EPUB Edit an EPUB Use Regular Expressions Create Links and Footnotes Use Stylesheets Include Custom Fonts Tips FAQ Common Questions Where to Get Help Starting Sigil Using Sigil Formatting and Styles Contributing to Sigil
previous page start next page
24 of 24
13/1/2013 1:31

Sigil-Create An

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Sigil-Create An

Uploaded by

Copyright:

Available Formats

Create an EPUB

Sigil User Guide

previous page next page

See the User Interface chapter for more details.

You can now use the button

The Metadata Editor window will be displayed:

However, there are still a few steps needed to identify it as a cover.

A new HTML file will be created in your Text folder:

This will display the Insert Images window:

See the Images chapter for more details.

This will open the Heading Selector dialog:

You should save your book if you haven't already.

See the Table of Contents chapter for more details.

Now select EditInsert Chapter Marker to insert a marker in your text:

The marker will appear as a horizontal line:

Do this for every chapter in your book.

See the Splitting and Merging chapter for more details.

See the Validate and Clean chapter for more details.

previous page start next page

You might also like