SimpleTOC – Inhaltsverzeichnis Block

Beschreibung

Füge einen Inhaltsverzeichnisblog zu seinen Artikeln und Seiten hinzu. Das Verzeichnis ist eine verschachtelte Liste mit Links zu allen gefundenen Überschriften in dem Artikel oder Seite. Um es zu nutzen, füge einfach einen Block hinzu und suche nach „SimpleTOC“ oder nur „TOC“.

Die maximale Tiefe des Inhaltsverzeichnisses kann neben vielen anderen Optionen in der Seitenleiste der Blöcke konfiguriert werden. Du kannst die Überschrift „Inhaltsverzeichnis“ ausblenden und deine eigene hinzufügen, indem du einen normalen Überschriftenblock verwendest.

SimpleTOC ist Open-Source und wird auf GitHub entwickelt. Wenn du einen Fehler findest oder eine Idee für ein Feature hast, bitte mach bei der Entwicklung mit und erzeuge einen „pull request“.

Erstelle eine neue WordPress-Instanz, auf der das SimpleTOC-Plug-in bereits installiert ist.

Funktionen

  • Für Gutenberg entwickelt.
  • Ohne Konfiguration: Einfach den SimpleTOC Block zum Artikel hinzufügen und das war’s.
  • Minimale und gültige HTML-Ausgabe.
  • Es wird kein JavaScript oder CSS hinzugefügt. Außer, du aktivierst das Akkordeon-Menü.
  • Style SimpleTOC mit Gutenbergs nativen Gruppenstil-Optionen.
  • Übernimmt den Stil deines Themes.
  • Smooth scrolling effect über CSS.
  • Optionale ARIA Label und Navigationsrollenattribute.
  • Übersetzt in verschiedene Sprachen. Inklusive Deutsch, Chinesisch (Taiwanesisch), Niederländisch, Brasilianisch-Portugiesisch, Französisch, Spanisch und Lettisch.
  • Ideal für die Erstellung eines Abschnitts mit häufig gestellten Fragen auf Ihrer Website.

Konfiguration

  • Administratoren können globale Einstellungen verwenden, um die individuellen Blockeinstellungen zu ersetzen.
  • Füge Hintergrund und Textfarbe über Gutenberg Gruppen hinzu.
  • Native Unterstützung für weite und volle Breite.
  • Steuern Sie die maximale Tiefe der Überschriften.
  • Wähle zwischen einer geordneten, aufzählenden HTML-Liste. Oder rücke die Liste ein.
  • Wähle eine Überschriftsebene aus oder verwandle sie in einen Absatz.
  • Deaktiviere die H2 Überschrift des Inhaltsverzeichnisses und füge deine eigene hinzu.

Kompatibilität

  • Unterstützung für GeneratePress und Rank Math.
  • Funktioniert populären AMP Plug-ins.

Danksagungen

Dieses Plug-In ist ein Fork von pdewouters und benutzt Code von Easy-Table-of-Contents

Vielen Dank an Tom J Nowell und Sally CJ, die mir beide sehr bei meinen Fragen drüben bei wordpress.stackexchange.com geholfen haben

Danke an Quintus Valerius Soranus für die Erfindung des Inhaltsverzeichnisses 100 BC.

Screenshots

  • SimpleTOC-Block im Gutenberg-Editor
  • SimpleTOC im Beitrag
  • Simple aber mächtig. Passe jedes Inhaltsverzeichnis so an, wie du möchtest.
  • Steuern Sie die maximale Tiefe der Überschriften.
  • SimpleTOC gestylt mit Gutenbergs nativen Gruppenstilen.
  • Erweiterte Funktionen von SimpleTOC
  • Gutenberg Überschriften-Block: Einen eigenen Anker setzen
  • SimpleTOC versteckt im Akkordeon-Menü.
  • SimpleTOC globale Einstellungen

Blöcke

Dieses Plugin unterstützt 1 Block.

  • SimpleTOC Adds a Table of Contents.

Installation

SimpleTOC kann über das Plugin-Menü innerhalb der WordPress-Administration gefunden und installiert werden (Plugins -> Installieren). Alternativ kann SimpleTOC auch von WordPress.org heruntergeladen und manuell installiert werden…

Füge einen Block in Gutenberg hinzu und suche nach „SimpleTOC“ oder nur „TOC“. Bitte speichere deinen Beitrag bevor du den Block nutzen kannst.

FAQ

Konfiguration globaler Einstellungen in SimpleTOC.

SimpleTOC ermöglicht es dir, globale Einstellungen für deine WordPress-Website zu konfigurieren. Diese Einstellungen können global durchgesetzt werden und überschreiben mögliche Block-Level-Konfigurationen. Um auf diese Einstellungen zuzugreifen, navigiere zum SimpleTOC-Bereich der WordPress-Einstellungen.

Wie füge ich eine Hintergrundfarbe zu SimpleTOC mit Gutenberg Gruppen hinzu?

Markiere den Block und wähle im Kontextmenü „gruppieren“. Wende „Hintergrundfarbe“, „Linkfarbe“ und „Textfarbe“ auf diese Gruppe an. SimpleTOC wird diese Stile erben. Du möchtest diese gestylte SimpleTOC-Gruppe das nächste Mal verwenden, wenn Du einen Beitrag schreibst? Wandele sie in einen wiederverwendbaren Block um.

