Как конвертировать RST в EPUB
- Добавьте ваш файл .RST - перетащите его в поле выше или нажмите, чтобы выбрать.
- Конвертируйте его в .EPUB за несколько секунд.
- Скачайте ваш новый файл .EPUB.
Чего ожидать
- Специфические директивы Sphinx -
:ref:,:func:,.. toctree::- при конвертации с помощью Pandoc молча отбрасываются или остаются в виде простого текста; для таких проектов используйтеsphinx-build -b epub. - Изображения, на которые ссылаются через
.. image::или.. figure::, включаются только в том случае, если пути к их файлам разрешаются из каталога, в котором вы запускаете команду. - Вывод EPUB как из Pandoc, так и из Sphinx основан на HTML и не требует LaTeX, в отличие от конвертации в PDF, для которой часто требуется полная установка LaTeX.
Часто задаваемые вопросы
Является ли Pandoc бесплатным для использования?
Да. Pandoc - это программное обеспечение с открытым исходным кодом, бесплатное для Windows, macOS и Linux.
Нужен ли мне LaTeX для конвертации RST в EPUB?
Нет. EPUB основан на HTML, поэтому ни Pandoc, ни Sphinx не требуют установки LaTeX для вывода в формате EPUB.
В моем EPUB отсутствуют перекрестные ссылки и внутренние ссылки. Почему?
Скорее всего, это специфические директивы Sphinx. Переключитесь на
sphinx-build -b epub, чтобы расширения обрабатывались корректно.Какую версию EPUB создает Pandoc?
Pandoc по умолчанию выводит EPUB3. Добавьте
-t epub2 в команду, если ваш ридер требует более старый формат.
