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 « J'aime »

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]Le consensus général est que l’extension devrait permettre une syntaxe telle que :

une pensée profonde qui a besoin d'une référence[^1]

[^1] : Voici la référence.

[/quote]

Juste pour information, l’extension ne semble pas autoriser la syntaxe markdown classique pour les notes de bas de page en utilisant [^1]. Je n’obtiens pas de notes de bas de page formatées à moins d’utiliser le formatage « inline », comme ceci :

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]Vous pouvez également utiliser des notes de bas de page « inline » — pas l’expansion inline, mais la note elle-même. Comme ceci :

D'autres sages paroles ^[Lincoln, ou Einstein, ou quelque chose comme ça]

[/quote]

L’activation des notes de bas de page en utilisant le formatage inline des notes de bas de page entraîne des notes de bas de page numérotées automatiquement qui apparaissent ensuite en bas du message, tandis que l’activation de l’expansion inline active l’expérience de type « infobulle avec ellipsis » sans que les notes de bas de page n’apparaissent en bas du message. Si vous avez activé l’option d’expansion inline, votre fenêtre d’aperçu de message ressemblera à des notes de bas de page numérotées traditionnelles, mais vous verrez l’effet d’expansion inline après la publication.

J’apprécie les notes de bas de page numérotées automatiquement en utilisant le formatage inline, il m’a juste fallu quelques essais pour comprendre comment je devais réellement formater le markdown et quelles options permettraient de les faire se comporter comme souhaité. J’espère que ce commentaire aidera quelqu’un d’autre à éviter la même confusion.

Modification pour ajouter : L’option d’expansion inline est la façon dont vos notes de bas de page apparaîtront sur mobile, que cette option soit activée ou non (également pour le bureau).

5 « J'aime »

Recette pour permettre à vos utilisateurs de créer du contenu popup inline avec ce plugin de notes de bas de page Discourse :

Combinez ce plugin avec le Composant de thème Bouton de note de bas de page du compositeur [1] (il fournit un bouton dans le compositeur/éditeur pour créer des notes de bas de page)

Vous pouvez mettre n’importe quoi à l’intérieur des popups, y compris du HTML.

Exemples :

Texte [2]


Texte et téléchargement d’image [3]


Contenu HTML [4]


  1. (installez les deux) ↩︎

  2. Texte brut ici. ↩︎

  3. Texte et téléchargement d’image

    ↩︎

  4. Lorsque vous rencontrez un groupe open source pour la première fois, cela peut être une expérience déroutante. Que ce soit pour poster sur une liste de diffusion pour la première fois, écrire un article de blog sur le projet que vous entreprenez ou traîner sur un canal IRC, la façon dont les gens interagissent et ce qu’ils attendent les uns des autres est très différente de celle de la salle de classe ou avec des amis et la famille.


    Ouverture et partage

    La communication open source peut varier considérablement. Une valeur fondamentale commune est que le partage de code est une bonne chose. Indépendamment de la licence, de la langue ou du style d’indentation, les développeurs open source créent, partagent et modifient le code source ensemble.

    ↩︎

14 « J'aime »

Le plugin de note de bas de page fonctionne-t-il également sur les pages publiques ? Dans mon cas précis, je souhaite qu’il ne fonctionne PAS sur les pages publiques et qu’il ne soit visible que dans la vue de sujet normale (pour l’utiliser pour des notes internes, etc.)

@jrgong – non…

Cependant, il existe cette approche alternative pour laquelle je développe actuellement un composant de thème… sur Github.

2 « J'aime »

On dirait que cela a été déplacé vers le cœur il y a 17 heures.

Je laisserai quelqu’un d’autre mettre cela à jour de manière appropriée.

Traduction manquante : en.Le plugin discourse-footnote a été intégré au cœur de discourse. Veuillez supprimer le plugin de votre app.yml et reconstruire votre conteneur.
3 « J'aime »

Après avoir déplacé vers le noyau,

J’ai supprimé le plugin de app.yml et exécuté ./launcher rebuild app,

mais les paramètres restent sur la page du plugin. Est-ce qu’il est acceptable de laisser les choses ainsi ?

C’est le nouveau. :+1: Voici une photo des deux pour comparaison :

old one

new one

4 « J'aime »

C’est vraiment un beau son ! :+1: Merci de partager. :smiling_face_with_three_hearts:

Merci de l’avoir mentionné, je viens de pousser un correctif.

3 « J'aime »

L’autre problème est que vous n’avez plus besoin d’installer le plugin, et si vous l’avez installé, vous n’avez pas besoin de l’inclure dans votre fichier yml.

2 « J'aime »

J’ai été trop lent pour mettre à jour le sujet avec les nouvelles informations et tu m’as devancé. :slight_smile:

J’ajouterai ma contribution maintenant de toute façon…


:information_source: Discourse Footnote est maintenant inclus dans le cœur de Discourse, donc ce plugin n’aura plus besoin d’être installé séparément. :partying_face:

Si vous auto-hébergez, vous devriez voir des informations sur votre tableau de bord concernant sa suppression de votre app.yml.

:discourse2: Hébergé par nous ? Ce changement ne vous affectera en rien. :+1: Vous pouvez continuer à profiter de ce plugin sans vous soucier de quoi que ce soit.

4 « J'aime »

Ouais. Désolé pour ça.

C’est génial ! Je savais que tu avais un plan. J’aurais dû juste attendre, car l’autre chose que j’ai signalée était, en fait, un problème qui a été, en fait, traité par quelqu’un d’autre, et j’aurais dû juste être patient puisque je savais que tu allais t’en occuper. (Et c’est tellement joli, en plus !).

Cela fait toujours moins de 24 heures, donc, vous savez, c’est plutôt bien aussi.

Merci.

4 « J'aime »

3 messages ont été déplacées vers un nouveau sujet : Option Ajouter une note de bas de page au menu d’engrenage de l’éditeur

Existe-t-il un moyen de formater la note de bas de page normalement ? Pour qu’elle ne soit pas alignée avec les trois points, comme ceci ?[1]

Et qu’elle ressemble plutôt à ceci ?


  1. Cela semble étrange, pour moi ↩︎

Est-ce ce réglage ?

1 « J'aime »

Oui, mais je voulais dire en tant qu’utilisateur normal, pas en tant qu’administrateur modifiant un paramètre.

Non, il n’y a pas de paramètre utilisateur pour cela. Il n’y en a qu’un seul global.

1 « J'aime »

Je remarque que la mise en notes ne permet pas l’utilisation de la syntaxe markdown courante entre les crochets de la note de bas de page[1]

Ce n’est pas très grave, mais cela limite certainement la fonctionnalité de ce que vous pouvez mettre dans la note de bas de page !


  1. Ex : Ceci est dans un crochet de note de bas de page, mais la mise en page se casse dès que j’introduis des paragraphes, des en-têtes, des listes, etc.\n\nVoici une rupture de paragraphe. ↩︎

{“translation”: "Vous pouvez, assurez-vous d’indentifier avec au moins 4 espaces.

Par exemple :


Voici une référence de note de bas de page[^1], et une autre[^longnote].

[^1]: Voici la note de bas de page.

[^longnote]: En voici une avec plusieurs blocs.

    Les paragraphes suivants sont indentés pour montrer qu'ils
appartiennent à la note de bas de page précédente.

    * élément1
    * élément 2

    **Plus** de texte

    m 

Rend à :

![image|387x219](upload://rKf3zv09pn1uwmMDpXGQrWxHK7m.png)"}