Wie kann man eine einzelne Überschrift aus dem TOC ausschließen?

Wenn du wirklich eine einzelne Überschrift aus dem Inhaltsverzeichnis ausblenden willst, dann füge die CSS-Klasse „simpletoc-hidden“ zu einem Überschriftenblock hinzu. Du findest dieses Feld an der gleichen Stelle wie das HTML-Ankerfeld: In der Seitenleiste Block > Erweitert. Überlege dir aber zuerst, warum du eine bestimmte Überschrift ausblenden möchtest. Vielleicht möchtest du alle Überschriften einer bestimmten Tiefenstufe entfernen. Dann gibt es dafür eine Option in den Blockoptionen in Gutenberg. Wenn du der Meinung bist, dass diese Überschrift nicht Teil des Inhaltsverzeichnisses sein sollte, wird sie vielleicht im Beitrag selbst nicht benötigt?

Ich würde gerne meine SimpleTOC-Einstellungen als Standard speichern. Ist das möglich?

Du kannst deinen konfigurierten SimpleTOC-Block in einen wiederverwendbaren Block in Gutenberg umwandeln. Er behält seine Einstellungen. Auf diese Weise kannst du deine gewünschten Einstellungen für jeden neuen Beitrag verwenden, indem du den wiederverwendbaren Block hinzufügst.

Wie fügt man einen div-Tag-Wrapper zum TOC hinzu?

Wenn du eine benutzerdefinierte Klasse zum SimpleTOC-Block unter „Erweitert“ hinzufügst und dann „Zusätzliche CSS-Klassen“, wird ein div-Element mit dieser Klasse um die HTML-Ausgabe herum platziert.

Wie kann man Entwicklern erlauben, bestimmte Überschriften programmatisch auszuschließen?

Verwende den Filter „simpletoc_excluded_blocks“. Dieser Code schließt unter anderem Überschriftenblöcke aus, die sich innerhalb eines Spaltenblocks befinden:

Beispiel:

add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) {
    $blocks[] = 'core/column';

    return $blocks;
} );

Wie kann ich die Farbe des Akkordeon-Menüs ändern?

Das heavy plus Zeichen, das ich verwendet habe, kann nicht ohne Hacks mit css eingefärbt werden. Aber Du kannst das Symbol in etwas anderes ändern und die Farbe des neuen Symbols ändern.

.simpletoc-collapsible::after {
    content: "✖";
    color: #e94c89;
}

Wie ändere ich die TOC-Überschrift ‚Inhaltsverzeichnis‘ in etwas anderes?

Ich sehe im Moment keine einfache Lösung. SimpleTOC ist nur ein Block, der in Ihrem Beitrag platziert werden kann. Wenn es ein Plugin gäbe, das Blöcke zu jedem Beitrag hinzufügt, dann wäre das die Lösung. Ich denke, dies sollte ein weiteres separates Plugin sein, um den Code von SimpleTOC sauber und … nun ja, einfach zu halten.

Rezensionen

5. März 2024 2 Antworten
Simple and great plugin! Works very well with the Blocksy theme on the sidebar.
13. Februar 2024
I have tried many different plugins for creating an automated Table of Content, but for the time being I'll stick to this one. The plugin does everything I need, and if a problem occured it was solved in no time. Marc's support actually deserves more than five stars. Dank je wel, as we say in the Netherlands 👍🏻
23. Dezember 2023 1 Antwort
While many plug-ins are cluttered and clunky in appearance, this table of contents plug-in blends in as if it were a built-in part of the theme you are using, and is also easy to use. It is a plugin that makes me wish it would continue to be developed. Thank you to the creator.
Alle 65 Rezensionen lesen

Mitwirkende & Entwickler

„SimpleTOC – Inhaltsverzeichnis Block“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

„SimpleTOC – Inhaltsverzeichnis Block“ wurde in 16 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „SimpleTOC – Inhaltsverzeichnis Block“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

6.3.2

  • Behoben: Die Option für automatisches Aktualisieren funktionierte in einigen Fällen nicht.

6.3.0

  • Hinzugefügt: Option für automatische Aktualisierung. Diese kann in den erweiterten Einstellungen des Blocks deaktiviert werden.
  • Hinzugefügt: Option zur globalen Deaktivierung der automatischen Aktualisierung in den Einstellungen von WordPress SimpleTOC.

6.2.0

  • Hinzugefügt: Implementierung einer flüssigen Animation für eine verbesserte Benutzerinteraktion im Akkordeon-Menü.
  • Hinzugefügt: Verbessertes Styling des Akkordeon-Menüs für eine optisch ansprechendere und modernere Benutzererfahrung.

6.1.0

  • Behoben: Fehlerhafte Auszeichnung, wenn Tags für Überschriften unterhalb des Minimums geschlossen wurden. Danke @harmoney!

6.0.10

  • Aira-hidden Attribute zum Icon im Akkordion hinzugefügt. Danke Alex Stine!

6.0.9

  • ARIA-Zugänglichkeitsbeschriftungen für das Akkordeon hinzugefügt. Danke, Amber Hinds!
  • Fixed: Caching des Akkordion JavaScript. Danke jghitchcock!
  • Korrekte ARIA control Attribute hinzugefügt.