Seletor de Tema do Codeblock

:discourse2: Summary Codeblock Theme Picker will allow you to easily change the theme used in code blocks.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/hljs-theme-picker
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

This is just a handful of the available options. This component includes all 90 options offered in the hljs repository.

:information_source: While all the options are included in this component, it will only load the one you pick. So, there’s no overhead.

How to use it

Due to the way this component is wired up, it will require a small change to one of your site settings.

  1. Head to your.site.com/admin/site_settings/
  2. Search for theme_authorized_extensions
  3. Add css to that list.

Like so:

:warning: You have to do this before you install the component, otherwise it won’t work.

Once that’s done, you can install the component just like any other component.

Settings

Name Description
hljs theme Select the theme you want code blocks to use. You can visit the hljs demo page to preview the themes
hljs dark match Load dark color scheme if available

If you need to see what the options look like, have a look here We're not a CDN - highlight.js

Once you decide on a hljs theme to use, you can search the dropdown for the one you want and save the setting. You will need to refresh the page in order for everything to start working.

Credits

All of the hljs themes included in this component have copyright information in their respective files. The list of all of those authors (:heart:) is too big to add here, but you can see them here.


:discourse2: Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.

Last edited by @JammyDodger 2024-06-11T13:25:37Z

Check documentPerform check on document:
42 curtidas

This theme is very useful and running in my site for a long time. How ever I suddenly found it has a problem on firefox. The custom css file blocked by the following header X-Content-Type-Options: nosniff. Console shows that css file MIME type is text/html. No matter which theme I choise the problem still happen on firefox but chrome is fine.

This super theme component would be even better if the selected codeblock style was also selectable as a user preference.

5 curtidas

Seconded. As user preference would be very cool.

Anyway to show line numbers?

Great theme component.

One question, there are 242 themes on highlight.js demo. For example, “Github Dark Dimmed” as attached image.

Is there any way to solve this issue? Thanks for advice.

Unfortunately, this is a little bit involved.

Discourse runs version 10.6.0 of highlight-js. Most of the extra themes missing right now - base16 - require version 11.0

The issue is that that version introduces some breaking changes and deprecations. Have a look here

Release Version 11 · highlightjs/highlight.js · GitHub

So, this means that the current options are going to stay the same for a while. First, the highlight-js version needs to be updated in tests-passed in Discourse. Then we’d need to wait for a stable release. Updating the themes (even the current ones) would put us in a bad state where it’s guesswork whether the theme works properly on your site or not.

4 curtidas

Este componente parece estar com defeito nas últimas versões beta - o destaque não funciona mais corretamente quando ele está instalado. Removi o componente dos temas e ele voltou a funcionar - eu apenas não consigo escolher o tema de destaque.

2 curtidas

confirme que a realce de sintaxe também está quebrado aqui na versão beta mais recente

@Falco acabou de mesclar uma correção para este componente: DEV: Update highlight.js to version 11 by xfalcox · Pull Request #3 · discourse/hljs-theme-picker · GitHub

Ele inclui uma atualização para os temas da versão 11 do highlight.js (o core também foi atualizado para a versão 11 do highlight.js) e correções para estilos que não possuíam a especificidade correta.

2 curtidas

Recebi este erro ao tentar instalar o componente

Erro ao criar ativo de upload: a11y-dark. Nome original do arquivo Desculpe, o arquivo que você está tentando carregar não está autorizado (extensões autorizadas: wasm, jpg, jpeg, png, woff, woff2, svg, eot, ttf, otf, gif, webp, avif, js).

VocĂŞ fez esta parte :point_down:

1 curtida

Ah nĂŁo, vou fazer isso :hugs:

1 curtida

Acabei de encontrar este componente de tema — ainda bem que ele existe! Notei que a configuração hljs dark match não parece funcionar.

Por exemplo, temos hljs theme definido como atom-one-light (para o qual também existe atom-one-dark).

Ao atualizar, o atom-one-light é aplicado enquanto no modo escuro, mas o bloco de código não muda para escuro ao mudar para o modo escuro — ele permanece claro.


Recebi esta mensagem de erro ao instalar componentes de tema, espero que alguém possa orientar a comunidade sobre como corrigi-los.

Você adicionou css à lista de extensões de tema permitidas?

1 curtida

Obrigado, funcionou ^^

1 curtida

Nota:

Deveria ser: