So installieren Sie SiteFab, erstellen eine neue Site und kompilieren sie in weniger als 30 Sekunden:
# install the main package
pip install sitefab
spacy download en_core_web_sm
pip install -U spacy-lookups-data
# clone the site template as base
git clone https://github.com/ebursztein/sitefab-template.git mysite/
# clone the plugins in your site directory
git clone https://github.com/ebursztein/sitefab-plugins.git mysite/plugins
# generate your shiny new site
sitefab -c mysite/config/sitefab.yaml generate
Und voilà! Sie wissen, dass Sie über eine voll funktionsfähige Site verfügen, die statisch kompiliert werden kann. Als nächsten Schritt sollten Sie Ihre Inhalte hinzufügen, die HTML-Vorlagen anpassen und die Plugin-Konfiguration nach Ihren Wünschen anpassen!
Hier sind einige der wichtigsten High-Level-Funktionen, die SiteFab zum statischen Generator der Wahl für moderne Websites machen:
<picture>
-Element, WebP-Versionen für die Browser, die es unterstützen, eingefrorene Miniaturansichten zum Laden und zugeschnittene Miniaturansichten für Vorschauen.Was SiteFab von anderen Site-Generatoren unterscheidet, sind neben seinen technischen Merkmalen seine Leitprinzipien:
Konfiguration statt Konvention : Jedes Verhalten wird explizit spezifiziert. Es gibt keine speziellen Dateien oder Verzeichnisse. SiteFab macht nur das, was in der Site-Konfiguration angegeben ist. Nicht mehr und nicht weniger.
Inhaltsunabhängig : Es gibt nur eine Art von Inhalt, den sogenannten Beitrag. SiteFab macht keine Annahmen über den in den .md-Dateien gespeicherten Inhalt. Seine Aufgabe besteht darin, die im Frontmatter angegebene Konfiguration anzuwenden, um die angegebenen Dateien zu rendern und sicherzustellen, dass die aktivierten Plugins ordnungsgemäß ausgeführt werden.
Atomarität : Jeder Inhalt ist in sich geschlossen, da er in seiner Frontmaterie eine eigene Konfiguration hat, einschließlich der zu verwendenden Vorlage. Dadurch können sowohl komplexe Websites mit Konfiguration pro Seite als auch sehr einfache Websites, die dieselbe Vorlage immer wieder verwenden, unterstützt werden.
Orthogonalität : Site-Konfiguration, Plugins und Plugin-Konfiguration sind unabhängig von der Kern-Engine, sodass Sie so viele Konfigurationen und optimierte Plugins verwenden können, wie Sie möchten. Darüber hinaus können Sie diese zusammen mit dem Inhalt Ihrer Website überprüfen, um reproduzierbare Builds, sichere Rollbacks und eine gleichzeitige Version der Build-Pipeline (z. B. Alpha oder Stable) zu gewährleisten.
Hier sind einige beliebte Alternativen, wenn SiteFab nicht das ist, wonach Sie suchen:
Jekyll: Die beliebteste Website zum Generieren, geschrieben in Ruby
.
Hugo: Ein beliebter Website-Generator, geschrieben in Go
, bei dem die Geschwindigkeit im Vordergrund steht.
Pelican: Ein weiterer in Python
geschriebener Site-Generator.