Bonanza des boutons de compositeur

:information_source: 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 abondance de nouveaux boutons dans sa configuration par défaut.
:hammer_and_wrench: Dépôt centertap/DiscourseComposerButtonBonanza - Codeberg.org
:eyes: Readme Making sure you're not a bot!
:spiral_notepad: Notes de version Making sure you're not a bot!
:question: Guide d’installation Comment installer un thème ou un composant de thème
:heart: Sponsoring Présenté par… CTAP\u003cbr\u003eCe 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 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 sa sortie de la boîte, il fournit une multitude de nouveaux boutons, un fouillis de boutons, une abondance de boutons. La configuration par défaut ajoute trois nouveaux boutons à la barre d’outils (Pouvez-vous les repérer ? :smile:), et cache les autres derrière un bouton de bascule dans le menu contextuel :gear: :

Après avoir cliqué sur le bouton de 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 :gear: de la barre d’outils ;
  • fournir des traductions/localisations pour les boutons.

Ce composant ne définit aucun balisage ni aucun 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 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 :asterisk: 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 publications existantes. Ce composant n’est pas responsable du 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é, barré
    • \u003csup\u003esuperscript\u003c/sup\u003e et \u003csub\u003esubscript\u003c/sub\u003e
    • \u003cbig\u003etextes\u003c/big\u003e, \u003csmall\u003etextes\u003c/small\u003e
    • \u003ckbd\u003estyle clavier\u003c/kbd\u003e
  • Mise en forme
    • \u003cbig\u003e\u003cb\u003eTitre 1\u003c/b\u003e\u003c/big\u003e, \u003cb\u003eTitre 2\u003c/b\u003e, \u003csmall\u003e\u003cb\u003eTitre 3\u003c/b\u003e\u003c/small\u003e
    • Note de bas de page[1]
    • \u003cruby\u003eTexte Ruby\u003crp\u003e(\u003c/rp\u003e\u003crt\u003e ルビー テキスト\u003c/rt\u003e\u003crp\u003e)\u003c/rp\u003e\u003c/ruby\u003e
    • Image via URL externe (\u003cimg\u003e)
    • Liste de contrôle
    • \u003cmark\u003eSurligné\u003c/mark\u003e, \u003cins\u003eInséré\u003c/ins\u003e, \u003cdel\u003eSupprimé\u003c/del\u003e texte
  • Symboles
    • Copyright ©, Registré ®, Marque déposée™
    • Euro €, Yen ¥
    • le kaomoji “shrug” (parce que, pourquoi pas ? ¯\\\(ツ)\/¯ )
  • et, un bouton de bascule pour afficher/masquer la plupart des boutons ci-dessus

Comme mentionné ci-dessus, ce ne sont que les défauts. Tous ces boutons peuvent
être réorganisés ou supprimés, et de nouveaux peuvent être ajoutés.


  1. …comme cette note de bas de page, par exemple. ↩︎

19 « J'aime »

C’est super, merci !

Y a-t-il un moyen d’ajouter directement la balise ‘spoiler’ dans la barre d’outils supérieure ? C’est quelque chose que nous utilisons beaucoup.

Edit : J’ai trouvé la solution :smiley:

3 « J'aime »

Comment les raccourcis fonctionnent-ils ?

J’aimerais créer un raccourci clavier pour mon bouton « spoiler », mais la plupart des raccourcis ne sont-ils pas déjà utilisés pour d’autres choses ?

L’exemple indique Shift-4 mais pour moi, cela correspond à un signe $.

2 « J'aime »

Oui, très bon composant. Je cherchais le bouton pour afficher les boutons supplémentaires dans la barre du compositeur.

Je pense qu’une fonctionnalité sympa serait d’ajouter un bouton à la barre du compositeur. Peut-être 2 options : afficher/cacher &/ou les menus de la barre du compositeur. De cette façon, vous pouvez regrouper les fonctions dans une barre sélectionnable.

