Umgang mit Ankern in mit Markdown erstellten Beiträgen

Unterstützung
1

Hallo Community, ich benutze eine Discourse-Seite, um einige Spezifikationen zu veröffentlichen, die hauptsächlich in Markdown geschrieben sind, aber ich bin auf das Problem gestoßen, dass die für die Header verwendeten Anker gerendert werden, obwohl sie verborgen sein sollten.

Weiß jemand, ob es eine Möglichkeit gibt, sie zu verbergen?

image
image1333×533 27.8 KB

2 „Gefällt mir“
2

Hallo, willkommen!

Ist diese Syntax von kramdown oder PHP Markdown Extra?

Discourse basiert auf MarkdownIt, das auf der CommonMark Spezifikation basiert. Es unterstützt nicht die Angabe einer Header-ID.

Es scheint, dass sie es irgendwann diskutiert haben: Anchors in markdown - Spec - CommonMark Discussion, aber ich sehe keine definitive Schlussfolgerung.

Discourse generiert jedoch automatisch Anker.
Sie können es hier sehen:

Im Wesentlichen können Sie diese IDs erwarten:

  • h-{headingId} (keine Beitrags-ID, kein Slug)
  • h-{slug}-{headingId} (kein Beitrags-ID)
  • p-{postId}-h-{headingId} (Beitrags-ID, kein Slug)
  • p-{postId}-h-{slug}-{headingId} (Beitrags-ID, Slug)

Z.B.:

Die Benutzeroberfläche einer Online-IDE mit hervorgehobener HTML-Syntax, einschließlich eines Anker-Tags, zugehöriger Werte, einer CSS-Flex-Eigenschaft und semantisch relevanter Code-Strukturen. (Beschriftet von KI)
Die Benutzeroberfläche einer Online-IDE mit hervorgehobener HTML-Syntax, einschließlich eines Anker-Tags, zugehöriger Werte, einer CSS-Flex-Eigenschaft und semantisch relevanter Code-Strukturen. (Beschriftet von KI)865×308 23.1 KB

Wenn Sie möchten, können Sie immer noch manuell einen Anker mit HTML erstellen, z. B. <a>Ankername</a>

Das Bild zeigt ein Browserfenster mit einem geöffneten Textfeld „Header“, das HTML-Code enthält: „<<“ gefolgt von „<a name="test">Header</a>“. (Beschriftet von KI)
Das Bild zeigt ein Browserfenster mit einem geöffneten Textfeld „Header“, das HTML-Code enthält: „<<“ gefolgt von „<a name="test">Header</a>“. (Beschriftet von KI)708×156 6.87 KB

Das Bild zeigt HTML-Code, der ein Anker-Tag erstellt, das mit „header-1“ verknüpft ist, wobei die Attribute „name“ und „href“ auf „p-704-a-nametestestast Header“ bzw. „test“ gesetzt sind, was auf eine Webseiten-Navigationsschnittstelle zur Leistungsüberwachung hinweist. (Beschriftet von KI)
Das Bild zeigt HTML-Code, der ein Anker-Tag erstellt, das mit „header-1“ verknüpft ist, wobei die Attribute „name“ und „href“ auf „p-704-a-nametestestast Header“ bzw. „test“ gesetzt sind, was auf eine Webseiten-Navigationsschnittstelle zur Leistungsüberwachung hinweist. (Beschriftet von KI)801×190 16.3 KB

Zusätzliche Ressourcen –
Wenn Sie eine Inhaltsübersicht generieren müssen, gibt es diese Komponente für Sie:

5 „Gefällt mir“
3

Vielen Dank @Arkshine!

Das Problem liegt eher daran, dass wir die Markdowns, die auch für andere Zwecke in Discourse verwendet werden, veröffentlichen. Daher verwenden die Personen, die die Dokumente pflegen, diese Anker für Querverweise, wenn sie mehrere Markdowns in einem einzigen Dokument zusammenführen.

Ich denke, ich werde eine Art Skript erstellen, um den Inhalt vor dem Posten zu bereinigen.

3 „Gefällt mir“
4

Ich verstehe!

Die Lösung besteht auch darin, ein Plugin für Discourse mit einem Markdown-Plugin zu erstellen, um diese Syntax zu unterstützen. Wenn Sie etwas Budget haben, könnten Sie Marketplace fragen.

5

@Nihokam

Wenn du immer noch interessiert bist, habe ich ein kleines Discourse-Plugin erstellt, das das Festlegen einer Anker-ID neben der Überschrift handhabt.

Es funktioniert neben den automatischen Überschriften-Ankern von Discourse.
Beachte, dass es sich um eine grundlegende Unterstützung handelt. Es gibt wahrscheinlich viele Varianten, aber dieses Plugin unterstützt nur die folgenden:

## Meine Überschrift {#custom_section}

wird generieren:


<a name="custom_section" href="#custom_section" class="custom-anchor-id"></a>

Die Benutzeroberfläche eines Markdown-Editors mit verschiedenen Symbolen für HTML- und Markdown-Formatierung und einer erweiterten Überschriftenliste mit Überschrift 1, Unterüberschrift 1.1, einer weiteren Überschrift und benutzerdefinierten HTML-Entitätssymbolen in der Symbolleiste. (Beschriftet von KI)
Die Benutzeroberfläche eines Markdown-Editors mit verschiedenen Symbolen für HTML- und Markdown-Formatierung und einer erweiterten Überschriftenliste mit Überschrift 1, Unterüberschrift 1.1, einer weiteren Überschrift und benutzerdefinierten HTML-Entitätssymbolen in der Symbolleiste. (Beschriftet von KI)922×286 7.71 KB

Bild
Bild365×223 9.99 KB

Das Bild zeigt einen HTML-Snippet mit verschachtelten - und -Tags, die benutzerdefinierte Ankerreferenzen für klickbare Abschnitte mit den Titeln „Überschrift 1“, „Unterüberschrift 1.1“ und „Eine weitere Überschrift“ enthalten. (Beschriftet von KI)
Das Bild zeigt einen HTML-Snippet mit verschachtelten - und -Tags, die benutzerdefinierte Ankerreferenzen für klickbare Abschnitte mit den Titeln „Überschrift 1“, „Unterüberschrift 1.1“ und „Eine weitere Überschrift“ enthalten. (Beschriftet von KI)771×310 10.5 KB

Du kannst es gerne ausprobieren! Lass mich wissen, wenn du Probleme damit hast.

2 „Gefällt mir“
6

Danke @Arkshine!

Ich werde mich mit unserem Discourse-Administrator in Verbindung setzen, um die Nutzung zu besprechen :grin:

1 „Gefällt mir“
7

@Arkshine Wissen Sie, wie Anker in Discourse (der aktuellen Website) generiert werden? Ich frage, weil sie nicht den von Ihnen geteilten Mustern zu folgen scheinen. Sehen Sie zum Beispiel dies:

https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544#creating-a-simple-table-1

Gibt es dafür eine Einstellung? Ich konnte sie nicht finden. Oder verwenden sie <a>? Oder Ihr Plugin?