sign in sign up
<<
Home , Calibre (software), Sigil (application)

Sigil Tutorial - Overview

Sigil Tutorial - Overview:

1. Overview | 2. Importing Your Content | 3. Formatting Your Content | 4. Walkthrough

How to use Sigil to make ePub . We're going to cover the following topics:

Overview: Where to get Sigil, and a quick look at it's features Importing Your Content: Different ways to get your into Sigil Formatting Your Content - Making it look like a book. Walkthrough - Guided tour through making an using Sigil

First, you can download Sigil from here: http://code.google.com/p/sigil/

It's available for OS X (Mac), Windows, and .

Once you get it installed, the main screen will look like this:

The top part is the menu and toolbars, much like every other application out there.

The pane on the left shows the contents of the ePub Container (This should look familiar if you've read my manual ePub tutorial.)

The middle pane shows the contents of whatever file you've opened from the left pane. Sigil can edit any part of the

http://www.jedisaber.com/eBooks/Sigil01.shtml[2015-03-15 08:32:30] Sigil Tutorial - Sigil Overview

ePub file, including XHTML files (your book), CSS files, the ePub structure files, and you can add images to the ePub file right from Sigil too!

The right pane is the TOC, or Table of Contents, viewer. This is the stuff that shows if you press the Table of Contents button in your e-Reader.

Sigil can edit XHMTL files in either WYSIWYG, or code view, or a combination of both. (CSS files and the ePub structure files can only be edited in code view.)

Let's look at what the toolbar buttons do.

Toolbar buttons

New (Creates a new book) - Clicking this button will make a new, empty ePub book with nothing in it.

Open (Open a book from disc) - This will open a dialog that will let you pick an existing ePub book on your hard drive, and open it for editing. Note: Don't do this unless you really want to edit a book. Sigil might change some of the book's structure to make it easier to work on the book in Sigil, which might or might not mess up how the book looks right now.

Save (Save the current book) - If you've not saved your book before, this will open a dialog box asking you to enter a filename for your book, and where to save it on your hard drive. If you have saved before, or if you're saving changes to an ePub book that you've opened, it will just save without showing anything... you know, like every other program does.

Undo, Redo, Cut, Copy, and Paste - These also work just like they do in every other program. (An advanced clipboard feature is coming at some point, look for me to update this when it arrives.)

Find and Replace - Click this opens another pane that lets you.... find and replace text. This comes in very handy if your source is say, from a scanner, and lots of "fun" OCR errors.

WYSIWYG Viewing mode - This is the default view, and lets you edit your book almost exactly like you would in a word processor.

Mixed Viewing mode - This spits the content pane into a top pane that shows WYSIWYG content, and a bottom pane that shows the underlying code.

Code View - This shows the XHTML code that makes up your books content. Or, in other words, it shows what your content files would look like had you unzipped the ePub file and opened your content in a text editor. This should look familiar if you've read my manual tutorial.

Split at Cursor - This button splits the file into separate chapters. If book is imported as one big file, place the cursor where the chapter break should be, and click this button. Bam! New Chapter. If you're writing along, and need to start a new chapter, click this button, and it will make a new chapter file for you. More on this button later in the tutorial...

http://www.jedisaber.com/eBooks/Sigil01.shtml[2015-03-15 08:32:30] Sigil Tutorial - Sigil Overview

Insert Image - This adds an image to the current file that you're working in. Note that in Sigil 0.5.3, it does NOT add an image to the ePub container, and to add an image to your book, you have to add the image to the container first, or you will get an error when you click this button (Or the image won't be in the list of images...) To add an image to the container, you need to click File>>New>>Add an Existing file. Don't worry, it's not as complicated as it sounds, we'll go over this later.

