forked from withastro/starlight
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into hd-fix-i18n-non-root-single-locale
* main: [ci] format [ci] release (withastro#1714) Fix various Expressive Code translation issues (withastro#1708) Fix nested aside title rendering issue (withastro#1703) I18n(pt-PT): Add resources pages (withastro#1678) Add SST Ion & Font Awesome to site showcase (withastro#1710)
- Loading branch information
Showing
19 changed files
with
471 additions
and
52 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
129 changes: 129 additions & 0 deletions
129
docs/src/content/docs/pt-pt/resources/community-content.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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', | ||
}, | ||
]} | ||
/> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.