Skip to content

Commit ba99daa

Browse files
vasfvitordelucis
vasfvitor
and
delucis
authored
i18n(pt-br): Updated some EC text markers and frames (#1311)
* `overriding-components.md` #1168 * `getting-started.mdx` (#1241) * `components.mdx` (#1102) * `css-and-tailwind.mdx` (#1102) * `customization.mdx` (#1102) * `manual-setup.mdx` (#1102) * translate filename in `components.mdx` * fix: indentation Co-authored-by: Chris Swithinbank <[email protected]> --------- Co-authored-by: Chris Swithinbank <[email protected]>
1 parent 4117bf1 commit ba99daa

File tree

6 files changed

+41
-35
lines changed

6 files changed

+41
-35
lines changed

‎docs/src/content/docs/pt-br/getting-started.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -135,27 +135,27 @@ Como o Starlight é um software em beta, haverá frequentes atualizações e mel
135135
Certifique-se de atualizar Starlight constantemente!
136136
:::
137137

138-
Starlight é uma integração Astro, e é atualizado como qualquer outra integração `@astrojs/*`:
138+
Starlight é uma integração Astro. Você pode atualiza-lo e outros pacotes Astro com o seguinte comando em seu terminal:
139139

140140
<Tabs>
141141
<TabItem label="npm">
142142

143143
```sh
144-
npm install @astrojs/starlight@latest
144+
npx @astrojs/upgrade
145145
```
146146

147147
</TabItem>
148148
<TabItem label="pnpm">
149149

150150
```sh
151-
pnpm upgrade @astrojs/starlight --latest
151+
pnpm dlx @astrojs/upgrade
152152
```
153153

154154
</TabItem>
155155
<TabItem label="Yarn">
156156

157157
```sh
158-
yarn upgrade @astrojs/starlight --latest
158+
yarn dlx @astrojs/upgrade
159159
```
160160

161161
</TabItem>

‎docs/src/content/docs/pt-br/guides/components.mdx

+10-2
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Elas se parecem com tags HTML porém começam com uma letra maiúscula correspon
1717

1818
```mdx
1919
---
20-
# src/content/docs/index.mdx
20+
# src/content/docs/exemplo.mdx
2121
title: Bem-vindo a minha documentação
2222
---
2323

@@ -39,7 +39,7 @@ Aprenda mais sobre como [utilizar componentes no MDX](https://docs.astro.build/p
3939
Starlight aplica estilos padrões para seu conteúdo Markdown, como por exemplo, adicionando margem entre elementos.
4040
Se esses estilos conflitam com a aparência do seu componente, defina a classe `not-content` no seu componente para desabilitá-los.
4141

42-
```astro
42+
```astro 'class="not-content"'
4343
---
4444
// src/components/Exemplo.astro
4545
---
@@ -62,6 +62,8 @@ Você pode mostrar uma interface com abas utilizando os componentes `<Tabs>` e `
6262
Cada `<TabItem>` tem que ter uma `label` para mostrar aos usuários.
6363

6464
```mdx
65+
# src/content/docs/exemplo.mdx
66+
6567
import { Tabs, TabItem } from '@astrojs/starlight/components';
6668

6769
<Tabs>
@@ -87,6 +89,8 @@ Coloque múltiplos cartões no componente `<CardGrid>` para mostrar cartões lad
8789
Um `<Card>` precisa de um `title` e pode opcionalmente incluir o atributo `icon` para definir o nome de um dos [ícones integrados do Starlight](#todos-os-ícones).
8890

8991
```mdx
92+
# src/content/docs/exemplo.mdx
93+
9094
import { Card, CardGrid } from '@astrojs/starlight/components';
9195

9296
<Card title="Veja isso">Conteúdo interessante que você quer destacar.</Card>
@@ -135,6 +139,8 @@ Um `<LinkCard>` precisa de um `title` e um atributo [`href`](https://developer.m
135139
Agrupe múltiplos componentes `<LinkCard>` em `<CardGrid>` para mostrar cartões lado a lado quando houver espaço suficiente.
136140

137141
```mdx
142+
# src/content/docs/exemplo.mdx
143+
138144
import { LinkCard, CardGrid } from '@astrojs/starlight/components';
139145

140146
<LinkCard
@@ -180,6 +186,8 @@ Starlight providencia um conjunto comum de ícones que você pode mostrar em seu
180186
Cada `<Icon>` requer um [`name`](#todos-os-ícones) e pode opcionalmente incluir um atributo `label`, `size` e `color`.
181187

182188
```mdx
189+
# src/content/docs/exemplo.mdx
190+
183191
import { Icon } from '@astrojs/starlight/components';
184192

185193
<Icon name="star" color="goldenrod" size="2rem" />

‎docs/src/content/docs/pt-br/guides/css-and-tailwind.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Customize os estilos aplicados ao seu site Starlight ao fornecer arquivos CSS ad
2222

2323
2. Adicione o caminho para seu arquivo CSS ao array `customCss` do Starlight em `astro.config.mjs`:
2424

25-
```js
25+
```diff lang="js"
2626
// astro.config.mjs
2727
import { defineConfig } from 'astro/config';
2828
import starlight from '@astrojs/starlight';
@@ -32,8 +32,8 @@ Customize os estilos aplicados ao seu site Starlight ao fornecer arquivos CSS ad
3232
starlight({
3333
title: 'Documentação com CSS Customizado',
3434
customCss: [
35-
// Caminho relativo ao seu arquivo CSS customizado
36-
'./src/styles/customizado.css',
35+
+ // Caminho relativo ao seu arquivo CSS customizado
36+
+ './src/styles/customizado.css',
3737
],
3838
}),
3939
],

‎docs/src/content/docs/pt-br/guides/customization.mdx

+23-23
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Adicionar uma logo customizada ao cabeçalho do site é uma forma rápida de adi
2828

2929
2. Adicione o caminho para sua logo como a opção [`logo.src`](/pt-br/reference/configuration/#logo) do Starlight em `astro.config.mjs`:
3030

31-
```js
31+
```diff lang="js"
3232
// astro.config.mjs
3333
import { defineConfig } from 'astro/config';
3434
import starlight from '@astrojs/starlight';
@@ -38,7 +38,7 @@ Adicionar uma logo customizada ao cabeçalho do site é uma forma rápida de adi
3838
starlight({
3939
title: 'Documentação com Minha Logo',
4040
logo: {
41-
src: './src/assets/minha-logo.svg',
41+
+ src: './src/assets/minha-logo.svg',
4242
},
4343
}),
4444
],
@@ -49,7 +49,7 @@ Por padrão, a logo será mostrada ao lado do `title` do seu site.
4949
Se sua imagem da logo já inclui o título do site, você pode esconder o texto do título visualmente ao definir a opção `replacesTitle`.
5050
O texto do `title` ainda será incluido para leitores de tela para que o cabeçalho continue acessível.
5151

52-
```js
52+
```js {5}
5353
starlight({
5454
title: 'Documentação com Minha Logo',
5555
logo: {
@@ -78,12 +78,12 @@ Você pode mostrar diferentes versões da sua logo no modo claro e escuro.
7878

7979
2. Adicione o caminho para suas variantes da logo como as opções `light` e `dark` ao invés de `src` em `astro.config.mjs`:
8080

81-
```js
81+
```diff lang="js"
8282
starlight({
8383
title: 'Documentação com Minha Logo',
8484
logo: {
85-
light: './src/assets/logo-clara.svg',
86-
dark: './src/assets/logo-escura.svg',
85+
+ light: './src/assets/logo-clara.svg',
86+
+ dark: './src/assets/logo-escura.svg',
8787
},
8888
}),
8989
```
@@ -92,7 +92,7 @@ Você pode mostrar diferentes versões da sua logo no modo claro e escuro.
9292

9393
O Starlight possui suporte integrado para a geração de um sitemap. Habilite a geração do sitemap definindo sua URL como `site` em `astro.config.mjs`:
9494

95-
```js
95+
```js {4}
9696
// astro.config.mjs
9797

9898
export default defineConfig({
@@ -108,7 +108,7 @@ Por padrão, páginas do Starlight usam um layout com uma barra de navegação l
108108
Você pode aplicar um layout de página maior sem barras laterais definindo [`template: splash`](/pt-br/reference/frontmatter/#template) no frontmatter de uma página.
109109
Isso funciona particularmente bem para páginas iniciais e você pode vê-lo em ação na [página inicial deste site](/pt-br/).
110110

111-
```md
111+
```md {5}
112112
---
113113
# src/content/docs/index.md
114114

@@ -127,7 +127,7 @@ Por padrão, cabeçalhos `<h2>` e `<h3>` são inclusos no índice. Modifique qua
127127
<Tabs>
128128
<TabItem label="Frontmatter">
129129

130-
```md
130+
```md {4-6}
131131
---
132132
# src/content/docs/exemplo.md
133133
title: Página com apenas H2s no índice
@@ -140,13 +140,13 @@ tableOfContents:
140140
</TabItem>
141141
<TabItem label="Configuração global">
142142

143-
```js
143+
```js {7}
144144
// astro.config.mjs
145145

146146
defineConfig({
147147
integrations: [
148148
starlight({
149-
title: '',
149+
title: 'Documentação com configuração de sumário personalizado',
150150
tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 2 },
151151
}),
152152
],
@@ -161,7 +161,7 @@ Desabilite o índice completamente definindo a opção `tableOfContents` como `f
161161
<Tabs>
162162
<TabItem label="Frontmatter">
163163

164-
```md
164+
```md {4}
165165
---
166166
# src/content/docs/exemplo.md
167167
title: Página sem um índice
@@ -172,7 +172,7 @@ tableOfContents: false
172172
</TabItem>
173173
<TabItem label="Configuração global">
174174

175-
```js
175+
```js {7}
176176
// astro.config.mjs
177177

178178
defineConfig({
@@ -195,7 +195,7 @@ Starlight tem suporte integrado para adicionar links de suas contas de redes soc
195195
Você pode encontrar uma lista completa de ícones suportados na [Referência de Configuração](/pt-br/reference/configuration/#social).
196196
Nos avise no GitHub ou Discord se você precisa de suporte para outro serviço!
197197

198-
```js
198+
```js {9-12}
199199
// astro.config.mjs
200200
import { defineConfig } from 'astro/config';
201201
import starlight from '@astrojs/starlight';
@@ -231,7 +231,7 @@ Se o seu projeto Starlight não está na raiz do seu repositório, inclua o cami
231231

232232
Este exemplo mostra o link de edição configurado para a documentação do Starlight, que vive no subdiretório `docs/` da branch `main` do repositório `withastro/starlight` no GitHub:
233233

234-
```js
234+
```js {9-11}
235235
// astro.config.mjs
236236
import { defineConfig } from 'astro/config';
237237
import starlight from '@astrojs/starlight';
@@ -266,7 +266,7 @@ Você pode customizá-la adicionando um arquivo `404.md` (ou `404.mdx`) ao seu d
266266

267267
Você pode utilizar todas as técnicas de customização e layout de página do Starlight em sua página 404. Por exemplo, a página 404 padrão utiliza o [template `splash`](#layout-da-página) e o componente [`hero`](/pt-br/reference/frontmatter/#hero) no frontmatter:
268268

269-
```md
269+
```md {4,6-8}
270270
---
271271
title: '404'
272272
template: splash
@@ -322,7 +322,7 @@ Para utilizar Google Fonts, siga o [guia de configuração do Fontsource](#confi
322322

323323
3. Adicione o caminho para seu arquivo `font-face.css` ao array `customCss` do Starlight em `astro.config.mjs`:
324324

325-
```js
325+
```diff lang="js"
326326
// astro.config.mjs
327327
import { defineConfig } from 'astro/config';
328328
import starlight from '@astrojs/starlight';
@@ -332,8 +332,8 @@ Para utilizar Google Fonts, siga o [guia de configuração do Fontsource](#confi
332332
starlight({
333333
title: 'Documentação Com Meu Tipo de Letra Customizado',
334334
customCss: [
335-
// Caminho relativo para seu arquivo CSS @font-face.
336-
'./src/fonts/font-face.css',
335+
+ // Caminho relativo para seu arquivo CSS @font-face.
336+
+ './src/fonts/font-face.css',
337337
],
338338
}),
339339
],
@@ -381,7 +381,7 @@ Ele providencia módulos do npm que você pode isntalar para as fontes que você
381381

382382
3. Adicione os arquivos CSS do Fontsource ao array `customCss` do Starlight em `astro.config.mjs`:
383383

384-
```js
384+
```diff lang="js"
385385
// astro.config.mjs
386386
import { defineConfig } from 'astro/config';
387387
import starlight from '@astrojs/starlight';
@@ -391,9 +391,9 @@ Ele providencia módulos do npm que você pode isntalar para as fontes que você
391391
starlight({
392392
title: 'Documentação Com Meu Tipo de Letra Customizado',
393393
customCss: [
394-
// Arquivos do Fontsource para as espessuras de fonte regular e semi-negrito.
395-
'@fontsource/ibm-plex-serif/400.css',
396-
'@fontsource/ibm-plex-serif/600.css',
394+
+ // Arquivos do Fontsource para as espessuras de fonte regular e semi-negrito.
395+
+ '@fontsource/ibm-plex-serif/400.css',
396+
+ '@fontsource/ibm-plex-serif/600.css',
397397
],
398398
}),
399399
],

‎docs/src/content/docs/pt-br/guides/overriding-components.md

-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
---
22
title: Substituindo Componentes
33
description: Aprenda como substituir os componentes nativos do Starlight para adicionar elementos personalizados a UI do seu site de documentação.
4-
sidebar:
5-
badge: New
64
---
75

86
<!---

‎docs/src/content/docs/pt-br/manual-setup.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ A integração Starlight é configurada no seu arquivo `astro.config.mjs`.
4444

4545
Adicione um `title` para começar:
4646

47-
```js {7-9}
47+
```js ins={8}
4848
// astro.config.mjs
4949
import { defineConfig } from 'astro/config';
5050
import starlight from '@astrojs/starlight';

0 commit comments

Comments
 (0)