Beskrivelse
Tilføj en indholdsfortegnelsesblok til dine indlæg og sider. Indholdsfortegnelsen er en indlejret liste med links til alle overskrifter, der findes i indlægget eller på siden. For at bruge den skal du blot tilføje en blok og søge efter “SimpleTOC” eller bare “TOC”.
Den maksimale dybde for indholdsfortegnelsen kan konfigureres i blokkens sidepanel blandt mange andre indstillinger. Der kan du også skjule overskriften “Indholdsfortegnelse” og tilføje din egen ved at bruge en almindelig overskriftsblok.
Start en ny WordPress-instans op med SimpleTOC-pluginnet forudinstalleret.
Brugerfeedback
“Det er letvægts, stabilt og fuldt kompatibelt med WordPress Full Site Editing. En pålidelig løsning, der integreres sømløst og yder præcis som forventet.”
— @js100 på wordpress.org“Gør arbejdet perfekt og tilføjer ingen spildkode/bloat.”
— @clicknathan på wordpress.org“Enkel og alligevel kraftfuld. Fantastisk plugin, der gør præcis det, du har brug for.”
— @mixey på wordpress.org
Tilgængelighed
Dette plugin er designet & udviklet til overholdelse af WCAG 2.2 niveau AA. Pluginnet er testet med hjælpeteknologier og er beregnet til at være tilgængeligt, men visse tredjeparts-plugins eller -temaer kan påvirke den enkelte tilgængelighed på et givet websted. Hvis du finder et tilgængelighedsproblem, bedes du sige til, så vil vi prøve at udbedre det hurtigst muligt.
Skjulte indholdsfortegnelser bruger native <details>– og <summary>-semantik uden ekstra ARIA-referencer, der kræver tilpassede ID’er.
Funktioner
- Designet til Gutenberg.
- Ingen konfiguration krævet: Tilføj SimpleTOC-blokken til dit indlæg, og det er det hele.
- Minimalt og gyldigt HTML-output.
- Benytter browserens indbyggede details-tag til en sammenklappelig grænseflade.
- Ingen JavaScript eller CSS som standard. Valgfrie funktioner som accordion-menu, blød rulning eller boks-stil tilføjer kun minimale filer/assets, når de er aktiveret.
- Valgfri boks-stil til indholdsfortegnelsen med en standard grå baggrund.
- Tilpas stilen på SimpleTOC med Gutenbergs native gruppestil-indstillinger.
- Arver stilen fra dit tema.
- Blød rulle-effekt (smooth scrolling) via CSS.
- Indbygget tilgængelighed ved at følge webstandarder.
- Valgfri ARIA Label og navigations-rolleattributter.
- Oversat til flere sprog. Herunder tysk, japansk, kinesisk (Taiwan), hollandsk, brasiliansk portugisisk, fransk, spansk og lettisk.
- Ideel til at oprette en sektion med ofte stillede spørgsmål (FAQ) på dit websted.
Tilpasning
- Administratorer kan benytte globale indstillinger til at tilsidesætte de individuelle blokindstillinger.
- Tilføj baggrunds- og tekstfarve med Gutenberg-grupper.
- Native bloksupport for bred og fuld bredde.
- Styr den maksimale dybde af overskrifterne.
- Vælg mellem en ordnet liste eller en punktopstilling i HTML. Eller indryk listen.
- Aktiver en boks-stil og vælg en boksfarve direkte i blokkens sidepanel.
- Vælg et overskriftsniveau eller lav det om til et afsnit.
- Deaktiver H2-overskriften i indholdsfortegnelsesblokken og tilføj din egen.
Kompatibilitet
- Support for GeneratePress og Rank Math.
- Fungerer med populære AMP-plugins.
Sådan bidrager du
SimpleTOC er open source og udvikles på GitHub Pages. Hvis du finder en fejl eller har en idé til en funktion, er du velkommen til at bidrage og oprette en pull request.
Krediteringer
Mange tak til Tom J Nowell og Sally CJ, som begge hjalp mig meget med mine spørgsmål ovre på wordpress.stackexchange.com
Og mange flere tak til alle de udviklere på GitHub, der har hjulpet mig med at gøre SimpleTOC til det, det er i dag!
Tak til Quintus Valerius Soranus for at opfinde indholdsfortegnelsen omkring år 100 f.Kr.
Skærmbilleder
Blokke
Dette plugin giver 1 blok.
- SimpleTOC Adds a Table of Contents.
Installation
SimpleTOC kan findes og installeres via Plugin-menuen i WordPress-administrationen (Plugins -> Tilføj nyt). Alternativt kan det downloades fra WordPress.org og installeres manuelt …
Tilføj en blok i Gutenberg og søg efter “SimpleTOC” eller blot “TOC”. Gem venligst dit indhold, før du bruger blokken.
FAQ
-
Konfiguration af globale indstillinger i SimpleTOC
-
SimpleTOC giver dig mulighed for at konfigurere globale indstillinger for dit WordPress-websted. Disse indstillinger kan gennemtvinges globalt og tilsidesætte eventuelle konfigurationer på blokniveau. For at tilgå disse indstillinger skal du navigere til SimpleTOC-sektionen i WordPress-indstillingerne.
-
Hvordan tilføjer jeg en baggrundsfarve til SimpleTOC ved hjælp af Gutenberg-grupper?
-
Vælg blokken og vælg “gruppe” i kontekstmenuen. Anvend “baggrundsfarve”, “linkfarve” og “tekstfarve” på denne gruppe. SimpleTOC vil arve disse stilarter. Vil du gerne bruge denne stylede SimpleTOC-gruppe næste gang du skriver et indlæg? Konverter den til en genanvendelig blok.
-
Hvordan ekskluderes en enkelt overskrift fra indholdsfortegnelsen?
-
Hvis du virkelig ønsker at skjule en enkelt overskrift fra indholdsfortegnelsen, skal du tilføje CSS-klassen “simpletoc-hidden” til en overskriftsblok. Du kan finde dette felt samme sted som HTML-ankerfeltet: I Blok > Avanceret-sidepanelet. Men overvej først grunden til, at du ønsker at skjule en specifik overskrift. Måske vil du fjerne alle overskrifter på et bestemt dybdeniveau? Så er der en indstilling til det i blokkens indstillinger i Gutenberg. Hvis du mener, at overskriften ikke bør være en del af indholdsfortegnelsen, er den måske slet ikke nødvendig i selve indlægget?
-
Jeg vil gerne gemme mine SimpleTOC-indstillinger som standard. Er det muligt?
-
Du kan konvertere din konfigurerede SimpleTOC-blok til en genanvendelig blok i Gutenberg. Den vil bevare sine indstillinger. På denne måde kan du bruge dine foretrukne indstillinger i hvert nyt indlæg ved at tilføje den genanvendelige blok.
-
Hvordan tilføjer man en div-tag wrapper til indholdsfortegnelsen?
-
Hvis du tilføjer en tilpasset klasse til SimpleTOC-blokken under “Avanceret” og derefter “Yderligere CSS-klasse(r)”, vil en div med den klasse blive svøbt om HTML-outputtet.
-
Hvordan giver man udviklere mulighed for at ekskludere specifikke overskrifter programmatisk?
-
Brug ‘simpletoc_excluded_blocks’-filteret. Dette kodeeksempel vil for eksempel ekskludere overskriftsblokke, der er placeret i en kolonneblok.
Eksempel:
add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) { $blocks[] = 'core/column'; return $blocks; } ); -
Det fede plustegn, jeg har brugt, kan ikke farves med CSS uden hacks. Men du kan ændre ikonet til noget andet og ændre farven på det nye ikon.
.simpletoc-collapsible::after { content: "✖"; color: #e94c89; } -
Hvordan tilføjer jeg automatisk SimpleTOC til alle artikler?
-
Jeg ser ikke en nem løsning på nuværende tidspunkt. SimpleTOC er blot en blok, der kan placeres i dit indlæg. Hvis der var et plugin, der tilføjede blokke til ethvert indlæg, ville det være løsningen. Jeg mener, at dette bør være et andet adskilt plugin for at holde koden i SimpleTOC ren og … tja, simpel.
Anmeldelser
Bidragsydere & udviklere
“SimpleTOC – Table of Contents Block” er open source-software. Følgende personer har bidraget til dette plugin.
Bidragsydere
“SimpleTOC – Table of Contents Block” er blevet oversat til 19 sprog. Tak til oversætterne for deres bidrag.
Oversæt “SimpleTOC – Table of Contents Block” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
7.1.1
- Rettet: Forhindrede meddelelser/notices fra WordPress HTML API, når indlejret blokindhold ikke er en streng.
- Rettet: Escapede indholdsfortegnelsens links og titler før rendering.
- Rettet: Bevarede validiteten af ældre (legacy) SimpleTOC-blokke i WordPress-editoren.
7.1.0
- Rettet: Undgår DOMDocument HTML-parsing for fremhævet overskrifts-markup ved i stedet at benytte WordPress HTML API.
- Ændret: Minimum krævede WordPress-version er nu 6.2.
- Tilføjet: PHPUnit-dækning for core rendering helpers og en editor e2e-smoketest.
7.0.10
- Rettet: Forhindrer forhåndsvisningen af SimpleTOC i editoren i at klappe sammen under automatiske gemninger i WordPress.
- Ændret: Automatisk opdatering i editoren kører nu efter manuelle indlægsgemninger og holder den forrige indholdsfortegnelse synlig under opdateringen.
7.0.9
- Rettet: Genoprettede WordPress 7.0 forhåndsvisninger i editoren for eksisterende SimpleTOC-blokke, der indeholder ældre editor-specifikke attributter.
- Rettet: Knappen “Skjul SimpleTOC” i editoren gemmer ikke længere en overflødig hjælpeattribut.
7.0.8
- Rettet: Forhindrer fejl ved forhåndsvisning i editoren, når et andet plugin tilføjer editor-specifikke attributter til blokke, for eksempel Noted! bloknoter. Tak til Hans-Gerd Gerhards (@hage).