mirror of
https://github.com/gryf/ebook-converter.git
synced 2026-01-01 15:32:26 +01:00
114 lines
2.8 KiB
ReStructuredText
114 lines
2.8 KiB
ReStructuredText
===============
|
|
Ebook converter
|
|
===============
|
|
|
|
This is impudent ripoff of the bits from `Calibre project`_, and is aimed only
|
|
for converter thing.
|
|
|
|
My motivation is to have only converter for ebooks run from commandline,
|
|
without all of those bells and whistles Calibre has, and with cleanest more
|
|
*pythonic* approach.
|
|
|
|
|
|
Requirements
|
|
------------
|
|
|
|
To build and run ebook converter, you'll need:
|
|
|
|
- Python 3.6 or newer
|
|
- `Liberation fonts`_
|
|
- setuptools
|
|
- C compiler (yes, there is a single module, which is written in C)
|
|
|
|
No Python2 support. Even if Calibre probably still is able to run on Python2, I
|
|
do not have an intention to support it.
|
|
|
|
|
|
What's supported
|
|
----------------
|
|
|
|
To be able to perform some optimization and make converter more reliable and
|
|
easy to use, first I need to remove some of the features, which are totally not
|
|
crucial in my opinion, although they might be re-added later, like, for
|
|
instance there is no automatic language translations depending on the locale
|
|
settings.
|
|
|
|
First of all, I'm in the process of getting rid of strongly coupled things to
|
|
QT libraries, and GUI code as well. Second, I'll try to minimize all
|
|
modifications from third parties (external modules copied into Calibre project
|
|
for instance), and make a huge cleanup. I'm not sure if I find time and
|
|
strength for doing it completely, but I'll try.
|
|
|
|
|
|
Input formats
|
|
~~~~~~~~~~~~~
|
|
|
|
Currently, I've tested following input formats:
|
|
|
|
- docx
|
|
- epub
|
|
- LibreOffice odt
|
|
- txt
|
|
- Palm pdb
|
|
- rtf
|
|
- mobi
|
|
- fb2
|
|
- html
|
|
- pdf
|
|
|
|
Note, that old Microsoft doc format is not supported, although old documents
|
|
can be fairly easy converted using text processors programs, lik Word or
|
|
LibreOffice to supported formats.
|
|
|
|
|
|
Output formats
|
|
~~~~~~~~~~~~~~
|
|
|
|
Currently, following formats are supported:
|
|
|
|
- lrf (for Sony readers)
|
|
- epub
|
|
- mobi
|
|
- docx
|
|
- htmlz (zipped HTML file with additional assets, like images)
|
|
- txt
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
Ebook converter is somewhere in between in alpha and beta stage, therefore I
|
|
didn't place it on `pypi`_ yet.
|
|
|
|
Preferred way for installation is to use virtualenv (or any other virtualenv
|
|
managers), i.e:
|
|
|
|
.. code:: shell-session
|
|
|
|
$ virtualenv venv
|
|
$ . venv/bin/activate
|
|
(venv) $ git clone https://github.com/gryf/ebook-converter
|
|
(venv) $ cd ebook-converter
|
|
(venv) $ # you can either use pip or just setuptools:
|
|
(venv) $ pip install .
|
|
(venv) $ # OR
|
|
(venv) $ python setup.py install
|
|
|
|
Simple as that. And from now on, you can issue converter:
|
|
|
|
.. code:: shell-session
|
|
|
|
(venv) $ ebook-converter book.docx book.lrf
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
This work is licensed on GPL3 license, like the original work. See LICENSE file
|
|
for details.
|
|
|
|
|
|
.. _Calibre project: https://calibre-ebook.com/
|
|
.. _pypi: https://pypi.python.org
|
|
.. _Liberation fonts: https://github.com/liberationfonts/liberation-fonts
|