menimal

Menimal ?

Menimal ist ein minimaler statischer Site-Generator .

Konzentrieren Sie sich auf den Inhalt: Schreiben Sie einfach Markdown-Dateien und CSS-Stile und alles andere wird für Sie generiert

Menimal ist vom Design her minimalistisch:

• Kein Javascript (kein package.json )
• Keine HTML-Vorlagen
• Kein mdx
• Keine SEO oder Metadaten

---

• Erste Schritte
  • Einsetzen
• Ordnerstruktur
  • pages
  • static
  • config.json
  • style.css
• Roadmap
• Lizenz
• Notizen
  • Andere statische Site-Generatoren
  • Entwicklung
  • Durchführung

Erste Schritte

Menimal ist ein einzelnes npx -Skript, das Sie von überall aus ausführen können, ohne ein Paket zu installieren.

Stellen Sie sicher, dass NodeJs auf Ihrem Computer installiert ist

Sie müssen nur einen einzigen Befehl ausführen:

npx menimal

Dadurch wird ein build -Ordner erstellt, der Ihre statische Website enthält.

Einsetzen

Hosting-Plattformen ermöglichen die Definition eines Build-Befehls und eines Ausgabeordners:

• Build-Befehl: npx menimal
• Ausgabeordner: build

Das ist alles. Sie können Menimal überall einsetzen?

---

Ordnerstruktur

Menimal erfordert eine genaue Ordnerstruktur:

• pages : enthält Markdown-Dateien ( .md )
• static : enthält statische Dateien ( robots.txt , fonts , favicon.ico )
• config.json : enthält Site-Konfiguration (minimal)
• style.css : enthält Stile (einzelne CSS-Datei)

Das vollständige und funktionierende Beispiel finden Sie im Beispielordner

pages

Jede Markdown-Datei entspricht einer .html Seite auf der Website.

Der Name der Datei .md wird verwendet, um sowohl den Namen der HTML-Datei als auch den Titel der Seite zu generieren:

• HTML-Datei: wie .md nur mit Kleinbuchstaben
• Titel: wie .md - jedoch durch Leerzeichen ersetzt

Beispielsweise generiert This-is-the-Title-of-the-article.md Folgendes:

• HTML: this-is-the-title-of-the-article.html
• Titel: Dies ist der Titel des Artikels

static

Alle Dateien in static werden im endgültigen Build kopiert.

Hier können Sie Bilder, Schriftarten, robots.txt , favicon.ico , sitemap.xml oder alles andere hinzufügen

config.json

Für die Konfiguration ist vorerst ein einziges Feld erforderlich: der Name der Website, der in <header> angezeigt wird:

{
  "name" : " Sandro Maglione "
}

style.css

Alle Stile sind in einer einzigen CSS-Datei definiert.

Sie können die generierte HTML-Struktur jeder Datei in Vorlagen anzeigen

Diese Datei wird minimiert und in jede generierte Seite importiert.

Roadmap

• Laden Sie Schriftarten in HTML vor

 < link rel =" preload " href =" font.woff2 " as =" font " crossorigin type =" font/woff2 " > 

Lizenz

MIT-Lizenz, Einzelheiten finden Sie in der Datei LICENSE.md.

---

Notizen

Dieses Projekt ist Teil meines wöchentlichen Newsletters auf sandromaglione.com .

Andere statische Site-Generatoren

• Hexo
• Jekyll
• Hugo

Entwicklung

• Verwenden Sie npx --loglevel silly .. aus example , um npx -Befehl zu debuggen

Durchführung

Alle Details zur Umsetzung im vollständigen Artikel lesen ?