summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRicardo Jaime Gil SimƵes2025-01-08 17:50:49 +0000
committerGitHub2025-01-08 18:50:49 +0100
commite394ed659be6b6787870ba6f06c20060359697be (patch)
tree4427148d7e35c88286708aa0739af29f80f4642a
parentdcc144c9530beaa6d163a52d03ccc20ac3d61022 (diff)
downloadIT.starlight-e394ed659be6b6787870ba6f06c20060359697be.tar.gz
IT.starlight-e394ed659be6b6787870ba6f06c20060359697be.tar.bz2
IT.starlight-e394ed659be6b6787870ba6f06c20060359697be.zip
i18n(pt-PT): update outdated pages (#2741)
-rw-r--r--docs/src/content/docs/pt-pt/environmental-impact.md32
-rw-r--r--docs/src/content/docs/pt-pt/index.mdx6
-rw-r--r--docs/src/content/docs/pt-pt/manual-setup.mdx26
-rw-r--r--docs/src/content/docs/pt-pt/resources/community-content.mdx11
-rw-r--r--docs/src/content/docs/pt-pt/resources/plugins.mdx76
5 files changed, 124 insertions, 27 deletions
diff --git a/docs/src/content/docs/pt-pt/environmental-impact.md b/docs/src/content/docs/pt-pt/environmental-impact.md
index e1c687fa..576e9057 100644
--- a/docs/src/content/docs/pt-pt/environmental-impact.md
+++ b/docs/src/content/docs/pt-pt/environmental-impact.md
@@ -89,20 +89,21 @@ Escolher um alojamento que utiliza energia renovƔvel significarƔ menos emissƵ
EstÔ curioso para comparar com os outros frameworks de documentação?
Estes testes realizados com o [Website Carbon Calculator][wcc] comparam pƔginas semelhantes construƭdas com diferentes ferramentas.
-| Framework | CO₂ por visita da pÔgina |
-| --------------------------- | ------------------------ |
-| [Starlight][sl-carbon] | 0.01g |
-| [VitePress][vp-carbon] | 0.05g |
-| [Docus][dc-carbon] | 0.05g |
-| [Sphinx][sx-carbon] | 0.07g |
-| [MkDocs][mk-carbon] | 0.10g |
-| [Nextra][nx-carbon] | 0.11g |
-| [docsify][dy-carbon] | 0.11g |
-| [Docusaurus][ds-carbon] | 0.24g |
-| [Read the Docs][rtd-carbon] | 0.24g |
-| [GitBook][gb-carbon] | 0.71g |
-
-<small>Dados recolhidos a 14 de Maio de 2023. Clique num dos links para ver os valores atualizados.</small>
+| Framework | COā‚‚ per page visit | Rating |
+| --------------------------- | ------------------ | :----: |
+| [Starlight][sl-carbon] | 0.01g | A+ |
+| [Read the Docs][rtd-carbon] | 0.05g | A+ |
+| [Sphinx][sx-carbon] | 0.06g | A+ |
+| [VitePress][vp-carbon] | 0.07g | A+ |
+| [Docus][dc-carbon] | 0.09g | A+ |
+| [docsify][dy-carbon] | 0.10g | A |
+| [Nextra][nx-carbon] | 0.11g | A |
+| [MkDocs][mk-carbon] | 0.19g | B |
+| [Docusaurus][ds-carbon] | 0.21g | B |
+| [GitBook][gb-carbon] | 0.43g | C |
+| [Mintlify][mt-carbon] | 1.22g | F |
+
+<small>Dados recolhidos a 22 de Julho de 2024. Clique num dos links para ver os valores atualizados.</small>
[sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/
[vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/
@@ -114,6 +115,7 @@ Estes testes realizados com o [Website Carbon Calculator][wcc] comparam pƔginas
[ds-carbon]: https://www.websitecarbon.com/website/docusaurus-io-docs/
[rtd-carbon]: https://www.websitecarbon.com/website/docs-readthedocs-io-en-stable-index-html/
[gb-carbon]: https://www.websitecarbon.com/website/docs-gitbook-com/
+[mt-carbon]: https://www.websitecarbon.com/website/mintlify-com-docs-quickstart/
## Mais recursos
@@ -135,6 +137,6 @@ Estes testes realizados com o [Website Carbon Calculator][wcc] comparam pƔginas
[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
[http]: https://httparchive.org/reports/state-of-the-web
-[assets]: https://docs.astro.build/pt-pt/guides/assets/
+[assets]: https://docs.astro.build/en/guides/images/
[islands]: https://docs.astro.build/pt-pt/concepts/islands/
[wcc]: https://www.websitecarbon.com/
diff --git a/docs/src/content/docs/pt-pt/index.mdx b/docs/src/content/docs/pt-pt/index.mdx
index 9d1f0075..95ea0dff 100644
--- a/docs/src/content/docs/pt-pt/index.mdx
+++ b/docs/src/content/docs/pt-pt/index.mdx
@@ -7,6 +7,12 @@ description: Starlight ajuda-te a construir websites de documentação belos e r
template: splash
editUrl: false
lastUpdated: false
+banner:
+ content: |
+ Atualização para o Astro 5?
+ <a href="https://github.com/withastro/starlight/releases/tag/%40astrojs/starlight%400.30.0">
+ Aprenda como fazer
+ </a>
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.
diff --git a/docs/src/content/docs/pt-pt/manual-setup.mdx b/docs/src/content/docs/pt-pt/manual-setup.mdx
index ae8a6a7a..ce654bfd 100644
--- a/docs/src/content/docs/pt-pt/manual-setup.mdx
+++ b/docs/src/content/docs/pt-pt/manual-setup.mdx
@@ -16,7 +16,7 @@ Para seguir este guia, vocĆŖ vai precisar de um projeto Astro existente.
O Starlight é uma [integração Astro](https://docs.astro.build/pt-br/guides/integrations-guide/). Adicione-o ao seu site executando o comando `astro add` no diretório raiz do seu projeto:
-<Tabs>
+<Tabs syncKey='pkg'>
<TabItem label="npm">```sh npx astro add starlight ```</TabItem>
<TabItem label="pnpm">```sh pnpm astro add starlight ```</TabItem>
<TabItem label="Yarn">```sh yarn astro add starlight ```</TabItem>
@@ -48,20 +48,25 @@ Encontre todas as opções disponíveis na referência sobre [configuração do
### Configure coleções de conteúdos
-O Starlight é construído com base nas [coleções de conteúdos](https://docs.astro.build/pt-pt/guides/content-collections/) do Astro, que são configuradas no arquivo `src/content/config.ts`.
+O Starlight é construído com base nas [coleções de conteúdos](https://docs.astro.build/pt-pt/guides/content-collections/) do Astro, que são configuradas no arquivo `src/content.config.ts`.
-Crie ou atualize o arquivo de configuração de conteúdo, adicionando uma coleção `docs` que usa o esquema `docsSchema` do Starlight:
+Crie ou atualize o arquivo de configuração de conteúdo, adicionando uma coleção `docs` que usa os esquemas `docsLoader` e `docsSchema` do Starlight:
-```js ins={3,6}
+```js ins={3-4,7}
// src/content/config.ts
import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
import { docsSchema } from '@astrojs/starlight/schema';
export const collections = {
- docs: defineCollection({ schema: docsSchema() }),
+ docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
};
```
+O Starlight tambem suporta a [opção `legacy.collections`](https://docs.astro.build/pt-pt/reference/legacy-flags/) onde as coleções são tratadas utilizando a implementação
+anterior das coleções de conteúdo.
+Isto é útil se tiver um projeto Astro existente e não pode, de momento, efetuar alterações às coleções para utilizar um `loader`.
+
### Adicione conteĆŗdo
Agora que o Starlight estĆ” configurado Ć© hora de adicionar algum conteĆŗdo!
@@ -84,11 +89,11 @@ Veja todas as opções disponíveis na [referência do frontmatter](/pt-pt/refer
## Dicas para sites existentes
-Se você tiver um projeto Astro existente, pode utilizar o Starlight para adicionar rapidamente uma seção de documentação ao seu site.
+Se você tiver um projeto Astro existente, pode utilizar o Starlight para adicionar rapidamente uma secção de documentação ao seu site.
-### Utilize o Starlight como um subcaminho
+### Utilize o Starlight como um sub-caminho
-Para adicionar todas as pÔginas do Starlight num subcaminho, coloque todo o conteúdo da sua documentação dentro de um subdiretório de `src/content/docs/`.
+Para adicionar todas as pÔginas do Starlight num sub-caminho, coloque todo o conteúdo da sua documentação dentro de um sub-diretório de `src/content/docs/`.
Por exemplo, se todas as pÔginas do Starlight devem começar com `/guias/`, adicione o seu conteúdo no diretório `src/content/docs/guias/`:
@@ -111,7 +116,8 @@ No futuro, planeamos melhorar o suporte deste caso de uso para evitar a necessid
### Usar o Starlight com SSR
-Pode utilizar o Starlight no seu projeto juntamente com outros conjuntos de pĆ”ginas renderizadas a pedido seguindo para isso o guia [ā€œAdaptadores de renderização a pedidoā€](https://docs.astro.build/en/guides/server-side-rendering/) da documentação do Astro.
+Para habilitar o SSR siga o guia [ā€œAdaptadores de renderização a pedidoā€](https://docs.astro.build/en/guides/on-demand-rendering/) da documentação do Astro e
+adicione um adaptador ao seu projeto Starlight.
Atualmente as pÔginas de documentação geradas pelo Starlight são sempre pré-renderizadas independentemente do modo de geração do projeto.
-Esperamos ser capazes de suportar a renderização a pedido de pÔginas do Startlight dentro em breve.
+Para desabilitar a pré-renderização das suas pÔginas Starlight coloque a [opção de config `prerender`](/pt-pt/reference/configuration/#prerender) a `false`.
diff --git a/docs/src/content/docs/pt-pt/resources/community-content.mdx b/docs/src/content/docs/pt-pt/resources/community-content.mdx
index 84f0a270..af035338 100644
--- a/docs/src/content/docs/pt-pt/resources/community-content.mdx
+++ b/docs/src/content/docs/pt-pt/resources/community-content.mdx
@@ -86,6 +86,11 @@ Explore o conteĆŗdo produzido pela comunidade e mantido pelos utilizadores Starl
title="Acrescentar Dados Estructurados a pƔginas do Starlight"
description="Aprenda a construir dados dinâmicos estructurados JSON-LD para as suas pÔginas de documentação."
/>
+ <LinkCard
+ href="https://starlight-examples.netlify.app/"
+ title="Exemplos do Starlight"
+ description="Uma coleção de exemplos deStackBlitz embebidos que demonstram formas prÔticas de fazer coisas em sites de documentação do Starlight."
+ />
</CardGrid>
## ConteĆŗdo de VĆ­deo
@@ -148,5 +153,11 @@ import YouTubeGrid from '~/components/youtube-grid.astro';
description:
'Neste video eu abordo o que torna o Starlight tão porreiro e porque razão deve experimentÔ-lo no seu próximo projecto.',
},
+ {
+ href: 'https://www.youtube.com/watch?v=Q1E4Gkt63ko',
+ title: 'Astro Starlight and emoji-blast with Chris Swithinbank',
+ description:
+ "Wherein Chris, the creator of Astro's Starlight framework-on-a-framework, walks me through setting it up for a new emoji-blast website. 🌟 šŸŽ‡",
+ },
]}
/>
diff --git a/docs/src/content/docs/pt-pt/resources/plugins.mdx b/docs/src/content/docs/pt-pt/resources/plugins.mdx
index d9f80602..d543ef57 100644
--- a/docs/src/content/docs/pt-pt/resources/plugins.mdx
+++ b/docs/src/content/docs/pt-pt/resources/plugins.mdx
@@ -66,9 +66,76 @@ Estenda o seu site com os plugins oficiais suportados pela equipa Starlight e co
<LinkCard
href="https://github.com/lorenzolewis/starlight-utils"
title="starlight-utils"
- description="Extenda o Starlight com uma coleção de utilitÔrios comuns."
+ description="Estenda o Starlight com uma coleção de utilitÔrios comuns."
/>
+<LinkCard
+ href="https://github.com/trueberryless/starlight-view-modes"
+ title="starlight-view-modes"
+ description="Adicione a capacidade de mostrar diferentes formas de visualização no seu website de documentação."
+ />
+ <LinkCard
+ href="https://github.com/HiDeoo/starlight-versions"
+ title="starlight-versions"
+ description="Acrescente a versão às pÔginas da sua documentação Starlight."
+ />
+ <LinkCard
+ href="https://inox-tools.fryuni.dev/star-warp"
+ title="star-warp"
+ description="Acelere a pesquisa de resultados na sua documentação."
+ />
+ <LinkCard
+ href="https://github.com/HiDeoo/starlight-heading-badges"
+ title="starlight-heading-badges"
+ description="Adicione distintivos aos cabeƧalhos de Markdown e MDX."
+ />
+ <LinkCard
+ href="https://github.com/Fevol/starlight-site-graph"
+ title="starlight-site-graph"
+ description="Adicione um mapa interativo do site Ơ barra lateral das suas pƔginas."
+ />
+ <LinkCard
+ href="https://github.com/HiDeoo/starlight-sidebar-topics"
+ title="starlight-sidebar-topics"
+ description="Divida a sua documentação em secções diferentes cada uma com a sua barra lateral."
+ />
+ <LinkCard
+ href="https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown"
+ title="starlight-sidebar-topics-dropdown"
+ description="Divida as suas pÔginas de documentação em vÔrias sub-pÔginas e alterne entre elas através de um menu na barra lateral."
+ />
+ <LinkCard
+ href="https://github.com/trueberryless-org/starlight-cooler-credit"
+ title="starlight-cooler-credit"
+ description="Adicione os créditos do Starlight ou Astro no fundo da tabela de conteúdos."
+ />
+ <LinkCard
+ href="https://github.com/trueberryless-org/starlight-contributor-list"
+ title="starlight-contributor-list"
+ description="Apresente uma lista de todos os contribuidores do seu projeto."
+ />
+</CardGrid>
+
+### Temas da comunidade
+Um Tema é um plugin do Starlight que muda visualmente a aparência do site através da sobreposição de componentes, CSS personalizados, ou outras
+novas funcionalidades.
+
+<CardGrid>
+ <LinkCard
+ href="https://github.com/HiDeoo/starlight-theme-rapide"
+ title="starlight-theme-rapide"
+ description="Tema do Starlight inspirado no tema Vitesse do Visual Studio Code."
+ />
+ <LinkCard
+ href="https://github.com/Fevol/starlight-theme-obsidian"
+ title="starlight-theme-obsidian"
+ description="Tema do Starlight inspirado em sites com o tema Obsidian Publish."
+ />
+ <LinkCard
+ href="https://github.com/TheOtterlord/catppuccin-starlight"
+ title="catppuccin-starlight"
+ description="Tema em tons de pastel suave para o Starlight"
+ />
</CardGrid>
## Ferramentas e integraƧƵes da comunidade
@@ -106,6 +173,11 @@ Estas ferramentas e integraƧƵes da comunidade podem ser usadas para adicionar
<LinkCard
href="https://github.com/HiDeoo/starlight-showcases"
title="starlight-showcases"
- description="Conjunto de componentes do Starlight para cosntruir pÔginas de demonstração."
+ description="Conjunto de componentes do Starlight para construir pÔginas de demonstração."
+ />
+ <LinkCard
+ href="https://github.com/HiDeoo/generator-starlight-plugin"
+ title="@hideoo/starlight-plugin"
+ description="A generator to quickly scaffold Starlight plugins."
/>
</CardGrid>