Bonanza des boutons de compositeur

[mdoggydog]

Ce composant ne fonctionne qu’avec l’éditeur markdown. Non compatible avec l’éditeur richtext.

	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 panoplie de nouveaux boutons dans sa configuration par défaut.
	Dépôt	centertap/DiscourseComposerButtonBonanza - Codeberg.org
	Readme	Making sure you're not a bot!
	Notes de publication	Making sure you're not a bot!
	Guide d’installation	Comment installer un thème ou un composant de thème
	Sponsoring	Offert 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 le CTAP.

Installer Composer Button Bonanza

« Des facilités de composition 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 l’installation, il fournit une foule de nouveaux boutons, un assortiment de boutons, une panoplie 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 quels 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 (facilité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 les notes de bas de page taperont probablement ^[ et ] directement sur le clavier ; mais les autres seront heureux d’avoir un bouton pour leur 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 publications existantes. Ce composant n’est pas responsable de l’application de tout 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 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é, barré
  • ^supertexte et _sous-texte
  • grand texte, petit texte
  • style-touche
• Mise en forme
  • Titre 1, Titre 2, Titre 3
  • Note de bas de page^[1]
  • Texte Ruby( ルビー テキスト)
  • Image via URL externe (<img>)
  • Liste de contrôle
  • Surligné, Inséré, Texte supprimé
• Symboles
  • Copyright ©, Registré ®, Marque commerciale™
  • Euro €, Yen ¥
  • le kaomoji « shrug » (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.

---

1. …comme cet exemple de note de bas de page. ↩︎