feat: automate migration from v1 to v2

.eslintignore

@@ -23,6 +23,7 @@ packages/docusaurus-plugin-sitemap/lib/
 packages/docusaurus-plugin-ideal-image/lib/
 packages/docusaurus-plugin-ideal-image/copyUntypedFiles.js
 packages/docusaurus-theme-classic/lib/
+packages/docusaurus-migrate/lib/
 
 packages/docusaurus-1.x/.eslintrc.js
 packages/docusaurus-init/templates/facebook/.eslintrc.js

.github/workflows/migration-cli-e2e-test.yml

@@ -0,0 +1,36 @@
+name: MIGRATION CLI E2E TEST
+
+on:
+  # Trigger the workflow on push or pull request,
+  # but only for the master branch
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [10.x]
+    steps:
+      - uses: actions/checkout@v1
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Installation
+        run: yarn
+      - name: Migrate D1 website
+        run: yarn docusaurus-migrate migrate ./website-1.x ./test-migrated
+      - name: Install in Test website
+        run: yarn
+        working-directory: test-migrated
+      - name: Build Test website
+        run: yarn build
+        working-directory: test-migrated
+        env:
+          CI: true

.gitignore

@@ -27,3 +27,4 @@ packages/docusaurus-plugin-debug/lib/
 packages/docusaurus-plugin-sitemap/lib/
 packages/docusaurus-plugin-ideal-image/lib/
 packages/docusaurus-theme-classic/lib/
+packages/docusaurus-migrate/lib/

.prettierignore

@@ -14,5 +14,6 @@ packages/docusaurus-plugin-content-pages/lib/
 packages/docusaurus-plugin-debug/lib/
 packages/docusaurus-plugin-sitemap/lib/
 packages/docusaurus-plugin-ideal-image/lib/
+packages/docusaurus-migrate/lib/
 packages/docusaurus-theme-classic/lib/
 __fixtures__

jest.config.js

@@ -15,6 +15,7 @@ const ignorePatterns = [
   '/packages/docusaurus-plugin-content-blog/lib',
   '/packages/docusaurus-plugin-content-docs/lib',
   '/packages/docusaurus-plugin-content-pages/lib',
+  '/packages/docusaurus-migrate/lib',
 ];
 
 module.exports = {

packages/docusaurus-migrate/bin/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+const chalk = require('chalk');
+const semver = require('semver');
+const cli = require('commander');
+const path = require('path');
+
+const requiredVersion = require('../package.json').engines.node;
+
+const {migrateDocusaurusProject, migrateMDToMDX} = require('../lib');
+
+function wrapCommand(fn) {
+  return (...args) =>
+    fn(...args).catch((err) => {
+      console.error(chalk.red(err.stack));
+      process.exitCode = 1;
+    });
+}
+
+if (!semver.satisfies(process.version, requiredVersion)) {
+  console.log(
+    chalk.red(`\nMinimum Node version not met :(`) +
+      chalk.yellow(
+        `\n\nYou are using Node ${process.version}. We require Node ${requiredVersion} or up!\n`,
+      ),
+  );
+  process.exit(1);
+}
+
+cli
+  .command('migrate [siteDir] [newDir]')
+  .option('--mdx', 'Try to migrate MD to MDX too')
+  .option('--page', 'Try to migrate pages too')
+  .description('Migrate between versions of docusaurus website')
+  .action((siteDir = '.', newDir = '.', {mdx, page}) => {
+    const sitePath = path.resolve(siteDir);
+    const newSitePath = path.resolve(newDir);
+    wrapCommand(migrateDocusaurusProject)(sitePath, newSitePath, mdx, page);
+  });
+
+cli
+  .command('mdx [siteDir] [newDir]')
+  .description('Migrate markdown files to MDX')
+  .action((siteDir = '.', newDir = '.') => {
+    const sitePath = path.resolve(siteDir);
+    const newSitePath = path.resolve(newDir);
+    wrapCommand(migrateMDToMDX)(sitePath, newSitePath);
+  });
+cli.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+  cli.outputHelp();
+}

packages/docusaurus-migrate/external_types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+declare module '@mapbox/hast-util-to-jsx';
+
+declare module 'hast-util-to-string';
+
+declare module 'color';