Коллекция файлов Markdown для книги

У меня есть набор связанных файлов уценки. Я хотел бы создать книгу, например, в формате html или pdf. Я искал и нашел 3 инструмента:

  1. Электронная книга Пандок
  2. Гитбук
  3. Bookdown

Какие функции я ищу:

  • Совместимые расширения Chrome/Chromium, которые позволяют копировать содержимое веб-сайта и вставлять его в формат назначения (такая возможность есть у уценки)
  • Я использую VS Code, чтобы писать свои заметки в файлах уценки, мне нужна поддержка утилиты сборки для автоматизации рендеринга уценки. Поскольку я продолжаю добавлять новые файлы уценки на лету, может быть, утилита сборки может генерировать обновленный блокнот, скажем, каждые 15 минут.
  • Мои заметки имеют большую структуру, которая может иметь несколько уровней подкаталогов, поэтому утилита сборки должна иметь возможность рекурсивно добавлять все файлы (порядок, в котором файлы должны добавляться, может быть определен числом, указанным в заголовке файлов yaml ).
  • Хотя я не против платить за софт, но было бы неплохо иметь самые дешевые инструменты.

Если вы использовали эти инструменты, можете ли вы порекомендовать мне подходящий инструмент (пожалуйста, подтвердите его сравнением плюсов и минусов)?

Пожалуйста, перечислите функции, которые вам нужны, и любые ограничения, такие как ОС и цена, а затем попросите рекомендации , а не сравнения.

Ответы (1)

Лично я бы посоветовал взглянуть на Sphinx-Doc , который представляет собой инструмент документации Python, который использует ReStructuredText (с поддержкой Markdown ) для создания красивой документации в нескольких форматах, все с перекрестными ссылками, встроенными изображениями и т. д .:

  • HTML-сайт (с возможностью поиска)
  • HTML-справка
  • PDF-документ
  • электронная книга

Особенности включают в себя:

  • Иерархическая структура
  • Генерация оглавления
  • Генерация индекса или индексов
  • Сноски
  • Глоссарии
  • Внешние ссылки
  • Код с подсветкой синтаксиса (для более чем 80 языков программирования).
  • Хорошая интернационализация.
  • Автоматическая генерация на readthedocs.org из репозиториев GitHub .
  • Несколько тем HTML в установке по умолчанию, и вы можете настроить или загрузить больше (даже для мобильных устройств ).
  • Степень контроля над созданием PDF.
  • Математическая визуализация (через расширения).
  • Make script может быть привязан к макросу в VS Code
  • Все инструменты:
    • Бесплатно (бесплатно)
    • Бесплатно (с открытым исходным кодом)
    • Кроссплатформенность (Windows/OS-X/Linux/другие)

Встроенные темы:введите описание изображения здесь

Есть ли у reStructuredText совместимые расширения Chrome/Chromium, которые позволяют мне копировать содержимое веб-сайта и вставлять его в формат назначения (у уценки есть такая возможность). Я спрашиваю, потому что я много копирую из Интернета в свои заметки.
Коллекция файлов Markdown для книги
СпросиСетьПолитика конфиденциальности1y, 0v