diff --git a/docs/src/content/docs/pt-br/guides/customization.mdx b/docs/src/content/docs/pt-br/guides/customization.mdx index 55b30e78912..a401e26f110 100644 --- a/docs/src/content/docs/pt-br/guides/customization.mdx +++ b/docs/src/content/docs/pt-br/guides/customization.mdx @@ -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 diff --git a/docs/src/content/docs/pt-br/guides/i18n.mdx b/docs/src/content/docs/pt-br/guides/i18n.mdx index 10d24590752..8fe1fdce7ac 100644 --- a/docs/src/content/docs/pt-br/guides/i18n.mdx +++ b/docs/src/content/docs/pt-br/guides/i18n.mdx @@ -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`. @@ -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." } ``` diff --git a/docs/src/content/docs/pt-br/index.mdx b/docs/src/content/docs/pt-br/index.mdx index 0fbeb24b30c..edab368a721 100644 --- a/docs/src/content/docs/pt-br/index.mdx +++ b/docs/src/content/docs/pt-br/index.mdx @@ -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: | diff --git a/docs/src/content/docs/pt-br/reference/configuration.md b/docs/src/content/docs/pt-br/reference/configuration.mdx similarity index 88% rename from docs/src/content/docs/pt-br/reference/configuration.md rename to docs/src/content/docs/pt-br/reference/configuration.mdx index 2d9ce8b7e2f..29586c32403 100644 --- a/docs/src/content/docs/pt-br/reference/configuration.md +++ b/docs/src/content/docs/pt-br/reference/configuration.mdx @@ -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 @@ -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', }, ], @@ -187,6 +187,7 @@ type SidebarItem = { | { link: string; badge?: string | BadgeConfig; + attrs?: Record; } | { items: SidebarItem[]; collapsed?: boolean } | { @@ -207,7 +208,7 @@ interface BadgeConfig { ### `locales` -**tipo:** { \[dir: string\]: [LocaleConfig](#localeconfig) } +**tipo:** \{ \[dir: string\]: [LocaleConfig](#localeconfig) \} [Configure internacionalização (i18n)](/pt-br/guides/i18n/) para o seu site definindo quais `locales` são suportados. @@ -307,7 +308,9 @@ O local padrãoserá utilizado para providenciar conteúdo de fallback onde est ### `social` -**tipo:** `Partial>` +import SocialLinksType from '../../../../components/social-links-type.astro'; + +**tipo:** 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. @@ -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 ``, 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. diff --git a/docs/src/content/docs/pt-br/reference/frontmatter.md b/docs/src/content/docs/pt-br/reference/frontmatter.md index c03c527bf88..ed8d73d07e4 100644 --- a/docs/src/content/docs/pt-br/reference/frontmatter.md +++ b/docs/src/content/docs/pt-br/reference/frontmatter.md @@ -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` @@ -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 +--- +```