Selecionando a linguagem de programação usada em blocos de código

:bookmark: Este guia explica como selecionar a linguagem de programação usada em blocos de código em publicações do Discourse, juntamente com como suprimir a colorização de sintaxe.

:person_raising_hand: Nível de usuário necessário: Todos os usuários

Quando você envolve código usando três crases em suas publicações, o Discourse usa o highlight.js para detectar e aplicar automaticamente a colorização de sintaxe ao código. No entanto, você pode especificar a linguagem de programação se a detecção automática não funcionar como esperado.

Especificando a linguagem de programação para blocos de código

Para especificar a linguagem de programação de um bloco de código, digite o nome da linguagem logo após o primeiro conjunto de crases:

``` sua_linguagem
# Seu código aqui
```

Por exemplo, para especificar Ruby:

``` ruby
3.times do |stuff|
  stuff.do
end
```

O resultado será assim:

3.times do |stuff|
  stuff.do
end

A linguagem deve ser uma das linguagens realçadas configuradas para colorização de sintaxe no seu site. Se uma linguagem não estiver funcionando, consulte o administrador do seu site.

Suprimindo a colorização

Se você deseja evitar qualquer colorização de sintaxe, pode usar text, plain ou pre como linguagem:

``` text
Seu texto para NÃO realçar aqui
```

O resultado aparecerá como texto simples sem nenhuma colorização:

Seu texto para NÃO realçar aqui

Melhores práticas

  • Sempre especifique a linguagem se a detecção automática não estiver reconhecendo seu código corretamente.
  • Para administradores: Certifique-se de verificar se a linguagem escolhida está configurada na configuração do site linguagens realçadas.

Recursos adicionais

11 curtidas