Documentation développeur VN-Designer
10

Paquets et thèmes (.vndext)

Structure d'un fichier de paquet (.vndext) avec blocs et fichiers de thème, params.json, blocs à l'échelle du site, règles d'import, CSS du thème et un mini-thème complet en exemple.

Vue d'ensemble#

Un paquet est un fichier ZIP portant l'extension .vndext. Il contient un ou plusieurs blocs (composants) et, en option, les fichiers communs d'un thème (CSS, images, polices). L'import ne vérifie que le contenu : un fichier .zip contenant params.json fonctionne exactement comme un fichier .vndext.

  • Bloc unique : components ne contient qu'une seule entrée. Le bloc est importé directement.
  • Paquet de thème : components contient plus d'une entrée. L'import affiche une sélection avec les aperçus de tous les blocs ; les blocs choisis vont dans la bibliothèque du projet ou directement sur la page.

Façons d'amener un paquet dans le programme :

VoieEmplacement dans le programmeRésultat
Choisir un fichier ou le glisser dans la fenêtreAjouter un bloc › onglet « Fichier (.vndext) »Par défaut : ajout à la bibliothèque uniquement ; avec l'interrupteur « Insérer directement dans le projet », placement immédiat sur la page
Dossier des thèmesAjouter un bloc › onglet « Thèmes »Tous les fichiers .vndext/.zip du dossier choisi apparaissent comme catalogue ; s'y ajoutent les thèmes de démarrage fournis
Galerie en ligneAjouter un bloc › onglet « Galerie de blocs VN »Le paquet est chargé tel quel et passe par le même import
Extensionctx.blocks.importPackage, ctx.blocks.importToLibraryvoir Extensions

Structure du ZIP#

Voici la structure du paquet vn-kinetic-theme.vndext (16 blocs) ; les fichiers sans importance pour l'import sont signalés.

text
params.json                          Pflicht: Name, Alias, Liste der Bausteine
thumbnail.jpg                        Vorschau für die Online-Galerie (nur dort gelesen)
CREDITS.txt, cover.png, splash.html  ohne Bedeutung für den Import
plugins/plugin.json                  ohne Bedeutung für den Import
plugins/theme/css/style.css          Theme-CSS (wird einmal pro Projekt geladen)
components/
  _images/hero1.jpg …                Bilder, auf die Bausteine verweisen
  menu1/
    template.html                    Pflicht: Markup + <vn-parameters>
    style.less                       optional: Stil des Bausteins (LESS oder CSS)
    thumb.png                        optional: Vorschau in der Auswahl
  hero1/ … footer1/

params.json#

Ce fichier décrit le paquet. Le programme ne lit que les champs suivants ; les autres champs (version, minAppVersion, description, plugins, logo, ampCompatible, _isSecondary) sont ignorés.

Syntaxe

json
{
  "name": "Mini Theme",
  "title": "Mini Theme",
  "alias": "mini-theme",
  "components": [
    { "path": "components/menu1", "_group": "Menü", "_title": "Menü (einfach)" }
  ]
}

Champs

