Descrição
No Gutenberg, adicione um bloco e pesquise por “SimpleTOC” ou apenas “TOC”. Você precisa salvar seu post antes de adicionar o bloco. Ele analisa o conteúdo do post e recupera os títulos dos blocos, criando um novo bloco dinâmico, com uma lista de links para os títulos.
Oculte o título “Sumário” e defina uma profundidade máxima de exibição na configuração da barra lateral dos blocos. Adicione a classe CSS “simpletoc-hidden” a um bloco de título para remover esse título específico do sumário gerado.
Recursos
- Nenhum JavaScript ou CSS adicionado.
- Projetado para Gutenberg
- Compatível com plugins AMP.
- Saída HTML mínima e válida.
- Herda o estilo do seu tema.
- Suporte para layouts de bloco de coluna.
- Controle a profundidade máxima dos títulos.
- Escolha entre uma lista html ordenada e não ordenada.
- SEO amigável: desative o título h2 do bloco TOC e adicione o seu próprio.
- Dispõe de traduções para inglês, francês, espanhol, alemão e português do Brasil.
- Funciona em textos não latinos. Testado com japonês e árabe.
- Finds headlines in groups and reusable blocks. And in groups within reusable blocks.
- Suporte para Rank Math.
Credits
Este plugin é derivado de https://github.com/pdewouters/gutentoc, de pdewouters, e usa o código de https://github.com/shazahm1/Easy-Table-of-Contents, de shazahm1
Muito obrigado a Tom J Nowell, https://tomjn.com, e Sally CJ, que me ajudaram muito com minhas perguntas no wordpress.stackexchange.com
Imagens de tela
Blocos
Este plugin disponibiliza 1 bloco.
- SimpleTOC
Instalação
SimpleTOC pode ser encontrado e instalado através do menu Plugin na administração do WordPress (Plugins -> Adicionar Novo). Como alternativa, ele pode ser baixado do WordPress.org e instalado manualmente…
No Gutenberg, adicione um bloco e pesquise “SimpleTOC” ou apenas “TOC”. Salve seu conteúdo antes de usar o bloco.
FAQ
-
Why did you do this?
-
Because I needed a simple plugin to do this job and decided to do it on his own. I believe that a Table of Contents does not need Javascript and additional css. Furthermore the plugin should work out-of-the-box without any configuration.
-
How do I change the TOC heading ‘Table of contents’ to some other words?
-
Hide the headline in the sidebar options of SimpleTOC and add your own heading.
-
How do I add SimpleTOC to all articles automatically?
-
I don’t see an easy solution at the moment. SimpleTOC is only a block that can be placed in your post. If there would be a plugin that adds blocks to every post then this would be the solution. I think this should be another separate plug-in to keep the code of SimpleTOC clean and … well, simple. Maybe someone knows of a plug-in that adds blocks automatically to all posts with some parameters and settings? What about site editing in WordPress? I think the core team is working on something like that. I will keep this post open. If I have gained more knowledge how to solve this I will add this feature.
-
How do I add a background color to SimpleTOC?
-
SimpleTOC is simple. It will never load JavaScript or CSS. But you can add custom CSS yourself to your theme:
.simpletoc { padding: 1em 2em; background: #bada55; }
If you want to add a color including the headline, add a custom css class to the SimpleTOC block. Name it “toctoc” or something like that.
.toctoc { padding: 1em 1em; background: #bada55; }
If you use that CSS it will add a colored background to the whole TOC including the heading.
Avaliações
Colaboradores e desenvolvedores
“SimpleTOC – Bloco de sumário” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.
Colaboradores“SimpleTOC – Bloco de sumário” foi traduzido para 8 localizações. Agradecemos aos tradutores por suas contribuições.
Traduzir “SimpleTOC – Bloco de sumário” para o seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, dê uma olhada no repositório SVN ou assine o registro de desenvolvimento via RSS.
Registro de alterações
4.5
- Feature: Add the css class “smooth-scroll” to the links. This enables smooth scrolling in themes like GeneratePress.
4.4.9.2
- Refactoring: Better TOC generation with less HTML validation errors.
4.4.9
- Feature: Support for headlines in reusable blocks.
4.4.8
- Feature: Added option to toggle absolute urls.
4.4.7
- Fix: Heading ids won’t be added to all posts anymore.
- Fix: Headings with attributes like align-center will now appear in your TOC.
- Recurso: Adicionada a opção para substituir a tag ul pela tag ol. Isso adicionará números decimais a cada título no sumário.
- Recurso: Funciona em blocos aninhados. Isso significa suporte para layouts de bloco de coluna.
4.3
- Recurso: Suporte para títulos não latinos. SimpleTOC agora usa uma lista de blocos de caracteres, em vez de uma lista de permissões.
- Recurso: Adicione a classe CSS “simpletoc-hidden” ao bloco de título para removê-lo do sumário.
4.1.1
- Recurso: suporte experimental para texto árabe.
4.0
- Recurso: Adicionada opção para definir o nível máximo dos títulos.
3.9
- Adicionadas traduções do português brasileiro. Obrigado Ralden Souza!
3.5
- Adicionado suporte para o plugin Rank Math.