Guida alla formattazione dei post su Discourse: aggiungi formattazioni per rendere i post più vivaci

Talvolta, apportare piccole modifiche ai post può aumentarne notevolmente la leggibilità e l’interazione! Questo articolo si concentra sulle “piccole modifiche” alla formattazione dei post.

È ancora più efficace aprire l’editor dei post e imparare seguendo questo tutorial, poiché l’editor dei post ha una pagina di anteprima integrata:

Bevi un sorso d’acqua, stiracchiati. Pronto ad aprire il tuo editor di post? Bene, iniziamo!



Titoli

Aggiungi il simbolo # prima di una riga per trasformare il contenuto della riga in un titolo. Il numero di simboli # corrisponde al livello del titolo.

Input:

# Titolo di primo livello
## Titolo di secondo livello
### Titolo di terzo livello
#### Titolo di quarto livello

Output:

:bulb: Quando il contenuto di un post è abbondante e ha una certa struttura, l’aggiunta di titoli aiuta i lettori a comprendere meglio la struttura organizzativa del contenuto, rendendo il post più chiaro.

:bulb: I titoli nel post avranno automaticamente collegamenti che puntano a quel titolo (sposta il mouse sul titolo per vedere il simbolo :link: che rappresenta il collegamento corrispondente), facilitando il salto rapido a un titolo specifico tramite collegamento.

:bulb: Si noti che deve esserci uno spazio tra il simbolo # e il contenuto del titolo.

:bulb: Alcuni potrebbero usare il grassetto come titolo, ma nella maggior parte dei casi non è consigliato, poiché il grassetto non ha la semantica, la gerarchia o i collegamenti automatici del formato del titolo, né può preparare il terreno per il formato dell’indice che verrà introdotto di seguito.

:bulb: Si consiglia di utilizzare titoli di secondo livello anziché titoli di primo livello come titolo più grande quando si pubblicano post, poiché i titoli di primo livello sono già stati utilizzati dal titolo principale dell’argomento.



Indice

Come forse avrai notato, questo post ha un indice. Se stai usando un telefono, l’indice si apre cliccando sul pulsante dell’indice in basso a destra. Se stai usando un computer, l’indice appare sul lato destro dello schermo.

Puoi aggiungere un indice ai tuoi post quando contengono titoli.

Come aggiungerlo: Assicurati che il post contenga alcuni titoli (questi titoli verranno utilizzati per costruire l’indice). Nell’editor, posiziona il cursore su una riga vuota. Quindi fai clic sul pulsante mostrato nell’immagine seguente.

Dopo aver fatto clic su questo pulsante, apparirà una sequenza di simboli inglesi nell’editor:

 <div data-theme-toc="true"> </div>

Questi simboli vengono utilizzati per generare automaticamente l’indice e non verranno visualizzati nel post pubblicato, quindi non eliminarli, lasciali e continua a scrivere il contenuto del post. Vedrai l’indice dopo aver pubblicato il post.

:bulb: L’indice può visualizzare centralmente i titoli, facilitando il salto rapido al contenuto del titolo corrispondente. Se il post contiene titoli, aggiungere un indice è una buona scelta!



Grassetto, Corsivo, Evidenziazione

Input:

Ciò che è racchiuso tra una coppia di doppie stelle è **grassetto**
Ciò che è racchiuso tra una coppia di singole stelle è *corsivo*
Aggiungi due simboli speciali attorno al testo da <mark>evidenziare</mark>.

Output:
Ciò che è racchiuso tra una coppia di doppie stelle è grassetto
Ciò che è racchiuso tra una coppia di singole stelle è corsivo
Aggiungi due simboli speciali attorno al testo da evidenziare.

:bulb: Il grassetto è evidente e adatto per enfatizzare informazioni importanti.

:bulb: Il corsivo può anche essere utilizzato per enfatizzare, e talvolta viene utilizzato per indicare lingue straniere, nomi speciali o nomi propri, distinguendoli dal testo normale circostante.

:bulb: L’evidenziazione è anche evidente; quando usarla dipende dalle tue esigenze.



Citazione

Aggiungi un simbolo > prima di un paragrafo per applicare il formato di citazione al paragrafo.
Input:

