Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

i18n(pt-PT): update outdated pages #2741

Merged
merged 4 commits into from
Jan 8, 2025
Merged

i18n(pt-PT): update outdated pages #2741

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
821ecc4
update outdated pages
rgilsimoes Dec 26, 2024
204bbbe
fix: Updated manual-setup.md changes and adjusted broken link.
rgilsimoes Jan 7, 2025
57d8c47
fix: Small review
rgilsimoes Jan 8, 2025
4552dbe
Merge branch 'main' into i18-ptPT-update-translations
delucis Jan 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 17 additions & 15 deletions docs/src/content/docs/pt-pt/environmental-impact.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand All @@ -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

Expand All @@ -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/
6 changes: 6 additions & 0 deletions docs/src/content/docs/pt-pt/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
26 changes: 16 additions & 10 deletions docs/src/content/docs/pt-pt/manual-setup.mdx
View file
Open in desktop
rgilsimoes marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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!
Expand All @@ -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/`:

Expand All @@ -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`.
11 changes: 11 additions & 0 deletions docs/src/content/docs/pt-pt/resources/community-content.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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. 🌟 🎇",
},
]}
/>
76 changes: 74 additions & 2 deletions docs/src/content/docs/pt-pt/resources/plugins.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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>
Loading