Solucionado (ver solução)

Importante

Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!

Solucionado
(ver solução)
2
respostas

[Projeto] Glossário de RPG

Seguindo a atividade "Simulando a navegação por títulos em HTML", aqui está o resumo da minha atividade:

O tema escolhido foi um Glossário de RPG de mesa, a fim de trazer termos comumente utilizados desse passatempo que gosto.

<!DOCTYPE html>
<html lang="">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Glossário de RPGs de Mesa</title>
</head>
<body>
    <h1>Glossário de RPGs de Mesa</h1>

    <h2>Termos Comuns</h2>
    <p>D&D -> <a href="https://www.dndbeyond.com/" target="_blank">Dungeons & Dragons</a></p>
    <p>RPG -> Role-Playing Game</p>
    <p>D20 -> Dado de 20 lados e/ou sistema </p>

    <h3>Termos de Personagem</h3>
    <p>PV -> Pontos de Vida</p>
    <p>Spell Slot -> Espaço para conjurar magias</p>
    <p>CA - Classe de Armadura</p>

    <h4>Termos de Jogo</h4>
    <p>Mestre ou Narrador -> Personagem que orienta a narrativa do jogo e interpreta NPCs</p>
    <p>Teste -> Ação realizada para determinar o sucesso ou fracasso de uma ação escolhida pelo jogador</p>
    <p>NPC -> Personagem não-jogador, controlado pelo mestre</p>

</body>
</html>

Após submeter à revisão da IA, me foi pontuado 2 coisas que realmente fizeram sentido para um melhor entendimendo da minha página:

  1. A hierarquia de Hs estava confusa com “Termos de Jogo” (h4) pertencente a “Termos de Personagem” (h3). Como os termos Mestre, Teste e NPC são conceitos gerais de jogo, a relação não era adequada.

    • A sugestão foi padronizar tudo em h2 e eu acatei.
  2. Meu documento declarava <html lang="en"> mas o conteúdo está em português. A IA indicou que isso poderia prejudicar tecnologias assistivas, especialmente leitores de tela, que podem tentar pronunciar o conteúdo usando regras do inglês.

    • A sugestão foi alterar para <html lang="pt-BR"> e eu acatei.

Assim, o código da minha página ficou da seguinte maneira

<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Glossário de RPGs de Mesa</title>
</head>
<body>
    <h1>Glossário de RPGs de Mesa</h1>

    <h2>Termos Comuns</h2>
    <p>D&D -> <a href="https://www.dndbeyond.com/" target="_blank">Dungeons & Dragons</a></p>
    <p>RPG -> Role-Playing Game</p>
    <p>D20 -> Dado de 20 lados e/ou sistema </p>

    <h2>Termos de Jogo</h2>
    <p>Mestre ou Narrador -> Personagem que orienta a narrativa do jogo e interpreta NPCs</p>
    <p>Teste -> Ação realizada para determinar o sucesso ou fracasso de uma ação escolhida pelo jogador</p>
    <p>NPC -> Personagem não-jogador, controlado pelo mestre</p>

    <h2>Termos de Personagem</h2>
    <p>PV -> Pontos de Vida</p>
    <p>Spell Slot -> Espaço para conjurar magias</p>
    <p>CA -> Classe de Armadura</p>

</body>
</html>

Algo que também foi pontuado pela IA foi a tag com link <a href="https://www.dndbeyond.com/" target="_blank">Dungeons & Dragons</a>. A IA pontou que a tag estava escrita de outra maneira, pontuada abaixo:

<a href="[https://www.dndbeyond.com/](https://www.dndbeyond.com/)" target="_blank">

Entretanto, essa formatação foi oriunda do próprio chat com a IA e não do meu código, por isso, relevei já que não se aplicava ao meu conteúdo.

2 respostas
solução!

Fala, Raphael! Tudo bom?

Agradeço por trazer sua solução para o fórum!

Curti demais como trabalhou a hierarquia de títulos para organizar o conteúdo em HTML, entendeu perfeitamente a importância da acessibilidade com lang="pt-BR" para leitores de tela e usou bem a tag de link para direcionar o usuário a recursos externos. Esse cuidado deixa a página mais clara, inclusiva e bem estruturada.

Algo bem legal para complementar é adicionar uma lista ordenada ou não ordenada para os termos, o que pode melhorar a semântica e a legibilidade. Dessa maneira:

<h2>Termos Comuns</h2>
<ul>
  <li>D&D -> <a href="https://www.dndbeyond.com/" target="_blank">Dungeons & Dragons</a></li>
  <li>RPG -> Role-Playing Game</li>
  <li>D20 -> Dado de 20 lados e/ou sistema</li>
</ul>

Isso faz com que os termos fiquem mais organizados e fáceis de navegar.

E algumas boas práticas que você pode adotar são:

  • Semântica: usar listas para conjuntos de termos relacionados.
  • Acessibilidade: garantir contraste adequado entre texto e fundo.
  • Consistência: manter a mesma hierarquia de títulos para seções equivalentes.

Continue postando as suas soluções! Além de ganhar pontos de XP na plataforma, você pode ajudar outros estudantes no fórum.

Ah, uma pergunta: você prefere evoluir esse glossário para incluir imagens ilustrativas dos termos ou manter apenas texto para focar na clareza e acessibilidade?

Fico à disposição! E se precisar, conte sempre com o apoio do fórum.

Abraço e bons estudos!

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!

Olá, Daniel!

Muito obrigado pelo feedback. Pretendo organizar os tópicos em uma lista de descrições (

, e ), mas vou fazer isso ao longo das aulas pra revisar meu conhecimento e me preparar para próximos passos na programação.

Sobre a pergunta, por hora manterei os termos somente em texto, mas em breve quero destacar os capítulos ( tags) com imagens.

Abraço!