Definition-Box: Format, Regeln und Beispiele

Eine Definitionsbox gibt dem Hauptbegriff der Seite eine präzise, abgegrenzte Erklärung, bevor der Artikel ihn ausführt. Es ist ein Eröffnungselement: eine wiederverwendbare Inhaltskomponente, die nahe dem Anfang erscheint, weil ein Leser den zentralen Begriff nicht aus Beispielen, Vorteilen oder Hintergrundinformationen erschließen sollte.

Dieses Live-Beispiel ist das vollständige Element, kein Vorgeschmack auf eine weiter unten auf der Seite folgende Definition. Sein Titel ist optional; sein Textkörper nicht. Der untenstehende Produktionsvertrag legt fest, wann das Element gehört, was jedes Feld bedeutet und wie dieselben Inhalte über verschiedene Publikationssysteme abgebildet werden.

Warum dieses Element wichtig ist

Leser beginnen selten damit, eine Informationsseite Wort für Wort zu lesen. Sie überfliegen den Titel, die Eröffnungszeilen, Überschriften und optisch abgehobene Blöcke, um zu entscheiden, ob die Seite ihre Frage beantwortet. Eine in einem Einleitungsabsatz vergrabene Definition zwingt den Leser, die Antwort von Kontext, Behauptungen und Szenenbeschreibung zu trennen. Die Box hebt diese Arbeit auf: Ihre Abgrenzung sagt: „Dies ist die Definition.“

Diese Abgrenzung gibt der Definition auch eine stabile, adressierbare Position. Redakteure wissen, wo sie sie überprüfen müssen, Vorlagen wissen, wo sie sie rendern müssen, und zukünftige Überarbeitungen zwingen weder Leser noch Qualitätsprüfung dazu, mehrere Einleitungsabsätze zu durchsuchen. Eine einheitliche Platzierung ist in einer gesamten Bibliothek wichtig, weil dieselbe Informationsaufgabe nicht unvorhersehbar von Seite zu Seite wandern sollte.

Maschinelle Extraktionsfähigkeit ist die Fähigkeit von Software, eine Inhaltseinheit zu isolieren, ohne ihre Bedeutung zu verlieren. Eine typisierte Definition mit Titel und Textkörper kann unabhängig indexiert, verglichen, zitiert oder transformiert werden. Ein Satz, der lediglich zufällig einen Begriff in Freitext definiert, löst sich im umgebenden Text auf: Software muss erraten, wo die Definition beginnt, wo sie endet und ob die vorhergehende Aussage Teil davon ist. Befolgen Sie die Element-Schreibregeln , damit die semantische Identität auch dann erhalten bleibt, wenn sich das visuelle Design ändert.

Die Formulierung muss auch ohne die Box funktionieren. Styling erzeugt Kontrast für Menschen; ein in sich geschlossenes Subjekt, Verb und unterscheidende Bedeutung erzeugen Extraktionsfähigkeit für Maschinen. „Es ist eine Methode zu deren Verbesserung“ versagt, wenn es aus seinem Absatz entfernt wird. „Content-Pruning ist der Prozess des Entfernens, Konsolidierens oder Aktualisierens von Seiten, die keinen nützlichen Such- oder Geschäftszweck mehr erfüllen“ überlebt.

Wann man sie verwendet

Verwenden Sie eine Definitionsbox, wenn die Seite um einen Begriff organisiert ist und dieser Begriff präzise in einer kurzen Aussage definiert werden kann. Sie ist obligatorisch für Glossarbegriffs- und Was-ist-X-Formate. Sie ist auch obligatorisch für diagnose- oder zustandsorientierte Inhalte: Ein Leser muss wissen, was der genannte Zustand ist, bevor er Ursachen, Tests oder Behandlungsmöglichkeiten in Betracht zieht.

