diff options
author | Ricardo Jaime Gil Simões | 2024-04-05 09:23:25 +0100 |
---|---|---|
committer | GitHub | 2024-04-05 10:23:25 +0200 |
commit | b610a1cdc327433ec255374a9fea913085f568e2 (patch) | |
tree | 30b77393cb0f506e8f337ef7149ec1de79ab607b | |
parent | 5d7b775c7aeb46242cd537b9c638b201f3e9ce88 (diff) | |
download | IT.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.mjs | 2 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/resources/community-content.mdx | 129 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/resources/plugins.mdx | 96 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/resources/showcase.mdx | 21 |
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). |