blob: 81b016bb26f6eef894233f7489b2546381a3ce87 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
nov.el
======
.. image:: https://raw.github.com/wasamasa/nov.el/master/img/novels.gif
About
-----
``nov.el`` provides a major mode for reading EPUB documents.
Features:
- Basic navigation (jump to TOC, previous/next chapter)
- Jump to next chapter when scrolling beyond end
- Renders EPUB2 (.ncx) and EPUB3 (<nav>) TOCs
- Hyperlinks to internal and external targets
- Supports textual and image documents
- View source of document files
- Metadata display
- Image rescaling
Screenshot
----------
.. image:: https://raw.github.com/wasamasa/nov.el/master/img/scrot.png
Installation
------------
You'll have to manually install `esxml
<https://github.com/tali713/esxml>`_ with the ``css-select`` branch
checked out first, then this package. Sorry about that!
Setup
-----
Make sure you have an ``unzip`` executable on ``PATH``, otherwise the
extraction of EPUB files will fail. If you for some reason have
``unzip`` in a non-standard location, customize ``nov-unzip-program``
to its path.
Put the following in your init file:
.. code:: elisp
(push '("\\.epub\\'" . nov-mode) auto-mode-alist)
Usage
-----
Open the EPUB file with ``C-x C-f ~/novels/novel.epub``, scroll with
``SPC`` and switch chapters with ``n`` and ``p``. More keybinds can
be looked up with ``F1 m``.
Contributing
------------
See `CONTRIBUTING.rst
<https://github.com/wasamasa/nov.el/blob/master/CONTRIBUTING.rst>`_.
Alternatives
------------
The first one I've heard of is `epubmode.el
<https://www.emacswiki.org/emacs/epubmode.el>`_ which is, well, see
for yourself. You might find `ereader
<https://github.com/bddean/emacs-ereader>`_ more useful, especially if
you're after Org integration and annotation support.
|