Auf symptombasierten Seiten und How-to-Seiten wird das Element selten verwendet. Fügen Sie es nur hinzu, wenn eine kurze Definition eine echte, für die Aufgabe notwendige Mehrdeutigkeit auflöst. In einem Leitfaden mit dem Titel „Wie man Keyword-Kannibalisierung behebt“ kann beispielsweise Keyword-Kannibalisierung vor den Schritten definiert werden, weil die Diagnose bestimmt, welche Lösung angewendet wird. Ein Leitfaden mit dem Titel „Wie man einen Titel-Tag ändert“ benötigt keine Box, die einen Titel-Tag definiert, wenn die Zielgruppe und die einleitende Anweisung das Objekt bereits eindeutig machen.

Verwenden Sie keine Definitionsbox für:

• Eine breite Einleitung, Geschichte, Vorteilsbehauptung oder Erklärung, warum das Thema wichtig ist. Diese Passagen entwickeln den Artikel; sie definieren den Begriff nicht.
• Eine Zusammenfassung der Seite. Eine Zusammenfassung sammelt mehrere Schlussfolgerungen, während eine Definition die Bedeutung eines Begriffs angibt.
• Ein Produktversprechen wie „AmICited ist der einfachste Weg, die Sichtbarkeit zu verbessern.“ Das ist Positionierung, keine überprüfbare Definition.
• Eine Warnung, Einschränkung, Voraussetzung oder ein Tipp. Ihre kommunikative Aufgabe unterscheidet sich, selbst wenn ein Thema sie wie das gleiche farbige Feld aussehen lassen könnte.
• Einen sekundären Begriff, der erst in der Mitte des Artikels eingeführt wird. Definieren Sie diesen Begriff in dem Satz, in dem er zum ersten Mal erscheint, oder geben Sie ihm eine eigene Seite, wenn er eine ausführliche Behandlung verdient.
• Ein Zitat, dessen Autorität die Klarheit ersetzt. Ordnen Sie eine formelle Definition im umgebenden Text zu, wenn eine Quellenangabe erforderlich ist; halten Sie die Box als direkte Aussage lesbar.

Der häufige Beinahe-Fehler ist eine „Einleitung zur Definition“: „Kundenabwanderung ist eines der wichtigsten Konzepte für Abonnementunternehmen, und ihr Verständnis kann das Wachstum verändern.“ Dies besagt, dass das Konzept wichtig ist, sagt aber nie, was es ist. Die Box kann keine leere Szenenbeschreibung präzise machen.

Wo man sie platziert

Die Platzierung kodiert die Priorität. Setzen Sie die Definitionsbox unmittelbar nach dem Einleitungsabsatz oder der kurzen Einführung als ersten Inhaltsblock. Die Einführung begründet, warum der Leser auf der Seite ist; die Box fixiert dann die Bedeutung, bevor Ursachen, Beispiele, Vorteile, Schritte oder Vergleiche davon abhängen.

Platzieren Sie keine Navigation, kein Inhaltsverzeichnis, keine wichtigsten Erkenntnisse, keine Bildergalerie und keinen werblichen Aufruf zum Handeln zwischen Einführung und Definition. Diese Blöcke zwingen den Leser, nicht verwandtes Material zu durchqueren, bevor er die Bedeutung des Begriffs erhält. Breadcrumbs und der Page-Hero sind Vorlagen-Chrome und keine verfassten Inhalte, daher dürfen sie der Einführung vorausgehen.

Verwenden Sie eine Definitionsbox pro Seite. Diese Regel besteht, weil die Komponente das primäre Definitionsobjjekt der Seite identifiziert. Zwei Boxen erzeugen zwei konkurrierende Hauptbegriffe und machen die Extraktion mehrdeutig. Wenn beide Begriffe wirklich primär sind, teilen Sie das Thema auf zwei Seiten auf und verbinden Sie sie im Text. Wenn der zweite Begriff untergeordnet ist, definieren Sie ihn inline, anstatt ihn als zweite kanonische Antwort zu gestalten.

