From e394ed659be6b6787870ba6f06c20060359697be Mon Sep 17 00:00:00 2001 From: Ricardo Jaime Gil Simões Date: Wed, 8 Jan 2025 17:50:49 +0000 Subject: i18n(pt-PT): update outdated pages (#2741) --- .../src/content/docs/pt-pt/environmental-impact.md | 32 ++++----- docs/src/content/docs/pt-pt/index.mdx | 6 ++ docs/src/content/docs/pt-pt/manual-setup.mdx | 26 +++++--- .../docs/pt-pt/resources/community-content.mdx | 11 ++++ docs/src/content/docs/pt-pt/resources/plugins.mdx | 76 +++++++++++++++++++++- 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 | - -Dados recolhidos a 14 de Maio de 2023. Clique num dos links para ver os valores atualizados. +| 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 | + +Dados recolhidos a 22 de Julho de 2024. Clique num dos links para ver os valores atualizados. [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? + + Aprenda como fazer + 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: - + ```sh npx astro add starlight ``` ```sh pnpm astro add starlight ``` ```sh yarn astro add starlight ``` @@ -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." /> + ## 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 + + + + + + + + + + + +### 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. + + + + + ## Ferramentas e integrações da comunidade @@ -106,6 +173,11 @@ Estas ferramentas e integrações da comunidade podem ser usadas para adicionar + -- cgit