L’éditeur richtext (vue unique, WYSIWYG) est incomplet et ne prend pas encore correctement en charge ce composant de thème.
 |
Résumé | Composer Button Bonanza permet à un administrateur de site de définir et d’ajouter de nouveaux boutons de balisage à la barre d’outils du Compositeur, et fournit une aubaine de nouveaux boutons dans sa configuration par défaut. |
 |
Dépôt | centertap/DiscourseComposerButtonBonanza - Codeberg.org |
 |
Readme | README.md |
 |
Notes de publication | RELEASE-NOTES.md |
 |
Guide d’installation | Comment installer un thème ou un composant de thème |
 |
Parrainage | Présenté par…  Ce composant de thème est développé par le Center for Transparent Analysis and Policy, une organisation à but non lucratif 501(c)(3). Si ce composant est utile pour votre site, envisagez de faire un don pour soutenir CTAP. |
Installer Composer Button Bonanza
“Des possibilités de compositeur que vous pouvez vous permettre !”
Composer Button Bonanza est un composant de thème qui fournit plus de boutons de balisage pour le Compositeur.
Dès la sortie de la boîte, il fournit une foule de nouveaux boutons, un fouillis de boutons, une aubaine de boutons. La configuration par défaut ajoute trois nouveaux boutons à la barre d’outils (Pouvez-vous les repérer ? 
), et masque le reste derrière un bouton à bascule dans le menu contextuel 
:
Après avoir cliqué sur le bouton à bascule, le reste des boutons devient visible :
Via les paramètres de configuration du composant de thème, vous pouvez :
- ajouter de nouvelles définitions de boutons (et/ou supprimer celles fournies) ;
- sélectionner les boutons à afficher et quand les afficher ;
- modifier l’ordre des boutons et placer les boutons dans la barre d’outils ou dans le menu contextuel de la barre d’outils ;
- fournir des traductions/localisations pour les boutons.
Ce composant ne définit aucun balisage ou style — il ajoute simplement des boutons pratiques (possibilités !) pour taper le balisage existant qui invoquera les styles existants. Son objectif principal est d’aider vos utilisateurs à découvrir et à utiliser les fonctionnalités du Compositeur. Par exemple, les utilisateurs qui utilisent beaucoup de notes de bas de page taperont probablement directement ^[ et ] sur le clavier ; mais le reste d’entre nous sera heureux d’avoir un bouton 
pour nous rappeler quoi faire.
Un avantage de cette approche est que si vous décidez de supprimer ce composant de thème, vous ne perturberez pas le style des messages existants. Ce composant n’est pas responsable d’appliquer un style ; il fournit simplement des raccourcis vers des fonctionnalités déjà présentes dans le Compositeur, et/ou fournies par d’autres plugins ou composants de thème.
Configuration par défaut
La configuration par défaut fournit des définitions pour la plupart (tous ?) des balisages supplémentaires qui sont disponibles sur une installation Discourse par défaut (avec tous les plugins intégrés activés, et aucun plugin supplémentaire installé) :
- Styles de texte :
- souligné,
texte barré - $\text{sup}super-script\text{/sup} et \text{sub}sous-script\text{/sub}$
- $\text{big}grand texte\text{/big}, \text{small}petit texte\text{/small}$
- $\text{kbd}style clavier\text{/kbd}$
- souligné,
- Mise en forme
- $\text{big}\text{b}Titre 1\text{/b}\text{/big}, \text{b}Titre 2\text{/b}, \text{small}\text{b}Titre 3\text{/b}\text{/small}$
- Note de bas de page[1]
- $\text{ruby}Texte Ruby\text{rp}(\text{/rp}$$\text{rt} ルビー テキスト\text{/rt}$$\text{rp})\text{/rp}\text{/ruby}$
- Image via URL externe (
$\text{img}$) - Liste de contrôle
- $\text{mark}Texte surligné\text{/mark}, \text{ins}Texte inséré\text{/ins}, \text{del}Texte supprimé\text{/del}$
- Symboles
- Copyright ©, Registered ® , Trademark™
- Euro €, Yen ¥
- le kaomoji “hausser les épaules” (parce que, pourquoi pas ? ¯\_(ツ)_/¯ )
- et, un bouton à bascule pour afficher/masquer la plupart des boutons ci-dessus
Comme mentionné ci-dessus, ce ne sont que les valeurs par défaut. Tous ces boutons peuvent être réorganisés ou supprimés, et de nouveaux peuvent être ajoutés.
…comme cet exemple de note de bas de page. ↩︎
Je n’ai pas essayé de trouver un moyen de supprimer les raccourcis — encore une fois, ce composant s’ajoute à la base des boutons déjà intégrés à Composer. (Je voudrais pouvoir faire en sorte que ctrl+e ne soit pas un raccourci pour le texte préformaté, et qu’il s’agisse simplement de « sauter à la fin de la ligne » à la place !)
