Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Sigil

Notices

Closed Thread
 
Thread Tools Search this Thread
Old 10-24-2009, 12:35 PM   #1
mklynds
That guy, no not that guy
mklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with others
 
mklynds's Avatar
 
Posts: 337
Karma: 2846
Join Date: May 2009
Location: Alberta, Canada
Device: PRS600 Red
The Adventures of Joe Nobody and the Badly Formatted Epub! A Beginners FAQ!

Let me start by saying I am aware that I started a discussion in the main Sigil thread stickied at the top of the forum. After a short deliberation I figured that I am probably re-asking a lot of already answered questions and that these questions will likely be asked again.

I have decided that I will do my best to compile a Newbie FAQ. A beginners guide to Epub Perfection!!! I hope that all Sigil users, contributers and Creator, cough cough, will add there input and help make this a useful tool.

The format as I see it will be a collective posting and answering of questions that I will compile into an orderly manner in the first 5 or so posts in this thread. Feel free to post questions and answers in this thread. I will also watch other threads for Q & A that should be included.


[Official FAQ is here. -- Valloric]

Last edited by mklynds; 10-25-2009 at 01:21 AM.
mklynds is offline  
Old 10-24-2009, 12:35 PM   #2
mklynds
That guy, no not that guy
mklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with others
 
mklynds's Avatar
 
Posts: 337
Karma: 2846
Join Date: May 2009
Location: Alberta, Canada
Device: PRS600 Red
In The Beginning There Is The Download!!!

Q: What is Sigil?
A: Sigil is a WYSIWYG eBook editor. It is designed to edit books in ePub format.

Q: Why would I use Sigil?
A: You are tired of poorly formatted eBooks that don't do the book you are reading justice. You want your eBooks to feel and look like the real deal! You want to customize your reading experience! So many reasons, so little time!

Q: Okay, you sold me, where can I get Sigil?
A: Right here!

Q: Is it available on my OS?
A: Sigil is available for download and installation on Windows, Mac & Linux.

Q: I have downloaded the install files and now i have to install, help me?
A: Of course, Sigils creator has graciously provided us with these instructions.

Q: What is an ePub?
A: ePub is an open format defined by the Open eBook Forum of the International Digital Publishing Forum. It is based on XHTML and XML along with optional style sheets.

Q: What is .SGF then?
A: .SGF is the file type native to Sigil. It is used to save the data of your book as you edit it. It's the "working" code dumped raw. Also, it's proprietary to Sigil and shouldn't be used anywhere else.

Q: Why use .SGF and not just save it as an ePub?
A: With SGF, there is no preprocessing. The benefit here is that the user is isolated from the changes that are made when exporting an epub. In the future, when Sigil supports loading and saving of different file formats (RTF, Mobi, LIT, LRF etc... who knows), those formats will conceivably need some specific information recorded that cannot just store in an epub.

Q: So when do I make it an ePub?
A: You can save it as an ePub any time you like. It isn't actually necessary to do so until you are finished your project or want to view your work on your eReader.

Q:
A:

Q:
A:

Last edited by mklynds; 10-25-2009 at 12:58 AM.
mklynds is offline  
Old 10-24-2009, 12:36 PM   #3
mklynds
That guy, no not that guy
mklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with others
 
mklynds's Avatar
 
Posts: 337
Karma: 2846
Join Date: May 2009
Location: Alberta, Canada
Device: PRS600 Red
Okay Okay Sigil is installed. Now what? A beginners guide to Epub editing!

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Last edited by mklynds; 10-25-2009 at 12:35 AM.
mklynds is offline  
Old 10-24-2009, 12:36 PM   #4
mklynds
That guy, no not that guy
mklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with others
 
mklynds's Avatar
 
Posts: 337
Karma: 2846
Join Date: May 2009
Location: Alberta, Canada
Device: PRS600 Red
Hey that's a nice Epub! Can it get any better? An advanced guide to Epub editing!