Ein Direktantwortblock kann nur dann neben einer Definition existieren, wenn er eine andere Hauptfrage beantwortet. Auf einer Diagnoseseite kann die Definition angeben, was der Zustand ist, während der Direktantwortblock die empfohlene erste Maßnahme angibt. Wenn die Hauptfrage der Seite „Was ist X?“ lautet, sind der Direktantwortblock und die Definition dieselbe Antwort. Fassen Sie sie zu einer Definitionsbox zusammen; nebeneinander existierende Versionen wiederholen lediglich die Formulierung und konkurrieren um die Extraktion.

Anatomie

Das Element hat zwei verfasste Bereiche und eine strukturelle Beziehung. Der Screenshot muss das gerenderte Element zeigen, ohne erklärenden Text in das Bild einzubetten; die Legende unten bleibt auswählbar, zugänglich und wartbar, wenn sich das Design ändert.

Gerenderte Legende

1. Optionaler Titel: Üblicherweise „Was ist X?“ Er identifiziert den genauen Begriff und darf keine zweite Aussage hinzufügen.
2. Erforderlicher Textkörper: Eine in sich geschlossene Definition, die den Begriff nennt, ihn in eine sinnvolle Kategorie einordnet und angibt, was ihn auszeichnet.
3. Eröffnungsposition: Die Box folgt auf die Einführung und geht dem ersten erklärenden Abschnitt voraus. Diese Beziehung ist Teil des Vertrags, auch wenn sie kein Feld ist.

Rahmen, Hintergrund, Abstände, Symbolbehandlung und Typografie gehören zum Renderer. Autoren liefern Bedeutung, keine visuellen Token. Das Element muss verständlich bleiben, wenn jeder dekorative Stil entfernt wird.

Gestaltungsbeispiele

Die Galerie deckt die unterstützten Inhaltsvarianten ab, anstatt verschiedene semantische Typen zu erfinden. Jede Aufnahme sollte nach Möglichkeit dieselbe Definition wiederverwenden, damit Prüfer die Titelbehandlung, den Textumbruch und das Viewport-Verhalten beurteilen können, anstatt nicht verwandte Texte zu vergleichen.

Mit Titel: Die bevorzugte Variante, wenn der Begriff unbekannt, mehrdeutig, abgekürzt oder vom genauen Seitentitel verschieden ist.

Ohne Titel: Zulässig, wenn die Seitenüberschrift und die unmittelbar vorhergehende Einführung das Thema unmissverständlich machen. Der Textkörper muss dennoch den Begriff nennen; das Weglassen des Titels erlaubt niemals Pronomen wie „es“, um das Subjekt zu ersetzen.

Maximale Länge: Der Renderer bricht den vollständigen Textkörper um. Er darf nicht abschneiden, einklappen, scrollen oder die Schriftgröße reduzieren, um die redaktionelle Maximallänge zu unterschreiten.

Schmales Viewport: Titel und Textkörper behalten ihre Reihenfolge, lesbare Zeilenlänge und sichtbare Abgrenzung bei. Keine Bedeutung darf von einem Symbol abhängen, das sich neben den Text bewegt.

Parameter

Die Parameter trennen Inhalt von Darstellung. Ihre Grenzen halten Definitionen über Seiten hinweg vergleichbar und verhindern, dass sich die Komponente in einen allgemeinen Hinweis verwandelt.

Parameter der Definitionsbox

Der Renderer kann den Begriff für die Indexierung ableiten, aber Autoren dürfen niemals einen Textkörper schreiben, der davon abhängt, dass dieses abgeleitete Feld angezeigt wird. Eine kopierte Definition muss ihr Subjekt explizit nennen.

Syntax und Codebeispiele

Alle drei Formen tragen denselben Titel und Textkörper. Die portable Markdown-Direktive ist die kanonische Autorenform; Hugo und WordPress sind Adapter. Die Beispiele verwenden bewusst identische Formulierungen, damit ein Migrationstest Werte vergleichen kann, nicht nur das Erscheinungsbild.

Portable Markdown-Direktive

:::definition
## Was ist Content-Pruning?

