Automatische Bildkonvertierung

Jamdesk kann PNG- und JPG-Bilder während des Builds in das WebP-Format konvertieren. WebP-Dateien sind normalerweise 60–80 % kleiner als die Originale, ohne sichtbaren Qualitätsverlust. Dadurch laden Ihre Seiten schneller, ohne dass eine manuelle Bildverarbeitung erforderlich ist.

Die Funktion ist standardmäßig deaktiviert. Aktivieren Sie sie in Ihrer docs.json.

Aktivieren

Fügen Sie das Feld images.convertToWebp zu Ihrer docs.json hinzu:

{
  "images": {
    "convertToWebp": true
  }
}

Das ist die einzige Einstellung. Die Settings-Seite im Dashboard zeigt den aktuellen Status unter Config Highlights an, verfügt aber nicht über einen eigenen Schalter. docs.json ist die maßgebliche Quelle.

Was konvertiert wird

Konvertierte Bilder behalten ihren Basisnamen und erhalten die Erweiterung .webp. Jede Referenz in Ihrem MDX, benutzerdefiniertem CSS, benutzerdefiniertem JS und in der docs.json wird automatisch aktualisiert. Sie müssen keine Pfade ändern.

Was als Original erhalten bleibt

Einige Bilder bleiben auch bei aktivierter Konvertierung unverändert.

Favicons. Nicht jeder Browser und E-Mail-Client rendert WebP-Favicons zuverlässig.

Bilder für soziale Medien (og:image und twitter:image in Ihren seo.metatags) bleiben ebenfalls in ihrem ursprünglichen Format. Crawler sozialer Medien wie Facebook, LinkedIn, WhatsApp und ältere Versionen von Twitter/X rendern nicht alle WebP. Eine fehlerhafte Vorschaudarstellung ist schlechter als ein geringfügig größeres JPG.

Auch nicht verwendete Bilder werden übersprungen. Wenn eine Datei in Ihrem Verzeichnis /images liegt, aber weder von Ihrem MDX noch von der Konfiguration referenziert wird, wird das Original weiterhin in das CDN hochgeladen, aber nicht konvertiert. Es ist nicht sinnvoll, CPU-Zeit für etwas aufzuwenden, auf das nichts verweist.

Bilder, die von der Konvertierung nicht profitieren würden, bleiben als Originale erhalten. Wenn die WebP-Ausgabe größer als die Quelldatei wäre, wie es bei bereits komprimierten JPGs und sehr kleinen PNGs häufig vorkommt, behält Jamdesk das Original. Diese Bilder erscheinen in den Build-Statistiken als skipped.

Eine Ausnahme, die konvertiert wird, ist background.image. Dabei handelt es sich um einen vom Browser gerenderten Vollbildhintergrund, der wie jedes andere Bild von WebP profitiert.

Build-Fortschrittsanzeige

Wenn die Funktion aktiviert ist, zeigt Ihr Build den Schritt Optimizing images in der Fortschrittsliste des Dashboards an, zwischen „Building documentation“ und „Uploading to CDN“. Die jamdesk deploy CLI zeigt denselben Schritt in ihrer Fortschrittsausgabe im Terminal an. Wenn die Funktion deaktiviert ist, wird der Schritt überhaupt nicht angezeigt.

Build-Caching

Jamdesk speichert im Build-Manifest einen Hash jedes Quellbilds. Wenn sich eine Datei seit dem letzten Build nicht geändert hat, überspringt Jamdesk die Konvertierung und verwendet das zwischengespeicherte WebP erneut. Rebuilds bleiben auch bei Hunderten von Bildern schnell.

Fehlerbehandlung

Wenn die Konvertierung eines einzelnen Bildes fehlschlägt (beschädigte Datei, unzureichender Arbeitsspeicher, unerwartetes Format), bleibt das Original erhalten und der restliche Build wird fortgesetzt. Ihre Dokumentation wird durch einen Fehler bei der Bildkonvertierung nicht beschädigt.

Build-Protokolle

Zusätzlich zur Anzeige im Dashboard enthalten Ihre Build-Protokolle eine Zeile wie diese:

Optimizing images... done (4 converted, 2 cached, 1 skipped, 0 failed, saved 1.2 MB)