Q: How can I use an Image for a Chapter heading (an image saying "CHAPTER ONE", and have it show up correctly in the Table of Contents (in text, as "CHAPTER ONE")?
A: You can put anything between the heading tags to make Sigil link to it in the NCX, and set the "title" attribute on the <h#> element to get the text.

So, "<h1 title='CHAPTER 1'><img ... ></h1>". The TOC would link to that heading element (and by extension, the images inside it) and the TOC entry would say "CHAPTER 1".
(from https://www.mobileread.com/forums/showthread.php?t=59619 )

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Q:
A:

Last edited by mklynds; 10-25-2009 at 12:54 AM.
mklynds is offline  
Old 10-24-2009, 12:39 PM   #5
mklynds
That guy, no not that guy
mklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with othersmklynds plays well with others
 
mklynds's Avatar
 
Posts: 337
Karma: 2846
Join Date: May 2009
Location: Alberta, Canada
Device: PRS600 Red
Once again another hold.
mklynds is offline  
Old 10-24-2009, 02:34 PM   #6
kjk
.
kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.kjk ought to be getting tired of karma fortunes by now.
 
Posts: 3,408
Karma: 5647231
Join Date: Oct 2008
Device: never enough
Q: What is the difference between the .sgf format and ePUB file format?

A: SGF just takes whatever the state of your XHTML code is in currently and dumps it as one large XHTML file (in an epub-like container, with the included images etc). The source file looks exactly like what you see in Code View.

Exporting an epub takes your source code, splits it up on chapter breaks, filters out Sigil-specific CSS and XHTML, creates CSS files from <style> tags and then writes it all out. So there is some (a lot actually) pre-processing going on.

(from https://www.mobileread.com/forums/showthread.php?t=53997 )

Q: How can I use an Image for a Chapter heading (an image saying "CHAPTER ONE", and have it show up correctly in the Table of Contents (in text, as "CHAPTER ONE")?

A: You can put anything between the heading tags to make Sigil link to it in the NCX, and set the "title" attribute on the <h#> element to get the text.

So, "<h1 title='CHAPTER 1'><img ... ></h1>". The TOC would link to that heading element (and by extension, the images inside it) and the TOC entry would say "CHAPTER 1".
(from https://www.mobileread.com/forums/showthread.php?t=59619 )

Last edited by kjk; 10-24-2009 at 02:40 PM.
kjk is offline  
Old 10-24-2009, 03:02 PM   #7
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,982
Karma: 350515
Join Date: Feb 2008
Device: Kobo Clara HD
I was actually planning on writing a FAQ wiki page on the Sigil website tomorrow . I may as well do it today then.

A thread like this where people could post what they think would be good Q&A's was planned. I'd then update the wiki if I found something interesting. So this thread may as well be it.

Consider this thread officially sanctioned and stickied.
Valloric is offline  
Old 12-27-2009, 09:03 AM   #8
moz
Addict
moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.
 
moz's Avatar
 
Posts: 370
Karma: 1553
Join Date: Feb 2008
Location: Melbun
Device: Kobo H2O
Q: where can I find a list of the keyboard shortcuts for Sigil?

Q: which regex engine is used, and where is the documentation for it?

Q: how do I access this mysterious "Import" function mentioned in the FAQ?

More FAQs will no doubt occur as I use the program more. I've been waiting for something to let me directly edit epubs. So far Sigil is definitely worth using!
moz is offline  
Old 12-27-2009, 10:02 AM   #9
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,982
Karma: 350515
Join Date: Feb 2008
Device: Kobo Clara HD
Quote:
Originally Posted by moz View Post
Q: where can I find a list of the keyboard shortcuts for Sigil?
All of the shortcuts are written next to the command names in the menus. Anything else is OS-standard, like PageUp, PageDown etc.

Quote:
Originally Posted by moz View Post
Q: which regex engine is used, and where is the documentation for it?
See this post.

Quote:
Originally Posted by moz View Post
Q: how do I access this mysterious "Import" function mentioned in the FAQ?
"Import" means "open".
Valloric is offline  
Old 12-27-2009, 05:17 PM   #10
moz
Addict
moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.moz once ate a cherry pie in a record 7 seconds.
 
moz's Avatar
 
Posts: 370
Karma: 1553
Join Date: Feb 2008
Location: Melbun
Device: Kobo H2O
q: can I use regular expressions in the replacement text?

Similar functionality to other editors - is there a way to mark part of the "find" expression and use it in the replace expression. For example find "The Book, Chapter [0-9]+:[^\n]+" and replace with "<h2>Chapter ...</h2>" where the "..." is the rest of the matched expression.

(thanks for the quick answers, btw, much appreciated)
moz is offline  
Old 12-27-2009, 05:25 PM   #11
rogue_ronin
Banned
rogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-booksrogue_ronin has learned how to read e-books
 
Posts: 475
Karma: 796
Join Date: Sep 2008
Location: Honolulu
Device: Nokia 770 (fbreader)
Generally, in regex, anything enclosed in parentheses () are stored for replacement. In your replace field, you put \1 for the first set of parentheses, \2 for the second, etc.

So:

Code:
Find: The Book, Chapter ([0-9]+):([^\n]+)
Replace: <h2>Chapter \1 -- \2</h2>
would find The Book, Chapter 17: The End of Mayonnaise
and replace it with
<h2>Chapter 17 -- The End of Mayonnaise</h2>.

m a r
rogue_ronin is offline  
Old 01-20-2010, 01:52 PM   #12
akratic
Junior Member
akratic began at the beginning.
 
Posts: 1
Karma: 10
Join Date: Jan 2010
Device: nook
The offical FAQ mentions that this thread is the right place to contribute to the official FAQ.

The answer to the following FAQ question: How do I add margins to the text? could be significantly improved.

In particular, body { margin-left: 2em; margin-right: 2em; } is recommended, which will only add left and right margins. Extending this example to body { margin: 2em } doesn't work well either, adding top and bottom margins only to the entire book.

After a fair bit of searching on this forum, I discovered that a better approach for margins is: @page { margin: 2em; } which will add margins to every page of the book.
akratic is offline  
Old 01-20-2010, 01:57 PM   #13
Elfwreck
Grand Sorcerer
Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.Elfwreck ought to be getting tired of karma fortunes by now.
 
Elfwreck's Avatar
 
Posts: 5,185
Karma: 25133758
Join Date: Nov 2008
Location: SF Bay Area, California, USA
Device: Pocketbook Touch HD3 (Past: Kobo Mini, PEZ, PRS-505, Clié)
Quote:
Originally Posted by akratic View Post
The answer to the following FAQ question: How do I add margins to the text? could be significantly improved.

In particular, body { margin-left: 2em; margin-right: 2em; } is recommended, which will only add left and right margins.
Using em for margins instead of points means that when the font size is increased, so are the margins, making readers who prefer a large font stuck reading two or three words in the center of a mostly-blank page.
Elfwreck is offline  
Old 01-20-2010, 02:01 PM   #14
zelda_pinwheel
zeldinha zippy zeldissima
zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.
 
zelda_pinwheel's Avatar
 
Posts: 27,827
Karma: 921169
Join Date: Dec 2007
Location: Paris, France
Device: eb1150 & is that a nook in her pocket, or she just happy to see you?
Quote:
Originally Posted by akratic View Post
The offical FAQ mentions that this thread is the right place to contribute to the official FAQ.

The answer to the following FAQ question: How do I add margins to the text? could be significantly improved.

In particular, body { margin-left: 2em; margin-right: 2em; } is recommended, which will only add left and right margins. Extending this example to body { margin: 2em } doesn't work well either, adding top and bottom margins only to the entire book.

After a fair bit of searching on this forum, I discovered that a better approach for margins is: @page { margin: 2em; } which will add margins to every page of the book.
to further expand on this point, i don't recommend using ems as the unit of measurement for margins, since that is a proportional unit (it is the width of the letter "m" in whatever font size you are using. if the font size itself is defined in ems, 1em is around 16pt). this means that if you enlarge the text, the margin will also be enlarged proportionally. it's better therefore either to use percentage (which is proportional as well, but to the size of the display) for example :
body {margin : 15%;}
or
@page {margin : 15%;}

or use pixels (this is a fixed unit and will not vary proportionally), for instance
body {margin : 20px;}
or
@page {margin : 20px;}

Last edited by zelda_pinwheel; 01-20-2010 at 02:06 PM.
zelda_pinwheel is offline  
Old 01-20-2010, 02:02 PM   #15
zelda_pinwheel
zeldinha zippy zeldissima
zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.zelda_pinwheel ought to be getting tired of karma fortunes by now.
 
zelda_pinwheel's Avatar
 
Posts: 27,827
Karma: 921169
Join Date: Dec 2007
Location: Paris, France
Device: eb1150 & is that a nook in her pocket, or she just happy to see you?
Quote:
Originally Posted by Elfwreck View Post
Using em for margins instead of points means that when the font size is increased, so are the margins, making readers who prefer a large font stuck reading two or three words in the center of a mostly-blank page.
heh. great minds. i was writing at the same time as you were posting.
zelda_pinwheel is offline  
Closed Thread

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Classic Bought a Badly Formatted Book From B&N lionel47 Barnes & Noble NOOK 11 05-22-2010 04:31 PM
Unutterably Silly How To Write Badly Well Madam Broshkina Lounge 4 11-04-2009 08:26 AM
Properly formatted PDFs to Epub AgentBEATS Calibre 10 11-01-2009 11:02 PM
Action Sala, George Augustus: Strange Adventures of Captain Dangerous 3 ePUB v1 13 jan 2009 mtravellerh ePub Books 0 01-13-2009 01:05 PM
Action Sala, George Augustus: Strange Adventures of Captain Dangerous 2 ePUB v1 12 jan 2009 mtravellerh ePub Books 0 01-12-2009 06:39 AM


All times are GMT -4. The time now is 10:10 AM.


MobileRead.com is a privately owned, operated and funded community.