Content-Pruning ist der Prozess des Entfernens, Konsolidierens oder Aktualisierens von Seiten, die keinen nützlichen Such- oder Geschäftszweck mehr erfüllen.
:::

Die erste Überschrift wird auf title abgebildet; alles danach auf body. Lassen Sie die Überschrift für die titellose Variante weg, behalten Sie den Begriff aber im Textkörper.

Hugo-Shortcode

{{< callout type="note" title="What is content pruning?" >}}Content pruning is the process of removing, consolidating, or updating pages that no longer serve a useful search or business purpose.{{< /callout >}}

Die Seite verwendet den vorhandenen Callout-Renderer für die sichtbare Hugo-Darstellung wieder. Der Definitionsvertrag stammt weiterhin aus der typisierten portablen Quelle: note ist hier ein Rendering-Adapter, keine Erlaubnis, gewöhnliche Hinweise in Definitionsboxen zu setzen.

WordPress-Block oder Shortcode

[definition title="What is content pruning?"]Content pruning is the process of removing, consolidating, or updating pages that no longer serve a useful search or business purpose.[/definition]

Eine WordPress-Implementierung kann dieselben Felder als benutzerdefinierten Block bereitstellen. Die gespeicherten Werte bleiben title und body; Editor-Steuerelemente, Farben und Abstände sind Darstellungseinstellungen und dürfen die Bedeutung der Definition nicht verändern.

Beispiele

Dies ist gut, weil es den Begriff nennt, die Bedingung identifiziert und die unterscheidende Konsequenz angibt. Es behauptet nicht, dass jedes Seitenpaar, das ein Wort teilt, konkurriert; der Ausdruck „dieselbe Suchintention“ liefert die notwendige Abgrenzung. Der Textkörper ist ohne den Titel nützlich und kurz genug, um vollständig zitiert zu werden.

Dies ist schlecht, weil es Keyword-Kannibalisierung nie definiert. Es bietet Wichtigkeit, Zielgruppe, Dringlichkeit und eine vage Wirkung, aber keine Kategorie oder unterscheidende Bedingung. Das Ersetzen von „eines der wichtigsten“ durch „eine Situation, in der mehrere Seiten um dieselbe Suchintention konkurrieren“ verwandelt Werbung in Bedeutung.

Ein zweites schlechtes Muster ist die Überfrachtung der Box: eine Definition gefolgt von Ursachen, fünf Beispielen, einer Warnung und einem empfohlenen Tool. Selbst wenn der erste Satz zutreffend ist, zerstört das zusätzliche Material die stabile Abgrenzung. Behalten Sie die Definition; verschieben Sie Ursachen und Beispiele in den nächsten Abschnitt, die Warnung in ihr korrektes Element und die Empfehlung an den Punkt, an dem der Leser danach handeln kann.

Schema-Markup und Barrierefreiheit

Eine Definitionsbox erzeugt nicht automatisch eine eigenständige Schema.org-Entität. In einem gewöhnlichen Artikel bleibt ihr Text Teil des umschließenden Article oder TechArticle. Auf einer Glossarseite kann eine Publikationsimplementierung den Begriff und die Definition einem geeigneten Vokabular zuordnen, jedoch nur, wenn die Website diese Schema-Richtlinie übernommen hat. Erfinden Sie keinen DefinitionBox-Typ: Er existiert in Schema.org nicht.

Verdoppeln Sie den Textkörper ebenso wenig in JSON-LD , nur weil die Box wichtig aussieht. Schema-Markup muss die Seite wahrheitsgemäß beschreiben, und das Verdoppeln sichtbarer Textpassagen in eine nicht verwandte Eigenschaft erzeugt Rauschen statt stärkerer Bedeutung. Wenn eine Schema-Eigenschaft befüllt wird, muss ihr Wert inhaltlich mit der sichtbaren Definition übereinstimmen und mit ihr aktualisiert werden.

