summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRicardo Jaime Gil Simões2024-04-05 09:23:25 +0100
committerGitHub2024-04-05 10:23:25 +0200
commitb610a1cdc327433ec255374a9fea913085f568e2 (patch)
tree30b77393cb0f506e8f337ef7149ec1de79ab607b
parent5d7b775c7aeb46242cd537b9c638b201f3e9ce88 (diff)
downloadIT.starlight-b610a1cdc327433ec255374a9fea913085f568e2.tar.gz
IT.starlight-b610a1cdc327433ec255374a9fea913085f568e2.tar.bz2
IT.starlight-b610a1cdc327433ec255374a9fea913085f568e2.zip
I18n(pt-PT): Add resources pages (#1678)
-rw-r--r--docs/astro.config.mjs2
-rw-r--r--docs/src/content/docs/pt-pt/resources/community-content.mdx129
-rw-r--r--docs/src/content/docs/pt-pt/resources/plugins.mdx96
-rw-r--r--docs/src/content/docs/pt-pt/resources/showcase.mdx21
4 files changed, 248 insertions, 0 deletions
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index bdf80614..00f9a99d 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -160,6 +160,7 @@ export default defineConfig({
id: 'Panduan',
'zh-CN': '指南',
'pt-BR': 'Guias',
+ 'pt-PT': 'Guias',
ko: '가이드',
tr: 'Rehber',
ru: 'Руководства',
@@ -194,6 +195,7 @@ export default defineConfig({
'zh-CN': '资源',
fr: 'Ressources',
'pt-BR': 'Recursos',
+ 'pt-PT': 'Recursos',
ja: 'リソース',
ru: 'Ресурсы',
},
diff --git a/docs/src/content/docs/pt-pt/resources/community-content.mdx b/docs/src/content/docs/pt-pt/resources/community-content.mdx
new file mode 100644
index 00000000..466af6d8
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/resources/community-content.mdx
@@ -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',
+ },
+ ]}
+/>
diff --git a/docs/src/content/docs/pt-pt/resources/plugins.mdx b/docs/src/content/docs/pt-pt/resources/plugins.mdx
new file mode 100644
index 00000000..778578cc
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/resources/plugins.mdx
@@ -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>
diff --git a/docs/src/content/docs/pt-pt/resources/showcase.mdx b/docs/src/content/docs/pt-pt/resources/showcase.mdx
new file mode 100644
index 00000000..ba58e224
--- /dev/null
+++ b/docs/src/content/docs/pt-pt/resources/showcase.mdx
@@ -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).