Ganze site Zusammenstellung von markdown/pandoc?

Mit Sphinx-doc, können Sie eine Reihe von ReStructureText Dateien, die mit einem index.rst - Datei, die ein Inhaltsverzeichnis-makro, auto-generiert ein Inhaltsverzeichnis von die andere Dateien enthalten, und ein conf.py wirkt wie eine Zusammenstellung config. Sie können dann kompilieren Sie die Menge in einer einzigen python-doc-Stil Website, komplett mit index -, Navigations-tools, und eine Suche-Funktion.

Gibt es ein vergleichbares tool für markdown (vorzugsweise pandoc-Stil markdown)?

  • Gibt es auch einige (markdown) Dokumentation Werkzeug, das erzeugen von PDF-und ePub-so einfach wie die Sphinx hat?
  • Bearbeiten Sie in Markdown, konvertieren in XHTML mit pandoc und schließlich in PDF konvertieren mit dem PrinceXML, was Sie können oder können nicht verwenden Sie für freie (siehe CSO-Lizenz). Wieder, überprüfen Sie heraus meine Webseite für details. Es ist ein open-source-alternative namens wkhtmltopdf, das ist nicht gut, an der Seite brechen obwohl.
InformationsquelleAutor naught101 | 2013-03-14
  1. 9

    Einige statische Website-Generatoren, die Arbeit mit Markdown:

    Ich denke, dass keiner von Ihnen verwenden pandoc (vielleicht, weil es wurde in Haskell geschrieben), aber Sie alle verwenden eine erweiterte Markdown-syntax oder kann so konfiguriert werden, um pandoc.

    Auch andere interessante Möglichkeiten zum generieren einer Website von markdown:

    • Markdown-Wikis, die sind Datei-basiert: f.ex. Gollum, die Wiki-Engine, die auch von GitHub
    • Telegramm: kommerziell; geschrieben von David Pollak, der Erfinder der Fahrstuhl-Scala-framework

    Motoren verwenden Pandoc:

    Die endgültige Liste der Static-Site-Generatoren

    Einen guten überblick über statische site-Generatoren: http://staticsitegenerators.net/

    • Hyde ist im Grunde ein CMS, richtig? Ich will nicht etwas, dass ich wieder raus gelaufen. Einige andere, die interessant Aussehen, obwohl, vielen Dank für die Liste!
    • Soweit ich weiß, Hyde produzieren auch statische HTML-genau wie Jekyll.
    • Für diejenigen, die nach mir kommen: Pelican ist cool, aber es hat an einem blog, anstatt eine statische Seite, wie sphinx ist.
    • Was hast du denn am Ende? Ich bin auf der Suche nach einer ähnlichen Lösung.
    InformationsquelleAutor Sonson123
  2. 7

    Pandoc, die GNU machen und sed Befehle, bestreut mit einigen CSS sind alles, was Sie brauchen, um vollständig zu automatisieren die Erstellung einer statischen website ab Markdown.

    Pandoc bietet drei Befehlszeilen-Optionen beschrieben, die zur navigation zwischen den Seiten, sowie Erstellung eines Inhaltsverzeichnis (TOC) auf der Basis der überschriften innerhalb der Seite. Mit CSS können Sie die navigation und Inhaltsverzeichnis schauen und sich benehmen, wie Sie wollen.

    -B-DATEI, --include-vor-Körper=DATEI

    Gehören der Inhalt der DATEI, verbatim, an den Anfang des Dokuments Körper (z.B. nach den Tags in HTML oder \begin{document} - Befehl in LaTeX). Dies kann genutzt werden, um Navigationsleisten oder Banner in HTML-Dokumenten. Diese option kann mehrfach verwendet werden, um mehrere Dateien einzufügen. Sie werden in der angegebenen Reihenfolge. Impliziert --standalone.

    --Inhaltsverzeichnis --table-of-contents

    Ist eine automatisch generierte Inhaltsverzeichnis.

    --toc-depth=ZAHL

    Geben Sie die Anzahl der Abschnitt Ebenen in das Inhaltsverzeichnis auf.
    Der Standardwert ist 3, was bedeutet, dass level 1, 2, und 3-Header aufgeführt werden, die im Inhalt).

    Als eine Angelegenheit von der Tat, meine persönliche website, ist diese Art gebaut. Schauen Sie sich seine makefile für mehr details. Es ist alles frei-libre-open-source-Lizenz unter der GNU GPL version 3.

    • Äh... den Inhaltsverzeichnis-Optionen beziehen sich auf den Header innerhalb eine markdown-Datei. Ich spreche über ein Inhaltsverzeichnis über mehrere Dateien, die jeweils eine eigene Seite. Ihre persönliche Webseite ist eine einzelne Seite...
    • Ich bearbeitet meine Antwort. Navigation zwischen den Seiten können leicht behandelt werden mit der --include-before-body=FILE option.
    • Nein, Sie fehlt der Punkt. Sphinx-doc können Sie schreiben mehrere Seiten das als separate Dateien, und erzeugt dann eine HTML-Datei für jede Seite (mit einem Inhaltsverzeichnis in der side-bar), sowie ein voll-Seite-Inhaltsverzeichnis-html-Datei (die nicht haben .erste Quelle, aber es automatisch erzeugt). Das ist, was ich bin das Fragen.
    • Dann Sphinx-doc ist in der Tat mehr tun, als einige der Motoren (Gouda, Rippledoc,...) angeführt von dem original-poster.
    • on4aa: ich bin der OP. Ich sehe den Mangel an Klarheit in der Frage, obwohl, und bearbeitet.
    InformationsquelleAutor Serge Stroobandt
  3. 2

    Wenn Sie OK sind, nicht mit Pandoc, mkdocs würde scheinen, um Ihre Bedürfnisse anzupassen.

    Wenn Sie definitiv möchten, verwenden Pandoc-flavoured Markdown, Sie könnte prüfen,pdsite. Ich schrieb es als ein Weg, um mkdocs-Stil-Website-generation mit mehr input Formate (wie emacs org-mode) und ohne die Python-Abhängigkeiten - Sie passieren in einem Ordner von Markdown-Dateien und erhalten eine HTML-Seite (einschließlich der automatisch-generierten multi-level-navigation links). Es ähnelt Serge Stroobandt ist Ansatz, es ist nur ein shell-script (nicht von Ihnen verlangen, um tree jedoch installiert). Leider ist es nicht eine Suche-Funktion noch nicht, obwohl das wäre nicht zu hart zu...

    InformationsquelleAutor Gord Stephen
Schreibe einen Kommentar