Donate - Sadly, this doesn't mean to donate to me... It does, however, bring you to a page on the Internet where you can donate to Sigil's development. You won't ever use this button when making a book, but hopefully you'll click it at some point.. hey, Sigil is free, and our donations are all measly thanks the developers get for making this great program. (No, I'm not a Sigil developer, and am not affiliated with them in any way. I just use the program.)

Paragraph Style - This drop-down menu lets you set the paragraph style. Highlight a word, sentence, or paragraph, then select the style you want, and Sigil will automatically place the appropriate HTML elements into the code. (It will put

and

tags, for example, around what you've highlighted, making it a heading, for example). More on this later.

Bold, Italic, Underline, Align Right, Align Center, Align Left, Bullet list, Number List, Indent Left, Indent Right - Yeah, these all work the same as they do in a word processor too.

Validate ePub - This button.... validates your ePub file. It's really hard to make a bad enough mistake with Sigil that an ePub file won't open, but some reading software is more finicky than others, and this button looks for any and all errors. If it finds any, you get a box with the error code, and a not very helpful description of where the error is.

So, that's the main user interface of Sigil. The program can do a lot more than what these buttons do (For example, editing the meta information for your book (such as the author, genre, etc)), but they're the ones you'll be using the most often. We'll get into the other features ... that's right, later in the tutorial.

http://www.jedisaber.com/eBooks/Sigil01.shtml[2015-03-15 08:32:30] Sigil Tutorial - Sigil Overview

Sigil Tutorial - Importing Your Content:

1. Overview | 2. Importing Your Content | 3. Formatting Your Content | 4. Walkthrough

There are several different ways to get books into Sigil:

Type them in Sigil Open an existing ePub eBook Use another program to convert them to ePub, then edit with Sigil Copy and paste the text into Sigil, then edit it.

Typing a Book in Sigil

Sigil offers almost a full word processor interface, so you can type your book into Sigil, but that's not really what it's designed for.

It'll work, but you lose a few options, such as: scene and character building tools in programs like Scrivner; editable format for editors and critique partners; ability to put you document into standard manuscript format for submitting to agents and editors.

Sigil is for editing ePub files, and works best when used that way, to take an existing ePub file, and make it both beautiful and functional enough for digital publication. So, I'd recommend typing your rough draft in .doc format (Using MS Word, Open Office, , or your other favorite editor), then importing into Sigil when you're ready to publish it.

Open an existing ePub book

This is easy. Click the "Open" button on the Sigil toolbar, and it'll open right up.

Right about now, some of you may be thinking, "Why even use Sigil, then, if it can only open ePub files, and not import anything?"

For one, Sigil is about making , and editing ePubs. There are other programs to convert to ePub, and more and more programs have options to export to ePub.

"Okay," you might say, "That's nice, but why do I need Sigil if I can export to ePub using that other program?"

Well, go ahead and export your book (Which is in standard manuscript format, right?) using the export to ePub option, or something like . Look at the output. Yeah, it's readable (depending on what you converted it from), but is it pretty? Is it what you'd expect from a professionally published eBook? Yeah, I didn't think so. That's what Sigil is for.

Use another program to convert them to ePub, then edit with Sigil

This is how you're going to get most of your content into Sigil. Since the content is already in ePub format, you open it the same as above.

http://www.jedisaber.com/eBooks/Sigil02.shtml[2015-03-15 08:33:06] Sigil Tutorial - Sigil Overview

Most of the manuscripts you want to convert to ePub will probably be in .doc (MS Word) format. Programs like Atlantis, or Open Office (with an add-in) do a decent job converting .doc files into ePub books, but you'll probably want to tweak it a little. Adjust chapter breaks if the conversion program either missed or put an extra one in, format the chapter headings, paragraph margins, tweak the meta data (author, title, genre, ISBN, etc), and anything else.

Copy and paste the text into Sigil, then edit it

Sometimes, you have a format that just won't cooperate. (I'm looking at you, PDF!) In that case, you can copy the text, and paste it into Sigil. This used to be used the most with books. Being all text, they needed some special loving care when converted to ePub. Nowadays, though, you can download them in ePub.

You might also need to copy and paste the text in if the conversion program you're using happens to do a really bad job for some reason or another, or you can't afford or just don't trust an automated program to import content properly. (Calibre really does do an adequate job converting from most formats, and it's free.)

>> Continue to Part 3 of the Sigil tutorial: Formatting Your Content

Was this guide useful to you?

You can also follow my blog for updates on books I write, and also some ePub content: http://aarondemott.blogspot.com