ChampTypeDéfautSignification
nametextealiasNom d'affichage du paquet. Pour un bloc unique, c'est le nom du bloc ; pour un paquet de thème, il précède le nom de chaque bloc (« Mini Theme – Footer ») et sert de nom du groupe de thèmes dans la bibliothèque
aliastexteblock-<heure>Identifiant du paquet. Il sert à former l'alias et la classe CSS de chaque bloc, voir Identifiants
titletextealiasDétermine l'identifiant du CSS du thème (vn-theme-css-<title>), voir CSS du thème
componentsliste–Obligatoire. Chaque entrée est un objet avec path (dossier dans le ZIP, obligatoire). Si components manque ou si la liste est vide, l'import rejette le paquet
components[].pathtexte–Dossier du bloc, p. ex. components/menu1. Il doit contenir template.html et, en option, style.less (ou style.css) et thumb.png
components[]._titletextenom du dossierNom d'affichage du bloc dans la sélection, la bibliothèque et le catalogue (« Hero mit Hintergrundbild »)
components[]._grouptexte–Groupe dans la sélection du thème (« Menü », « Header », « Footer ») ; sans _title, on obtient p. ex. « Header 7 » à partir de _group et du nombre figurant dans le nom du dossier
components[]._oncetexte–Affichage uniquement : si vous y mettez une valeur, la mention « · à l’échelle du site » s'ajoute dans la sélection et le catalogue. Le comportement réel est piloté par l'attribut once dans le bloc, voir Blocs à l'échelle du site
themeobjet–Facultatif : settings (liste de variables de thème) et customLESS (chemin d'un fichier LESS dans le paquet), voir Propriétés du thème
appScriptvaleur–Un paquet avec appScript et sans components est rejeté. Avec components, ceux-ci sont importés normalement ; le script reste inutilisé

template.html#

Le balisage du bloc. Le premier élément est la racine du bloc (le plus souvent section). Il contient un bloc <vn-parameters> avec les champs de saisie du panneau des propriétés, puis le balisage proprement dit avec des espaces réservés {{…}} et des directives comme vn-if, vn-class, vn-style. Tout cela est décrit dans le chapitre Champs de saisie ; ici, seulement le comportement à l'import :

  • Toutes les références de la forme …/_images/<fichier> (également ../_images/… ou un chemin plus long devant) sont converties en vrais fichiers du projet, voir Images et noms de fichier.
  • Le bloc <vn-parameters> est supprimé lors du rendu et n'est jamais exporté.
  • Les blocs <script> propres restent dans le balisage. Ils s'exécutent sur la page terminée. Dans l'éditeur, le programme les exécute également par défaut (réglage du site « Exécuter les scripts des blocs dans l’éditeur », activé), mais avec des substituts pour les minuteries, les événements load et location ; chaque nouveau rendu arrête les minuteries du précédent. Écrivez vos scripts de façon à reconnaître avec el.closest('#canvas') s'ils s'exécutent dans l'éditeur, et à ne rien déplacer ni masquer dans ce cas.

style.less ou style.css#

Le style du bloc. Le programme cherche d'abord style.less, puis style.css. Il le recompile à chaque modification d'une valeur de propriété ; chaque nom de paramètre y est disponible comme variable LESS (@paddingTop, @bg-type, @bg-value …). Le style ne vaut que pour cette instance de bloc : le programme place la classe d'instance devant.

thumb.png#

L'image d'aperçu du bloc pour la sélection et la bibliothèque. Le programme ne lit que ce nom (thumb.png, PNG). À partir de 30 Ko, elle est réduite à 480 px de large au maximum et enregistrée en WebP dans le projet. Si le fichier manque, la sélection affiche un symbole de remplacement.

components/_images#

Dossier d'images commun du paquet. Les références dans template.html, style.less et dans le CSS du thème s'écrivent ../_images/<fichier>. Sont autorisés les fichiers dont l'extension est jpg, jpeg, png, gif, svg et webp.

plugins/ et fonts/#

Tous les fichiers .css sous plugins/ ainsi que fonts/style.css font partie du CSS du thème, voir CSS du thème. Les fichiers JavaScript sous plugins/ ne sont copiés dans le projet par le programme que si le paquet est un thème Bootstrap 4 (mode Bootstrap).

Aucun fichier de script par bloc#

Pour chaque bloc, l'import ne lit que template.html, style.less/style.css et thumb.png. Un fichier de script propre à côté du bloc (script.js) n'est pas lu. Le JavaScript doit figurer comme <script> dans template.html ; n'utilisez ni ID fixes ni indicateurs stockés comme propriété JavaScript de l'élément, car le même bloc peut apparaître plusieurs fois sur une page.

thumbnail.jpg et l'aperçu de la galerie#

Comme aperçu du paquet, la galerie en ligne retient le premier fichier correspondant dans l'ordre de priorité thumbnail, thumb, preview, screenshot, card, block, cover (extension .jpg/.jpeg/.png, 2 Mo au maximum ; les fichiers dont le nom contient « splash » ne comptent pas). La comparaison porte sur le nom de fichier sans dossier : thumbnail.jpg l'emporte sur le thumb.png des blocs. Le programme lui-même ne lit jamais thumbnail.jpg.

Identifiants : alias, étiquette, groupe#

À partir des indications de params.json, l'import déduit ces noms (exemple : alias: mini-theme, bloc components/hero1, identifiant de bloc bmw3s2mqdbf95) :

NomBloc uniquePaquet de thèmeExemple
Alias du blocalias<alias>-<nom du dossier>mini-theme-hero1
Étiquette (nom d'affichage)name<name> – <_title>« Mini Theme – Hero mit Hintergrundbild »
Classe racinevn-imp-<alias>vn-imp-<alias>-<nom du dossier>vn-imp-mini-theme-hero1
Classe d'instance dans le HTML final<classe racine>-<identifiant de bloc>idemvn-imp-mini-theme-hero1-bmw3s2mqdbf95
ID d'ancre de la racineblk-<identifiant de bloc> (ou l'ID d'ancre défini par l'utilisateur)idemblk-bmw3s2mqdbf95

La classe racine est formée à partir de l'alias (seulement a-z0-9, tout le reste devient -). Chaque instance de bloc reçoit sa propre classe d'instance ; c'est pourquoi deux blocs identiques sur une même page ne se gênent pas. {{vn-id}} dans le balisage représente l'ID d'ancre de l'instance.

Le groupe (_group) sert de catégorie dans la sélection du thème, dans le catalogue des thèmes et dans la recherche de la galerie. Un bloc qui se trouve déjà dans la bibliothèque ne connaît plus _group (il n'est pas enregistré avec le bloc) ; sa catégorie y est son nom sans le nombre final (« Hero 3 » → « Hero »).

Blocs à l'échelle du site : global et once#

Le menu et le pied de page appartiennent à chaque page. Un bloc devient « global » (à l'échelle du site) lorsque son élément racine porte l'attribut global.

Syntaxe

html
<section class="mini mini-menu" global once="menu"> … </section>
<section class="mini mini-footer" global once="footers"> … </section>

Attributs

AttributValeurSignification
global–Rend le bloc global : il ne se trouve pas dans une page, mais dans la liste des blocs globaux, et apparaît sur chaque page exportée
oncetexte, p. ex. menu, footersNom du groupe. De chaque groupe, il n'existe qu'un seul bloc au plus dans le projet : un bloc nouvellement inséré remplace l'ancien (message « ancien bloc global remplacé »). Sans once, le groupe s'appelle global

La position dans l'export est déterminée par le nom du groupe : s'il contient menu, nav ou header (sans tenir compte de la casse), le bloc se place avant le contenu de la page, tous les autres groupes après. Dans l'exemple ci-dessus, le menu se trouve donc en haut et le pied de page en bas. Leur CSS n'atterrit qu'une seule fois dans style.css.

L'import étape par étape#

importVndextComponent() dans src/vndext-import.js traite pour chaque bloc ces étapes, exactement dans cet ordre :

  1. Lire template.html et style.less (ou style.css).
  2. Réécrire les attributs Bootstrap 4 en Bootstrap 5.
  3. Supprimer les traces de démonstration connues provenant de sources de paquets tierces (voir ci-dessous).
  4. Supprimer un marqueur de langage placé en tête dans le style (« css: »).
  5. Réécrire les anciens noms de directives en vn-.
  6. Convertir ../_images/… en fichiers du projet (modèle et style).
  7. Charger le CSS du thème, si le paquet en contient un (une fois par thème).
  8. Reprendre les variables du thème (params.theme.settings) comme siteVars.
  9. Lire et réduire l'image d'aperçu.
  10. Former les noms d'alias et la classe racine ; reconnaître le bloc à l'échelle du site (global/once).
  11. Copier dans le projet les valeurs d'image par défaut avec chemin file:/// si le fichier existe sur cet ordinateur.
  12. Construire les champs et les valeurs par défaut à partir de <vn-parameters>.
  13. Marquer les champs d'image, les textes courants, les boutons, les symboles et les images libres afin qu'ils soient cliquables dans l'éditeur.

Le résultat est une entrée avec templateHtml, lessText, fields, defaults, wrapperClass, siteVars, thumb, isGlobal, globalGroup et une fonction render. Elle est enregistrée avec le projet ; à l'ouverture, le programme ne reconstruit que la fonction render et réexécute les étapes de marquage (elles sont répétables, les identifiants existants sont conservés).

Nettoyage des anciens paquets#

Les paquets issus de sources plus anciennes apportent des particularités que l'import nettoie lui-même. Les nouveaux paquets devraient les éviter dès le départ.

Constat dans le paquetTraitement
data-toggle, data-target, data-dismiss, data-ride, data-slide, data-slide-to, data-parentL'attribut Bootstrap 5 data-bs-… est ajouté avec la même valeur (un data-bs-… existant est conservé)
Liens de démonstration et noms du programme d'origine (liens de réseaux sociaux, adresses courtes, textes alternatifs, textes courants)Les liens deviennent #, les textes alternatifs sont vidés, les noms dans le texte sont remplacés par un nom fictif
Vérification « s'exécute dans le builder ? » dans le scriptSimplifiée en une simple vérification d'iframe
mbr-parameters, mbr-if, mbr-class, mbr-style, mbr-buttons, mbr-menu, mbr-video, mbr-icon, mbr-articleRenommés en vn-… (mbr-icon devient data-vn-icon)
mbr-theme-style="display-N" pour les thèmes avec des variables displayNSizeDevient vn-theme-style, afin que la classe corresponde au CSS du thème et non aux classes display plus grandes de Bootstrap
value="file:///…" dans les champs d'imageVoir Images et noms de fichier
<mbr-parameters> dans le modèle et le styleRenommé en <vn-parameters>

Images et noms de fichier#

  • Destination : les images de _images arrivent comme vrais fichiers dans assets/images/ du projet, les polices dans assets/fonts/, le CSS du thème dans assets/theme/. Une entrée du modèle devient une adresse file:// de ce fichier.
  • Les noms sont conservés. Si le nom est libre, un fichier est créé avec le nom d'origine. S'il existe déjà un fichier de contenu identique (quel que soit son nom), il est réutilisé. Si le nom est occupé par un contenu différent, le programme ajoute -2, -3 … Il n'y a pas de question posée, même pour de nombreux fichiers d'un thème.
  • Taille : 15 Mo au maximum par fichier ; les fichiers vides sont refusés.
  • Chemins étrangers : une valeur d'image par défaut avec value="file:///C:/…" pointe vers l'ordinateur de l'auteur. Le programme ne la reprend que si elle pointe vers le dossier du projet ; sinon, il tente de copier le fichier de cet ordinateur dans le projet (formats d'image uniquement) et laisse le champ vide en cas d'échec. Dans les paquets, utilisez donc toujours ../_images/….

Attributs Bootstrap et mode Bootstrap#

Le programme fournit Bootstrap 5.0.1 (vendor/bootstrap.min.css, vendor/bootstrap.bundle.min.js) et les Bootstrap Icons. Les paquets pour Bootstrap 5 n'ont besoin de rien d'autre. Un paquet avec son propre plugins/bootstrap/css/bootstrap.min.css dont l'en-tête mentionne « Bootstrap v4.x.x » est considéré comme un thème Bootstrap 4 : au premier import, le programme copie les scripts du thème (plugins/*/*.js, sans .map ni *.full.js) dans assets/theme-js/ et enregistre l'entrée sous siteSettings.themeAssets. L'utilisateur peut alors basculer le projet sur « Bootstrap du thème ». Dans l'export, chaque page charge alors jQuery (vendor/jquery.min.js), Popper, le JS Bootstrap du thème, le script de défilement fluide, les scripts des plugins que leurs blocs demandent, et enfin le script du thème. Les plugins dont un bloc a besoin sont indiqués par l'attribut plugins="DropDown, TouchSwipe" sur l'élément racine.

Si un dossier de plugin manque dans le paquet, le programme ne le charge pas. Les paquets pour Bootstrap 5 portent data-bs-version="5.1" sur l'élément racine ; le programme signale lorsqu'un tel bloc arrive dans un projet Bootstrap 4.

CSS du thème#

Le CSS du thème est le CSS commun d'un paquet de thème (typographie de base, boutons, classes utilitaires). Il ne se trouve pas dans les différents blocs, mais est chargé une fois par projet.

Quels fichiers sont chargés#

À l'import du premier bloc d'un paquet, le programme cherche ces fichiers dans le ZIP et les assemble dans cet ordre en un seul fichier :

  1. plugins/bootstrap/css/bootstrap.min.css
  2. plugins/theme/css/style.css
  3. fonts/style.css
  4. tous les autres plugins/**/*.css, par ordre alphabétique (à l'exception de bootstrap-grid* et bootstrap-reboot*)
  5. le fichier LESS compilé à partir de params.theme.customLESS (s'il est indiqué)

Un CSS de thème n'est créé que si au moins une de ces sources existe. Un bloc isolé sans ces fichiers (le cas habituel) ne déclenche aucun CSS de thème. Un paquet avec son propre Bootstrap apporte donc le CSS de Bootstrap ; les paquets destinés au Bootstrap 5 fourni ne livrent dans plugins/theme/css/style.css que leurs propres règles.

Dans l'éditeur : layer et scope#

Dans l'éditeur, le CSS du thème se trouve dans un <style id="vn-theme-css-<name>"> dans l'en-tête du document :

css
@layer theme-base {
@scope (#canvas) {
  /* Theme-CSS */
}
}

L'ordre des layers est app-ui, bootstrap-base, theme-base, vn-blocks ; les layers suivants l'emportent. Le CSS des blocs se trouve dans vn-blocks et l'emporte donc sur le CSS du thème pour les déclarations ordinaires, même avec une spécificité plus faible. Avec !important, c'est inversé : c'est la couche antérieure qui l'emporte, donc le CSS du thème sur une déclaration !important du bloc (dans l'export, en revanche, la spécificité et l'ordre décident, voir Qui l'emporte). @scope (#canvas) limite le thème à la zone de travail afin qu'il ne modifie pas l'interface du programme. Écrivez le CSS du thème tout à fait normalement, sans @scope ni @layer.

Dans l'export#

Les pages chargent un seul fichier style.css. Sa structure : d'abord le CSS du thème sans scope (il n'y a pas de #canvas dans l'export), puis le CSS de tous les blocs, ensuite les règles de polices, les règles auxiliaires fixes du programme (menu, menu mobile, liens) et enfin le CSS personnalisé de l'utilisateur. Le CSS du thème et le CSS des blocs se trouvent au même niveau dans l'export ; à spécificité égale, ce qui vient après l'emporte.

Une seule fois par projet#

L'identifiant du CSS du thème est vn-theme-css- plus title (à défaut alias), le tout en minuscules et chaque caractère autre que a-z et 0-9 remplacé par - (« Mini Theme » → vn-theme-css-mini-theme). Si un style de cet identifiant existe déjà dans le projet, le programme ne recharge rien :

  • Deux paquets différents avec le même title partagent un seul CSS de thème : le premier chargé l'emporte.
  • Une mise à jour d'un paquet ne remplace pas le CSS du thème d'un projet existant (lors du test : nouvelles règles dans le CSS du paquet, nouvel import, le projet affiche toujours l'ancien CSS). Le nouveau bloc arrive, l'ancien CSS du thème reste. Un renouvellement n'est pas prévu ; dans un nouveau projet, c'est le nouveau CSS du thème qui s'applique. Lors des mises à jour, comptez donc avec le fait que les blocs doivent fonctionner avec l'ancien CSS du thème.

Polices et images dans le CSS du thème#

Dans chaque fichier CSS du paquet, les références url(…) sont résolues par rapport à l'emplacement du fichier dans le ZIP. Les fichiers d'extension woff2, woff, ttf, otf, eot vont dans assets/fonts/, les images (jpg, jpeg, png, gif, svg, webp) dans assets/images/ ; les références dans le CSS deviennent des adresses file:// (dans l'export, assets/…). Les adresses data:, http: et // restent inchangées.

Propriétés du thème (params.theme)#

Un thème peut définir ses variables à un seul endroit, afin que tous les blocs les utilisent en LESS. Cela se fait dans params.theme.settings :

Syntaxe

json
{
  "theme": {
    "settings": [
      { "var": "primaryColor", "type": "color", "default": "#0f766e", "title": "Hauptfarbe" },
      { "set": [
        { "var": "successColor", "default": "#28a745" },
        { "var": "dangerColor", "default": "#dc3545" }
      ] }
    ],
    "customLESS": "plugins/theme/css/custom.less"
  }
}

Champs

ChampSignification
settings[].varNom de la variable ; elle est disponible dans chaque style.less du paquet sous la forme @primaryColor. Les entrées sans var (titres) sont ignorées
settings[].defaultValeur initiale
settings[].typecolor, range, checkbox (aussi switch → valeur booléenne), sinon texte. Si type manque, le programme le déduit de la valeur : booléen → checkbox, nombre → range, #hex → color, sinon texte
settings[].setListe d'entrées de même nature sans champ de groupe propre (p. ex. des variantes de couleur)
customLESSChemin d'un fichier LESS dans le ZIP ; il est compilé avec les variables et son CSS est ajouté au CSS du thème

Sans ces indications, tout style.less qui utilise une variable de thème échoue (variable @primaryColor is undefined). Pour les blocs importés isolément, le programme tient à disposition un jeu neutre de noms connus (primaryColor, secondaryColor, successColor, infoColor, warningColor, dangerColor, mainFont, display1Font/display1Size … display7Size, isRoundedButtons etc.) ; les vraies valeurs du paquet ont la priorité. Les variables sont enregistrées avec le bloc (siteVars).

Enregistrement et auto-réparation#

Le CSS du thème terminé se trouve comme fichier assets/theme/vn-theme-css-<name>.css dans le projet ; la référence figure dans siteSettings.themeCssFiles (identifiant → chemin). À l'ouverture d'un projet, le programme recharge ces fichiers dans l'éditeur et les intègre à l'export.

Si, à l'ouverture, il trouve dans assets/theme/ des fichiers vers lesquels aucune référence ne pointe (restes d'anciens imports sans enregistrement ultérieur), il les note seulement comme « retrouvés ». Ces restes ne sont ni appliqués dans l'éditeur, ni exportés, ni enregistrés ; sinon, les couleurs de boutons de plusieurs thèmes depuis longtemps inutilisés entreraient en collision. Un thème ne redevient actif que s'il est réimporté.

Dossier des thèmes et catalogue#

Un dossier des thèmes est un dossier quelconque contenant des fichiers .vndext ou .zip. Dans chaque fichier, le programme lit uniquement params.json et le thumb.png des blocs (cache d'après le nom de fichier, la taille et la date de modification) ; l'import proprement dit n'a lieu que lorsqu'un bloc est choisi.

  • Le thème de démarrage « VN Studio » est fourni (assets/starter-themes/). S'il existe pour un fichier Name.vndext un fichier jumeau Name.en.vndext, le programme affiche le fichier anglais dans une interface non allemande.
  • Les paquets défectueux (pas un ZIP, pas de params.json, pas de blocs) sont absents du catalogue ; la ligne d'état indique le nombre de fichiers ignorés (« paquet non valide »).
  • Depuis la galerie, le bouton « Dans le dossier des thèmes » charge un paquet sous son nom de galerie comme .vndext dans le dossier. Les noms de fichier sont alors réduits aux lettres, aux chiffres et à .-_ () (80 caractères au maximum).

Outil Package#

L'extension VN Package Tool (vn-paketwerkzeug) traite de nombreux paquets à la fois. Elle ne fait que lire les fichiers, ne modifie pas le programme et indique pour chaque paquet : bloc, paquet de thème, outil ou défectueux. Constats (chacun de niveau « Remarque » ou « Erreur ») :

  • valeurs d'image par défaut ou url(file:///…) qui pointent vers l'ordinateur de l'auteur
  • caractéristiques de Bootstrap 4 (data-toggle, ml-/mr-, text-left …)
  • jQuery dans le script (ne fonctionne que dans le mode Bootstrap « depuis le thème »)
  • PHP dans le bloc (la page doit s'appeler .php)
  • blocs de script propres et références à des adresses externes (nécessitent Internet chez le visiteur)
  • fichiers de plugin (utilisés uniquement dans le mode Bootstrap « depuis le thème »)
  • image d'aperçu thumb.png manquante

Actions : écrire des fichiers .vndext nettoyés dans un dossier (les originaux restent intacts ; sont supprimés les chemins d'image locaux, url(file:///…) et les marques de provenance) ou déposer en une seule fois tous les paquets sélectionnés dans la bibliothèque du projet ouvert (paquets de thème avec tous leurs blocs, un alias identique remplace l'entrée précédente ; nécessite le champ de programme ctx.blocks.importToLibrary). Voir aussi Extensions.

Exemple : un paquet de thème minimal#

Le paquet se compose d'un menu, d'un hero et d'un pied de page, d'un CSS commun et d'une image. Il a été importé et exporté dans le programme ; le menu et le pied de page se trouvaient respectivement en haut et en bas dans l'export, l'image est devenue assets/images/foto.jpg et le CSS du thème précédait le CSS des blocs.

Fichiers

text
mini-theme.vndext
  params.json
  thumbnail.jpg
  plugins/theme/css/style.css
  components/_images/foto.jpg
  components/menu1/{template.html, style.less, thumb.png}
  components/hero1/{template.html, style.less, thumb.png}
  components/footer1/{template.html, style.less, thumb.png}

params.json

json
{
  "name": "Mini Theme",
  "title": "Mini Theme",
  "alias": "mini-theme",
  "components": [
    { "path": "components/menu1", "_group": "Menü", "_title": "Menü (einfach)" },
    { "path": "components/hero1", "_group": "Header", "_title": "Hero mit Hintergrundbild" },
    { "path": "components/footer1", "_group": "Footer", "_title": "Footer" }
  ]
}

plugins/theme/css/style.css

css
.mini { font-family: "Segoe UI", Arial, sans-serif; color: #1f2937; }
.mini h1, .mini h2 { margin: 0 0 .5em; line-height: 1.15; }
.mini .btn-mini { display: inline-block; padding: .6rem 1.4rem; border-radius: 999px; background: #0f766e; color: #fff; text-decoration: none; }

components/menu1/template.html (à l'échelle du site, groupe menu)

html
<section class="mini mini-menu" global once="menu">
  <vn-parameters>
    <header>Farben</header>
    <input type="color" title="Hintergrund" name="barBg" value="#ffffff">
    <input type="checkbox" title="Beim Scrollen oben festhalten" name="sticky" checked>
  </vn-parameters>
  <nav class="navbar navbar-expand-lg" vn-class="{'navbar-fixed-top': sticky}">
    <div class="container">
      <a class="navbar-brand" href="index.html">Mein Betrieb</a>
      <ul class="navbar-nav ms-auto flex-row gap-3">
        <li class="nav-item"><a class="nav-link" href="index.html">Start</a></li>
        <li class="nav-item"><a class="nav-link" href="kontakt.html">Kontakt</a></li>
      </ul>
    </div>
  </nav>
</section>

components/menu1/style.less

less
.navbar {
  background: @barBg;
  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.08);
}

components/hero1/template.html (widget d'arrière-plan, champ d'image avec valeur par défaut issue du paquet)

html
<section class="mini mini-hero">
  <vn-parameters>
    <header>Größe</header>
    <input type="range" inline title="Abstand oben" name="paddingTop" min="2" max="16" step="1" value="8">
    <input type="range" inline title="Abstand unten" name="paddingBottom" min="2" max="16" step="1" value="8">

    <header>Anzeigen</header>
    <input type="checkbox" title="Bild neben dem Text" name="showImage" checked>
    <select title="Ausrichtung" name="align">
      <option value="left" selected>Links</option>
      <option value="center">Zentriert</option>
    </select>

    <header>Farben</header>
    <fieldset type="background" name="bg">
      <input type="image" title="Bild" value="">
      <input type="color" title="Farbe" value="#e6f4f1" selected>
    </fieldset>
    <input type="color" title="Textfarbe" name="textColor" value="#1f2937">
    <input type="image" title="Foto" name="photo" value="../_images/foto.jpg">
  </vn-parameters>
  <div class="container">
    <div class="row align-items-center">
      <div class="col-lg-7">
        <h1>Willkommen in unserem Betrieb</h1>
        <p>Hier steht ein kurzer Text. Klicken Sie hinein, um ihn zu ändern.</p>
        <a class="btn-mini" href="kontakt.html">Kontakt aufnehmen</a>
      </div>
      <div class="col-lg-5" vn-if="showImage">
        <img src="{{photo}}" alt="" class="img-fluid">
      </div>
    </div>
  </div>
</section>

components/hero1/style.less

less
padding-top: (@paddingTop * 1rem);
padding-bottom: (@paddingBottom * 1rem);
color: @textColor;
text-align: ~"@{align}";
& when (@bg-type = 'color') { background-color: @bg-value; }
& when (@bg-type = 'image') { background-image: url(@bg-value); background-size: cover; background-position: center; }

components/footer1/template.html (à l'échelle du site, groupe footers)

html
<section class="mini mini-footer" global once="footers">
  <vn-parameters>
    <header>Farben</header>
    <input type="color" title="Hintergrund" name="bg" value="#134e4a">
  </vn-parameters>
  <div class="container py-4">
    <p class="mb-0">© Mein Betrieb · <a href="impressum.html">Impressum</a></p>
  </div>
</section>

components/footer1/style.less

less
background: @bg;
color: #ffffff;
a { color: #ffffff; }

Construire le paquet (Python, uniquement la bibliothèque standard et Pillow pour les images)

python
import io, json, zipfile
from PIL import Image

def bild(w, h, farbe, fmt):
    b = io.BytesIO(); Image.new('RGB', (w, h), farbe).save(b, fmt); return b.getvalue()

komponenten = [('menu1', 'Menü', 'Menü (einfach)'),
               ('hero1', 'Header', 'Hero mit Hintergrundbild'),
               ('footer1', 'Footer', 'Footer')]
params = {'name': 'Mini Theme', 'title': 'Mini Theme', 'alias': 'mini-theme',
          'components': [{'path': 'components/' + n, '_group': g, '_title': t} for n, g, t in komponenten]}

with zipfile.ZipFile('mini-theme.vndext', 'w', zipfile.ZIP_DEFLATED) as z:
    z.writestr('params.json', json.dumps(params, ensure_ascii=False, indent=2))
    z.write('src/plugins/theme/css/style.css', 'plugins/theme/css/style.css')
    z.writestr('components/_images/foto.jpg', bild(800, 600, (15, 118, 110), 'JPEG'))
    for n, g, t in komponenten:
        z.write('src/components/%s/template.html' % n, 'components/%s/template.html' % n)
        z.write('src/components/%s/style.less' % n, 'components/%s/style.less' % n)
        z.writestr('components/%s/thumb.png' % n, bild(320, 180, (15, 118, 110), 'PNG'))
    z.writestr('thumbnail.jpg', bild(640, 360, (15, 118, 110), 'JPEG'))

Résultat dans l'export (abrégé) : le menu en premier, le hero, le pied de page en dernier ; chaque instance avec sa propre classe ; le CSS du thème avant le CSS des blocs.

html
<section class="mini mini-menu vn-imp-mini-theme-menu1-bmw3s2mqu4wym" global="" once="menu" id="blk-bmw3s2mqu4wym">…</section>
<section class="mini mini-hero vn-imp-mini-theme-hero1-bmw3s2mqdbf95" id="blk-bmw3s2mqdbf95">
  … <img src="assets/images/foto.jpg" alt="" class="img-fluid"> …
</section>
<section class="mini mini-footer vn-imp-mini-theme-footer1-bmw3s2mqy6gzj" global="" once="footers" id="blk-bmw3s2mqy6gzj">…</section>
css
/* style.css (Anfang) */
/* plugins/theme/css/style.css */
.mini { font-family: "Segoe UI", Arial, sans-serif; color: #1f2937; }
…
.vn-imp-mini-theme-hero1-bmw3s2mqdbf95 { padding-top: 8rem; padding-bottom: 8rem; color: #1f2937; text-align: left; background-color: #e6f4f1; }

Liste de contrôle avant diffusion#

  • Importer le paquet dans un nouveau projet (bibliothèque) et insérer chaque bloc. Examinez les groupes de propriétés : chaque ligne header apparaît comme un groupe.
  • Exporter et ouvrir la page dans le navigateur ; vérifier le menu et le pied de page.
  • Aucun chemin file:///, aucun ID fixe, aucune référence à des serveurs tiers (polices, scripts, images).
  • Un thumb.png par bloc (largeur d'environ 480 px) et, dans le paquet, un thumbnail.jpg s'il doit aller dans la galerie en ligne.
  • Images et polices comme fichiers dans le paquet ; pas de vidéos.
  • Description des textes d'exemple sans noms ni adresses réels (example.com).