SimpleTOC – Bloco de sumário

Perguntas frequentes

Configurando as configurações globais no SimpleTOC

O SimpleTOC permite que você defina configurações globais para o seu site em WordPress. Essas configurações podem ser aplicadas globalmente, sobrepondo-se a quaisquer configurações em nível de bloco que possam existir. Para acessar essas configurações, navegue até a seção SimpleTOC das configurações do WordPress.

How do I add colors or the Box style to SimpleTOC?

Select the SimpleTOC block and open Gutenberg’s Styles tab. Choose the Box style or use the native color controls to set text, link, and background colors. Native spacing controls are available for vertical margins and padding.

Como excluir um único título do Sumário?

Se você realmente quiser ocultar um único título do sumário, então adicione a classe CSS “simpletoc-hidden” a um bloco de título. Você pode encontrar este campo no mesmo lugar que o campo âncora HTML: Na barra lateral Bloco > Avançado. Mas primeiro, pense no motivo pelo qual você gostaria de esconder um título específico. Talvez você queira remover todos os títulos de um nível de profundidade específico. Então há uma opção para isso nas opções de blocos no Gutenberg. Se você acha que este título não deve fazer parte do sumário, talvez não seja necessário no próprio post?

Eu gostaria de salvar minhas configurações do SimpleTOC como padrão. Isso é possível?

Você pode converter o seu bloco SimpleTOC configurado em um bloco reutilizável no Gutenberg. Ele manterá suas configurações. Dessa forma, você pode usar as configurações desejadas para cada novo post adicionando o bloco reutilizável.

How can I style SimpleTOC through theme.json?

Add styles for the simpletoc/toc block to your theme.json. SimpleTOC uses the standard Gutenberg block wrapper and supports native colors, vertical margins, padding, font size, and line height settings.

The following example sets default colors, spacing, and typography for every SimpleTOC block:

{
    "$schema": "https://schemas.wp.org/trunk/theme.json",
    "version": 3,
    "styles": {
        "blocks": {
            "simpletoc/toc": {
                "color": {
                    "background": "#f5f5f5",
                    "text": "#1e1e1e"
                },
                "elements": {
                    "link": {
                        "color": {
                            "text": "#0057b8"
                        }
                    }
                },
                "spacing": {
                    "margin": {
                        "top": "1.5rem",
                        "bottom": "1.5rem"
                    },
                    "padding": {
                        "top": "1rem",
                        "right": "1rem",
                        "bottom": "1rem",
                        "left": "1rem"
                    }
                },
                "typography": {
                    "fontSize": "1rem",
                    "lineHeight": "1.6"
                }
            }
        }
    }
}

Replace the example values with your theme’s values or preset variables. Selecting the Box style adds the standard is-style-boxed class.

Como permitir que os desenvolvedores excluam títulos específicos de forma programática?

Use o filtro ‘simpletoc_excluded_blocks’. Por exemplo, esse código irá excluir blocos de títulos que estão dentro de um bloco de coluna.

Exemplo:

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

    return $blocks;
} );

Como eu mudo a cor do menu sanfona?

O personagem heavy plus que eu usei não pode ser colorido com css sem hacks. Mas você pode alterar o ícone para outra coisa e alterar a cor do novo ícone.

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

Como adicionar o SimpleTOC a todos os artigos automaticamente?

Não vejo uma solução fácil no momento. O SimpleTOC é apenas um bloco que pode ser colocado no seu post. Se houvesse um plugin que adicionasse blocos a todas os posts, então essa seria a solução. Acho que isso deveria ser um plugin separado para manter o código do SimpleTOC limpo e… bem, simples.