# S'orienter dans l'éditeur

Apprenez à connaître Structure, à modifier les onglets, les aperçus et les données de saisie afin de savoir par où commencer dans l'éditeur.

L'ouverture d'un modèle rassemble sa structure, ses outils d'édition et son aperçu. Sélectionnez une pièce à modifier, puis regardez l'aperçu pour voir le résultat sans quitter l'éditeur.

Commencez dans **Structure** pour sélectionner ce que vous souhaitez modifier, utilisez les onglets à côté pour apporter des modifications, puis ouvrez **Run** pour générer un PDF. Les illustrations ci-dessous montrent chaque domaine dans son contexte.

## 1. Structure : choisissez ce que vous souhaitez modifier

**Structure** est à gauche. Il montre les pages et les sections qui composent le modèle. La sélection d'un élément ouvre ses options d'édition dans le panneau à côté de lui.

- **Global** contient les paramètres partagés dans le modèle.
- **Page** représente une page dans la mise en page, avec ses sections à l'intérieur.
- **Section** est un bloc de contenu, tel que les détails du client ou un tableau de services.
- **En-tête/pied de page** contient le contenu de l'en-tête ou du pied de page lorsque le modèle l'utilise.

Par exemple, sélectionnez **Parties de facturation** pour modifier les étiquettes dans la section des détails du client. Sélectionnez **Global** pour les paramètres partagés tels que les polices ou l'arrière-plan.

<figure class="doc-sim data-assets-illustration tour-illustration" aria-label="Structure → sélectionnez une section pour ouvrir ses outils d'édition">
<div class="sim-stage"><div class="sim-panel tour-tree"><div class="ds-head"><strong>STRUCTURE</strong><span class="sim-control">＋</span></div><div class="tour-tree-row">⌄   Global <span class="sim-badge">1/2</span></div><div class="tour-tree-row tour-child">▤   Pied de page</div><div class="tour-tree-row">⌄   01 page <span class="sim-badge">3</span></div><div class="tour-tree-row tour-child">▤   Titre</div><div class="tour-tree-row tour-child sim-selected sim-focus">▤   Contenu <span class="sim-badge">4p</span></div><div class="tour-tree-row tour-child">▤  Résumé</div></div></div>
<figcaption>Structure → sélectionnez une section pour ouvrir ses outils d'édition</figcaption>
</figure>

## 2. HTML, CSS, Props et Config

Après avoir sélectionné un élément dans Structure, le panneau suivant affiche ses onglets disponibles :

- **HTML** : le contenu et la structure de la section.
- **CSS** : présentation, telle que les couleurs, la taille des polices et l'espacement.
- **Props** : valeurs enregistrées avec le modèle, souvent des étiquettes, des couleurs ou du texte réutilisable.
- **Config** : paramètres de l'élément sélectionné, tels que les marges, les arrière-plans ou les sauts de page.

Avec un modèle existant, ouvrez **Props** pour modifier une étiquette sans modifier HTML/CSS. L'illustration ci-dessous montre un accessoire `heading` sur la section sélectionnée ; son HTML lit la valeur via `{{ props.heading }}`.

Les onglets disponibles dépendent de votre sélection. **Global** a Props et Config, tandis qu'une section peut avoir HTML, CSS, Props et Config. Une variante qui hérite de la base peut offrir moins d'options d'édition.

<figure class="doc-sim data-assets-illustration tour-illustration" aria-label="Section → Props → valeur utilisée dans HTML">
<div class="sim-stage"><div class="sim-panel"><div class="sim-tabs tour-tabs"><span>HTML</span><span>CSS</span><span class="sim-active">Props</span><span>Config</span></div><div class="ds-head"><strong>SECTION · Contenu</strong></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>rubrique</b><span class="ds-type">Texte</span></div><div class="sim-prop-value"><small class="sim-label">VALEUR</small><span class="sim-input sim-focus">Titre du document</span><span class="sim-embed">{{ props.heading }}</span></div></div></div></div>
<figcaption>Section → Props → valeur utilisée dans HTML</figcaption>
</figure>

## 3. Implantation et PDF : voir le résultat

L'aperçu à côté du panneau d'édition comporte deux modes : **Mise en page** et **PDF**.

**Mise en page** vous aide à voir comment les sections s'emboîtent pendant que vous travaillez. **PDF** affiche le document sous forme de pages, ce qui est utile pour vérifier les marges, les en-têtes, les pieds de page et le contenu qui passe sur la page suivante.

