Docx-template : Différence entre versions
| Ligne 25 : | Ligne 25 : | ||
<p>Le <code>{ @inject all }</code> est donc utile dans les cas où celui qui paramètre souhaite simplement personnaliser les styles, l'aspect du document, établir une page de garde stylisée, etc ...</p> | <p>Le <code>{ @inject all }</code> est donc utile dans les cas où celui qui paramètre souhaite simplement personnaliser les styles, l'aspect du document, établir une page de garde stylisée, etc ...</p> | ||
<h3 id="injectsimple">Inject d'une partie d'un SmartDoc dans un docx-template</h4> | <h3 id="injectsimple">Inject d'une partie d'un SmartDoc dans un docx-template</h4> | ||
| − | <p>Il est aussi possible d'injecter juste certaines parties du SmartDoc dans le docx-template, dans l'ordre souhaité</p> | + | <p>Il est aussi possible d'injecter juste certaines parties du SmartDoc dans le docx-template, dans l'ordre souhaité.</p> |
| − | <p>Pour définir une partie de [[SmartDoc]] à injecter, celle-ci doit être délimitée par un [[SmartDoc/Blocs|Bloc]]</p> | + | <p>Pour définir une partie de [[SmartDoc]] à injecter, celle-ci doit être délimitée par un [[SmartDoc/Blocs|Bloc]].</p> |
| − | <p>Il suffit ensuite de prévoir une ligne de ce type dans le docx-template : <code> { @inject NOM_DU_BLOC }</p> | + | <p>Il suffit ensuite de prévoir une ligne de ce type dans le docx-template : <code> { @inject NOM_DU_BLOC } </code>.</p> |
Version du 27 août 2020 à 13:30
Sommaire
Docx-template
Introduction
Principe
Un docx-template constitue la base Word d'un SmartDoc.
Tout Smartdoc, avant de devenir un fichier Word (docx), est d'abord traité en HTML par le système puis injecté dans un docx-template.
Si aucun docx-template n'est spécifié dans le paramétrage du SmartDoc, le système crée automatiquement un docx-template dans lequel il injecte la totalité du SmartDoc.
Avantage de la fonctionnalité
L'avantage principal lié au fait de préciser un Docx-template dans le paramétrage est de pouvoir personnaliser totalement le fichier Docx qui fera office de docx-template : styles des titres, interlignes, pied de page, en-tête, filigrane, page de garde stylisé, etc ...
Le second avantage, de manière générale, est de pouvoir profiter de toutes les fonctionnalités les plus avancées de Word : tableaux, retraits, etc ...
Enfin, à l'instar des SmartDocX, les docx-template peuvent aussi accueillir directement des variables, inscrites de la manière suivante : ${MA_VARIABLE}
Mise en place d'un docx-template dans le fichier de paramétrage
Paramétrage dans la DocList
La DocList doit prévoir le fait que le SmartDoc correspondant va bénéficier d'un docxtemplate.
Paramétrage dans le SmartDoc concerné
Le SmartDoc doit aussi prévoir, dans ses options, qu'il va bénéficier d'une docx-template.
Principe des injects dans un docx-template
Intérêt de l'Inject A venir
Inject de la totalité d'un SmartDoc dans un docx-template
Il suffit d'écrire { @inject all } dans le docx-template.
Dans ce cas, le système injecte dans le docx-template la totalité du SmartDoc.
Le { @inject all } est donc utile dans les cas où celui qui paramètre souhaite simplement personnaliser les styles, l'aspect du document, établir une page de garde stylisée, etc ...
Inject d'une partie d'un SmartDoc dans un docx-template
Il est aussi possible d'injecter juste certaines parties du SmartDoc dans le docx-template, dans l'ordre souhaité.
Pour définir une partie de SmartDoc à injecter, celle-ci doit être délimitée par un Bloc.
Il suffit ensuite de prévoir une ligne de ce type dans le docx-template : { @inject NOM_DU_BLOC } .
