I talked to John Schember and it seems that the best description of the format is:
Required:
- Single Zip archive containing a single HTML file required at top-level, any name.
Optional:
- Single optional OPF metadata file at top level - any name. Structure for OPF file is almost the same as ePub2.
* opf is allowed "metadata" section.
* opf is allowed "guide" section but only allowed 1 cover reference.
* No other guide features are supported.
- Cover:
* Cover image is allowed and if present must be referenced by the opf.
* Does not have to be referenced by the html file.
* Can be in any location. The opf will point to where it is located.
* Can be any image format (jpg is recommended).
* Can have any filename (cover is recommended).
- CSS, images and any other support files are allowed, and can be in
any location (top level or in sub directories). The html just has
to reference them by the relative path if they're in a sub directory.
- It can also place class based CSS inside of the head element in the HTML
itself, or write the CSS inline within each element.
Default structure for Calibre is:
index.html
metadata.opf
cover.jpg
style.css
images/
If anything here is not in accord with what you think, please let me know.
Paulo Ney
|