# Modèles de documents

> Mets en page tes documents, avec une IA ou à la main.

nullish est livré avec des modèles par défaut tout simples, en anglais, allemand, français et italien. Tu veux des documents à ton image ? Crée tes propres modèles : toute la page est à toi, pas seulement un logo et une ligne de texte.

Les modèles se font avec le projet [nullish document templates](https://github.com/usenullish/document-templates). Il affiche un aperçu en direct de tes documents avec des données d'exemple : tu vois chaque changement tout de suite. Laisse une IA faire le travail, ou modifie les modèles toi-même.

## Récupérer le projet

{% steps %}

1. Fais un fork de [usenullish/document-templates](https://github.com/usenullish/document-templates) sur GitHub si tu veux garder tes modèles dans ton propre dépôt, puis clone-le :

   ```sh
   git clone https://github.com/usenullish/document-templates.git
   cd document-templates
   npm ci
   ```

2. Lance l'aperçu et ouvre [localhost:4321](http://localhost:4321) :

   ```sh
   npm run dev
   ```

{% /steps %}

## Le faire avec une IA

Ouvre le projet dans un assistant de code comme Claude Code, Cursor ou Copilot, et décris ce que tu veux :

- « Mets mon logo `logo.svg` en haut à gauche et notre couleur `#1d4ed8` pour les titres. »
- « Place notre adresse en pied de page et les coordonnées bancaires à côté des totaux. »
- « Fais-le ressembler à ce PDF » (avec une ancienne facture en pièce jointe).

Le projet décrit les données de chaque document, donc l'assistant sait ce qu'il a sous la main. Garde l'aperçu ouvert à côté et demande des retouches jusqu'à ce que ça te plaise.

## Ou le modifier toi-même

Chaque document a son propre dossier dans `src/templates/`. Pour les factures, c'est `src/templates/invoices/` :

- `Invoice.astro`, c'est la mise en page : ce qui figure sur la page, et où.
- `i18n.json` contient les textes en anglais, français, allemand et italien.

Habille-le avec du CSS tout simple ou des classes Tailwind. Les tailles sont en millimètres, comme sur papier. Le [README du projet](https://github.com/usenullish/document-templates#readme) liste les données de chaque document et la syntaxe des modèles.

{% aside %}
nullish ne stocke que le HTML : le modèle ne peut rien charger d'ailleurs. Intègre ton logo en SVG
ou en URI `data:`, et pareil pour une police personnalisée.
{% /aside %}

## L'uploader dans nullish

{% steps %}

1. Génère les modèles :

   ```sh
   npm run build
   ```

   Tu obtiens un fichier par langue pour chaque document, p. ex. dans `templates/invoices/` : `en.html`, `fr.html`, `de.html` et `it.html`.

2. Dans nullish, va dans **Paramètres → Facturation → Modèles de documents** et crée un modèle. Donne-lui un **Nom**.

3. Choisis **Ajouter un contenu** pour chaque langue dont tu as besoin : sélectionne la **Langue** et uploade le fichier qui va avec, p. ex. `fr.html` pour le français.

{% /steps %}

Quand tu génères un PDF, une facture par exemple, choisis ton modèle sous **Modèle de document**. Tu peux en avoir plusieurs, par exemple un par marque.

{% aside type="tip" %}
Une faute de frappe dans les données utilisées par un modèle fait planter le PDF : tu le verras tout
de suite. Contrôle dans l'aperçu avant d'uploader.
{% /aside %}