Verwendung von H1 vs. H2 Überschriften im Composer

Wenn bei der Verwendung einer Markdown-Überschrift erster Ebene (#) in einem Thema wird dadurch h1 oder h2 in der HTML-Ausgabe erzeugt?

Es wird ein <h1> ausgegeben :slight_smile:

Bedeutet das also, dass Discourse davon ausgeht, dass es in Ordnung ist, mehrere <h1>-Tags auf einer Seite zu haben? Wenn der Thementitel h1 ist, sollten die Überschriften erster Ebene innerhalb dieses Themas standardmäßig h2 sein, oder?

Discourse geht von nichts aus, es gibt aus, was Sie es auszugeben bitten.
Es ist auf jeden Fall bessere Praxis, ## als oberste Überschriften innerhalb eines Beitrags zu verwenden :slight_smile:

1 „Gefällt mir“

Das ist definitiv eine „Benutzerschulung“, die wir uns ersparen könnten, indem wir # nicht zu einer Überschrift der Stufe 1 machen… :anxious_face_with_sweat:

Wissen Sie, ob es eine Möglichkeit gibt, das zu ändern? Oder zumindest Überschriften der Stufe 1 in der Werkzeugleiste auszublenden? (Ich vermute, dass Leute, die direkt in Markdown schreiben, ein realistisches Schulungsziel sind …)

1 „Gefällt mir“

Ja, das ist ziemlich einfach. Das Listenelement hat ein data-name="heading-1"-Attribut, das Sie mit CSS ansprechen können :slight_smile:

Heh – ich habe es mir gerade auch angesehen. In einem schnellen Test verbirgt dies die H1-Option sowohl im Markdown- als auch im Rich-Text-Editor:

button[data-name="heading-1"] {
  display: none;
}

(Ich behalte das vielleicht einfach bei! Ich sehe keinen großen Grund, H1 im Editor anzubieten.)

2 „Gefällt mir“

Ich kann Ihren Standpunkt verstehen, aber das ist nichts, worüber Discourse notwendigerweise entschieden hat. Discourse folgt einer Markdown-Konvention namens CommonMark, und diese spezifiziert, dass # in ein H1 umgewandelt werden soll. Ich denke, diese Konvention, wie Markdown-Überschriften in HTML-Tags umgewandelt werden, ist bei den meisten wichtigen Markdown-Spezifikationen ziemlich Standard.

1 „Gefällt mir“

Nun, zwei <h1>-Überschriften sind eigentlich keine so große Frage. Es ist ein wirklich altes SEO-Meme, das schon lange kein Problem mehr darstellt. Google und Co. verwenden die erste oder was auch immer sie für am besten geeignet halten.

Wir können diskutieren, ob zwei Hauptüberschriften inhaltlich die klügste Entscheidung sind, aber wenn eine Plattform unterschiedliche Stile für den Them_ennamen und Überschriften in Beiträgen verwendet, spielt das keine wirkliche Rolle.

Dennoch ist es angebrachter, in Beiträgen ##/<h2> zu verwenden. Aber da es keine tatsächliche Rolle spielt, ist es meiner Meinung nach besser, wenn Benutzer Überschriften verwenden, die diese vermeiden, weil sie Angst haben, die „falsche“ Überschrift zu verwenden :man_shrugging:

1 „Gefällt mir“

Überschriften sind heute vielleicht nur noch ein kleines Signal für SEO – aber weil ich ein Nerd bin, mag ich trotzdem keine doppelten H1s. :nerd_face:

Ich denke auch darüber nach, wie Steph druckbare Dokumentationen für die Seitenerstellung erstellt, bei denen H1s im Beitrag sogar noch größer dargestellt werden als die H1 der Seite selbst:

Bild

Wenn man diese zu H2 macht, bleiben sie etwas kleiner als die obere H1:

Bild

1 „Gefällt mir“

Ja, das ist das Problem. Für mich ist es natürlich, zuerst die Überschrift erster Ebene zu verwenden, aber wenn das Theme nicht mit derselben Annahme gestaltet ist, ist es unordentlich. Hier gibt es eine Art Trennung.

(Nebenbemerkung: Wird dir das Dokument auf Englisch angezeigt, ohne dass du etwas unternommen hast?!?)

Das ist natürlich, ja, und es ergibt Sinn, wenn man eine Webseite von Grund auf neu erstellt. Aber ein CMS oder ein Veröffentlichungssystem bezieht die H1 der Seite fast immer aus einem Titel-Feld, sodass man normalerweise zu H2 für die Inhaltsabschnitte greifen würde.

(Und ich habe das Übersetzungstool des Webbrowsers verwendet, um Englisch zu erhalten.)

1 „Gefällt mir“

Ich stimme zu. Aber wir sollten nicht erwarten, dass Community-Mitglieder das wissen müssen, meiner Meinung nach.

Yep – und ich sehe keinen Nachteil darin, einfach die H1-Option auszublenden.

Obwohl ich nicht viele Überschriften von den meisten Benutzern sehe, die typische Beiträge erstellen. Leute, die längere Dokumentationsthemen erstellen, haben wahrscheinlich (oder werden schnell haben) etwas mehr Erfahrung mit ## und diesem „TT“-Symbol.

(Außerdem: Mir ist gerade diese interessante alte Diskussion aufgefallen, in der vorgeschlagen wird, dass Überschriften nur in Themen verwendet und in Antworten deaktiviert werden sollten: Disable headers in replies like h1 and h2)

1 „Gefällt mir“