Eigenschaften beim Importieren von Markdown
Einige Aspekte des Imports hängen speziell mit dem Markdown-Dateiformat und der Art und Weise zusammen, wie es in gültiges XML konvertiert wird. Einige davon können Sie über die Import-Einstellungen an Ihre Anforderungen anpassen, während Sie bei anderen möglicherweise den eigentlichen Markdown-Inhalt anpassen müssen.
Die Ordnerstruktur nach dem Import in Paligo hängt von den in den Markdown-Dateien enthaltenen Überschriften (# Überschrift 1, ## Überschrift 2, ### Überschrift 3 usw.) in Verbindung mit der Importeinstellung „Max. Ordnerebenen“ ab. Jede Überschriftenebene wird als eigenes Topic importiert. Standardmäßig (wenn „Max. Ordnerebenen“ auf 1 belassen wird) wird jedes Topic der Überschrift 1 zusammen mit allen Untertopics in einem eigenen Ordner gespeichert. Wenn „Max. Ordnerebenen“ auf einen höheren Wert gesetzt wird, werden auch Überschriften niedrigerer Ebenen in eigenen Ordnern gespeichert.
Anmerkung
Ordner und Topics werden nach dem Inhalt der Überschrift benannt.
Jede Markdown-Datei enthält drei Überschriftenebenen (# Dateiname Überschrift 1, ### Dateiname Überschrift 2, ### Dateiname Überschrift 3).
 |
Jede Markdown-Datei enthält drei Überschriftenebenen (# Dateiname Überschrift 1, ### Dateiname Überschrift 2, ### Dateiname Überschrift 3).
 |
 |
 |
Beim Import mehrerer Dateien werden relative Links, die in der Verzeichnisstruktur nach oben führen (z. B. ../another_topic), auf das erste gefundene Ergebnis aufgelöst. Das bedeutet: Wenn Sie Dateien mit demselben Namen an mehreren Stellen in Ihrem Verzeichnis haben, werden relative Links, die nach oben zu all diesen Dateien führen, auf das erste Ergebnis in der Hierarchie aufgelöst.
Relative Links, die in der Verzeichnisstruktur nach unten verweisen, werden korrekt aufgelöst.
Um mögliche Verlinkungsfehler zu vermeiden und aus Gründen der Strukturkontrolle empfehlen wir Ihnen, alle Ihre Markdown-Dateien in einer einzigen großen Datei zusammenzufassen, wobei die Überschriftenebenen, Kennungen und relativen Links korrekt festgelegt sein sollten.
Die Bilder werden im Ordner „Media“ in einem Ordner abgelegt, dessen Name der Überschrift 1 der Markdown-Stammdatei entspricht, wobei die Unterordner den Namen des Topics tragen, aus dem das Bild referenziert wird.
Stellen Sie sicher, dass alle Bilder, die Sie importieren möchten, in der/den Markdown-Datei(en) korrekt und mit einem relativen Verweis angegeben sind.
Anmerkung
Bilder, auf die nicht verwiesen wird, werden nicht importiert, auch wenn sie in der importierten ZIP-Datei enthalten sind.
Wenn Ihre Markdown-Datei ein Inhaltsverzeichnis enthält, erstellt der Import ein separates Thema, das dieses Inhaltsverzeichnis enthält, einschließlich Querverweisen auf die entsprechenden Topics, auf die sich die Einträge beziehen.