Como gerar um slug para um URL

Quando usar um slug de texto

Um slug é uma versão preparada para ser usada no endereço de uma página. Este gerador converte texto num slug limpo e compatível com um URL, preservando as palavras reconhecíveis depois de tratar acentos e outros sinais. Pode escolher a forma de separar os termos e decidir se o resultado deve usar minúsculas.

A ferramenta é útil quando parte de um título, nome de artigo ou expressão descritiva e precisa de obter uma sequência mais simples. A normalização transforma caracteres acentuados em equivalentes sem acento antes da criação do slug. Assim, uma entrada escrita em português pode ser processada sem manter esses sinais no texto final.

O preenchimento do texto é opcional, e o separador começa definido como hífen. A conversão para minúsculas também começa ativada, embora possa alterar essa opção antes de obter o resultado.

Passos para gerar o slug

1. Introduza no campo de texto o título, nome ou expressão que quer transformar. Pode deixar o campo vazio, mas essa escolha produz um slug vazio, pelo que deve confirmar o conteúdo antes de avançar.

2. Selecione o separador que pretende ver entre os termos. As opções documentadas são hífen, sublinhado e ponto; escolha uma delas conforme a forma de leitura que procura para o resultado.

3. Verifique o controlo de conversão para minúsculas. Quando está ativo, as letras do slug são convertidas para minúsculas; quando o desativa, essa conversão não é aplicada.

4. Inicie a conversão através do controlo disponível e consulte o resultado apresentado. Não é necessário retirar manualmente os acentos ou a pontuação antes de enviar o texto, porque esses elementos são tratados durante a geração.

5. Leia o slug antes de o utilizar. Sequências de caracteres não alfanuméricos são substituídas pelo separador escolhido, os separadores no início e no fim são retirados e ocorrências repetidas ficam reduzidas a uma só.

Leitura do resultado e dos seus limites

O resultado não é uma cópia literal do título introduzido. Primeiro, os caracteres acentuados passam para uma forma compatível com ASCII; depois, grupos de caracteres não alfanuméricos passam a funcionar como uma divisão entre termos. Por isso, espaços e pontuação não permanecem necessariamente com o mesmo aspeto da entrada.

A escolha do separador muda a apresentação do slug: pode obter termos unidos por hífen, sublinhado ou ponto. A opção de minúsculas deve ser lida em conjunto com a forma escrita do texto, porque desligá-la permite conservar a capitalização resultante do processamento, em vez de pedir a sua conversão.

Uma entrada composta apenas por caracteres especiais não fornece termos para o resultado e produz um slug vazio. Quando existe texto útil, a informação devolvida inclui ainda o texto original limitado aos primeiros 100 caracteres e o número de caracteres do slug gerado. Esses dados ajudam a conferir o que foi recebido e o tamanho do resultado.

Exemplo prático

Uma pessoa está a preparar o endereço de uma página sobre um guia rápido de café e quer converter o respetivo título num slug.

Introduza “Café résumé naïve: guia rápido”, mantenha o hífen selecionado e deixe ativa a conversão para minúsculas; em seguida, execute a transformação.

O resultado tem termos separados por hífen, equivalentes sem acento, sem separadores repetidos ou nas extremidades e com minúsculas. Nos dados de um resultado não vazio aparecem também o texto original até aos primeiros 100 caracteres e a contagem de caracteres do slug.

Limitações

• As opções documentadas limitam-se a três separadores; a capitalização pode ser preservada, e entradas vazias ou só com sinais produzem um slug vazio.

Erros comuns

• Um resultado vazio pode vir de um campo sem conteúdo ou de uma entrada formada apenas por sinais; introduza pelo menos palavras ou números e volte a executar a conversão.

Perguntas frequentes

O que acontece se não introduzir texto?

Se o campo ficar vazio, o resultado será um slug vazio. Uma entrada que contenha apenas caracteres especiais também não gera termos para o slug.

Quais são os separadores disponíveis?

Pode selecionar hífen, sublinhado ou ponto. A escolha fica entre estas três opções documentadas, e os grupos não alfanuméricos são convertidos no separador selecionado.

O slug fica sempre em minúsculas?

Só fica em minúsculas quando essa conversão está ativada. Se desligar o controlo, a ferramenta não aplica a conversão para minúsculas ao resultado.