 |
Résumé | Les Formulaires de substitution vous permettent de créer une documentation dynamique en générant un formulaire qui remplace toute occurrence d’un =MODÈLE= dans votre message par la valeur saisie dans un champ de texte ou de sélection. |
 |
Aperçu | Aperçu sur Discourse Theme Creator |
 |
Lien du dépôt | https://github.com/discourse/discourse-placeholder-theme-component |
 |
Nouveau sur les Thèmes Discourse ? | Guide de démarrage pour utiliser les Thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Ajoutez des espaces réservés aux messages dans ce format :
[wrap=placeholder key=NAME description="Votre nom"][/wrap]
[wrap=placeholder key=COUNTRY default=US defaults=FR,DE,US,CN,AU,CA][/wrap]
Votre email : =NAME=-=COUNTRY=@example.com
Et cela donnera :
Ceci est utilisé dans les listes de diffusion
Votre email : =ZNAME=-=ZCOUNTRY=@example.com
Comme indiqué ci-dessus, le texte à l’intérieur du wrapper sera utilisé comme description longue.
[wrap=placeholder key=NAME description="Votre nom"]
Ceci est utilisé dans les listes de diffusion
[/wrap]
Clés disponibles
- key : La clé qui doit être remplacée dans votre message
- default/defaults : valeur(s) par défaut
- description : un texte d’espace réservé pour le champ de saisie
Exemples
# créer un nouveau plugin
rails g plugin =PLUGIN_NAME=
cd plugins/=PLUGIN_NAME=
Nous l’utilisons pour créer des runbooks, des tutoriels et des modèles réutilisables (cela fonctionnera également dans les blocs de code). Partagez vos cas d’utilisation !
Paramètres
| Traduction | Valeur par défaut |
|---|---|
| toolbar.builder | Ajouter un espace réservé |
| builder.errors.no_key | Une clé est requise. |
| builder.title | Ajouter un espace réservé |
| builder.insert | Insérer |
| builder.key.label | Clé |
| builder.key.description | La =Clé= à remplacer dans le message. |
| builder.description.label | Description |
| builder.description.description | Description affichée sur le champ de saisie lorsqu’aucune valeur n’est définie. |
| builder.values.label | Valeur(s) par défaut |
| builder.values.description | Valeur(s) optionnelle(s) pour votre espace réservé ; si plusieurs valeurs sont définies, une liste de sélection sera utilisée. |
Hébergé par nous ? Les composants de thème sont disponibles à l’utilisation sur nos plans Standard, Business et Enterprise.