Discourse Fußnote

:discourse2: Zusammenfassung Discourse Footnote ermöglicht Benutzern, Markdown-Fußnoten in Beiträgen zu erstellen.
:open_book: Installationsanleitung Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich.

Fußnoten aktivieren

Das Footnote-Plugin ist standardmäßig aktiviert, kann aber über die Seite admin/plugins deaktiviert/aktiviert werden:

enable footnote

Funktionen

Sobald es aktiviert ist, können Sie Fußnoten zu Ihren Beiträgen hinzufügen, indem Sie sie wie folgt eingeben:

Ein Satz, der eine Fußnote benötigt. ^[Die Fußnote] 
Ein weiterer Satz, der eine Fußnote benötigt. ^[Die zweite Fußnote]

Oder so:

Ein Satz, der eine Fußnote benötigt. [^1] 
Ein weiterer Satz, der eine Fußnote benötigt. [^2]

[^1]: Die Fußnote
[^2]: Die zweite Fußnote

Sie können beide Stile innerhalb eines Beitrags mischen und auch nicht-nummerierte Anker verwenden.

Es gibt zwei Möglichkeiten, Fußnoten anzuzeigen, die durch die Admin-Einstellung display footnotes inline gesteuert werden:

Nicht-inline:

Inline:

Ein Satz, der eine Fußnote benötigt[1]
Ein weiterer Satz, der eine Fußnote benötigt[2]

Die Inline-Versionen sind sowohl für Zitate als auch für Mobilgeräte geeignet.

Einstellungen

Name Beschreibung
enable markdown footnotes Aktiviert Markdown-Fußnoten auf dieser Site
display footnotes inline Aktiviert die Inline-Erweiterung von Fußnoten

:discourse2: Von uns gehostet? Dieses Plugin ist in allen unseren Hosting-Tarifen verfügbar: Footnote | Discourse - Civilized Discussion

Entwicklungshistorie

Discourse Footnote packt die footnote markdown.it-Erweiterung von @Vitaly als Discourse-Plugin neu.


  1. Die Fußnote ↩︎

  2. Die zweite Fußnote ↩︎

73 „Gefällt mir“

Nur zur Information, die Erweiterung scheint die normale Markdown-Formatierung für Fußnoten mit [^1] nicht zuzulassen. Ich erhalte keine formatierten Fußnoten, es sei denn, ich verwende die „Inline“-Formatierung, wie hier:

Das Aktivieren von Fußnoten mit Inline-Fußnotenformatierung führt zu automatisch nummerierten Fußnoten, die dann zusammen unter dem Beitrag erscheinen. Gleichzeitig ermöglicht die Aktivierung der Inline-Erweiterung das Ellipsen-Tooltip-ähnliche Erlebnis, ohne dass Fußnoten unter dem Beitrag erscheinen. Wenn Sie die Option für die Inline-Erweiterung aktiviert haben, sieht Ihr Beitrags-Vorschaufenster wie traditionelle nummerierte Fußnoten aus, aber Sie sehen den Inline-Erweiterungseffekt nach der Veröffentlichung.

Ich schätze die automatisch nummerierten Fußnoten mit der Inline-Formatierung, es hat mich nur ein paar Versuche gekostet, herauszufinden, wie ich die Markdown tatsächlich formatieren sollte und welche Optionen sie wie gewünscht verhalten lassen. Hoffentlich hilft dieser Kommentar jemand anderem, die gleiche Verwirrung zu vermeiden.

Bearbeitung zur Ergänzung: Die Inline-Erweiterungsoption ist, wie Ihre Fußnoten auf Mobilgeräten erscheinen, unabhängig davon, ob diese Option aktiviert ist (auch für Desktops).

5 „Gefällt mir“

Rezept zum Erstellen von Inline-Popup-Inhalten mit diesem Discourse-Fußnoten-Plugin:

Kombinieren Sie dieses Plugin mit der Composer Footnote Button Theme Component [1] (es bietet eine Schaltfläche im Composer/Editor zum Erstellen von Fußnoten)

Sie können alles in die Popups einfügen, einschließlich HTML.

Beispiele:

Text [2]


Text und Bild-Upload [3]


HTML-Inhalt [4]


  1. (installieren Sie beide) ↩︎

  2. Einfacher Text hier. ↩︎

  3. Text und Bild-Upload

    ↩︎

  4. Wenn Sie zum ersten Mal auf eine Open-Source-Gruppe stoßen, kann das eine verwirrende Erfahrung sein. Ob Sie zum ersten Mal in eine Mailingliste posten, über das Projekt bloggen, das Sie in Angriff nehmen, oder in einem IRC-Kanal abhängen – die Art und Weise, wie Menschen interagieren, und was sie voneinander erwarten, unterscheidet sich ziemlich stark von der Schule oder von Freunden und Familie.


    Offenheit und Teilen

    Open-Source-Kommunikation kann stark variieren. Ein zentraler gemeinsamer Wert ist, dass das Teilen von Code gut ist. Unabhängig von Lizenz, Sprache oder Einrückungsstil erstellen, teilen und modifizieren Open-Source-Entwickler gemeinsam Quellcode.

    ↩︎

14 „Gefällt mir“

