i18n(pt-BR): update `astro-components.mdx` by ogabrielp · Pull Request #9061 · withastro/docs

ogabrielp · 2024-08-12T04:28:00Z

Description (required)

Adding missing block on lines 320-323; other minor changes as well. This could be two separate PRs, but I got the feeling that we usually go over the entirety of the file whenever it's changed, so I thought it'd be OK to do it here. Glad to split this one if need be.

- Fix uncommon "tanto/ou" structure - Avoid translating "it" as "ele" - More naturally translate "with zero Javascript footprint added"

netlify · 2024-08-12T04:28:17Z

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`ef8c54c`
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/66bce1ae3cd35900081b3d7c
😎 Deploy Preview	https://deploy-preview-9061--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

astrobot-houston · 2024-08-12T04:31:02Z

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

Locale	File	Note
pt-br	basics/astro-components.mdx	Localization changed, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

ogabrielp · 2024-08-12T04:30:02Z

 **Componentes Astro** são parte fundamental de qualquer projeto Astro. São componentes de template com apenas HTML e sem execução no lado do cliente. Você pode localizar um componente Astro por sua extensão de arquivo: `.astro`.

-Componentes Astro são extremamente flexíveis. Geralmente, um componente Astro irá conter alguma **UI reutilizável na página**, como um cabeçalho ou um cartão de perfil. Outras vezes, um componente Astro pode conter um pequeno pedaço de HTML, como uma coleção de tags `<meta>` comuns que facilitam trabalhar com SEO. Componentes Astro também pode conter o layout inteiro de uma página.
+Componentes Astro são extremamente flexíveis. Geralmente, um componente Astro irá conter alguma **UI reutilizável na página**, como um cabeçalho ou um cartão de perfil. Outras vezes, um componente Astro pode conter um pedaço menor de HTML, como uma coleção de tags `<meta>` comuns que facilitam trabalhar com SEO. Componentes Astro podem até mesmo conter o layout inteiro de uma página.


Using "menor" as translation for "smaller";

"Até mesmo" better conveys the meaning of "even" in the original.

ogabrielp · 2024-08-12T04:37:48Z

+Componentes Astro são extremamente flexíveis. Geralmente, um componente Astro irá conter alguma **UI reutilizável na página**, como um cabeçalho ou um cartão de perfil. Outras vezes, um componente Astro pode conter um pedaço menor de HTML, como uma coleção de tags `<meta>` comuns que facilitam trabalhar com SEO. Componentes Astro podem até mesmo conter o layout inteiro de uma página.

-A coisa mais importante de entender sobre componentes Astro é que eles **não renderizam no lado do cliente**. Eles renderizam para HTML tanto na hora da build ou sob demanda usando [renderização no lado do servidor (SSR)](/pt-br/guides/server-side-rendering/). Você pode incluir código JavaScript dentro do frontmatter do seu componente, e todo ele vai ser removido da página final enviada para o navegador dos seus usuários. O resultado é um site mais rápido, com nenhum JavaScript por padrão.
+A coisa mais importante de entender sobre componentes Astro é que eles **não renderizam no lado do cliente**. Eles renderizam para HTML em tempo de build ou sob demanda usando [renderização no lado do servidor (SSR)](/pt-br/guides/server-side-rendering/). Você pode incluir código JavaScript dentro do frontmatter do seu componente, e todo esse código vai ser removido da página final enviada para o navegador dos seus usuários. O resultado é um site mais rápido, sem nenhum JavaScript adicionado por padrão.


Spent some time with this one. The "tanto...ou..." structure is a bit unusual in Portuguese, so I tested a lot of different possibilities here:

"Eles renderizam para HTML ou em tempo de build, ou sob demanda" => felt like the first "ou" breaks reading flow because the reader might think we're about to mention another rendering method.

"Eles renderizam para HTML tanto em tempo de build quanto sob demanda" => implicitly suggests that both can be possible simultaneously, while the original is an either/or.

"Eles renderizam para HTML, seja em tempo de build ou sob demanda" => makes sense on its own, but doesn't quite fit with the previous sentence. Would work if we were just describing how components are rendered, but we're making the case that they don't render on the client-side, so the first part before the comma will feel kinda awkward to read.

Also replaced "todo ele" with "todo esse código" (less casual) and changed the unusual "com nenhum". Also snuck in an "adicionado" because there's the word "added" in the original.

ogabrielp · 2024-08-12T04:57:17Z

 ## Estrutura do Componente

-Um componente Astro é feito de duas partes principais: o **Script do Componente** e o **Template do Componente**. Cada parte executa um trabalho diferente, porém juntos eles providenciam um framework que é ao mesmo tempo fácil de utilizar e expressivo o suficiente para lidar com qualquer que seja o que você deseja construir.
+Um componente Astro é feito de duas partes principais: o **Script do Componente** e o **Template do Componente**. Cada parte executa um trabalho diferente, porém juntos eles fornecem um framework que é ao mesmo tempo fácil de utilizar e expressivo o bastante para lidar com o que quer que seja que você deseja construir.


"Fornecem" is a better translation for "provide";

Using "bastante" because "suficiente" has a slightly negative connotation;

Using "o que quer que seja que" instead of the more unusual "qualquer que seja o que"