Das Element benötigt keine interaktive ARIA-Rolle. Rendern Sie es in normaler Dokumentreihenfolge als beschrifteten Bereich oder semantischen Container, mit dem Titel vor dem Textkörper. Verwenden Sie nicht role="alert", da eine statische Definition keine dringende oder neu eingetroffene Information ist. Verwenden Sie keine Farbe oder ein Symbol als einziges Signal dafür, dass der Block eine Definition ist. Wenn der Titel als Überschrift implementiert ist, muss seine Ebene der Seitenhierarchie folgen; das ## der Quelle ist eine Feldabbildungskonvention, keine Anweisung, einen ungültigen Überschlagssprung zu erzeugen.

Das Tastaturverhalten ist normales Lesevverhalten: Die Box selbst ist nicht fokussierbar. Jeder darin enthaltene Link folgt der normalen Linksemantik und benötigt einen beschreibenden Ankertext. Die Bildschirmausgabe muss dieselbe sichtbare Reihenfolge von Titel vor Textkörper beibehalten.

Schreibregeln

Schreiben Sie die Definition, bevor Sie ihre Vorteile beschreiben. Beginnen Sie mit dem Begriff selbst, verwenden Sie dann ein Verknüpfungsverb wie „ist“, „bedeutet“ oder „tritt auf, wenn“. Nennen Sie die nächstliegende sinnvolle Kategorie und das Merkmal, das den Begriff von benachbarten Konzepten unterscheidet. Diese Reihenfolge existiert, weil Kategorie ohne Unterscheidung breit ist, während Unterscheidung ohne Kategorie den Leser unsicher lässt, um welche Art von Sache es sich bei dem Begriff handelt.

Halten Sie den Textkörper auf maximal etwa 300 Zeichen, inklusive Leerzeichen. Bevorzugen Sie einen Satz. Ein zweiter kurzer Satz ist nur akzeptabel, wenn eine notwendige Abgrenzung im ersten Satz nicht klar ausgedrückt werden kann. Die Begrenzung ist redaktionell, keine Einladung, Satzzeichen zu komprimieren, Artikel zu entfernen oder Nebensätze aneinanderzureihen. Wenn die Genauigkeit mehr Platz erfordert, setzen Sie den exakten Kern in die Box und präzisieren Sie ihn unmittelbar danach.

Verwenden Sie einen neutralen, deklarativen Ton. Vermeiden Sie „wichtig“, „leistungsstark“, „bahnbrechend“, „Sie müssen wissen“ und ähnliche Werturteile. Vermeiden Sie zirkuläre Definitionen wie „Content-Optimierung ist der Akt der Optimierung von Inhalten.“ Schreiben Sie Abkürzungen bei der ersten Verwendung aus, es sei denn, die Abkürzung selbst ist der Begriff der Seite. Verwenden Sie denselben kanonischen Namen, der im Seitentitel erscheint.

Setzen Sie niemals Folgendes in den Textkörper:

• Mehr als einen primären Begriff oder eine Liste verwandter Begriffe.
• Vorteile, Geschichte, Ursachen, Symptome, Beispiele, Schritte, Produktvorstellungen oder Handlungsaufrufe.
• Tabellen, Bilder, Videos, Formulare, Buttons, Fußnoten oder verschachtelte Hinweise.
• Unbelegte Superlative, erfundene Statistiken oder Behauptungen, die einen Absatz Belege benötigen.
• Eine zweite Überschrift, Aufzählungsliste oder Blockzitat.
• Pronomen, deren Bedeutung von der vorhergehenden Einführung abhängt.

Ein Quellenangaben-Link ist die Ausnahme, nicht das Ziel. Verwenden Sie ihn nur, wenn eine rechtliche, wissenschaftliche oder standardbasierte Definition von einer benannten Quelle abhängt. Setzen Sie ausführliche Zitate und Meinungsverschiedenheiten zwischen Quellen in gewöhnlichen Text, wo der Leser die Einschränkung sehen kann, anstatt eine strittige Formulierung fälschlich für eine universelle Definition zu halten.

