Skip to content

Commit

Permalink
I18n(pt-PT): Add resources pages (#1678)
Browse files Browse the repository at this point in the history
  • Loading branch information
rgilsimoes committed Apr 5, 2024
1 parent 5d7b775 commit b610a1c
Show file tree
Hide file tree
Showing 4 changed files with 248 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -160,6 +160,7 @@ export default defineConfig({
id: 'Panduan',
'zh-CN': '指南',
'pt-BR': 'Guias',
'pt-PT': 'Guias',
ko: '가이드',
tr: 'Rehber',
ru: 'Руководства',
Expand Down Expand Up @@ -194,6 +195,7 @@ export default defineConfig({
'zh-CN': '资源',
fr: 'Ressources',
'pt-BR': 'Recursos',
'pt-PT': 'Recursos',
ja: 'リソース',
ru: 'Ресурсы',
},
Expand Down
129 changes: 129 additions & 0 deletions docs/src/content/docs/pt-pt/resources/community-content.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,129 @@
---
title: Conteúdo da Comunidade
description: Descubra guias produzidos pela comunidade, artigos e vídeos para ajudar a aprender e construir com o Starlight!
---

:::tip[Inclua o seu!]
Já produziu conteúdo sobre Starlight?
Então abra um PR e adicione o seu link nesta página!
:::

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

## Artigos e Avaliações

Aqui está uma coleção de posts e artigos para aprender mais sobre Starlight e sobre as experiências de outras pessoas:

<CardGrid>
<LinkCard
href="https://devm.io/open-source/starlight-astro"
title="Geração de Site Estático com Starlight"
description="'Nenhuma ideia é tão grande ou pequena ao projetar componentes' — uma entrevista com Chris Swithinbank, Líder Starlight"
/>
<LinkCard
href="https://frontendatscale.com/blog/hybrid-frontend-architecture/"
title="Arquitetura Frontend Híbrida com Astro e Starlight"
description="Maxi Ferreira e Ben Holmes constroem um site de documentação com Starlight, TinaCMS, e um Playground de API interativo com autenticação."
/>
<LinkCard
href="https://www.olets.dev/posts/comparing-docs-site-builders-vuepress-vs-starlight/"
title="Comparando construtores de site de documentação: VuePress vs Starlight"
description="Como estes dois frameworks se comparam?"
/>
</CardGrid>

## Receitas e Guias

Receitas são tipicamente guias passo a passo, curtos e focados, que levam o leitor a completar um exemplo funcional de uma tarefa específica.
As receitas são também uma ótima maneira de adicionar novas funcionalidades ou comportamentos para seu projeto Starlight bastando seguir simples instruções passo a passo!
Outros guias podem explicar conceitos relacionados a determinada área de conteúdo, como por exemplo usar imagens ou trabalhar com MDX.

Explore o conteúdo produzido pela comunidade e mantido pelos utilizadores Starlight:

<CardGrid>
<LinkCard
href="https://www.webpro.nl/scraps/versioned-docs-with-starlight-and-vercel"
title="Documentação versionada com Starlight e Vercel"
description="Um guia para implementar versões separadas da documentação para cada versão principal de um projeto"
/>
<LinkCard
href="https://hideoo.dev/notes/starlight-heading-links"
title="Adicione links em cabeçalhos Starlight"
description="Um guia sobre como usar um plugin rehype para criar links para seções específicas da sua documentação"
/>
<LinkCard
href="https://blog.otterlord.dev/posts/starlight-sponsors/"
title="Adicione patrocinadores para seu site Starlight"
description="Um guia sobre implementar um componente de patrocinadores personalizado na barra lateral da sua documentação"
/>
<LinkCard
href="https://hideoo.dev/notes/starlight-og-images"
title="Adicione imagens Open Graph a Starlight"
description="Um guia para gerar imagens sociais e as metatags correspondentes para as suas páginas"
/>
<LinkCard
href="https://hideoo.dev/notes/starlight-third-party-icon-sets"
title="Use ícones de terceiros em Starlight"
description="Um guia sobre como usar unplugin-icons para expandir a seleção de ícones disponíveis para Starlight"
/>
<LinkCard
href="https://hideoo.dev/notes/starlight-custom-html-head"
title="Edite o elemento HTML head de páginas Starlight"
description="Aprenda sobre como adicionar conteúdo como fontes, scripts e web analytics"
/>
<LinkCard
href="https://dev.to/mrrobot/publishing-documentation-with-astro-starlight-691"
title="Publicando documentação com Astro Starlight"
description="Começando com a documentação Starlight"
/>

</CardGrid>

## Conteúdo de Vídeo

Descubra os vídeos e canais com conteúdo Starlight, incluíndo transmissões ao vivo e conteúdo educacional.

import YouTubeGrid from '~/components/youtube-grid.astro';

### Videos oficiais do Astro

<YouTubeGrid
videos={[
{
href: 'https://www.youtube.com/watch?v=5u0Ds7wzUeI',
title: 'Starlight por Astro',
description: 'Veja o vídeo oficial do lançamento Starlight',
},
{
href: 'https://www.youtube.com/shorts/zjOWezSzd18',
title: '🌟 SUB 1 MINUTE RUN',
description:
'Veja o Ben lançar um novo site Starlight em menos de um minuto!',
},
]}
/>

### Vídeos e Transmissões da Comunidade

<YouTubeGrid
videos={[
{
href: 'https://www.youtube.com/watch?v=sF6UcV3moZg',
title: 'Construir documentação com o Starlight e Astro',
description:
"Veja o Chris e Alex mergulhar no Starlight em 'Code with CodingCat.dev'",
},
{
href: 'https://www.youtube.com/watch?v=sWkkHbwDeQc',
title: 'Astro Starlight',
description: 'Introdução ao Starlight em menos de um minuto.',
},
{
href: 'https://www.youtube.com/watch?v=-Ki-1E5gNCk',
title:
'Modelo de Documentação Astro Starlight (construa documentações personalizadas!)',
description:
'Tenha um novo site Starlight a funcionar em cerca de 5 minutos',
},
]}
/>
96 changes: 96 additions & 0 deletions docs/src/content/docs/pt-pt/resources/plugins.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: Plugins e Integrações
description: Descubra ferramentas da comunidade e integrações que estendem o Starlight!
sidebar:
order: 1
---

:::tip[Inclua o seu!]
Já construiu um plugin ou uma ferramenta para o Starlight?
Então abra um PR e adicione o seu link nesta página!
:::

## Plugins

Os [plugins](/pt-pt/reference/plugins/) podem personalizar ou estender a configuração do Starlight, a interface do utilizador e o comportamento, sendo também fáceis de compartilhar e de reutilizar.

Estenda o seu site com os plugins oficiais suportados pela equipa Starlight e com plugins da comunidade mantidos por outros utilizadores Starlight.

### Plugins oficiais

<CardGrid>
<LinkCard
href="/pt-br/guides/site-search/#algolia-docsearch"
title="Algolia DocSearch"
description="Substitua o fornecedor de pesquisa Pagefind pelo Algolia DocSearch."
/>
</CardGrid>

### Plugins da comunidade

<CardGrid>
<LinkCard
href="https://github.com/HiDeoo/starlight-links-validator"
title="starlight-links-validator"
description="Verifique links incorretos nas suas páginas do Starlight."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-typedoc"
title="starlight-typedoc"
description="Crie páginas Starlight a partir de TypeScript utilizando o TypeDoc."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-blog"
title="starlight-blog"
description="Adicione um blog ao seu site de documentação."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-openapi"
title="starlight-openapi"
description="Crie páginas de documentação a partir de especificações OpenAPI/Swagger."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-obsidian"
title="starlight-obsidian"
description="Publique cofres de Obsidian no seu site Starlight."
/>
<LinkCard
href="https://astro-ghostcms.xyz/intro/starlight/install/"
title="starlight-ghostcms"
description="Adicione os artigos do seu blog GhostCMS ao lado das páginas Starlight."
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-image-zoom"
title="starlight-image-zoom"
description="Adicione funções de zoom à sua documentação do Starlight."
/>
</CardGrid>

## Ferramentas e integrações da comunidade

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

Estas ferramentas e integrações da comunidade podem ser usadas para adicionar funcionalidades ao seu site Starlight.

<CardGrid>
<LinkCard
href="https://www.feelback.dev/blog/new-astro-starlight-integration/"
title="FeelBack"
description="Adicione um sistema de feedback de utilizador às páginas da documentação."
/>
<LinkCard
href="https://github.com/val-town/notion-to-astro"
title="notion-to-astro"
description="Converta exportações do Notion para documentos do Starlight"
/>
<LinkCard
href="https://github.com/mattjennings/astro-live-code"
title="astro-live-code"
description="Apresente blocos de código MDX como componentes interativos"
/>
<LinkCard
href="https://github.com/HiDeoo/starlight-i18n"
title="starlight-i18n"
description="Extensão para o Visual Studio Code que ajuda a traduzir páginas do Starlight."
/>
</CardGrid>
21 changes: 21 additions & 0 deletions docs/src/content/docs/pt-pt/resources/showcase.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: Montra Starlight
description: Descubra sites construídos com Starlight!
sidebar:
label: Montra de Sites
---

:::tip[Inclua o seu!]
Já construiu um site com o Starlight?
Então abra um PR e adicione o seu link nesta página!
:::

## Sites

import ShowcaseSites from '~/components/showcase-sites.astro';

O Starlight já está a ser usado em muitos sites em produção. Estes são alguns desses sites já espalhados pela web:

<ShowcaseSites />

Pesquise todos os [repositórios de projetos públicos que usam o Starlight no GitHub](https://github.com/withastro/starlight/network/dependents).

0 comments on commit b610a1c

Please sign in to comment.