Please consider donating a small amount to help pay the server costs. You don't have to, but if you would like to, I'd be very thankful!

http://www.jedisaber.com/eBooks/Sigil02.shtml[2015-03-15 08:33:06] Sigil Tutorial - Sigil Overview

Sigil Tutorial - Formatting Your Content:

1. Overview | 2. Importing Your Content | 3. Formatting Your Content | 4. Walkthrough

Now that we have some content in Sigil, let's make it look good!

We're to the real meat of this tutorial now, there's lots of topics that we can cover here. I'm going to cover some of the most common ones in no particular order. If there's something you want to know how to do, and don't see it here, e-mail me (e-mail is at the bottom of this page) and I'll eventually get around to adding it here (I might get to it faster if you donate...)

How to:

make text Bold, Italic, and Underlined make style paragraphs professionally (How to use CSS in Sigil) make a Table of Contents make a section divider

insert an image (and notes on Cover images)

edit meta-data (Author name, genre, ISBN and all that)

make a Chapter Break / make a section always be on a new page (insert page-break)

How to make text Bold, Italic, and Underlined

There's a button for that. See the first page of this tutorial

How to make style paragraphs professionally (How to use CSS in Sigil)

A picture is worth a thousand words here, so enjoy the following screenshots (click them to enlarge):

http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview

No CSS With CSS

I'm going to steal content from my manual tutorial here, as the CSS is the same. What's different, is that it's a lot easier to add a Cascading Style Sheet to your ePub file using Sigil than it is by hand.

/* Style Sheet for ePub Books */

/* Set margins at 2% (This gives a white border around the book) */

body {margin-left:2%; margin-right:2%; margin-top:2%; margin-bottom:2%;}

/* Text indent will make a paragraph indent, like putting a tab at the beginning of each new paragraph The margin settings get rid of the white space between paragraphs, again so it looks more like a book The text-align line justifies the margins. If you don't want them justified, change it to left, or remove that line You don't have to specify a font, but you can */

p {text-indent: .3in; margin-left:0; margin-right:0; margin-top:0; margin-bottom:0; text-align: justify; font-family:"Times New Roman";}

/* Here we make our headings centered We've also made the headings the same font as the body text */

http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview

h1 { text-align: center; font-family:"Times New Roman"; } h2 { text-align: center; font-family:"Times New Roman"; } h3 { text-align: center; font-family:"Times New Roman"; }

How to use all that green stuff:

1. Create a new Style sheet for your book: (If your book already has a stylesheet in it, you can just double- click it to edit it. Some converters will create a stylesheet for you, but you might want to modify it to change how your book looks.)

Click: File>>New>>Blank Stylesheet

This will add a stylesheet to the book browser pane, and open it for editing. (You might want to re-name it, for simplicity sake. To re-name the stylesheet, right-click it, and click, "Rename". Type in the name you want. (I usually just remove the numbers.))

2. Enter your CSS code

Any CSS code you want can go here. (Check the manual tutorial for the link to the IDPF page that lists the allowed CSS)

Fee free to copy the green CSS code from above and paste that in.

Close the stylesheet. (click the "X" next to the sheet's name on it's tab)

3. Add a link to the stylesheet on each file in your book that you want the code applied to. (Skip this step if your book already has a stylesheet.)

