Add Mascot to documentation

And minor tweaks to documentation structure

2 files changed, 39 insertions, 0 deletions

diff --git a/doc/docs/pt-br/doc/reference/the-yuescript-library.md b/doc/docs/pt-br/doc/advanced/the-yuescript-library.md
index 7775cd5..7775cd5 100644
--- a/doc/docs/pt-br/doc/reference/the-yuescript-library.md
+++ b/doc/docs/pt-br/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/pt-br/doc/reference/mascot.md b/doc/docs/pt-br/doc/reference/mascot.md
new file mode 100644
index 0000000..e2ff951
--- /dev/null
+++ b/doc/docs/pt-br/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# Mascote – Xiaoyu
+
+## Sobre
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="Xiaoyu, a Coelha Cibernética" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+Xiaoyu (小玉, "pequeno jade") é uma coelha cibernética e a mascote oficial do projeto YueScript. Ela geralmente pode ser encontrada empoleirada em uma lua crescente, mexendo em seu laptop – escrevendo YueScript, naturalmente.
+
+Seu título completo é Xiaoyu, a Coelha Cibernética (机兔小玉), e ela incorpora tudo o que o YueScript aspira ser: elegante, expressivo e um pouquinho divertido.
+
+Xiaoyu foi projetada e ilustrada por **[Tyson Tan](https://tysontan.com)**, que generosamente a criou para o projeto de forma gratuita – algo pelo qual somos incrivelmente gratos.
+
+## Imagens
+
+Artes em resolução completa estão disponíveis para download abaixo. Clique em qualquer imagem para abri-la em tamanho real.
+
+### Arte Completa
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="Xiaoyu — arte completa com fundo" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>Baixar PNG em tamanho real</a></p>
+
+### Fundo Transparente
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="Xiaoyu — fundo transparente" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>Baixar PNG transparente</a></p>
+
+### Arquivo .kra Compactado
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>Baixar arquivo .kra compactado</a></p>
+
+## Licença
+
+Xiaoyu é duplamente licenciada sob a [Licença MIT](https://opensource.org/licenses/MIT) e a Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).