diff options
author | Ricardo Jaime Gil SimƵes | 2025-01-08 17:50:49 +0000 |
---|---|---|
committer | GitHub | 2025-01-08 18:50:49 +0100 |
commit | e394ed659be6b6787870ba6f06c20060359697be (patch) | |
tree | 4427148d7e35c88286708aa0739af29f80f4642a | |
parent | dcc144c9530beaa6d163a52d03ccc20ac3d61022 (diff) | |
download | IT.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.md | 32 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/index.mdx | 6 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/manual-setup.mdx | 26 | ||||
-rw-r--r-- | docs/src/content/docs/pt-pt/resources/community-content.mdx | 11 | ||||
-rw-r--r-- | 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 | - -<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> |