Beitragstypen, die sie verwenden

Das Frontmatter postTypes erfasst die registrierten Verknüpfungen. Die Tabelle übersetzt diese Verknüpfungen in redaktionelle Regeln. Diagnose-/zustandsorientierte und symptombasierte Formate werden hier als Nutzungsmuster beschrieben, sind aber nicht als separate Playbook-Beitragstypen verlinkt, da sie nicht im aktuellen kanonischen Register enthalten sind.

Anforderungen nach Beitragstyp

Verwenden Sie die Box bei diagnose- oder zustandsorientierten Seiten immer und platzieren Sie sie vor Symptomen, Ursachen, Schweregrad oder Behandlungsmöglichkeiten. Verwenden Sie sie bei symptombasierten Seiten nur, wenn der Symptomname eine wirklich kurze, stabile Definition hat. Wenn die Box lediglich den Titel wiederholen würde – „Eine langsame Website ist eine Website, die langsam ist“ – lassen Sie sie weg und beginnen Sie mit der diagnostischen Schwelle oder dem beobachtbaren Problem im Text.

QA-Checkliste

Ein Prüfer beurteilt die Bedeutung vor dem Erscheinungsbild. Eine polierte Box, die eine vage Einleitung enthält, ist immer noch eine gescheiterte Definition.

• Ein Hauptbegriff: Die Seite und die Box definieren genau ein primäres Konzept.
• Korrekte Position: Die Box ist der erste verfasste Inhaltsblock nach der Einführung, ohne davor eingefügtes Inhaltsverzeichnis, wichtige Erkenntnisse, Galerie oder Werbung.
• Einmaliges Vorkommen: Keine zweite Definitionsbox konkurriert mit der kanonischen Antwort.
• Tatsächliche Definition: Der Textkörper gibt an, was der Begriff ist oder wann die Bedingung existiert; er sagt nicht nur, warum der Begriff wichtig ist.
• In sich geschlossene Formulierung: Der Textkörper nennt sein Subjekt und ergibt Sinn, wenn er ohne umgebenden Text oder Styling kopiert wird.
• Präzision: Kategorie, unterscheidendes Merkmal und jede wesentliche Abgrenzung sind genau. Die Formulierung verallgemeinert nicht übermäßig.
• Länge: Der Textkörper umfasst maximal etwa 300 Zeichen und bleibt lesbar, nicht komprimiert.
• Sauberer Inhalt: Keine Vorteile, Geschichte, Beispiele, Schritte, Produktbehauptungen, Medien, Tabellen oder verschachtelten Elemente erscheinen darin.
• Direktantwort-Entscheidung: Wenn die Seite „Was ist X?“ fragt, ist die Definitionsbox das einzige Direktantwort-Element. Wenn beide Elemente erscheinen, beantworten sie eindeutig unterschiedliche Fragen.
• Zugängliche Semantik: Titel geht dem Textkörper voraus, die Überschriftenhierarchie ist gültig, Farbe ist nicht das einzige Identifikationsmittel, und es sind keine Alert-Rolle oder unnötigen Fokusziele vorhanden.
• Portable Parität: Markdown-, Hugo- und WordPress-Abbildungen behalten denselben Titel und dieselbe Definition.
• Strukturierte Daten-Zurückhaltung: Jeder Schema-Wert stimmt mit dem sichtbaren Text überein, und es wird kein erfundener Schema.org-Typ verwendet.
• Screenshot-Status: Kommentare bleiben nicht-rendering Erfassungsanweisungen, bis die benannten Dateien existieren; kein nicht vorhandener Bildpfad wird als Bild referenziert.

FAQ

Die Academy-Vorlage rendert die fünf geprüften Fragen, die im [[faq]]-Frontmatter dieser Seite gespeichert sind. Zusammen decken sie die Notwendigkeit, die Koexistenz mit Direktantworten, Links und Zitate, die Längenbegrenzung und die Ein-Pro-Seite-Regel ab.