Bonanza des boutons de compositeur

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

: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 panoplie 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 publication Making sure you're not a bot!
:question: Guide d’installation Comment installer un thème ou un composant de thème
:heart: Sponsoring Offert par… CTAP
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 ? :smile:), et masque le reste derrière un bouton à bascule dans le menu contextuel :gear:.

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 :gear: 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 :asterisk: 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. ↩︎

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:

J’ai ajouté un avertissement au premier message indiquant qu’il n’est pas compatible avec l’éditeur de texte enrichi.

Je n’ai pas testé cela, mais il me semble que cela n’a rien à voir avec ce composant particulier. Je commencerais par créer un nouveau rapport de bogue de support avec les étapes de reproduction.

Je n’arrive pas à le reproduire, quel navigateur utilisez-vous ?

Ce problème est spécifique au composant, l’action originale de floutage de spoiler du cœur utilise une implémentation différente qui ne se contente pas d’ajouter le bbcode [spoiler].

2 « J'aime »

Ah, excellent et merci d’avoir examiné cela. :+1:

J’utilise Firefox 140.5.0esr.

1 « J'aime »

Merci pour le signalement, cela devrait être corrigé maintenant. (Et désolé pour le hors-sujet)