Esta guía explica cómo seleccionar el lenguaje de programación utilizado en los bloques de código dentro de las publicaciones de Discourse, junto con cómo suprimir el resaltado de sintaxis.
Nivel de usuario requerido: Todos los usuarios
Cuando encierra código usando comillas invertidas triples en sus publicaciones, Discourse utiliza highlight.js para detectar y aplicar automáticamente el resaltado de sintaxis al código. Sin embargo, puede especificar el lenguaje de programación si la autodetección no funciona como se espera.
Especificar el lenguaje de programación para bloques de código
Para especificar el lenguaje de programación de un bloque de código, escriba el nombre del lenguaje justo después del primer conjunto de comillas invertidas:
``` tu_lenguaje
# Tu código aquí
```
Por ejemplo, para especificar Ruby:
``` ruby
3.times do |stuff|
stuff.do
end
```
El resultado se verá así:
3.times do |stuff|
stuff.do
end
El lenguaje debe ser uno de los lenguajes resaltados configurados para el resaltado de sintaxis en su sitio. Si un lenguaje no funciona, consulte al administrador de su sitio.
Suprimir el resaltado
Si desea evitar cualquier resaltado de sintaxis, puede usar text, plain o pre como lenguaje:
``` text
Su texto que NO se resaltará aquí
```
El resultado aparecerá como texto sin formato sin ningún resaltado:
Su texto que NO se resaltará aquí
Mejores prácticas
- Siempre especifique el lenguaje si la detección automática no reconoce su código correctamente.
- Para administradores: Asegúrese de verificar que el lenguaje elegido esté configurado en la configuración del sitio
lenguajes resaltados.