harbour-books/docs/formats.en.html
Slava Monich cd357843cb Squashed 'fbreader/fbreader/' content from commit 7abc80d
git-subtree-dir: fbreader/fbreader
git-subtree-split: 7abc80d12fab06b05ea1fe68a0e73ea5e9486463
2015-05-26 23:59:24 +03:00

153 lines
7.9 KiB
HTML

<h3><center>Electronic Book Formats (supported and unsupported)</center></h3>
<p>Firstly, FBReader is an open source application, and as result all formats FBReader
currently supports are open formats. Theoretically, FBReader's engine could be used as a part of a
closed-source application that would be supporting books in some DRM-ed/non-open format. However this
requires desire not only of FBReader developers, but also that of owners of the corresponding
format.</p>
<p>Secondly, since FBReader's authors have limited resources, formats that have the following properties are
considered first:<ul>
<li>popularity of the format (usually this means that there are at least several books in this
format :))</li>
<li>the format is expected to be used for books and, first of all, fiction books (we do not have
any short-term plans to add support for any spreadsheet format)</li>
<li>the format is text based, and not image based (e.g. if a book is just a collection of
TIFF-images within a container of some sort (archive or other), then it's most likely that
implementation of this format will be prioritized rather low)</li>
</ul></p>
<p>We do not aim to make support for a particular format as complete as possible so it would cover
all options listed in the format description, e.g. those that would unlikely to be used in real
life. In many cases that would require a significant effort that would not result in
visible effect for the end user. However if a particular file is rendered incorrectly
from your point of view, please contact us and if possible include the offensive file and we will
try to fix the situation.</p>
<p>In the foreseen future we plan to make format support pluggable &mdash; this will help to separate the
application from the actual format support.</p>
<h4>Issues Common for All Formats</h4>
<p>There are two non-implemented features that many formats required:<ul>
<li>support of style sheets included in the book (e.g. for HTML that would be CSS declarations)</li>
<li>table support</li>
</ul>
We plan to implement both, when it becomes clear how they should be rendered (this is especially
important for small screens).</p>
<p>These features are not metioned in the table below.</p>
<h4>Missing formats</h4>
<p>If your favourite format is not listed here, please tell us about it. If you are able to give us
[a link to] the format description and can give a few books in this very format, we might be able to
implement support for it.</p>
<h4>List of formats and information about their support in FBReader</h4>
<table class="formats" align="center" width="90%" border="0">
<tr style="line-height:150%;font-weight:bold;">
<td class="formats">Format</td>
<td class="formats">Comments</td>
</tr>
<tr>
<td class="formats"><a href="http://www.plkr.org/">plucker</a></td>
<td class="formats">This format has commands for &ldquo;absolute positioning&rdquo;, which are targeted to the
devices with specific screen resolution (e.g. &ldquo;put the item 2 pixels away from the left
border&rdquo;.) Since FBReader aims to allow reading on devices with different screen sizes and
resolutions, such commands may be interpreted depending on the context and, in some cases, be
completely ignored.</td>
</tr>
<tr>
<td class="formats"><a href="http://en.wikipedia.org/wiki/Open_eBook">Open E-Book (oeb)</a></td>
<td class="formats">The format specification is quite extensive, while there's no a great deal of available books
[yet?]. As far as we know, FBReader reasonably well renders books in this format.</td>
</tr>
<tr>
<td class="formats"><a href="http://www.openreader.org/">OpenReader</a></td>
<td class="formats">The situation is the same as with the Open E-Book.</td>
</tr>
<tr>
<td class="formats"><a href="http://www.idpf.org/">epub</a></td>
<td class="formats">Support for this format is far from being complete, however we plan to improve it.</td>
</tr>
<tr>
<td class="formats">html</td>
<td class="formats">Generally speaking, HTML is not a book format. It has many elements that are related to the
visual rendering, while it lacks elements related to the book structure (as result, it's quite
impossible to determine a table of contents for an arbitrary book in HTML format). FBReader has
limited support for HTML, however it proved to be sufficient for the majority of books available
out there.</td>
</tr>
<tr>
<td class="formats"><a href="http://www.fictionbook.org/index.php/English">fb2</a></td>
<td class="formats">From practical point of view, version 2.0 of the format specification is fully supported. To
be compliant with version 2.1 of the standard, FBReader lacks support of tables.</td>
</tr>
<tr>
<td class="formats">plain text</td>
<td class="formats">This format is supported. However FBReader might not always correctly split text into
paragraphs.</td>
</tr>
<tr>
<td class="formats">ztxt (<a href="http://gutenpalm.sourceforge.net/">Weasel Reader</a> format)</td>
<td class="formats">This is just a compressed text. Comments for the previous format are also applicable for this
one.</td>
</tr>
<tr>
<td class="formats"><a href="http://en.wikipedia.org/wiki/PalmDoc">Palmdoc (Aportis Doc)</a></td>
<td class="formats">This format is fully supported.</td>
</tr>
<tr>
<td class="formats">tcr (Psion Text)</td>
<td class="formats">This format is fully supported.</td>
</tr>
<tr>
<td class="formats"><a href="http://www.mobipocket.com/">Mobipocket</a></td>
<td class="formats">DRM-ed and/or files compressed with secret algorithm of Mobipocket are not supported.</td>
</tr>
<tr>
<td class="formats">chm</td>
<td class="formats">There's no complete open description of this format, while there is an open source library
called chmlib that allows to work with the format as well as many open source applications that
use this library to read and render files in this format. FBReader's support is implemented
independently from chmlib as result rendering might be different.</td>
</tr>
<tr>
<td class="formats"><a href="http://en.wikipedia.org/wiki/Rich_Text_Format">rtf</a></td>
<td class="formats">FBReader has minimal support for RTF.</td>
</tr>
<tr>
<td class="formats"><a href="http://en.wikipedia.org/wiki/Portable_Document_Format">pdf</a></td>
<td class="formats">This format is not supported. Files in this format may contain just text as well as image
representation of pages. We plan to include PDF support in FBReader: first support for files
that are using text only.</td>
</tr>
<tr>
<td class="formats"><a href="http://djvu.org/">djvu</a></td>
<td class="formats">This format is not supported. Our current plans do not include this format either.</td>
</tr>
<tr>
<td class="formats">doc (Microsoft Word)</td>
<td class="formats">This format is not supported. Probably this format will be partially supported using catdoc.</td>
</tr>
<tr>
<td class="formats">odt</td>
<td class="formats">This format is not supported. It might be supported in future, however the specification is
way too big, so most likely there will be some limitations.</td>
</tr>
<tr>
<td class="formats"><a href="http://www.msh-tools.com/ebook/lrfformat.html">lrf</a></td>
<td class="formats">This format is not supported. Our current plans do not include this format
either.</td>
<tr>
<td class="formats"><a href="http://www.isilo.com/">iSilo</a></td>
<td class="formats">This format is not supported. Actually there are two kinds of iSilo format: old one and new
one (iSiloX). Old format is open however, to the best of our knowledge, currently it is
practically not used at all. On the other hand iSiloX is a proprietary format, so as result it cannot
be supported in FBReader.</td>
</tr>
<tr>
<td class="formats">.lit</td>
<td class="formats">This format is not supported and is unlikely to be ever supported. It is a closed format
created and owned by Microsoft and any attempts to support it would be quite questionable from
legal point of view.</td></tr>
</table>
</body>