Funktioniert das Fußnoten-Plugin auch auf öffentlichen Seiten? In meinem speziellen Fall möchte ich, dass es NICHT auf öffentlichen Seiten funktioniert und nur in der normalen Themenansicht sichtbar ist (um es für interne Notizen usw. zu verwenden).

@jrgong – nein…

Es gibt jedoch diesen alternativen Ansatz, für den ich gerade eine Theme-Komponente entwickle… auf Github.

2 „Gefällt mir“

Das wurde vor 17 Stunden in den Core verschoben.

Ich überlasse es jemand anderem, dies entsprechend zu aktualisieren.

Übersetzung fehlt: en.Das Discourse-Fußnoten-Plugin wurde in den Discourse-Core integriert. Bitte entfernen Sie das Plugin aus Ihrer app.yml und bauen Sie Ihren Container neu auf.
3 „Gefällt mir“

Nach dem Umzug zu Core,

habe ich das Plugin aus app.yml gelöscht und ./launcher rebuild app ausgeführt,

aber die Einstellungen bleiben auf der Plugin-Seite. Ist es in Ordnung, es einfach so zu belassen?

Das ist das neue. :+1: Hier ist ein Vergleichsfoto von beiden:

alt text

alt text

4 „Gefällt mir“

Das ist ein wirklich schöner Klang! :+1: Danke fürs Teilen. :smiling_face_with_three_hearts:

Danke, dass Sie das erwähnt haben, ich habe gerade eine Korrektur vorgenommen.

3 „Gefällt mir“

Das andere Problem ist, dass Sie das Plugin nicht mehr installieren müssen, und wenn Sie es installiert haben, müssen Sie das git clone nicht in Ihre yml-Datei aufnehmen.

2 „Gefällt mir“

Ich war zu langsam, um das Thema mit den neuen Informationen zu aktualisieren, und du warst schneller als ich. :slight_smile:

Ich werde meinen Teil jetzt trotzdem hinzufügen…


:information_source: Discourse Footnote ist jetzt Teil des Discourse-Kerns, sodass dieses Plugin nicht mehr separat installiert werden muss. :partying_face:

Wenn Sie selbst hosten, sollten Sie auf Ihrem Dashboard einige Informationen zum Entfernen aus Ihrer app.yml finden.

:discourse2: Von uns gehostet? Diese Änderung wird Sie in keiner Weise beeinträchtigen. :+1: Sie können dieses Plugin weiterhin nutzen und sich keine Sorgen machen.

4 „Gefällt mir“

Ja. Tut mir leid.

Das ist großartig! Ich wusste, dass du einen Plan hattest. Ich hätte einfach warten sollen, da das andere, was ich angesprochen habe, tatsächlich ein Problem war, das von jemand anderem gelöst wurde, und ich hätte einfach geduldig sein sollen, da ich wusste, dass du dich darum kümmern würdest. (Und es ist auch so schön!).

Es sind immer noch weniger als 24 Stunden vergangen, also ist das auch ziemlich gut.

Danke.

4 „Gefällt mir“

3 Beiträge wurden in ein neues Thema aufgeteilt: Fußnotenoption zum Zahnradmenü des Verfassers hinzufügen

Gibt es eine Möglichkeit, die Fußnote normal zu formatieren? Damit sie nicht mit den drei Punkten inline ist, so wie hier?[1]

Und stattdessen so aussieht?


  1. Das sieht komisch aus, finde ich ↩︎

Ist das diese Einstellung?

1 „Gefällt mir“

Ja, aber ich meinte als normaler Benutzer, nicht als Administrator, der eine Einstellung ändert.

Nein, es gibt keine Benutzereinstellung dafür. Nur eine globale Einstellung.

1 „Gefällt mir“

Mir ist aufgefallen, dass die Fußnoten nicht viel gängige Markdown-Syntax innerhalb der Fußnotenklammern zulassen[1].\n\nKeine große Sache, aber es schränkt sicherlich die Funktionalität dessen ein, was man in die Fußnote einfügen kann!


  1. z. B. Dies befindet sich in einer Fußnotenklammer, aber das Layout bricht zusammen, sobald ich Absätze, Überschriften, Listen usw. einführe.\n\nHier ist ein Absatzumbruch. ↩︎

Sie können, stellen Sie sicher, dass Sie mit mindestens 4 Leerzeichen einrücken.

Zum Beispiel:


Hier ist ein Fußnotenverweis[^1] und ein weiterer[^longnote].

[^1]: Hier ist die Fußnote.

[^longnote]: Hier ist eine mit mehreren Blöcken.

    Nachfolgende Absätze sind eingerückt, um zu zeigen, dass sie
zur vorherigen Fußnote gehören.

    * Punkt1
    * Punkt 2

    **Mehr** Text

    *kursiv*

Hier ist ein Fußnotenverweis[1] und ein weiterer[2].

Wird gerendert zu:


  1. Hier ist die Fußnote. ↩︎

  2. Hier ist eine mit mehreren Blöcken.

    Nachfolgende Absätze sind eingerückt, um zu zeigen, dass sie
    zur vorherigen Fußnote gehören.

    • Punkt1
    • Punkt 2

    Mehr Text

    kursiv ↩︎