Dans **Mise en page**, vous travaillez avec les pages et les sections du modèle. **PDF** affiche le résultat paginé, y compris les feuilles supplémentaires créées lorsque le contenu s'étend sur une page.

<figure class="doc-sim data-assets-illustration tour-illustration" aria-label="La mise en page montre la structure · PDF affiche les feuilles paginées">
<div class="sim-stage"><div class="sim-panel"><div class="sim-tabs tour-tabs"><span>Disposition</span><span class="sim-active sim-focus">PDF</span></div><div class="tour-sheets"><div><small>Page 1</small><div class="tour-sheet"><b>Tembuilder</b><span class="tour-line"></span><span class="tour-line"></span><span class="tour-line"></span><span class="tour-line"></span><small>1 / 2</small></div></div><div><small>Page 2</small><div class="tour-sheet"><b>Tembuilder</b><span class="tour-line"></span><span class="tour-line"></span><span class="tour-line"></span><span class="tour-line"></span><small>2 / 2</small></div></div></div></div></div>
<figcaption>La mise en page montre la structure · PDF affiche les feuilles paginées</figcaption>
</figure>

**La mise en page** reflète vos modifications actuelles. **PDF** restitue le contenu du modèle enregistré, alors enregistrez la conception et régénérez l'aperçu PDF après les modifications. Les paramètres d'aperçu proviennent des valeurs de l'éditeur, initialement Defaults ; les valeurs saisies dans Run s'appliquent uniquement aux tâches Run. Un aperçu PDF précédent ne s’actualise pas automatiquement.

## 4. Parameters : données pour chaque document

**Parameters** est à droite. Il affiche les données acceptées par le modèle, telles qu'un nom de client, un numéro de facture ou une liste de services.

Choisissez **Schema** pour inspecter les champs, les types et les valeurs par défaut. Choisissez **Payload** pour afficher les données sous la forme JSON. Les noms de champs doivent correspondre aux expressions utilisées dans le HTML du modèle.

Par exemple, un champ nommé `recipient` fournit l'expression `{{ params.recipient }}` pour votre HTML. Sa valeur par défaut réside dans Schema ; les données de chaque PDF sont saisies dans Run.

Voir [Parameters et Props](/docs/fr/data/parameters-props/) pour savoir lequel utiliser.

<figure class="doc-sim data-assets-illustration tour-illustration" aria-label="Parameters → Schema / Payload">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Parameters</strong><span class="sim-control">＋ Ajouter</span></div><div class="sim-tabs"><span class="sim-active">Schema</span><span>Payload</span></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>destinataire</b><span class="ds-type">Texte</span></div><div class="sim-prop-value"><small class="sim-label">PAR DÉFAUT</small><span class="sim-input sim-focus">Tembuilder</span><span class="sim-embed">{{ params.recipient }}</span></div></div></div></div>
<figcaption>Parameters → Schema / Payload</figcaption>
</figure>

## 5. Run et historique

Après avoir enregistré et publié le modèle, ouvrez **Run** pour choisir une clé, une version et une variante, et saisissez les données pour générer un PDF. Suivez [Créez votre premier PDF](/docs/fr/getting-started/first-pdf/) lorsque vous souhaitez essayer ce flux de travail.

Lorsque vous examinez votre travail, utilisez l'historique du modèle pour les modifications de conception enregistrées et **Renders** pour les tâches PDF et leurs résultats. Cela vous aide à trouver soit la version de conception, soit le fichier généré dont vous avez besoin.

<figure class="doc-sim data-assets-illustration tour-illustration" aria-label="Enregistrer → Publier → Run · Renders conserve les résultats">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Mon modèle <span class="sim-badge">v1</span></strong><div class="tour-actions"><span class="sim-control">Enregistrer</span><span class="sim-control sim-dark">Publier</span></div></div><div class="ds-head"><strong>COURIR</strong><span class="sim-control sim-focus">ϟ Run</span></div><div class="ds-run-fields"><div><small>VERSION</small><span class="sim-input">v1</span></div><div><small>VARIANTE</small><span class="sim-input">Norme</span></div></div><div class="ds-code"><code>{ "recipient": "Tembuilder" }</code></div><div class="ds-rows"><div><span>Renders</span><small>PDF · Terminé ↗</small></div></div></div></div>
<figcaption>Enregistrer → Publier → Run · Renders conserve les résultats</figcaption>
</figure>