ogabrielp · 2024-08-12T04:59:15Z

 ```

-A cerca de código é projetada para garantir que o JavaScript que você escreve nela está "cercado". Ele não irá escapar para a sua aplicação frontend ou cair na mão dos seus usuários. Você pode com segurança escrever aqui código que é custoso ou sensível (como uma chamada ao seu banco de dados privado) sem se preocupar com ele cair no navegador do seu usuário.
+A cerca de código é projetada para garantir que o JavaScript que você escreve nela está "cercado". Ele não irá escapar para a sua aplicação frontend ou cair nas mãos dos seus usuários. Você pode com segurança escrever aqui código que é custoso ou sensível (como uma chamada ao seu banco de dados privado) sem se preocupar com ele indo parar no navegador do seu usuário em algum momento.


Pluralized "na mão" because it's a more usual expression;

Replaced casual "cair" with "indo parar";

Making sure we include the "ever" from the original file in the translated version.

ogabrielp · 2024-08-12T05:00:53Z

 ### O Template do Componente

-O template do componente está abaixo da cerca do código e determina o HTML que irá sair do seu componente.
+O template do componente está abaixo da cerca do código e determina o HTML que será produzido pelo seu componente.


More accurate and technical term.

ogabrielp · 2024-08-12T05:26:43Z

 ```

-Note que slots nomeados precisam ser um filho imediato de um componente. Você não pode passar slots nomeados através de elementos aninhados.
+Note que slots nomeados precisam ser um filho imediato do componente. Você não pode passar slots nomeados através de elementos aninhados.


Original uses "of the component" instead of "of a component"

ogabrielp · 2024-08-12T05:27:58Z


 :::note
-Não é possível gerar dinamicamente um slot nomeado no Astro, como por exemplo dentro de uma função map. Se essa funcionalidade é necessária dentro de um componente de um framework de UI, o melhor é gerar esses slots dinâmicos dentro do próprio framework.
+Não é possível gerar dinamicamente o nome de um slot no Astro, como por exemplo dentro de uma função map. Se essa funcionalidade é necessária dentro de um componente de um framework de UI, o melhor é gerar esses slots dinâmicos dentro do próprio framework.


Original says it's not possible to dynamically generate an "Astro slot name", referring to the name rather than the slot.

ogabrielp · 2024-08-12T05:30:51Z


 ### Conteúdo de Fallback para Slots
-Slots também podem renderizar **conteúdo de fallback**. Quando não tem filhos correspondentes passados a um slot, um elemento `<slot />` irá renderizar o seu próprio filho placeholder.
+Slots também podem renderizar **conteúdo de fallback**. Quando não existirem filhos correspondentes passados a um slot, um elemento `<slot />` irá renderizar os elementos-filhos que ele possui como placeholder.


Use the subjunctive mood for better consistency ("quando não existirem"); might be overshooting on the final part here, but I don't think it can get much clearer than that.

ogabrielp · 2024-08-12T05:31:36Z

 ## Componentes HTML

-Astro suporta a importação e uso de arquivos `.html` como componentes ou como arquivos no subdiretório `src/pages/` como páginas. Você pode querer utilizar componentes HTML se você estiver reutilizando código de um site já construído sem um framework ou se você quer se certificar de que seu componente não tem funcionalidades dinâmicas.
+Astro suporta a importação e uso de arquivos `.html` como componentes ou colocando esses arquivos no subdiretório `src/pages/` como páginas. Você pode querer utilizar componentes HTML se você estiver reutilizando código de um site já construído sem um framework ou se você quer se certificar de que seu componente não tem funcionalidades dinâmicas.


Making translation more similar to the original

ogabrielp · 2024-08-12T05:34:35Z

 import ReadMore from '~/components/ReadMore.astro';

-<ReadMore>Aprenda sobre como utilizar [componentes de frameworks JavaScript](/pt-br/guides/framework-components/) em seu projeto Astro.</ReadMore>
+<ReadMore>Leia mais sobre como utilizar [componentes de frameworks de UI](/pt-br/guides/framework-components/) em seu projeto Astro.</ReadMore>


We use "leia mais" more often than we use "aprenda"; original also says "UI framework components", no mentions to Javascript in this part.

yanthomasdev

Amazing work @ogabrielp, thanks! LGTM

ogabrielp added 4 commits August 11, 2024 18:15

Add missing block

55ec1b5

Improve translation of 'smaller' and 'even'

b6622d0

Minor translation improvements

daffae5

- Fix uncommon "tanto/ou" structure - Avoid translating "it" as "ele" - More naturally translate "with zero Javascript footprint added"

General translation improvements

f1c4e27

github-actions Bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Aug 12, 2024

ogabrielp added 2 commits August 12, 2024 02:16

Revert to present tense

02d9746

Use proper plural for child element

01a5f18

ogabrielp commented Aug 12, 2024

View reviewed changes

Merge branch 'main' into astro-components-mdx

8423294

ogabrielp marked this pull request as ready for review August 12, 2024 05:35

yanthomasdev added 2 commits August 14, 2024 13:55

Fix small typo

f052dc4

Merge branch 'main' into astro-components-mdx

ef8c54c

yanthomasdev approved these changes Aug 14, 2024

View reviewed changes

yanthomasdev merged commit 0c8e2bf into withastro:main Aug 14, 2024

Uh oh!

Conversation

ogabrielp commented Aug 12, 2024

Description (required)

Uh oh!

netlify Bot commented Aug 12, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

astrobot-houston commented Aug 12, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lunaria Status Overview

Tracked Files

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ogabrielp Aug 12, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

yanthomasdev left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

netlify Bot commented Aug 12, 2024 •

edited

Loading

astrobot-houston commented Aug 12, 2024 •

edited

Loading

ogabrielp Aug 12, 2024 •

edited

Loading