Par exemple :

  • Barre de style : comprendrait des options comme gras, italique, barré, etc.
  • Barre de mise en page : tableau, alignement à droite, centrer, etc.
  • avec l’option de personnaliser la barre principale avec des fonctions couramment utilisées.

(Gardez à l’esprit que ce composant expose simplement les paramètres/options qui existent déjà dans le code JS de Discourse…)

Pour les raccourcis, vous spécifiez la touche de raccourci, ainsi que tous les modificateurs… et ensuite Discourse ajoute toujours un ctrl+ (ou cmd+ sur matériel Apple ?). Par exemple, la chaîne littérale « shift+4 » (comme paramètre de bouton) se traduit par ctrl+shift+4 (comme touches de raccourci).

:grimacing: 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 !)

2 « J'aime »

h01y cr@p c’est géniallllllll

2 « J'aime »

J’ai un problème avec ceci, je l’utilise et je l’adore, mais j’ai ajouté un bouton « spoiler » et il crée des balises spoiler en utilisant DIV au lieu de SPAN, donc elles vont toujours sur une nouvelle ligne lorsque j’utilise l’éditeur WYSIWYG.

Y a-t-il un moyen de changer cela s’il vous plaît ?

Est-ce toujours pris en charge ?

J’ai toujours le problème des spoilers dans une DIV et non dans une SPAN.

Je suppose que ce n’est plus pris en charge ?

Quelqu’un peut-il suggérer comment je peux corriger cela, le bouton “spoiler” ne fonctionne pas correctement (voir mon message précédent)

Je vais examiner cela, mais j’ai besoin que vous montriez précisément comment vous avez ajouté ce bouton « spoiler ».

Merci !

Voici ma configuration :

Screenshot 2025-11-30 at 19.58.22

Il y en a d’autres en dessous. Mais le spoiler est ajouté avec :

spoiler,shift+x

En mode Markdown, cela fonctionne parfaitement.
En mode WYSIWYG, lorsque vous sélectionnez quelque chose et cliquez sur le bouton spoiler, au lieu d’être dans une SPAN, cela se place dans une DIV, ce qui en fait un élément de bloc sur sa propre ligne.

Merci !

Littéralement il y a une heure, je viens de réaliser que ComposerButtonBonanza (CBB) est cassé dans l’Éditeur WYSIWYG. (Ou, peut-être, c’est l’inverse.) Nous n’utilisons pas le WYSIWYG sur le site que j’entretiens, donc je ne l’avais jamais remarqué ! Alors… beurk.

(Je ne suis pas fan du WYSIWYG. MediaWiki (par exemple, Wikipédia) a déployé beaucoup d’efforts dans un éditeur WYSIWYG il y a plus d’une décennie, pensant que cela encouragerait plus de gens à devenir éditeurs. Cela n’a eu aucun effet, et ils n’ont pas pu se débarrasser de l’éditeur original de toute façon car il y a tellement de choses qu’on ne peut pas vraiment accomplir avec la version WYSIWYG, et cela finit par être généralement un peu lourd par rapport à l’éditeur original wikicode+aperçu.)

Hmm… indépendamment de CBB… si j’insère un spoiler dans l’Éditeur WYSIWYG, puis que je clique en dehors de la boîte du spoiler pour éditer ailleurs, il se floute de façon permanente et je ne semble pas pouvoir modifier à nouveau le texte du spoiler… à moins de passer en mode Markdown. Est-ce que je rate quelque chose, ou est-ce juste un bug en mode WYSIWYG ?

…Oh, laissez tomber ! Si je triple-clique (par frustration et/ou ennui), alors je peux modifier à nouveau le texte du spoiler ! (Je ne suis pas fan du mode WYSIWYG ; est-ce que je l’ai déjà mentionné ?)

1 « J'aime »

Si vous pouvez corriger les spoilers pour qu’ils ne deviennent pas des éléments de bloc, je vous serai très reconnaissant :folded_hands: