Festival de Botões do Compositor

:information_source: Resumo Composer Button Bonanza permite que um administrador do site defina e adicione novos botões de marcação à barra de ferramentas do Composer, e fornece uma bonança de novos botões em sua configuração padrão.
:hammer_and_wrench: Repositório centertap/DiscourseComposerButtonBonanza - Codeberg.org
:eyes: Readme Making sure you're not a bot!
:spiral_notepad: Notas de Lançamento Making sure you're not a bot!
:question: Guia de Instalação Como instalar um tema ou componente de tema
:heart: Patrocínio Trazido a você por… CTAP\u003cbr\u003eEste componente de tema é desenvolvido pelo Center for Transparent Analysis and Policy, uma organização sem fins lucrativos 501(c)(3). Se este componente for útil para o seu site, considere fazer uma doação para apoiar o CTAP.

Instalar Composer Button Bonanza

“Acessos do Composer que Você Pode Pagar!”

Composer Button Bonanza é um componente de tema que fornece mais botões de marcação para o Composer.

Fora da caixa, ele fornece uma série de novos botões, uma confusão de botões, uma bonança de botões. A configuração padrão adiciona três novos botões à barra de ferramentas (Você consegue encontrá-los? :smile:), e esconde os demais atrás de um botão de alternância no menu pop-up :gear::

Após clicar no botão de alternância, os demais botões ficam visíveis:

Através das configurações do componente de tema, você pode:

  • adicionar novas definições de botões (e/ou remover as fornecidas);
  • selecionar quais botões mostrar e quando mostrá-los;
  • alterar a ordem dos botões e colocá-los na barra de ferramentas ou no menu pop-up :gear: da barra de ferramentas;
  • fornecer traduções/localizações para os botões.

Este componente não define nenhuma marcação ou estilo — ele apenas adiciona botões convenientes (acessos!) para digitar a marcação existente que invocará estilos existentes. Seu propósito principal é ajudar seus usuários a descobrir e usar a funcionalidade do Composer. Por exemplo, usuários que usam muitas notas de rodapé provavelmente digitarão ^[ e ] diretamente no teclado; mas o resto de nós ficará feliz em ter um botão :asterisk: para nos lembrar o que fazer.

Um benefício desta abordagem é que, se você decidir remover este componente de tema, não perturbará a estilização de nenhuma postagem existente. Este componente não é responsável por fazer qualquer estilização; ele apenas fornece atalhos para funcionalidades já existentes no Composer, e/ou fornecidas por outros plugins ou componentes de tema.

Configuração Padrão

A configuração padrão fornece definições para a maioria (todas?) das marcações extras que estão disponíveis em uma instalação padrão do Discourse (com todos os plugins integrados ativados e nenhum plugin extra instalado):

  • Estilos de texto:
    • sublinhado, riscado
    • \u003csup\u003esuperescrito\u003c/sup\u003e e \u003csub\u003esubscrito\u003c/sub\u003e
    • \u003cbig\u003etexto grande\u003c/big\u003e, \u003csmall\u003etexto pequeno\u003c/small\u003e
    • \u003ckbd\u003eestilo de teclado\u003c/kbd\u003e
  • Formatação
    • \u003cbig\u003e\u003cb\u003eTítulo 1\u003c/b\u003e\u003c/big\u003e, \u003cb\u003eTítulo 2\u003c/b\u003e, \u003csmall\u003e\u003cb\u003eTítulo 3\u003c/b\u003e\u003c/small\u003e
    • Nota de rodapé[1]
    • \u003cruby\u003eTexto Ruby\u003crp\u003e(\u003c/rp\u003e\u003crt\u003e ルビー テキスト\u003c/rt\u003e\u003crp\u003e)\u003c/rp\u003e\u003c/ruby\u003e
    • Imagem via URL externa (\u003cimg\u003e)
    • Lista de verificação
    • \u003cmark\u003eDestacado\u003c/mark\u003e, \u003cins\u003eInserido\u003c/ins\u003e, \u003cdel\u003eExcluído\u003c/del\u003e texto
  • Símbolos
    • Copyright ©, Registrado ®, Trademark™
    • Euro €, Iene ¥
    • a kaomoji “shrug” (porque, por que não? ¯\\\(ツ)\/¯ )
  • e, um botão de alternância para mostrar/ocultar a maioria dos botões acima

Como mencionado acima, estas são meramente as configurações padrão. Todos esses botões podem ser reorganizados ou removidos, e novos podem ser adicionados.


  1. …como esta nota de rodapé, por exemplo. ↩︎

19 curtidas

Isso é legal, obrigado!

Existe uma maneira de adicionar a tag ‘spoiler’ diretamente na barra de ferramentas superior? É algo que usamos muito.

Editar: Eu descobri :smiley:

3 curtidas

Como funcionam os atalhos?

Gostaria de criar um atalho de teclado para o meu botão “spoiler”, mas a maioria dos atalhos já não está sendo usada para outras coisas?

O exemplo diz Shift-4, mas para mim isso é um $…

2 curtidas

Sim, componente muito bom. Estava procurando pelo botão que exibe os botões extras na barra do compositor

Acho que uma funcionalidade legal seria adicionar um botão na barra do compositor. Talvez com 2 opções: exibir/ocultar e0a42() ou menus da barra do compositor. Assim, você pode agrupar funções em uma barra selecionável.

Por exemplo:

  • Barra de estilo: teria coisas como negrito, itálico, riscar, etc.
  • Barra de layout: tabela, alinhamento à direita, centralizar, etc.
  • Com opção de personalizar a barra principal com comandos usados com frequência.

(Tenha em mente que este componente apenas expõe os parâmetros/opções que já estão no código JS do Discourse…)

Para atalhos, você especifica a tecla de atalho, juntamente com quaisquer modificadores… e então o Discourse sempre adiciona um ctrl+ (ou cmd+ em hardware Apple?). Por exemplo, a string literal “shift+4” (como parâmetro do botão) se traduz em ctrl+shift+4 (como teclas de atalho).

:grimacing: Eu não tentei descobrir uma maneira de remover atalhos — novamente, este componente é aditivo em cima da base de botões já embutidos no Composer. (Eu gostaria de poder fazer ctrl+e não ser um atalho para texto pré-formatado, e apenas ser “ir para o final da linha” em vez disso!)

2 curtidas

h01y cr@p isso é awwwwwwesommmmme

2 curtidas

Tenho um problema com isso, estou usando e adorando, mas adicionei um botão “spoiler” e ele cria tags de spoiler usando DIV em vez de SPAN, então elas sempre vão para uma nova linha ao usar o editor WYSIWYG.

Existe uma maneira de mudar isso, por favor?

Isso ainda é compatível?

Ainda estou tendo o problema com spoilers em uma DIV, não em uma SPAN.

Acho que isso não é mais suportado?

Alguém pode sugerir como posso consertar isso, o botão “spoiler” não está funcionando corretamente (veja minha postagem anterior)

Vou investigar isso, mas preciso que você mostre especificamente como adicionou este botão de “spoiler”.