Questa guida di riferimento descrive tutte le opzioni di formattazione disponibili nei post di Discourse, inclusi markdown, BBCode e HTML. Specifica cosa è supportato e fornisce risorse dove è possibile visualizzare esempi.
Livello utente richiesto: Tutti gli utenti
Comprendere la formattazione supportata nei post
Sebbene il testo semplice sia sufficiente per la maggior parte delle risposte, Discourse consente agli utenti di migliorare la formattazione dei propri post utilizzando markdown, BBCode e HTML. Questa guida spiega quali tipi di formattazione sono supportati e come è possibile utilizzarli in modo efficace.
È anche possibile esercitarsi con alcune basi in un tutorial interattivo inviando un messaggio privato a @discobot qui o su qualsiasi sito Discourse.
Sommario
Questa guida copre:
- Sintassi markdown supportata
- Tag BBCode supportati
- Tag e attributi HTML supportati e sicuri
Best practice
- Utilizzare il markdown principalmente per la sua semplicità e leggibilità.
- Mescolare markdown e BBCode solo quando necessario e mantenere un uso coerente.
- Limitare l’uso dell’HTML a tag semplici e sicuri per evitare problemi di formattazione e garantire la sicurezza dei post.
Markdown supportato
Discourse utilizza markdown-it per la sua implementazione markdown.
Alcune funzionalità markdown comunemente utilizzate includono:
-
Grassetto:
**testo** -
Corsivo:
*testo* -
Link:
[titolo](https://example.com) -
Codice inline:`codice` -
Evidenziazione:
<mark></mark> -
Blocco di codice:
``` blocco di codice ```
Nei post più lunghi (come questo), può essere utile aggiungere struttura utilizzando le intestazioni:
# Intestazione 1
## Intestazione 2
### Intestazione 3
Nota: quando viene caricata un’immagine, la sintassi markdown per fare riferimento all’immagine verrà generata automaticamente.
Per un elenco completo delle funzionalità markdown, consultare la guida interattiva.
BBCode supportato
Discourse supporta un sottoinsieme di tag BBCode comuni, alcuni dei quali vengono generati automaticamente per supportare la formattazione speciale, ad esempio quando si cita un post nella propria risposta:
[quote=“utente”]testo citato[/quote]
[quote="user"]quoted text[/quote]
È anche possibile utilizzare BBCode per contrassegnare il testo nascosto come spoiler o come dettagli
testo spoilerato
[spoiler]spoiled text[/spoiler]
[details=“clicca per espandere”]testo nascosto[/details]
[details="click to expand"]hidden text[/details]
Sono supportati anche i tag BBCode per la formattazione semplice supportata da markdown o:
[b]forte[/b][i]enfasi[/i][u]sottolineato[/u][s]barrato[/s][ul][li]opzione uno[/li][/ul][img]http://example.com/image.png[/img][url]http://example.com[/url][code]codice[/code]
Per un elenco completo dei tag BBCode supportati e degli esempi, consultare i test BBCode di Discourse.
HTML supportato
Discourse supporta un sottoinsieme sicuro di HTML. Sebbene sia possibile mescolare HTML con markdown, sono consentiti solo tag e attributi HTML specifici per garantire sicurezza e coerenza dello stile.
Alcuni dei tag HTML consentiti includono:
<a href="https://example.com">link</a><strong>testo in grassetto</strong><em>testo in corsivo</em><ul><li>elemento elenco</li></ul><img src="https://example.com/image.png" alt="descrizione">
Per un elenco dettagliato dei tag e degli attributi HTML consentiti, consultare la lista consentita di Discourse.
Nota: Gli stili inline, come <span>testo colorato</span>, non sono supportati. Per stili personalizzati, vedere personalizzare i contenuti dei post.
Problemi comuni e soluzioni
- I tag BBCode o HTML non funzionano: Assicurarsi che i tag utilizzati facciano parte del sottoinsieme supportato.
- Gli stili inline vengono rimossi: Discourse non supporta gli stili inline per motivi di sicurezza. Utilizzare stili personalizzati o plugin se necessario.
- La formattazione cambia incollando da altri editor: Alcuni formati di testo ricco potrebbero non essere visualizzati correttamente. Utilizzare il markdown per formattare il testo in modo coerente.
FAQ
D: Posso usare le tabelle in Discourse?
R: Sì, è possibile utilizzare il markdown per creare tabelle. Per maggiori informazioni, consultare questa guida sulle tabelle.
D: Perché il mio stile inline non funziona?
R: Discourse non supporta gli stili inline in HTML per motivi di sicurezza. Prendere in considerazione l’utilizzo di BBCode personalizzato o della guida di stile personalizzato di Discourse.
D: Posso aggiungere tag BBCode personalizzati?
R: Sì, è possibile aggiungere tag BBCode personalizzati. Consultare il plugin BBCode di Discourse per maggiori informazioni.
Risorse aggiuntive
- Guida interattiva al markdown: https://markdown-it.github.io/
- Personalizzare i contenuti dei post: Customize posts' contents with your own styles
- Plugin BBCode di Discourse: Discourse BBCode
