Skip to content

Commit

Permalink
i18n(pt-BR): Add migrate-to-astro.mdx and cms.mdx translations (w…
Browse files Browse the repository at this point in the history
…ithastro#2366)

* i18n(pt-BR): Add `migrate-to-astro.mdx` and `cms.mdx` translations

* It's not a Yan PR if nothing breaks!

Co-authored-by: d6stiny <[email protected]>
  • Loading branch information
yanthomasdev and d6stiny authored Jan 13, 2023
1 parent e75d313 commit d397a5e
Show file tree
Hide file tree
Showing 4 changed files with 94 additions and 0 deletions.
4 changes: 4 additions & 0 deletions src/i18n/pt-br/docsearch.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,9 @@ export default DocSearchDictionary({
button: 'Pesquisar',
placeholder: 'Pesquisar pela documentação',
shortcutLabel: 'Pressione / para pesquisar',
resultsFooterLede: 'Procurando por uma integração ou tema Astro? Precisa de mais ajuda?',
resultsFooterIntegrations: 'Diretório de integrações Astro',
resultsFooterThemes: 'Vitrine de temas Astro',
resultsFooterDiscord: 'Junte-se a nós no Discord',
modal: {},
});
2 changes: 2 additions & 0 deletions src/i18n/pt-br/nav.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ export default NavDictionary({
'getting-started': 'Introdução',
install: 'Instalação',
'editor-setup': 'Configuração do Editor',
'guides/migrate-to-astro' : 'Migre para o Astro',
migrate: 'Guia de Migração',
coreConcepts: 'Principais Conceitos',
'concepts/why-astro': 'Por que Astro?',
Expand All @@ -29,6 +30,7 @@ export default NavDictionary({
'core-concepts/sharing-state': 'Compartilhamento de Estado',
'guides/rss': 'RSS',
'guides/troubleshooting': 'Solução de Problemas',
'guides/cms': 'Conectando um CMS',
'guides/images': 'Imagens',
'guides/fonts': 'Fontes',
'guides/testing': 'Testes',
Expand Down
39 changes: 39 additions & 0 deletions src/pages/pt-br/guides/cms.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: Use um CMS com o Astro
description: Como utilizar um CMS para adicionar conteúdo ao Astro
layout: ~/layouts/MainLayout.astro
i18nReady: true
---
import CMSGuidesNav from '~/components/CMSGuidesNav.astro';



**Pronto para conectar um CMS Headless ao seu projeto Astro?** Siga um dos nossos guias para integrar um CMS.

## Guias de CMS

<CMSGuidesNav />

Note que várias dessas páginas são **esboços**: elas são coleções de recursos esperando por sua contribuição!

## Por que utilizar um CMS?

Um Content Management System (Sistema de Gerenciamento de Conteúdo) te permite escrever conteúdo e gerenciar assets fora do seu projeto Astro.

Isso desbloqueia novas funcionalidades para trabalhar com conteúdo. A maioria dos CMSes te dá um editor visual de conteúdo, a habilidade de especificar tipos padrões de conteúdo e uma forma de colaborar com outros.

Um CMS pode ser útil para conteúdo que segue uma estrutura particular, muitas vezes te dando uma experiência estilo painel de controle e ferramentas de edição WYSIWYG. Você pode utilizar um CMS para escrever postagens de blog utilizando o editor de texto rico de um CMS ao invés de arquivos Markdown. Ou você pode utilizar um CMS para manter listagens de produtos para uma loja eCommerce, fazendo certos campos obrigatório para evitar listagens incompletas.

Seu projeto Astro pode então buscar seu conteúdo do seu CMS e mostrá-lo, onde e como você quiser no seu site.


## Quais CMSes funciona bem com o Astro?

Pelo Astro tomar conta da _apresentação_ do seu conteúdo, você vai querer escolher um CMS _headless_ , como aqueles na lista acima. Isso significa que o CMS te ajuda a escrever seu conteúdo, mas não gera um site que o mostra. Ao invés disso, você busca os dados do conteúdo e os utiliza no seu projeto Astro.

Alguns CMSes headless, como o Storyblok, oferecem uma [integração](/pt-br/guides/integrations-guide/) Astro que te ajuda a buscar o conteúdo especificadamente para um site Astro. Outros oferecem um SDK JavaScript, uma biblioteca que você instala e utiliza para buscar seu conteúdo remoto.

## Posso utilizar Astro sem um CMS?

Sim! Astro oferece formas integradas de [escrever conteúdo](/pt-br/guides/content/), incluindo suporte para páginas Markdown.

49 changes: 49 additions & 0 deletions src/pages/pt-br/guides/migrate-to-astro.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: Migrando um projeto existente para o Astro
description: Algumas dicas e truques para converter seu site para o Astro.
layout: ~/layouts/MainLayout.astro
i18nReady: true
---
import MigrationGuidesNav from '~/components/MigrationGuidesNav.astro';

**Pronto para converter seu site para o Astro?** Veja um dos nossos guias para dicas de migração.

## Guias de Migração

<MigrationGuidesNav />

Note que várias dessas páginas são **esboços**: elas são coleções de recursos esperando por sua contribuição!

## Por que migrar seu site para o Astro?

Astro tem vários benefícios: performance, simplicidade e muitas das funcionalidades que você quer integradas ao framework. Quando você precisa expandir seu site, Astro providencia várias [integrações oficiais e de terceiros da comunidade](https://astro.build/integrations).

Migrar pode ser menos trabalhoso do que você acredita!

Dependendo do seu projeto existente, você pode ser capaz de usar os já existentes:

- [Componentes de frameworks de UI](/pt-br/core-concepts/framework-components/) diretamente no Astro.

- [Folhas de estilo ou bibliotecas de CSS](/pt-br/guides/styling/) incluindo Tailwind.

- [Arquivos Markdown/MDX](/pt-br/guides/markdown-content/), configurados usando seus [plugins remark e rehype](/pt-br/guides/markdown-content/#configurando-markdown-e-mdx).

- [Conteúdos de CMS](/pt-br/guides/cms/) a partir de uma integração ou API.


## Quais projetos posso converter para o Astro?

[Vários sites existentes podem ser construídos com Astro](/pt-br/concepts/why-astro/). Astro é especialmente adequado para seus sites baseados em conteúdo como blogs, páginas iniciais, sites de marketing e portfólios. Astro se integra com vários CMSs headless populares e te permite conectar carrinhos de compras de eCommerce.

Astro te permite escolher entre um site gerado estaticamente e [renderização no lado do servidor (SSR)](/pt-br/guides/server-side-rendering/), o fazendo um ótimo substituto para SSGs ou para sites que precisam buscar dados da página no momento.

## Como o design do meu projeto vai mudar?

Dependendo do seu projeto existente, você pode precisar pensar de forma diferente sobre:

- Projetar com [Ilhas Astro](/pt-br/concepts/islands/#o-que-é-uma-ilha-astro) para evitar enviar JavaScript desnecessário ao navegador.

- Providenciar interatividade no lado do cliente com [tags `<script>` no lado do cliente](/pt-br/guides/client-side-scripts/) ou [componentes de frameworks de UI](/pt-br/core-concepts/framework-components/).

- Gerenciar [estado compartilhado](/pt-br/core-concepts/sharing-state/) com Nano Stores ou armazenamento local ao invés de hooks ou wrappers a nível de aplicação.

0 comments on commit d397a5e

Please sign in to comment.