forked from withastro/docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
…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
1 parent
e75d313
commit d397a5e
Showing
4 changed files
with
94 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. | ||
|