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 :
componentsne contient qu'une seule entrée. Le bloc est importé directement. - Paquet de thème :
componentscontient 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 :
| Voie | Emplacement dans le programme | Résultat |
|---|---|---|
| Choisir un fichier ou le glisser dans la fenêtre | Ajouter 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èmes | Ajouter 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 ligne | Ajouter un bloc › onglet « Galerie de blocs VN » | Le paquet est chargé tel quel et passe par le même import |
| Extension | ctx.blocks.importPackage, ctx.blocks.importToLibrary | voir 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.
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
{
"name": "Mini Theme",
"title": "Mini Theme",
"alias": "mini-theme",
"components": [
{ "path": "components/menu1", "_group": "Menü", "_title": "Menü (einfach)" }
]
}Champs
| Champ | Type | Défaut | Signification |
|---|---|---|---|
name | texte | alias | Nom 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 |
alias | texte | block-<heure> | Identifiant du paquet. Il sert à former l'alias et la classe CSS de chaque bloc, voir Identifiants |
title | texte | alias | Détermine l'identifiant du CSS du thème (vn-theme-css-<title>), voir CSS du thème |
components | liste | – | 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[].path | texte | – | Dossier du bloc, p. ex. components/menu1. Il doit contenir template.html et, en option, style.less (ou style.css) et thumb.png |
components[]._title | texte | nom du dossier | Nom d'affichage du bloc dans la sélection, la bibliothèque et le catalogue (« Hero mit Hintergrundbild ») |
components[]._group | texte | – | 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[]._once | texte | – | 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 |
theme | objet | – | 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 |
appScript | valeur | – | 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énementsloadetlocation; chaque nouveau rendu arrête les minuteries du précédent. Écrivez vos scripts de façon à reconnaître avecel.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) :
| Nom | Bloc unique | Paquet de thème | Exemple |
|---|---|---|---|
| Alias du bloc | alias | <alias>-<nom du dossier> | mini-theme-hero1 |
| Étiquette (nom d'affichage) | name | <name> – <_title> | « Mini Theme – Hero mit Hintergrundbild » |
| Classe racine | vn-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> | idem | vn-imp-mini-theme-hero1-bmw3s2mqdbf95 |
| ID d'ancre de la racine | blk-<identifiant de bloc> (ou l'ID d'ancre défini par l'utilisateur) | idem | blk-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
<section class="mini mini-menu" global once="menu"> … </section>
<section class="mini mini-footer" global once="footers"> … </section>Attributs
| Attribut | Valeur | Signification |
|---|---|---|
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 |
once | texte, p. ex. menu, footers | Nom 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 :
- Lire
template.htmletstyle.less(oustyle.css). - Réécrire les attributs Bootstrap 4 en Bootstrap 5.
- Supprimer les traces de démonstration connues provenant de sources de paquets tierces (voir ci-dessous).
- Supprimer un marqueur de langage placé en tête dans le style (« css: »).
- Réécrire les anciens noms de directives en
vn-. - Convertir
../_images/…en fichiers du projet (modèle et style). - Charger le CSS du thème, si le paquet en contient un (une fois par thème).
- Reprendre les variables du thème (
params.theme.settings) commesiteVars. - Lire et réduire l'image d'aperçu.
- Former les noms d'alias et la classe racine ; reconnaître le bloc à l'échelle du site (
global/once). - Copier dans le projet les valeurs d'image par défaut avec chemin
file:///si le fichier existe sur cet ordinateur. - Construire les champs et les valeurs par défaut à partir de
<vn-parameters>. - 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 paquet | Traitement |
|---|---|
data-toggle, data-target, data-dismiss, data-ride, data-slide, data-slide-to, data-parent | L'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 script | Simplifié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-article | Renommés en vn-… (mbr-icon devient data-vn-icon) |
mbr-theme-style="display-N" pour les thèmes avec des variables displayNSize | Devient 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'image | Voir Images et noms de fichier |
<mbr-parameters> dans le modèle et le style | Renommé en <vn-parameters> |
Images et noms de fichier#
- Destination : les images de
_imagesarrivent comme vrais fichiers dansassets/images/du projet, les polices dansassets/fonts/, le CSS du thème dansassets/theme/. Une entrée du modèle devient une adressefile://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 :
plugins/bootstrap/css/bootstrap.min.cssplugins/theme/css/style.cssfonts/style.css- tous les autres
plugins/**/*.css, par ordre alphabétique (à l'exception debootstrap-grid*etbootstrap-reboot*) - 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 :
@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
titlepartagent 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
{
"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
| Champ | Signification |
|---|---|
settings[].var | Nom 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[].default | Valeur initiale |
settings[].type | color, 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[].set | Liste d'entrées de même nature sans champ de groupe propre (p. ex. des variantes de couleur) |
customLESS | Chemin 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 fichierName.vndextun fichier jumeauName.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
.vndextdans 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.pngmanquante
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
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
{
"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
.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)
<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
.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)
<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
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)
<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
background: @bg;
color: #ffffff;
a { color: #ffffff; }Construire le paquet (Python, uniquement la bibliothèque standard et Pillow pour les images)
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.
<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>/* 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
headerapparaî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.pngpar bloc (largeur d'environ 480 px) et, dans le paquet, unthumbnail.jpgs'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).