docs: Added Portuguese (pt-PT) language (#1503)

Co-authored-by: Luiz Ferraz <luiz@lferraz.com>
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

7 files changed, 332 insertions, 1 deletions

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 369329b0..6049ae3c 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -11,6 +11,7 @@ i18n:
   - docs/src/content/docs/ja/**/*
   - docs/src/content/docs/zh-cn/**/*
   - docs/src/content/docs/pt-br/**/*
+  - docs/src/content/docs/pt-pt/**/*
   - docs/src/content/docs/ko/**/*
   - docs/src/content/docs/ru/**/*
   - docs/src/content/docs/id/**/*
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index e7480621..40ec5df1 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -12,6 +12,7 @@ export const locales = {
 	id: { label: 'Bahasa Indonesia', lang: 'id' },
 	'zh-cn': { label: '简体中文', lang: 'zh-CN' },
 	'pt-br': { label: 'Português do Brasil', lang: 'pt-BR' },
+	'pt-pt': { label: 'Português', lang: 'pt-PT' },
 	ko: { label: '한국어', lang: 'ko' },
 	tr: { label: 'Türkçe', lang: 'tr' },
 	ru: { label: 'Русский', lang: 'ru' },
diff --git a/docs/lunaria.config.json b/docs/lunaria.config.json
index 7051c270..8f8d9ecb 100644
--- a/docs/lunaria.config.json
+++ b/docs/lunaria.config.json
@@ -50,6 +50,10 @@
       "lang": "pt-br"
     },
     {
+      "label": "Português",
+      "lang": "pt-pt"
+    },
+    {
       "label": "Русский",
       "lang": "ru"
     },
diff --git a/docs/package.json b/docs/package.json
index 8a751b95..b6a13ab2 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -5,7 +5,7 @@
   "version": "0.0.1",
   "scripts": {
     "test": "start-server-and-test 'pnpm preview' http://localhost:4321 'pnpm pa11y'",
-    "pa11y": "pa11y-ci --sitemap 'http://localhost:4321/sitemap-0.xml' --sitemap-find 'https://starlight.astro.build' --sitemap-replace 'http://localhost:4321' --sitemap-exclude '/(de|zh-cn|fr|es|pt-br|it|id|ko|ru|tr|hi|da|uk)/.*'",
+    "pa11y": "pa11y-ci --sitemap 'http://localhost:4321/sitemap-0.xml' --sitemap-find 'https://starlight.astro.build' --sitemap-replace 'http://localhost:4321' --sitemap-exclude '/(de|zh-cn|fr|es|pt-br|pt-pt|it|id|ko|ru|tr|hi|da|uk)/.*'",
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",
diff --git a/docs/src/content/docs/pt-pt/404.md b/docs/src/content/docs/pt-pt/404.md
new file mode 100644
index 00000000..75a5e215
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/404.md
@@ -0,0 +1,13 @@
+---
+title: Não encontrado
+template: splash
+editUrl: false
+hero:
+  title: '404'
+  tagline: <strong>Houston, temos um problema.</strong> Não conseguimos encontrar esta página.<br>Verifique se o URL está correto ou tente utilizar a barra de pesquisa.
+  actions:
+    - text: Ir para o início
+      icon: right-arrow
+      link: /pt-pt/
+      variant: primary
+---
diff --git a/docs/src/content/docs/pt-pt/getting-started.mdx b/docs/src/content/docs/pt-pt/getting-started.mdx
new file mode 100644
index 00000000..4f87ca44
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/getting-started.mdx
@@ -0,0 +1,149 @@
+---
+title: Introdução
+description: Aprenda como começar a construir o seu próximo site de documentação com Starlight pelo Astro.
+---
+
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+
+O Starlight é um tema de documentação cheio de funcionalidades construído em cima do framework [Astro](https://astro.build).
+Este guia irá ajudá-lo a começar um novo projeto.
+Consulte as [instruções de instalação manual](/pt-pt/manual-setup) para adicionar o Starlight a um projeto Astro já existente.
+
+## Início Rápido
+
+### Crie um novo projeto
+
+Crie um novo projeto Astro + Starlight executando o seguinte comando no seu terminal:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight
+```
+
+</TabItem>
+</Tabs>
+
+Isto irá criar um novo [diretório de projeto](/pt-pt/guides/project-structure/) com todos os arquivos e configurações necessárias para o seu novo site.
+
+:::tip[Veja-o em ação]
+Experimente o Starlight directamente no seu navegador:
+[abrir o template no StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
+:::
+
+### Inicie o servidor de desenvolvimento
+
+Quando estiver a trabalhar localmente, o [servidor de desenvolvimento do Astro](https://docs.astro.build/pt/reference/cli-reference/#astro-dev) permitirá visualizar seu trabalho e atualizar automaticamente o seu navegador após fazer alterações.
+
+Dentro do diretório do seu projeto, execute o seguinte comando para iniciar o servidor de desenvolvimento:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npm run dev
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm dev
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dev
+```
+
+</TabItem>
+</Tabs>
+
+Será exibida uma mensagem no seu terminal com o URL para a visualização local.
+Abra esse URL para começar a navegar no seu site.
+
+### Crie conteúdo
+
+O Starlight está pronto para você adicionar novos conteúdos, ou trazer os seus arquivos já existentes!
+
+#### Formatos de arquivo
+
+O Starlight suporta a escrita de conteúdo em Markdown e MDX sem precisar de nenhuma configuração extra.
+Pode também adicionar suporte para Markdoc instalando a [integração experimental Astro Markdoc](https://docs.astro.build/pt-br/guides/integrations-guide/markdoc/).
+
+#### Adicione páginas
+
+Adicione novas páginas ao seu site criando arquivos `.md` ou `.mdx` em `src/content/docs/`.
+
+Adicione páginas ao seu site criando ficheiros _Markdown_ no directório `src/content/docs/`.
+
+Saiba mais acerca de _routing_ baseado em ficheiros e suporte para ficheiros MDX e Markdoc no guia [“Páginas”](/pt-pt/guides/pages/).
+
+### Próximos passos
+
+- **Configurar:** Descubra opções comuns em ["Customização do Starlight"](/pt-pt/guides/customization/).
+- **Navegar:** Configure a barra lateral com o guia [“Barra lateral de navegação”](/pt-pt/guides/sidebar/).
+- **Componentes:** Conheça os cartões, separadores e outros componentes integrados no guia [“Componentes”](/pt-pt/guides/components/).
+- **Deploy:** Publique o seu projeto com a ajuda do guia [“Deploy do seu site Astro”](https://docs.astro.build/pt-br/guides/deploy/) na documentação do Astro.
+
+## Atualizar o Starlight
+
+:::tip
+Como o Starlight é um software em beta é normal que ocorram atualizações e melhorias frequentes.
+Certifique-se que atualiza o Starlight constantemente!
+:::
+
+O Starlight é uma integração do Astro. Pode atualizá-lo, como outros pacotes Astro, executando no seu terminal o seguinte comando:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npx @astrojs/upgrade
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm dlx @astrojs/upgrade
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dlx @astrojs/upgrade
+```
+
+</TabItem>
+</Tabs>
+
+Consulte o [histórico de mudanças do Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md) para ver a lista completa das alterações feitas em cada versão.
+
+## Solucionar Problemas no Starlight
+
+Utilize as páginas de referência [configuração do projeto](/pt-pt/reference/configuration/) e [configuração do frontmatter para cada página](/pt-pt/reference/frontmatter/) para garantir que seu site Starlight está configurado e a funcionar corretamente.
+Confira os guias na barra lateral para ajudá-lo a adicionar conteúdo e a personalizar o seu site Starlight.
+
+Se não encontrar a sua resposta nesta documentação, visite por favor a [documentação do Astro](https://docs.astro.build/pt-br/) para consultar uma documentação mais completa sobre o Astro.
+A sua dúvida pode ser respondida se entender como é que o Astro funciona no geral e por debaixo do tema Starlight.
+
+Pode ainda procurar por [problemas conhecidos do Starlight no GitHub](https://github.com/withastro/starlight/issues), e obter ajuda no [Discord do Astro](https://astro.build/chat/) com a nossa ativa e amigável comunidade! Envie perguntas no nosso fórum `#support` com a tag "starlight", ou visite o canal dedicado `#starlight` para discutir o desenvolvimento atual e mais!
diff --git a/docs/src/content/docs/pt-pt/index.mdx b/docs/src/content/docs/pt-pt/index.mdx
new file mode 100644
index 00000000..d0971c60
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/index.mdx
@@ -0,0 +1,163 @@
+---
+title: Starlight 🌟 Construa sites de documentação com Astro
+head:
+  - tag: title
+    content: Starlight 🌟 Construa sites de documentação com Astro
+description: Starlight ajuda-te a construir websites de documentação belos e rápidos com Astro.
+template: splash
+editUrl: false
+lastUpdated: false
+hero:
+  title: Faça a sua documentação brilhar com Starlight
+  tagline: Tudo o que precisa para construir um site de documentação brilhante. Rápido, acessível e fácil de usar.
+  image:
+    file: ~/assets/hero-star.webp
+  actions:
+    - text: Começar
+      icon: right-arrow
+      variant: primary
+      link: /pt-pt/getting-started/
+    - text: Veja no GitHub
+      icon: external
+      link: https://github.com/withastro/starlight
+---
+
+import { CardGrid, Card } from '@astrojs/starlight/components';
+import AboutAstro from '~/components/about-astro.astro';
+import TestimonialGrid from '~/components/testimonial-grid.astro';
+import Testimonial from '~/components/testimonial.astro';
+
+<CardGrid stagger>
+	<Card title="Documentação de iluminar os olhos" icon="open-book">
+		Inclui: Navegação do site, pesquisa, internacionalização, SEO, tipografia
+		fácil de ler, _highlighting_ de código, modo escuro e mais.
+	</Card>
+	<Card title="Possibilitado pelo Astro" icon="rocket">
+		Aproveite todo o poder e performance do Astro. Estenda o Starlight com suas
+		integrações e bibliotecas favoritas do Astro.
+	</Card>
+	<Card title="Markdown, Markdoc e MDX" icon="document">
+		Utilize a sua linguagem de marcação favorita. O Starlight inclui validação
+		com _frontmatter_ e segurança integrada de tipos com TypeScript.
+	</Card>
+	<Card title="Traga seus componentes de UI" icon="puzzle">
+		O Starlight é uma solução completa de documentação agnóstica a frameworks.
+		Estenda-o com React, Vue, Svelte, Solid e outros.
+	</Card>
+</CardGrid>
+
+<TestimonialGrid title="O que dizem acerca de nós">
+  <Testimonial
+    name="Rachel"
+    handle="rachelnabors"
+    cite="https://twitter.com/astrodotbuild/status/1724934718745915558"
+  >
+	  A equipa do Astro EVOLUIU a forma como a documentação pode ser feita e podemos ter tudo pronto a instalar com o seu o projecto Starlight.
+	</Testimonial>
+  <Testimonial
+    name="Flavio"
+    handle="flaviocopes"
+    cite="https://twitter.com/flaviocopes/status/1738237658717905108"
+  >
+	  O _kit_ oficial de iniciação Starlight é de facto uma ferramenta incrível para construir um website de documentação
+	</Testimonial>
+  <Testimonial
+    name="Tomek"
+    handle="sulco"
+    cite="https://twitter.com/sulco/status/1735610348730802342"
+  >
+    O Starlight é o nosso modelo exemplar de uma grande experiência de DX: a rapidez, conveniência,
+		e atenção ao detalhe são inspiradoras. Ele trata da tecnologia e do aspecto, para que se possa
+		focar no seu conteúdo 👏
+
+		A equipa StackBlitz simplesmente adora-o!
+  </Testimonial>
+  <Testimonial
+    name="Roberto"
+    handle="RmeetsH"
+    cite="https://twitter.com/RmeetsH/status/1735783992018760090"
+  >
+    O Startlight tem sido uma completa mudança para mim, permitindo-me focar na criação de conteúdos.
+
+		O seu design intituitivo não só agiliza o meu fluxo de trabalho mas também reduz o tempo de envolvimento para developers open-source.
+  </Testimonial>
+  <Testimonial
+    name="Joel"
+    handle="jhooks"
+    cite="https://twitter.com/jhooks/status/1727405160547418405"
+  >
+		Dediquei mais algum tempo com o Starlight para a documentação do meu "Course Builder" e tem sido fantástico até agora.
+		Muitos pormenores interessantes e permite-me focar em escrever com _Markdown_ em vez de perder tempo no site.
+  </Testimonial>
+  <Testimonial
+    name="Rick"
+    handle="rick_viscomi"
+    cite="https://twitter.com/rick_viscomi/status/1665867447910510593"
+  >
+		Comecei a mexer com o Starlight. Tenho de dizer que estou bastante impressionado com a performance
+		pronta-a-instalar!
+
+    💯💯💯💯
+  </Testimonial>
+  <Testimonial
+    name="Nicolas"
+    handle="beaussan"
+    cite="https://twitter.com/beaussan/status/1735625189583466893"
+  >
+		O Starlight é a melhor forma de começar com a documentação, entre o poder
+		e a rapidez do Astro, e as ferramentas do Starlight, é uma combinação feita no céu.
+
+		Tem sido a minha escolha de eleição há algum tempo, e continuo a adorá-lo!
+
+  </Testimonial>
+  <Testimonial
+    name="Sylwia"
+    handle="SylwiaVargas"
+    cite="https://x.com/SylwiaVargas/status/1726556825741578286"
+  >
+		Utilizei o Starlight no meu último trabalho e adorei-o! Componentes fantásticos,
+		design intuitivo, e uma comunidade super responsiva (sempre que alguém precisava de algo,
+		eles lançavam-no mais cedo ou mostravam uma alternativa). Uma experiência muito agradável.
+  </Testimonial>
+  <Testimonial
+    name="Lou Cyx"
+    handle="loucyx"
+    cite="https://elk.zone/m.webtoo.ls/@loucyx@mastodon.social/111587380021362284"
+  >
+	  A documentação do meu site mono-repositório parece melhor do que nunca graças ao Starlight. É extremamente fácil de utilizar sem perder nenhum do poder do Astro.
+		Obrigado por trabalharem nele!
+	</Testimonial>
+  <Testimonial
+    name="BowTiedWebReaper"
+    handle="BowTiedWebReapr"
+    cite="https://twitter.com/BowTiedWebReapr/status/1735633399501697517"
+  >
+    O Starlight é a minha ferramenta de seleção para documentação. Ele tornou a inclusão de documentação no meu site Astro super fácil sem necessidade
+		de um sub-domínio ou de utilizar outra ferramenta.
+  </Testimonial>
+  <Testimonial
+    name="Jeff"
+    handle="J_Everhart383"
+    cite="https://twitter.com/J_Everhart383/status/1691900590048292908"
+  >
+	  Tenho estado a reconstruir a documentação da plataforma WPEngine Atlas Platform. Confiem em mim quando digo que o Starlight tem tudo o que precisam
+		para criar uma plataforma de documentação A+&nbsp;🙌
+	</Testimonial>
+  <Testimonial
+    name="Chloe"
+    handle="solelychloe"
+    cite="https://twitter.com/solelychloe/status/1695115277602628082"
+  >
+	  Experimente o Starlight!
+
+    Eu utilizo-o em alguns dos meus sites e é fantástico.
+  </Testimonial>
+</TestimonialGrid>
+
+<AboutAstro title="Trazido por">
+Astro é o framework web tudo-em-um projetado para velocidade.
+Traga o seu conteúdo de qualquer lugar e faça deploy em qualquer lugar, tudo fornecido pelos seus componentes de UI e bibliotecas favoritas.
+
+[Aprenda acerca do Astro](https://astro.build/)
+
+</AboutAstro>