a. Click on the tab for your content, if it's open, or double-click on the name of the file you want to apply the code to in the book browser (the left hand pane). b. Click the "Code View" button . Add a new line after the line that starts with "" d. copy this code: <link rel="stylesheet" type="text/css" href="../Styles/Style0001.css" /> e. Paste into the new line you made in step c. (make sure that if you re-named your stylesheet, you need to change this line too.)</p><p>4. Repeat step 3 for each file in your book that you want to apply the stylesheet to.</p><p>How to Make a Table of Contents</p><p>In Sigil, making a table of contents is really easy. It does most of the work for you. All you have to do is make the text you want to be in the table of contents a heading, then click a button.</p><p>1. Highlight the text you want to be in the TOC (Table of Contents). (Usually, this will be the chapter headings, the big, "Chapter 1" and whatnot at the beginning of each chapter. 2. Click the arrow to the right of " " up in the upper left-hand corner. 3. Select a heading style (Heading 1, Heading 2, etc). (Normally, you'll want to choose "Heading 1". If you have sections under each chapter that you want to show up in the TOC, you'll choose "Heading 2" for</p><p> http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview</p><p> those.) 4. Repeat Steps 1 - 3 for all your chapter headings. 5. Click the " " button in the bottom right corner of the Sigil window. 6. Sigil will think for a moment, then the Table of Contents will show up in the pane right above the button.</p><p>How to make a section divider</p><p>A section divider is that line, image, or line of asterisks in books that goes between different scenes, or when you jump to a new character's point of view. You usually use them when you need such a divider, but don't want to start a new chapter yet.</p><p>In Sigil, you can do a section divider several different ways. You can use the asterisks, insert an image, or use a horizontal line (like the green ones that space out the different sections in this tutorial.)</p><p>I'd recommend putting at least one line of whitespace on either side of the section divider, this helps separate the sections a little more. (You do this the same way you would in a word-processor; just press the enter key before and after the section divider.)</p><p>To use an image, see the next section below. To use asterisks, just type three or four of them in (it looks nicer with a space between each of them) and then highlight them and click the button on the toolbar to center it. To use a horizontal line: Unfortunately, Sigil doesn't have a button to do this. We have to get messy in the XHTML code. Don't worry, it's not that hard. 1. Click the button to switch to code view 2. Put the cursor at the end of the line (after all that code stuff that comes after the last word) where you want the horizontal line to go. 3. Press the ENTER key. 4. Type: <hr width="75%" color="#008000"> 5. This will make a horizontal line that takes up 75% of the screen width, and is green. If you want it to be longer or shorter, just change the "75" in the code to whatever percentage you want. 6. If you want a grey line, remove the color="#008000" line. 7. If you want a different colored line, Click Here for a list of hex color codes, and replace the numbers in that sample with the numbers for the color you want. 8. (Click to exit code view.)</p><p>How to insert an image (and notes on Cover images)</p><p>Inserting an image is a two-step process. As you learned in the manual tutorial, an ePub book is composed of a few parts; the content, the XML files that describe the content, and the package that holds all that stuff. As a result of that, to add an image to your book, we first need to add the image to the package (you know, so the person who reads it only has to download one file that has everything they need.)</p><p>1. Click in the book where you want the image to go. 2. Click: "File>>New>>Add Existing File" 3. This will open a regular file open box where you can find the image you want to add. http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview</p><p>Click the filename for the image, then click the "Open" button. 4. This will add the image to the ePub container. If you click the + sign next to "Images" in the left-hand pane in Sigil, you'll see the filename for your image there. 5. To add the image to the book, click the button in the toolbar. 6. The following window will open:</p><p>The left side of this window will show the names of all the images that have been added to this ePub file. If you click on a filename, a preview of that image will show up in the right side of the window. 7. Click the "OK" button.</p><p>Notes on Cover Images:</p><p>Use the following guidelines to ensure that most reader software will be able to show a preview of your books cover image. You should follow ALL of the below guidelines to ensure that a preview image will show up in most readers.</p><p>The cover image should be named "Color.jpg" The cover image should actually be in the JPEG format. Most cover read PNG and GIF formats, but one or two of them will only properly display JPEG files as the cover image) The cover image should be the first thing in the book. (Some reader software grabs the first image and uses that for the cover, some look for a file named "Cover.jpg" and use that, and some look for both. Thus, if you follow both of these guidelines, the cover will display properly on almost every reader.) The cover should have the alt text "Cover". Alt text is text that is displayed when an image can't load for whatever reason. To set the alt text for the image: 1. Click the button to enter code view. 2. The code for the cover image should look something like this (it might have some height and width settings in there too): <img src="Images/Cover.jpg" /> 3. Add "alt="Cover"" so it looks like this: <img alt="Cover" src="Images/Cover.jpg" /></p><p> http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview</p><p>4. Click to exit code view. The cover image should be in it's own XHMTL file named "Cover.xhtml". 1. (The cover image is the first thing in the book, right?) Click just below the image to put the cursor after the cover image. 2. Click the button in the toolbar. 3. Tada! The cover image is now in it's own file! (That was easy!) 4. Right-click on the filename for the cover in the book browser (The left-hand pane)</p><p>5. Click "Rename" 6. Rename the file to "Cover.xhtml" (Without the quotes) If you want the cover image to show up in the Table of Contents: (and you might want to do this anyway. Some readers won't show the cover image as a thumbnail if it's not defined in the ePub's structure. And, you want your readers to be able to easily see your pretty cover picture, right? ;) ) 1. Click to enter Code View. 2. Find the line of code for your cover image. It should look like this: <img alt="Cover" src="Images/Cover.jpg" /> 3. Change it to look like this:</p><p><h1 title="Cover"> <img alt="Cover" src="Images/Cover.jpg" /> </h1></p><p>4. What is all that? <h1></h1> is how you make a heading in HTML, so to make our cover a heading, we put it inside these tags. Why do we want to do that? Well, remember that Sigil will auto-generate our Table of Contents based off from the heading tags (scroll up for how to do this), so if we want our cover image to show up in the Table of Contents, we want to make it a heading. The title="Cover" bit is the text that shows up in the Table of Contents. Most of the time, only text is going to be in-between those heading tags, so whatever text is there is going to show up in the Table of Contents. In this case, there is no text. Sigil uses that title attribute to over-ride whatever the text in the heading tags is when it generates the Table of Contents. More on that in a different section.</p><p>How to edit meta-data (Author name, genre, ISBN and all that)</p><p>Meta-data is all the information about the book that's not really in the book. Well, it might be on the copyright page, but this is how you make sure that the reader software knows what the book's title is.</p><p> http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview</p><p>1. Click: "Edit>>Meta Editor..." 2. The following window will open:</p><p>3. Type the name of the book in title. (I don't need to explain the "Author" box, do I?) 4. You can click the "Add Basic" or "Add Adv." buttons to add all kinds of other information like the ISBN, copyright, and all that other stuff too. 5. Click the "OK" button when you're done.</p><p>How to make a Chapter Break / make a section always be on a new page (insert page-break)</p><p>There a few options to always make a section start on a new page in an eReading app. Each different file inside the ePub container will do this. If you want the content to be in the same file, but still start on a new page, you can do that too.</p><p>You can spit a section off into it's own file by clicking the button in Sigil.</p><p>If you want to keep content in the same file, but still have it be at the top of a new page, switch to Code View and add this line where you want the page break</p><p><div style="page-break-before:always;"></div></p><p>That's it! Note that the page-break won't show in Sigil, but it will in your e-reader.</p><p>>> Continue to Part 4 of the Sigil tutorial: Walkthrough</p><p>Was this guide useful to you?</p><p>You can also follow my blog for updates on books I write, and also some ePub content: http://aarondemott.blogspot.com</p><p>Please consider donating a small amount to help pay the server costs. You don't have to, but if you would</p><p> http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46] Sigil Tutorial - Sigil Overview</p><p> like to, I'd be very thankful!</p><p> http://www.jedisaber.com/eBooks/Sigil03.shtml[2015-03-15 08:33:46]</p> </div> </div> </div> </div> </div> </div> </div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.1/jquery.min.js" integrity="sha512-aVKKRRi/Q/YV+4mjoKBsE4x3H+BkegoM/em46NNlCqNTmUYADjBbeNefNxYV7giUp0VxICtqdrbqU7iVaeZNXA==" crossorigin="anonymous" referrerpolicy="no-referrer"></script> <script src="/js/details118.16.js"></script> <script> var sc_project = 11552861; var sc_invisible = 1; var sc_security = "b956b151"; </script> <script src="https://www.statcounter.com/counter/counter.js" async></script> <noscript><div class="statcounter"><a title="Web Analytics" href="http://statcounter.com/" target="_blank"><img class="statcounter" src="//c.statcounter.com/11552861/0/b956b151/1/" alt="Web Analytics"></a></div></noscript> </body> </html>