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.

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-BR): Update customization.mdx, i18n.mdx, index.mdx, frontmatter.md and configuration.mdx #940

Merged
merged 7 commits into from
Oct 24, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/src/content/docs/pt-br/guides/customization.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ defineConfig({

Starlight tem suporte integrado para adicionar links de suas contas de redes sociais ao cabeçalho do site através da opção [`social`](/pt-br/reference/configuration/#social) na integração Starlight.

Atualmente, links para Bitbucket, Codeberg, CodePen, Discord, GitHub, GitLab, Gitter, LinkedIn, Mastodon, Microsoft Teams, Stack Overflow, Threads, Twitch, Twitter e Youtube são suportados.
Você pode encontrar uma lista completa de ícones suportados na [Referência de Configuração](/reference/configuration/#social).
Nos avise no GitHub ou Discord se você precisa de suporte para outro serviço!

```js
Expand Down
5 changes: 3 additions & 2 deletions docs/src/content/docs/pt-br/guides/i18n.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ Se uma tradução ainda não está disponível para uma língua, Starlight irá

Em adição a hospedar arquivos de conteúdo traduzido, Starlight te permite traduzir as strings padrões da UI (e.x. o cabeçalho "Nesta página" no índice) para que seus leitores possam experienciar seu site inteiramente na língua selecionada.

Strings da UI são providenciadas para Inglês, Tcheco, Francês, Alemão, Italiano, Japonês, Português, Holandês, Dinarmaquês, Espanhol, Turco, Árabe, Norueguês, Persa, Chinês Simplificado, Coreano e Sueco por padrão, e nós aceitamos [contribuições para adicionar mais línguas padrões](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
Strings da UI são providenciadas para Inglês, Tcheco, Francês, Alemão, Italiano, Japonês, Português, Holandês, Dinamarquês, Espanhol, Turco, Árabe, Norueguês, Persa, Hebraico, Chinês Simplificado, Coreano, Indonésio, Russo, Sueco, Ucraniano e Vietnamita por padrão, e nós aceitamos [contribuições para adicionar mais línguas padrões](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).

Você pode fornecer traduções para línguas adicionais que você suporta — ou sobrescrever nossos rótulos padrões — através da coleção de dados `i18n`.

Expand Down Expand Up @@ -197,7 +197,8 @@ Você pode fornecer traduções para línguas adicionais que você suporta — o
"page.editLink": "Edit page",
"page.lastUpdated": "Last updated:",
"page.previousLink": "Next",
"page.nextLink": "Previous"
"page.nextLink": "Previous",
"404.text": "Page not found. Check the URL or try using the search bar."
}
```

Expand Down
5 changes: 5 additions & 0 deletions docs/src/content/docs/pt-br/index.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
---
title: Starlight 🌟 Construa sites de documentação com Astro
head:
- tag: title
content: Starlight 🌟 Construa sites de documentação com Astro
description: Starlight te ajuda a construir belos e performáticos websites de documentação com Astro.
template: splash
editUrl: false
lastUpdated: false
banner:
content: |
<span class="ph-banner">
Expand Down
delucis marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: Uma visão geral de todas as opções de configuração que o Starl

## Configure a integração `starlight`

Starlight é uma integração construída acima do framework web [Astro](https://astro.build). Você pode configurar o seu projeto dentro do arquivo de configuração `astro.config.mjs`:
Starlight é uma integração construída em cima do framework web [Astro](https://astro.build). Você pode configurar o seu projeto dentro do arquivo de configuração `astro.config.mjs`:

```js
// astro.config.mjs
Expand Down Expand Up @@ -157,19 +157,19 @@ Se o seu site é multilíngue, a `label` de cada item é considerada como estand

```js
sidebar: [
// um exemplo de barra lateral com rótulos traduzidos para o Francês.
// um exemplo de barra lateral com rótulos traduzidos para o Chinês Simplificado.
{
label: 'Comece Aqui',
translations: { fr: 'Commencez ici' },
translations: { 'zh-CN': '从这里开始' },
items: [
{
label: 'Introdução',
translations: { fr: 'Bien démarrer' },
translations: { 'zh-CN': '开始使用' },
link: '/introducao',
},
{
label: 'Estrutura de Projetos',
translations: { fr: 'Structure du projet' },
translations: { 'zh-CN': '项目结构' },
link: '/estrutura',
},
],
Expand All @@ -187,6 +187,7 @@ type SidebarItem = {
| {
link: string;
badge?: string | BadgeConfig;
attrs?: Record<string, string | number | boolean | undefined>;
}
| { items: SidebarItem[]; collapsed?: boolean }
| {
Expand All @@ -207,7 +208,7 @@ interface BadgeConfig {

### `locales`

**tipo:** <code>{ \[dir: string\]: [LocaleConfig](#localeconfig) }</code>
**tipo:** <code>\{ \[dir: string\]: [LocaleConfig](#localeconfig) \}</code>

[Configure internacionalização (i18n)](/pt-br/guides/i18n/) para o seu site definindo quais `locales` são suportados.

Expand Down Expand Up @@ -307,7 +308,9 @@ O local padrãoserá utilizado para providenciar conteúdo de fallback onde est

### `social`

**tipo:** `Partial<Record<'bitbucket' | 'codeberg' | 'codePen' | 'discord' | 'github' | 'gitlab' | 'gitter' | 'instagram' | 'linkedin' | 'mastodon' | 'microsoftTeams' | 'stackOverflow' | 'threads' | 'twitch' | 'twitter' | 'youtube', string>>`
import SocialLinksType from '../../../../components/social-links-type.astro';

**tipo:** <SocialLinksType />

Detalhes opcionais sobre as contas de redes sociais para esse site. Adicionar qualquer um desses irá os mostrar como links de ícone no cabeçalho do site.

Expand Down Expand Up @@ -424,3 +427,29 @@ starlight({
],
});
```

### `titleDelimiter`

**tipo:** `string`
**padrão:** `'|'`

Define o delimitador entre o título da página e o título do site na tag `<title>`, o qual é exibido na aba do navegador.

Por padrão toda página tem o `<title>` no formato `Título da Página | Título do Site`.
Por exemplo, o título da página atual é "Referência da Configuração" e o título do site "Starlight", então o `<title>` é "Referência da Configuração | Starlight”.

### `components`

**tipo:** `Record<string, string>`

Fornece os caminhos para os componentes que substituirão os componentes padrões do Starlight.

```js
starlight({
components: {
SocialLinks: './src/components/MeusLinksSociais.astro',
},
});
```

Consulte a [Referencia de Substituição](/pt-br/reference/overrides/) para ver os detalhes de todos os componentes que você pode substituir.
45 changes: 44 additions & 1 deletion docs/src/content/docs/pt-br/reference/frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -208,12 +208,39 @@ next: false
---
```

### `pagefind`

**tipo:** `boolean`
**padrão:** `true`

Configura se essa página deve ou não ser inclusa no índice de busca do [Pagefind](https://pagefind.app/).
Defina como `false` para excluir a página do resultado de buscas.

```md
---
# Não exibir essa página nas buscas
pagefind: false
---
```

### `sidebar`

**tipo:** `{ label?: string; order?: number; hidden?: boolean; badge?: string | BadgeConfig }`
**tipo:** [`SidebarConfig`](#sidebarconfig)

Controla como essa página é mostrada na [barra lateral](/pt-br/reference/configuration/#sidebar), quando se utiliza um grupo de links gerados automaticamente.

#### `SidebarConfig`

```ts
interface SidebarConfig {
label?: string;
order?: number;
hidden?: boolean;
badge?: string | BadgeConfig;
attrs?: Record<string, string | number | boolean | undefined>;
}
```

#### `label`

**tipo:** `string`
Expand Down Expand Up @@ -285,3 +312,19 @@ sidebar:
variant: caution
---
```

#### `attrs`

**tipo:** `Record<string, string | number | boolean | undefined>`

Atributos HTML que será adicionado ao link da barra lateral da página quando exibido em um grupo de link gerados automaticamente.

```md
---
title: Abrir em nova aba
sidebar:
# Abre a página em uma nova aba
attrs:
target: _blank
---
```