From b1f46f9bcf8f56dd2cdcc162f167107eefacf957 Mon Sep 17 00:00:00 2001 From: Ricardo Jaime Gil Simões Date: Fri, 23 Feb 2024 09:10:00 +0000 Subject: docs: Added Portuguese (pt-PT) language (#1503) Co-authored-by: Luiz Ferraz Co-authored-by: Chris Swithinbank --- .github/labeler.yml | 1 + docs/astro.config.mjs | 1 + docs/lunaria.config.json | 4 + docs/package.json | 2 +- docs/src/content/docs/pt-pt/404.md | 13 ++ docs/src/content/docs/pt-pt/getting-started.mdx | 149 ++++++++++++++++++++++ docs/src/content/docs/pt-pt/index.mdx | 163 ++++++++++++++++++++++++ 7 files changed, 332 insertions(+), 1 deletion(-) create mode 100644 docs/src/content/docs/pt-pt/404.md create mode 100644 docs/src/content/docs/pt-pt/getting-started.mdx create mode 100644 docs/src/content/docs/pt-pt/index.mdx 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 @@ -49,6 +49,10 @@ "label": "Português do Brasil", "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: Houston, temos um problema. Não conseguimos encontrar esta página.
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: + + + + +```sh +npm create astro@latest -- --template starlight +``` + + + + +```sh +pnpm create astro --template starlight +``` + + + + +```sh +yarn create astro --template starlight +``` + + + + +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: + + + + +```sh +npm run dev +``` + + + + +```sh +pnpm dev +``` + + + + +```sh +yarn dev +``` + + + + +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: + + + + +```sh +npx @astrojs/upgrade +``` + + + + +```sh +pnpm dlx @astrojs/upgrade +``` + + + + +```sh +yarn dlx @astrojs/upgrade +``` + + + + +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'; + + + + Inclui: Navegação do site, pesquisa, internacionalização, SEO, tipografia + fácil de ler, _highlighting_ de código, modo escuro e mais. + + + Aproveite todo o poder e performance do Astro. Estenda o Starlight com suas + integrações e bibliotecas favoritas do Astro. + + + Utilize a sua linguagem de marcação favorita. O Starlight inclui validação + com _frontmatter_ e segurança integrada de tipos com TypeScript. + + + O Starlight é uma solução completa de documentação agnóstica a frameworks. + Estenda-o com React, Vue, Svelte, Solid e outros. + + + + + + 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. + + + O _kit_ oficial de iniciação Starlight é de facto uma ferramenta incrível para construir um website de documentação + + + 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! + + + 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. + + + 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. + + + Comecei a mexer com o Starlight. Tenho de dizer que estou bastante impressionado com a performance + pronta-a-instalar! + + 💯💯💯💯 + + + 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! + + + + 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. + + + 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! + + + 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. + + + 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+ 🙌 + + + Experimente o Starlight! + + Eu utilizo-o em alguns dos meus sites e é fantástico. + + + + +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/) + + -- cgit