> Acqua verde galleggia sul pelo dell'acqua, il loto rosso spinge le onde chiare.

Output:

Acqua verde galleggia sul pelo dell’acqua, il loto rosso spinge le onde chiare.

Un blocco di citazione può contenere più paragrafi. È necessario aggiungere un simbolo > negli spazi vuoti tra i paragrafi.
Input:

> Contenuto del primo paragrafo.
>
> Contenuto del secondo paragrafo.

Output:

Contenuto del primo paragrafo.

Contenuto del secondo paragrafo.

:bulb: Il formato di citazione viene spesso utilizzato per citare testi, creazioni o contenuti di altre fonti.

:bulb: L’effetto visivo dei blocchi di citazione può presentare il contenuto citato in modo più evidente, rendendo facile distinguere quali sono i testi citati e quali sono i testi dell’autore nel post, a colpo d’occhio.



Citazione di contenuti del forum

Quando si desidera citare una parte di un post del forum, è possibile utilizzare il seguente metodo di citazione.
Output:

Come usarlo:
Seleziona il testo che desideri citare, apparirà un pulsante “Cita”, fai clic su di esso e l’editor si aprirà automaticamente, generando automaticamente il formato di citazione per quel testo.

:bulb: Quando si cita/risponde a una parte di un post del forum, questa citazione può far sapere chiaramente agli altri utenti del forum a quale frase di quale autore stai citando/rispondendo, e consente loro di visualizzare il contesto del contenuto citato. Ciò rende la discussione chiara.



Linea divisoria

Inserisci tre simboli - in una riga vuota per generare una linea divisoria.
Input:

---

Output: Ogni titolo di questo post ha una linea divisoria sopra!

:bulb: La riga sopra la linea divisoria deve essere vuota, altrimenti potrebbero verificarsi alcuni effetti strani (sperimenta tu stesso).



Spazi vuoti multipli

A volte vuoi separare due paragrafi con più spazi vuoti? Qui non è intuitivo: se l’input ha più spazi vuoti, l’effetto di visualizzazione avrà al massimo un solo spazio vuoto. In questo caso, se vuoi aggiungere forzatamente più spazi vuoti, devi inserire il carattere speciale <br> nella riga vuota, come nell’esempio seguente.
Input:

Contenuto sopra, separato da due spazi vuoti dal contenuto sottostante
<br>
<br>
Contenuto sottostante, separato da due spazi vuoti dal contenuto soprastante

Output:
Contenuto sopra, separato da due spazi vuoti dal contenuto sottostante




Contenuto sottostante, separato da due spazi vuoti dal contenuto soprastante



Note

Ci sono due forme di note:
Note a piè di pagina inline
Input:

Una frase che necessita di una nota ^[Contenuto della nota]
Un'altra frase che necessita di una nota ^[Un'altra nota]

Output:

Una frase che necessita di una nota [1]
Un’altra frase che necessita di una nota [2]

Note non inline
Input:

Una frase che necessita di una nota [^1]
Un'altra frase che necessita di una nota [^2]

[^1]: Contenuto della nota
[^2]: Un'altra nota

Output:



Nascondi dettagli

Esempio:
Nascondi dettagli

Come usarlo:

:bulb: Quando il tuo post contiene un lungo blocco di contenuto relativamente secondario, puoi usare questa funzione per nasconderlo.



Pulsanti per aggiungere rapidamente formattazione

Alcuni formati possono essere aggiunti tramite i pulsanti nell’editor.



Altra formattazione

Quanto sopra è un’introduzione ad alcuni formati più importanti, hai imparato? Lascia che esplori altri formati da solo.
Se hai domande, lascia un messaggio nell’area di feedback del forum. Ti auguro un piacevole post!

Riferimenti:


  1. Contenuto della nota ↩︎

  2. Un’altra nota ↩︎

6 Mi Piace

Va bene, va bene :star_struck: non vedo l’ora di vedere altri tutorial.

2 Mi Piace

@Dotila_Li
Potresti insegnarmi come impostare la sezione del capitolo della directory markdown della barra di scorrimento a destra per visualizzarla? C’è qualche plugin?


1 Mi Piace

Questo è il DiscoTOC - automatic table of contents Theme component

1 Mi Piace

Grazie!
Fantastico!