Bild Stefan

Webseiten erstellen

Mit Markdown tolle Webseiten erstellen

Bild Blog


veröffentlicht: Do, 10.2.2022 16:52

Webseiten mittels Markdown erstellen

Markdown vereinfacht das Erstellen von Texten, die in verschiedenen Formaten erstellt werden müssen (html, pdf, txt). So kann man aus markdown-Texten Webseiten erstellen. Hierfür verwende ich pandoc.

Grundsystem

Um Webseiten zu generieren, benötigen Sie folgende Software:

Sie können die neueste Version von generate_php hier downloaden:

Windows Linux Standard Template
generate_php.exe generate_php standard.zip

Generelles Vorgehen bei der Erstellung einer Webseite

Nach der Erstellung des Grundgerüstes der Webseite (Entpacken der Datei standard.zip) kann die Datei index.md mit einem Editor angepasst werden. Neue Seiten werden als neue .md - Dateien hinzugefügt. Die neue Datei muss in der Datei Makefile registriert werden. Nach Fertigstellung der Änderungen ist make auszuführen. Zum Testen muss dann php lokal ausgeführt werden und die Seiten können am Browser angesehen werden.

Git Workflow
Git Workflow

Eine neue Seite anlegen und verlinken

Eine neue Webseite wird erstellt indem eine neue md-Datei angelegt (Bsp. markdown1.md) wird und diese im Makefile registriert wird.

neue Seite anlegen
neue Seite anlegen

Im Makefile (1) die neue Seite (Bsp: markdown1.php) registieren, indem der neue Seitenname ans Ende von Zeile 1 im Makefile angefügt wird (2).

Makefile anpassen
Makefile anpassen

Einführung in Markdown


Übersichtsbild 2
Teil 1: Text, Links und Bilder

Ich verwende folgende Syntax um Webseiten zu erstellen:

Übersichtsbild 3
Teil 2: Tabellen

Tabellen eignen sich besonders, wenn Zeilen und Spalten dargestellt werden sollen.



Hilfsmittel


Übersichtsbild 5
Makefile - Änderungen aktualisieren

Unter Linux ist make das Standardprogramm um abhängige Dateien zu aktualisieren.

Übersichtsbild 6
Editoren für Markdown

Es gibt verschiedene Editoren um Markdowndateien zu bearbeiten. Meine Favoriten sind:



Faktura Quick Links