Ir para o conteúdo principal
Version: 2.0.0-beta.6

Visão geral da migração

Este documento o orienta na migração de um site existente do Docusaurus 1 para o Docusaurus 2.

Tentamos tornar isso o mais fácil possível e fornecer um cli de migração.

Principais diferenças#

Docusaurus 1 é um gerador de site de documentação puro, usando React como um mecanismo de template do lado do servidor, mas não carregando o React no navegador.

O Docusaurus 2, reconstruído do zero, gera um aplicativo de página única, usando todo o poder do React no navegador. Ele permite mais personalização, mas preserva as melhores partes do Docusaurus 1 - fácil de começar, documentos com versão e i18n.

Além disso, o Docusaurus 2 é um gerador de sites estáticos de alto desempenho e pode ser usado para criar sites baseados em conteúdo comuns (por exemplo, documentação, blogs, landing de produtos páginas de marketing, etc.) extremamente rapidamente.

Embora nosso foco principal ainda seja ajudá-lo a obter suas documentações corretamente, é possível construir qualquer tipo de site usando o Docusaurus 2, pois é apenas um aplicativo React. Docusaurus agora pode ser usado para construir qualquer site, não apenas sites de documentação.

Estrutura do Docusaurus 1#

Seu site Docusaurus 1 deve ter a seguinte estrutura:

├── docs└── website    ├── blog    ├── core    │   └── Footer.js    ├── package.json    ├── pages    ├── sidebars.json    ├── siteConfig.js    └── static

Estrutura do Docusaurus 2#

Após a migração, seu site Docusaurus 2 pode se parecer:

├── docs└── website    ├── blog    ├── src    │   ├── components    │   ├── css    │   └── pages    ├── static    ├── package.json    ├── sidebars.json    ├── docusaurus.config.js
info

Esta migração não altera o local da pasta /docs, mas os sites Docusaurus v2 geralmente têm a pasta /docs dentro de /website

Você está livre para colocar a pasta /docs em qualquer lugar que desejar após ter migrado para a v2.

Processo de migração#

Existem várias coisas a migrar para obter um site do Docusaurus 2 totalmente funcional:

  • packages
  • comandos cli
  • configuração do site
  • arquivos markdown
  • arquivo sidebars
  • páginas, componentes e CSS
  • documentos versionados
  • i18n suporte 🚧

Processo de migração automatizado#

O cli de migração tratará de muitas coisas da migração para você.

No entanto, algumas peças não podem ser automatizadas facilmente e você terá que voltar para o processo manual.

note

Recomendamos executar o cli de migração e completar as partes que faltam graças ao processo de migração manual.

Processo de migração manual#

Algumas partes da migração não podem ser automatizadas (principalmente as páginas) e você terá que migrá-las manualmente.

O guia de migração manual fornecerá todas as etapas manuais.

Suporte#

Para qualquer dúvida, você pode perguntar no #docusaurus-1-to-2-migration canal Discord.

Sinta-se à vontade para marcar @slorber em qualquer PRs de migração se quiser que a gente dê uma olhada.

Também temos voluntários dispostos a ajudá-lo a migrar seu site v1.

Exemplo de PRs de migração#

Você pode consultar nossos PRs de migração para Criar aplicativo React e Flux como exemplos de como uma migração para um site Docusaurus v1 básico pode ser feita.