Como adicionar o recurso de copiar trechos código nos seus conteúdos

Manuais do Fórum
1

Eventualmente necessitamos exibir parte de código em nosso conteúdo aqui no fórum, algumas vezes códigos com muitos símbolos e caracteres como “#” podem dificultar bastante a compreensão se forem escritos como texto simples.

Para contornar essas limitações, o fórum dispõe a possibilidade de usar MarkDown, entre outras sintaxes de marcação para formatar corretamente os trechos de código.

image
image703×206 3.56 KB

Existem duas formas de deixar o código com aspecto de referência: manualmente ou usando a ferramenta da plataforma.

Usando a ferramenta da plataforma

O fórum dispõe de um botão dedicado a esse fim:

image

Basta selecionarmos o conteúdo a ser comentado e o sistema entende quando necessita de crase simples ( ` ), normalmente usado para trecho com poucas palavras ou quando é necessário usar três (```), para mais de uma linha.

Para exemplificar, vou usar o trecho abaixo. Como está escrito:

```
# Daemon notificação
dunst \
-geom "280x50-10+40" -frame_width "1" -font "Iosevka Custom 9" \
-lb "$BACKGROUND" -lf "$FOREGROUND" -lfr "$BLUE" \
-nb "$BACKGROUND" -nf "$FOREGROUND" -nfr "$BLUE" \
-cb "$BACKGROUND" -cf "$RED" -cfr "$RED" &
```

Como é exibido:

# Daemon notificação
dunst \
-geom "280x50-10+40" -frame_width "1" -font "Iosevka Custom 9" \
-lb "$BACKGROUND" -lf "$FOREGROUND" -lfr "$BLUE" \
-nb "$BACKGROUND" -nf "$FOREGROUND" -nfr "$BLUE" \
-cb "$BACKGROUND" -cf "$RED" -cfr "$RED" &

Note que não foi necessário mudar cor, criar tabela e mexer em opções avançadas de formatação, o próprio sistema do fórum se encarrega de personalizar desta forma.

Escrever trechos de código manualmente

Como podem ter observado, basta usar três crases antes e mais três depois, fazendo o código ser automaticamente interpretado como citação:

Como foi escrito:

```
## Configuração-------------------------------#
bspc monitor -d 'I' 'II' 'III' 'IV' 'V' 'VI'

bspc config border_width 1
bspc config window_gap 10
bspc config split_ratio 0.50
```

Como é exibido no fórum:

## Configuração-------------------------------#
bspc monitor -d 'I' 'II' 'III' 'IV' 'V' 'VI'

bspc config border_width 1
bspc config window_gap 10
bspc config split_ratio 0.50

Copiar bloco de código inteiro

Nos exemplos acima, não há muita dificuldade em copiar todo código o selecionando, entretanto, existem casos que são muito maiores que os demonstrados aqui, com isso o fórum agora possui a melhoria de poder selecionar todo código por apenas um clique.

Ao deixarmos o mouse sobre o trecho desejado, aparece a função de copiar:

image

Ao clicar, exibe a seguinte mensagem:

image

Com isso, todo bloco desse código está em sua área de transferência.

Observação: Essa opção de copiar o código aparece apenas para trechos com três ou quatro crases ( ``` ou ```` ), caso use uma, duas ou “>” para comentar, essa função não é exibida.

12 curtidas
2

Vale ressaltar que é possível especificar a linguagem de programação utilizada nesses blocos, no conjunto de 3 crases de cima, caso o software do fórum faça um “chute” errado, com, por exemplo, ```sh (para shell scripts), ```cpp (para C++) ou mesmo ```plain (para ficar registrado que você não quer realce de sintaxe).

```plain
Apesar das "Aspas", isso não é um código.
```

```c
#include <stdio.h>

int main() {
    return puts("Olá Mundo");
}
```

Resultado:

Apesar das "Aspas", isso não é um código.

#include <stdio.h>

int main() {
    return puts("Olá Mundo");
}
10 curtidas