feat(v2): v1-v2 migration cli automate migration from v1 to v2 (#3015)

* add poc for migration tool

* fix version

* fix path

* fix some type error

* fix type errors

* fix commad

* delete package.lock.json

* ignore lib folder in eslint

* ignore lib in prettier

* fix missing version

* fix sidebar in next

* use primaey color

* fix navbar link

* fix footer

* sanatize front-matter for gray-matter

* add e2e test

* fixworkflow

* add unit test

* chore(v2): fix eslint error

* refactor(v2): use descriptive variable names

* refactor(v2): refactor createProjectStructure

* refactor(v2): refactor migrateDocusaurusProject

* refactor(v2): fix eslint errors

* fix(v2): fix mistake

* use path.join

* remove console.log

* try automate migrating md file to mdx

* fix types not found

* fix types

* remove unused fixture

* use package.json for version

* add support for pages

* add support

* sanitize fortmatter only in case of special character

* chore(v2): add color to dependencies

* feat(v2): initialize config with range of color and add logs

* chore(v2): add glob dependency

* fix(v2): fix color generation

* fix(v2): fix type issue

* feat(v2): add all unknown fields to customFields

* fix(v2): fix css mistake

* fix lerna

* fix(v2): fix github actions

* feat(v2): add option flag for migrating pages

* fix special character

* remove depulicate build

* fix test

* remove unwanted file

* fix frontmatter

* remove unused file

* rerun the test

* fix links

* feat(v2): filter out more fields from customFields

* feat(v2): filter out deprecated fields from customFields

* fix items

* fix types

* merge master

* revert docs

* fix doc

* fix broken link

* fix test

* test

* fix ci

* fix ci

* fix ci

* fix ci

* fix frontmatter

* log custom fields

Co-authored-by: teikjun <teikjunhci@gmail.com>

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();
+}