SimpleTOC – Bloco de sumário

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.
  • Encontra manchetes em grupos e blocos reutilizáveis. E em grupos dentro de blocos reutilizáveis.
  • Suporte para Rank Math.

Créditos

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

  • Bloco do SimpleTOC no editor do Gutenberg.
  • SimpleTOC no post.
  • Simples, mas poderoso. Personalize cada sumário como desejar.
  • Controle a profundidade máxima dos títulos.

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

Por que você fez isso?

Porque eu precisava de um plugin simples para fazer este trabalho e decidi fazê-lo por conta própria. Acredito que um Sumário não precisa de JavaScript e CSS adicional. Além disso, o plugin deve funcionar fora da caixa, sem nenhuma configuração.

Como mudar o título do ‘Sumário’ para outra palavra?

Esconda a manchete nas opções da barra lateral do SimpleTOC e adicione seu próprio título.

Como adicionar o SimpleTOC a todos os artigos automaticamente?

No momento, eu não vejo uma solução fácil. O SimpleTOC é apenas um bloco que pode ser colocado no seu post. Se houvesse um plugin que adicionasse blocos a cada post, então esta seria a solução. Eu acho que este deveria ser outro plugin separado para manter o código do SimpleTOC limpo e… bem, simples. Talvez alguém saiba de um plugin que adiciona blocos automaticamente a todos os posts, com alguns parâmetros e configurações? E quanto à edição do site no WordPress? Eu acho que a equipe do núcleo está trabalhando em algo assim. Vou manter este post aberto. Se eu tiver adquirido mais conhecimentos sobre como resolver isto, acrescentarei este recurso.

Como adicionar uma cor de fundo ao SimpleTOC?

SimpleTOC é simples. Ele nunca irá carregar JavaScript ou CSS. E você mesmo pode adicionar CSS personalizado ao seu tema:

.simpletoc {
    padding: 1em 2em;
    background: #bada55;
}

Se você quiser adicionar uma cor incluindo a manchete, adicione uma classe CSS personalizada ao bloco SimpleTOC. Dê um nome como “toctoc” ou algo que faça sentido.

.toctoc {
    padding: 1em 1em;
    background: #bada55;
}

Se você usar esse CSS, ele adicionará um fundo colorido a todo o Sumário, incluindo o título.

Como eu posso inserir rolagem suave?

Opcionalmente, você pode adicionar a classe css “smooth-scroll” a cada link do Sumário. Então você pode instalar o plugin que utiliza estas classes.

Avaliações

16 de julho de 2021
Perfect. Lightweight. Only wish it had AMP-friendly collapse options using "toggleVisibility" or something along those lines.
6 de julho de 2021
The plugin is perfect. The most important thing is that it does not use javascript. Just configure a block as needed and use it as a reusable block. Very good plugin - thanks for the good work
17 de junho de 2021
Buen complemente ligero y cumple el cometido!
8 de junho de 2021
Adding the SimpleTOC block to my pages is super easy, it works without any fuss, and it hasn't had any performance impacts as far as I can tell. I did find one bug, but the developer was able to fix it and publish a new version within a day or two, and they were very polite about it.
Leia todas as 24 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 9 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.7

  • Corrigido: alerta de php para html vazio.

4.6

  • Corrigido: a definição do nível máximo resultava em uma marcação inválida se o último item fosse pelo menos um título de nível 3.

4.5

  • Recurso: acrescente a classe CSS “smooth-scroll aos links. Isto ativa uma rolagem suave em temas como o GeneratePress.

4.4.9.2

  • Refatoração: melhor geração de Sumário, com menos erros de validação HTML.

4.4.9

  • Recurso: suporte para manchetes em blocos reutilizáveis.

4.4.8

  • Recurso: adicionada opção para alternar urls absolutas.

4.4.7

  • Correção: as IDs do título não serão mais adicionadas a todos os posts.
  • Correção: títulos com atributos como “align-center” agora irão aparecer no seu Sumário.
  • 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.