Abzeichnen und mehrere Dateien einschließen

Die kurze Antwort ist Nein. Die lange Antwort ist ja. 🙂

Markdown wurde entwickelt, um Leuten zu erlauben, schreiben Sie einfachen, lesbaren text, der könnte sich einfach in eine einfache HTML-markup. Es nicht wirklich zu tun-layout. Zum Beispiel, es gibt keinen wirklichen Weg, um auszurichten, ein Bild nach rechts oder Links. Zu deiner Frage, es gibt keine markdown-Befehl, um einen einzelnen link von einer Datei zur anderen in einer beliebigen version von markdown (soweit ich weiß).

Dem am nächsten kommen könnte, um diese Funktionalität wird Pandoc. Pandoc können Sie Dateien Zusammenführen, als Teil der transformation, die es erlaubt Sie zu leicht machen, mehrere Dateien in einer einzigen Ausgabe. Zum Beispiel, wenn Sie schufen ein Buch, dann könnte man Kapitel wie:

01_preface.md
02_introduction.md
03_why_markdown_is_useful.md
04_limitations_of_markdown.md
05_conclusions.md

Können Sie Zusammenführen, indem Sie das ausführen dieses Befehls im selben Verzeichnis:

pandoc *.md > markdown_book.html

Da pandoc wird merge alle Dateien vor der übersetzung, können Sie Ihre links in der letzten Datei wie folgt:

01_preface.md
02_introduction.md
03_why_markdown_is_useful.md
04_limitations_of_markdown.md
05_conclusions.md
06_links.md

Damit einen Teil Ihrer 01_preface.md könnte wie folgt Aussehen:

I always wanted to write a book with [markdown][mkdnlink].

Und ein Teil Ihrer 02_introduction.md könnte wie folgt Aussehen:

Let's start digging into [the best text-based syntax][mkdnlink] available.

So lange, wie Sie Ihre Letzte Datei enthält die Zeile:

[mkdnlink]: http://daringfireball.net/projects/markdown

...der gleiche Befehl verwendet, bevor die Zusammenführung und Konvertierung während darunter, dass link während. So stellen Sie sicher, lassen Sie eine leere Zeile oder zwei am Anfang der Datei. Die pandoc-Dokumentation sagt, dass es fügt eine leere Zeile zwischen Dateien, die zusammengeführt werden, auf diese Weise, aber das hat nicht funktioniert für mich, ohne die leere Zeile.

InformationsquelleAutor der Antwort Aaron Massey

Können Sie tatsächlich mit der Markdown-Präprozessor (MarkdownPP). Läuft mit der hypothetischen Buch-Beispiel von der anderen Antworten, die Sie schaffen würde .mdpp Dateien für Ihre Kapitel. Die .mdpp Dateien können dann mit der !INCLUDE "path/to/file.mdpp" Richtlinie, die arbeitet rekursiv ersetzt die Richtlinie den Inhalt der referenzierten Datei in der endgültigen Ausgabe.

chapters/preface.mdpp
chapters/introduction.mdpp
chapters/why_markdown_is_useful.mdpp
chapters/limitations_of_markdown.mdpp
chapters/conclusions.mdpp

Sie benötigen dann einen index.mdpp enthalten, dass die folgenden:

!INCLUDE "chapters/preface.mdpp"
!INCLUDE "chapters/introduction.mdpp"
!INCLUDE "chapters/why_markdown_is_useful.mdpp"
!INCLUDE "chapters/limitations_of_markdown.mdpp"
!INCLUDE "chapters/conclusions.mdpp"

Rendern Ihrem Buch führen Sie einfach den Präprozessor auf index.mdpp:

$ markdown-pp.py index.mdpp mybook.md

Vergessen Sie nicht, Blick auf die readme.mdpp in der MarkdownPP repository für eine exposition von Präprozessor-Funktionen geeignet für größere dokumentationsprojekte.

InformationsquelleAutor der Antwort ninegrid

Meine Lösung ist die Verwendung von m4. Es unterstützt auf den meisten Plattformen und ist im binutils-Paket.

Ersten zählen ein makro changequote() in der Datei ändern, die quoting-Zeichen, was Sie bevorzugen (die Standardeinstellung ist `). Das makro wird entfernt, wenn die Datei verarbeitet wird.

changequote(`{{', `}}')
include({{other_file}})

Auf der Kommandozeile:

m4 -I./dir_containing_other_file/input.md > _tmp.md
pandoc -o output.html _tmp.md

InformationsquelleAutor der Antwort Ben Hochstedler

Ich denke, dass wir besser die Einführung eines neuen file inclusion syntax (also nicht versauen mit
code-Blöcke, ich denke, die C-Stil-die Aufnahme ist Total falsch), und ich schrieb ein kleines tool, das in Perl, Benennung cat.pl,
weil es funktioniert wie cat (cat a.txt b.txt c.txt verschmelzen die drei
Dateien), aber es vereint die Dateien in die Tiefe, nicht in der Breite. Wie zu benutzen?

$ perl cat.pl <your file>

Die syntax im detail:

• rekursive include-Dateien: @include <-=path=
• nur eins: %include <-=path=

Er ordnungsgemäß verarbeiten kann file inclusion Schleifen (wenn a.txt <- b.txt, b.txt <- a.txt dann, was erwarten Sie?).

Beispiel:

a.txt:

a.txt

    a <- b

    @include <-=b.txt=

a.end

b.txt:

b.txt

    b <- a

    @include <-=a.txt=

b.end

perl cat.pl a.txt > c.txt, c.txt:

a.txt

    a <- b

    b.txt

        b <- a

        a.txt

            a <- b

            @include <-=b.txt= (note：won't include, because it will lead to infinite loop.)

        a.end

    b.end

a.end

Weitere Beispiele https://github.com/district10/cat/blob/master/tutorial_cat.pl_.md.

Schrieb ich auch eine Java-version hat eine identische Wirkung (nicht die gleichen, aber in der Nähe).

InformationsquelleAutor der Antwort dvorak4tzx

Verwende ich eine includes.txt - Datei mit alle meine Dateien in der richtigen Reihenfolge
das führe ich pandoc wie diese:

pandoc -s $(cat includes.txt) --quiet -f markdown -t html5 --css pandoc.css -o index.html

Funktioniert wie ein Charme!

InformationsquelleAutor der Antwort Mike Mitterer

Multimarkdown hat dies nativ. Er nennt es Datei transklusion:

{{some_other_file.txt}}

ist alles was es braucht. Seltsame Namen, aber alle Boxen Zecken.

InformationsquelleAutor der Antwort eff