Discourse Footnote

:discourse2: Summary Discourse Footnote allows users to create markdown footnotes in posts.
:open_book: Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately.

Enabling Footnote

The Footnote plugin is default enabled but can be disabled/enabled from the admin/plugins page:

enable footnote

Features

Once enabled, you can add footnotes to your posts by typing them in like this:

A sentence that needs a footnote. ^[The footnote] 
Another sentence that needs a footnote. ^[The second footnote]

Or like this:

A sentence that needs a footnote. [^1] 
Another sentence that needs a footnote. [^2]

[^1]: The footnote
[^2]: The second footnote

You can mix and match both styles within a post, as well as use non-numbered anchors.

There are two ways to display the footnotes, controlled by the display footnotes inline admin setting:

Non-inline:

Inline:

A sentence that needs a footnote[1]
Another sentence that needs a footnote[2]

The inline versions are both Quote and mobile-friendly.

Settings

Name Description
enable markdown footnotes enable footnote markdown on this site
display footnotes inline enable inline expansion of footnotes

:discourse2: Hosted by us? This plugin is available on all of our hosting tiers Footnote | Discourse - Civilized Discussion

Development History

Discourse footnote re-packages the footnote markdown.it extension by @Vitaly as a Discourse plugin.


  1. The footnote ↩︎

  2. The second footnote ↩︎

Last edited by @tobiaseigen 2025-07-16T20:45:27Z

Check documentPerform check on document:
72 Mi Piace

Solo un avviso che l’estensione non sembra consentire il normale markdown per le note a piè di pagina usando [^1]. Non ottengo note a piè di pagina formattate a meno che non usi la formattazione “inline”, così:

Abilitare le note a piè di pagina usando la formattazione inline delle note a piè di pagina si traduce in note a piè di pagina numerate automaticamente che appaiono in fondo al post insieme, mentre abilitare anche l’espansione inline abilita l’esperienza simile a un tooltip con ellissi senza note a piè di pagina che appaiono in fondo al post. Se hai l’opzione di espansione inline abilitata, la finestra di anteprima del tuo post apparirà come note a piè di pagina numerate tradizionali, ma vedrai l’effetto di espansione inline dopo la pubblicazione.

Apprezzo le note a piè di pagina numerate automaticamente usando la formattazione inline, mi ci sono voluti solo alcuni tentativi per capire come formattare correttamente il markdown e quali opzioni avrebbero fatto sì che si comportassero come desiderato. Spero che questo commento aiuti qualcun altro a evitare la stessa confusione.

Modifica per aggiungere: L’opzione di espansione inline è come appariranno le tue note a piè di pagina sui dispositivi mobili, indipendentemente dal fatto che tale opzione sia abilitata (anche per desktop).

5 Mi Piace

Ricetta per consentire ai tuoi utenti di creare contenuti popup inline utilizzando questo plugin per note a piè di pagina di Discourse:

Combina questo plugin con il Componente tema del pulsante per note a piè di pagina del compositore [1] (fornisce un pulsante nel compositore/editor per creare note a piè di pagina)

Puoi inserire qualsiasi cosa all’interno dei popup, incluso l’HTML.

Esempi:

Testo [2]


Caricamento di testo e immagini [3]


Contenuto HTML [4]


  1. (installali entrambi) ↩︎

  2. Testo normale qui. ↩︎

  3. Caricamento di testo e immagini

    ↩︎

  4. Quando incontri un gruppo open source per la prima volta, può essere un’esperienza sconcertante. Sia che tu stia pubblicando per la prima volta su una mailing list, scrivendo un post sul blog sul progetto che stai intraprendendo o frequentando un canale IRC, il modo in cui le persone interagiscono e ciò che si aspettano l’una dall’altra è piuttosto diverso rispetto all’aula o con amici e familiari.


    Apertura e Condivisione

    La comunicazione open source può variare molto. Un valore fondamentale condiviso è che la condivisione del codice è buona. Indipendentemente dalla licenza, dalla lingua o dallo stile di indentazione, gli sviluppatori open source creano, condividono e modificano il codice sorgente insieme.

    ↩︎

14 Mi Piace

