mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-24 02:27:19 +00:00
3fe5b77770
* fr-FR help for the use-browser-cache param of the listen command * fr-FR dialog heading for drag&drop image import in editor * fr-FR translations for PutForbidden & PutUnauthorized errors * fr-FR translations for TiddlySpot and TiddlyHost saver information * Update to fr-FR translations for named filters in $:/AdvancedSearch tab * fr-FR translation update for the render command help * fr-FR update to ModuleTypes translations * fr-FR help update for the sse-enabled param of the listen command * fr-FR update to ControlPanel Basics information * fr-FR translation improvements to TiddlerInfo captions and hints * fr-FR translation for the Layout Switcher caption * fr-FR translation updates for Layout-related information * fr-FR translation for ConfirmAction * fr-FR for the captions related to tag input clearing
36 lines
3.0 KiB
Plaintext
36 lines
3.0 KiB
Plaintext
title: $:/language/Help/render
|
|
description: Exécute le contenu de tiddlers individuels vers des fichiers
|
|
|
|
Exécute le contenu des tiddlers individuels identifiés par un filtre et enregistre le résultat vers les fichiers spécifiés.
|
|
|
|
Optionellement, on peut spécifier le titre d'un tiddler modèle (template). Dans ce cas, au lieu d'exécuter directement le contenu de chaque tiddler, le modèle est exécuté après avoir donné pour valeur à la variable "currentTiddler" le titre du tiddler dont le contenu est en cours d'exécution.
|
|
|
|
On peut spécifier le nom et la valeur d'une variable supplémentaire.
|
|
|
|
```
|
|
--render <filtre-sur-les-tiddlers> [<filtre-des-noms-de-fichier>] [<type-de-rendu>] [<modèle>] [ [<nom>] [<valeur>] ]*
|
|
```
|
|
|
|
* ''filtre-sur-les-tiddlers'': Un filtre qui indentifie les tiddlers dont le contenu doit être exécuté
|
|
* ''filtre-des-noms-de-fichier'': filtre optionnel pour transformer les titres de tiddlers en chemin de fichiers. À défaut, le filtre utilisé est `[is[tiddler]addsuffix[.html]]`, qui utilise le titre inchangé du tiddler comme nom de fichier
|
|
* ''modèle'': Modèle optionnel via lequel chaque tiddler doit être rendu
|
|
* ''type-de-rendu'': Type de rendu optionnel : la valeur `text/html` (par défaut) retourne le text HTML complet et `text/plain` se contente de retourner le contenu sous forme texte (autrement dit ignore les balises HTML et autres caractères non imprimables)
|
|
* ''nom'': Nom des variables optionnelles
|
|
* ''valeur'': Valeur des variables optionnelles
|
|
|
|
Par défaut, le nom de fichier est résolu relativement au sous-répertoire `output` du répertoire de l'édition. La commande `--output` peut servir à diriger les sorties vers un répertoire différent.
|
|
|
|
Notes :
|
|
|
|
* Les éventuels fichiers présents dans le répertoire de sortie ne sont pas supprimmés
|
|
* Les répertoires absents dans le chemin de fichier sont créés automatiquement.
|
|
* Lorsqu'un tiddler contient des espaces dans le titre, prendre garde à utiliser aussi bien les guillemets nécessaires au shell et les doubles crochets droits propres à TiddlyWiki : `--render "[[Motovun Jack.jpg]]"`
|
|
* Le filtre des noms de fichier est évalué après avoir initialisé l'élément d'entrée avec le titre du tiddler en cours d'exécution, permettant ainsi d'utiliser le titre comme base de calcul pour le nom de fichier. Par exemple `[encodeuricomponent[]addprefix[static/]]` applique un encodage d'URI à chaque titre, puis ajoute le préfixe `static/`
|
|
* Il est possible d'utiliser plusieurs paires ''nom''/''valeur'' pour passer plus d'une variable
|
|
* La commande `--render` remplace de manière plus souple les deux commandes `--rendertiddler` et `--rendertiddlers`, qui sont du même coup obsolètes.
|
|
|
|
Exemples :
|
|
|
|
* `--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]"` -- enregistre le contenu exécuté de tous les tiddlers non-système vers des fichiers du sous-répertoire "tiddlers" nommés par encodage URL des titres et ajout d'une extension html.
|
|
|