Migration von BeeFree

Das Paket @templatical/import-beefree konvertiert BeeFree-(BEE-)JSON-Templates in das TemplateContent-Format von Templatical.

WARNING

Dieses Paket befindet sich in aktiver Entwicklung. Einige Blocktypen und erweiterte Funktionen werden möglicherweise noch nicht vollständig unterstützt. Testen Sie Ihre konvertierten Templates, bevor Sie sie in Produktion einsetzen.

Installation

npm

npm install @templatical/import-beefree

pnpm

pnpm add @templatical/import-beefree

yarn

yarn add @templatical/import-beefree

bun

bun add @templatical/import-beefree

Ohne Build-Schritt (CDN)

Sie können es auch von einem CDN laden:

<script type="module">
  import { convertBeeFreeTemplate } from 'https://cdn.jsdelivr.net/npm/@templatical/import-beefree/+esm';
  // ...dann konvertieren wie im Abschnitt „Verwendung“ unten
</script>

Verwendung

import { convertBeeFreeTemplate } from '@templatical/import-beefree';

// Laden Sie Ihr BeeFree-Template-JSON
const res = await fetch('/api/beefree-templates/123');
const beefreeJson = await res.json();

// In das Templatical-Format konvertieren
const { content, report } = convertBeeFreeTemplate(beefreeJson);

// Im Editor verwenden
const editor = await init({
  container: '#editor',
  content,
});

// Den Konvertierungsbericht auf etwaige Probleme prüfen
console.log(report);

Die Funktion gibt ein ImportResult zurück mit:

• content — den konvertierten TemplateContent, bereit für den Editor
• report — einen Konvertierungsbericht mit dem Status jedes Blocks (converted, approximated, html-fallback oder skipped)

Status	Bedeutung
converted	Ohne Verlust auf einen Templatical-Block abgebildet.
approximated	Abgebildet, mit Clamp oder Flatten — note sagt, was sich geändert hat.
html-fallback	Kein Block-Äquivalent; das Original-Markup ist ein HtmlBlock.
skipped	Keine Ausgabe (Formulare und alles, was der Konverter ablehnt).

Das JSON, das BeeFrees Editor speichert (page.rows), ist die Eingabe. Ein kompiliertes HTML-Export ist ein anderes Envelope — @templatical/import-html.

Block-Zuordnung

BeeFree-Blocktypen werden den Templatical-Äquivalenten zugeordnet:

BeeFree-Modul	Templatical-Block	Status
Text	paragraph	Konvertiert
Paragraph	paragraph	Konvertiert
Heading	title	Konvertiert
List	paragraph	Konvertiert
Image	image	Konvertiert
Button	button	Konvertiert
Divider	divider	Konvertiert
Spacer	spacer	Konvertiert
Social	social	Konvertiert (16 Plattformen zugeordnet)
Html	html	Konvertiert
Menu	menu	Angenähert (Stile können abweichen)
Video	video	Konvertiert
Table	table	Konvertiert

Unbekannte Modultypen werden als Fallback in HTML-Blöcke konvertiert.

Konvertierung von Spaltenlayouts

BeeFree organisiert Inhalte in Zeilen mit Spalten. Diese werden einem Templatical-SectionBlock mit dem entsprechenden ColumnLayout zugeordnet:

BeeFree-Spalten	Templatical-Layout
1 Spalte (100%)	'1'
2 gleiche Spalten	'2'
3 gleiche Spalten	'3'
2 Spalten (~33/66)	'1-2'
2 Spalten (~66/33)	'2-1'

Spaltenbreiten, die nicht einem Standardverhältnis entsprechen, werden dem am nächsten liegenden verfügbaren Layout zugeordnet.

Template-Einstellungen

Globale Template-Einstellungen werden soweit möglich konvertiert:

• Breite -- BeeFrees page.body.content.style.width wird settings.width zugeordnet
• Hintergrundfarbe -- Zeilen- und Body-Hintergrundfarben bleiben erhalten
• Schriftfamilie -- Die Standard-Schriftfamilie wird in settings.fontFamily übernommen

Bekannte Einschränkungen

• Benutzerdefinierte Schriftarten -- BeeFrees Deklarationen für benutzerdefinierte Schriftarten werden nicht automatisch importiert. Fügen Sie sie manuell über die Konfigurationsoption fonts hinzu.
• Bedingte Anzeige -- BeeFrees Regeln für dynamische Inhalte haben kein direktes Äquivalent und werden während der Konvertierung verworfen.
• Icons -- Benutzerdefinierte Icon-Uploads von BeeFree werden nicht migriert. Standard-Social-Plattform-Icons werden anhand des Namens zugeordnet.
• Formulare -- BeeFrees Formularblöcke haben kein Templatical-Äquivalent und werden übersprungen.
• Erweitertes Styling -- Einige granulare BeeFree-Stileigenschaften (z. B. Padding-Überschreibungen pro Spalte, Hintergrundbilder in Inhaltsbereichen) werden möglicherweise nicht vollständig beibehalten.

Konvertierte Templates überprüfen

Überprüfen Sie nach der Konvertierung die Ausgabe im Editor auf:

1. Fehlende Bilder (bei Bedarf erneut hochladen oder URLs aktualisieren)
2. Schriftrendering (fügen Sie der Editor-Konfiguration benutzerdefinierte Schriftarten hinzu)
3. Spaltenproportionen (passen Sie Layouts an, wenn die automatische Zuordnung nicht passt)
4. Abstände und Padding (Feinabstimmung im Block-Einstellungsbereich)