Eine Sammlung von Markdown-Dateien zu einem Buch

Ich habe eine Reihe verwandter Markdown-Dateien. Ich möchte ein Buch im Format html oder pdf erstellen. Ich habe 3 Tools gesucht und gefunden:

  1. Pandoc-eBook
  2. Gitbook
  3. Buchen

Welche Funktionen suche ich:

  • Kompatible Chrome/Chromium-Erweiterungen, mit denen ich den Inhalt der Website kopieren und in das Zielformat einfügen kann (Markdown hat diese Funktion)
  • Ich verwende VS Code, um meine Notizen in Markdown-Dateien zu schreiben. Ich hätte gerne Unterstützung für ein Build-Dienstprogramm, um das Rendern von Markdown zu automatisieren. Da ich laufend neue Markdown-Dateien hinzufüge, könnte das Build-Dienstprogramm das aktualisierte Notebook beispielsweise alle 15 Minuten generieren.
  • Meine Notizen haben mehr Struktur, die mehrere Ebenen von Unterverzeichnissen haben könnte, daher sollte das Build-Dienstprogramm in der Lage sein, alle Dateien rekursiv hinzuzufügen (die Reihenfolge, in der die Dateien hinzugefügt werden sollen, kann durch eine Zahl definiert werden, die im YAML-Header der Dateien angegeben ist ).
  • Ich habe zwar nichts dagegen, für eine Software zu bezahlen, aber es wäre schön, die billigsten Tools zu haben.

Wenn Sie diese Tools verwendet haben, können Sie mir ein geeignetes Tool empfehlen (bitte mit einer Gegenüberstellung von Vor- und Nachteilen belegen)?

Bitte listen Sie die Funktionen auf, die Sie benötigen, und alle Einschränkungen wie Betriebssystem und Preis, und fragen Sie dann eher nach Empfehlungen als nach Vergleichen.

Antworten (1)

Persönlich würde ich vorschlagen, einen Blick auf Sphinx-Doc zu werfen , ein Python-Dokumentationstool, das ReStructuredText (mit Unterstützung für Markdown ) verwendet, um eine schöne Dokumentation in einer Reihe von Formaten zu erstellen, alle mit Querverweisen, eingebetteten Bildern usw .:

  • HTML-Website (durchsuchbar)
  • HTML-Hilfe
  • PDF-Dokument
  • eBook

Features sind:

  • Hierarchische Struktur
  • Erstellung des Inhaltsverzeichnisses
  • Generierung von Index oder Indizes
  • Fußnoten
  • Glossare
  • Externe Links
  • Code ist Syntax hervorgehoben (für über 80 Programmiersprachen).
  • Gute Internationalisierung.
  • Automatische Generierung auf readthedocs.org aus GitHub- Repositories.
  • Mehrere HTML-Designs in der Standardinstallation und Sie können weitere anpassen oder herunterladen (sogar für Mobilgeräte ein freundliches Design ).
  • Ein gewisses Maß an Kontrolle über die PDF-Generierung.
  • Mathematisches Rendern (über Erweiterungen).
  • Make-Skript könnte an ein Makro in VS Code gebunden werden
  • Alle Werkzeuge sind:
    • Kostenlos (gratis)
    • Kostenlos (Open-Source)
    • Plattformübergreifend (Windows/OS-X/Linux/Andere)

Eingebaute Themen:Geben Sie hier die Bildbeschreibung ein

Verfügt reStructuredText über kompatible Chrome/Chromium-Erweiterungen, mit denen ich den Inhalt der Website kopieren und in das Zielformat einfügen kann (Markdown hat diese Funktion). Ich frage, weil ich viel aus dem Internet in meine Notizen kopiere und einfüge.