Skip to content

mavv/epub-css-starter-kit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Epub CSS Starter Kit
========================

Creating epubs that work in multiple readers can be painful, like debugging web problems back 
in the glory days of ie6. Only this time there is no firebug.

Here's a css file to help alleviate the pain.

If you find that it doesn't work on a particular reader, please file an issue containing the 
following items:

* Reader platform and version
* Sample html
* Sample css
* Expected result

Some issues are ereader bugs. Some are css bugs. Ideally the css will look "good enough" on 
most devices. You can then take the css and tweak it for devices you want to focus on.

Focus
======

What platform is the focus of this effort? Oddly enough, the .mobi format for Kindle, is the least 
common denominator that we want to get working. Given that it has 70% of the market, it makes sense 
to put the effort there. Every effort has been made so that epubs using this css will generate clean
mobi's with kindlegen.

The other platforms of significance are nook and ibooks, in that order. Any other platform is icing 
on the cake. Support for other platforms will be given provided they don't break the top 3 platforms.
Otherwise it is suggested that these one off platforms be given custom css on top of the starter kit.

TODO
=====

How you can help

* Need to get a css file to start from
* Matrix of supported HTML http://wiki.mobileread.com/wiki/Device_Compatibility
* Matrix of supported eReaders
* Generate a sample book showing off html/css
* Documentation of how to use the css
* Try out the css or sample book and file bugs/patches

Resources
==========
* Demo epub at http://manual.calibre-ebook.com/conversion.html#epub-advanced-formatting-demo
* http://www.paulsalvette.com/2011/08/epub-and-kindlegen-tutorial-ebook.html
* http://wiki.mobileread.com/wiki/CSS_template
* http://gbenthien.net/Kindle/index.html

License
==========

MIT License

About

A css file that should work for most epub readers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published