Il plugin per le note a piè di pagina funziona anche sulle pagine pubbliche? Nel mio caso specifico, vorrei che NON funzionasse sulle pagine pubbliche e fosse visibile solo nella vista normale dell’argomento (per usarlo per appunti interni, ecc.)

@jrgong – no…

Tuttavia, esiste questo approccio alternativo per il quale sto sviluppando un componente del tema… su Github.

2 Mi Piace

Sembra che questo sia stato spostato nel core 17 ore fa.

Lascerò che qualcun altro aggiorni questo in modo appropriato.

Translation missing: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.
3 Mi Piace

Dopo lo spostamento nel core,

ho eliminato il plugin da app.yml ed eseguito ./launcher rebuild app,

ma le impostazioni rimangono nella pagina dei plugin. Va bene lasciarlo così?

Questa è la nuova. :+1: Ecco uno scatto di entrambi a confronto:

vecchio

nuovo

4 Mi Piace

È un suono davvero bello! :+1: Grazie per averlo condiviso. :smiling_face_with_three_hearts:

Grazie per averlo menzionato, ho appena rilasciato una correzione.

3 Mi Piace

L’altro problema è che non è più necessario installare il plugin e, se lo si è installato, non è necessario includere quel git clone nel file yml.

2 Mi Piace

Sono stato troppo lento nell’aggiornare l’argomento con le nuove informazioni e mi hai anticipato. :slight_smile:

Aggiungerò comunque il mio contributo…


:information_source: Discourse Footnote è ora incluso nel core di Discourse, quindi questo plugin non dovrà più essere installato separatamente. :partying_face:

Se hai un’installazione self-hosted, dovresti vedere alcune informazioni nella tua dashboard su come rimuoverlo dal tuo app.yml.

:discourse2: Ospitato da noi? Questa modifica non ti influenzerà in alcun modo. :+1: Puoi continuare a goderti questo plugin senza preoccuparti di nulla.

4 Mi Piace

Sì. Mi dispiace per questo.

È fantastico! Sapevo che avevi un piano. Avrei dovuto solo aspettare, dato che l’altra cosa che ho segnalato era, di fatto, un problema che è stato, di fatto, gestito da qualcun altro, e avrei dovuto solo essere paziente dato che sapevo che te ne saresti occupato. (Ed è anche così bello!).

Sono ancora passate meno di 24 ore, quindi, sai, anche questo è abbastanza buono.

Grazie.

4 Mi Piace

3 post sono stati divisi in un nuovo argomento: Opzione Aggiungi Nota a piè di pagina al menu a ingranaggio della composizione

C’è un modo per far sì che la nota a piè di pagina venga formattata normalmente? In modo che non sia allineata con i tre puntini, così?[1]

E invece che assomigli a questo?


  1. Questo sembra strano, a me ↩︎

È questa l’impostazione?

1 Mi Piace

Sì, ma intendevo come utente normale, non come amministratore che modifica un’impostazione.

No, non esiste una impostazione utente per questo. Solo una globale.

1 Mi Piace

Noto che la nota a piè di pagina non consente l’uso di molta sintassi markdown comune tra le parentesi della nota a piè di pagina[1]

Non è un grosso problema, ma limita certamente la funzionalità di ciò che puoi inserire nella nota a piè di pagina!


  1. Es: Questo è all’interno di una parentesi di nota a piè di pagina, ma il layout si interrompe ogni volta che introduco paragrafi, intestazioni, elenchi, ecc.\n\nEcco una interruzione di paragrafo. ↩︎

Puoi, assicurati di indentare con almeno 4 spazi.

Per esempio:


Ecco un riferimento a una nota a piè di pagina[^1], e un altro[^longnote].

[^1]: Ecco la nota a piè di pagina.

[^longnote]: Eccone una con più blocchi.

    I paragrafi successivi sono indentati per mostrare che appartengono alla nota a piè di pagina precedente.

    * elemento1
    * elemento 2

    **Altro** testo

    *corsivo*

Ecco un riferimento a una nota a piè di pagina[1], e un altro[2].

Viene renderizzato come:


  1. Ecco la nota a piè di pagina. ↩︎

  2. Eccone una con più blocchi.

    I paragrafi successivi sono indentati per mostrare che appartengono alla nota a piè di pagina precedente.

    • elemento1
    • elemento 2

    Altro testo

    corsivo ↩︎