chore(v2): make v2 docs plugin legacy (#1639)

* chore(v2): make v2 docs plugin legacy

* chore(v2): update fixtures

packages/docusaurus-plugin-content-docs-legacy/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@docusaurus/plugin-content-docs",
+  "name": "@docusaurus/plugin-content-docs-legacy",
   "version": "2.0.0-alpha.19",
-  "description": "Documentation plugin for Docusaurus",
+  "description": "Documentation plugin for legacy v1 Docusaurus docs",
   "main": "src/index.js",
   "publishConfig": {
     "access": "public"

packages/docusaurus-plugin-content-docs-legacy/src/index.js

@@ -21,8 +21,8 @@ const DEFAULT_OPTIONS = {
   // TODO: Change format to array.
   sidebarPath: '', // Path to sidebar configuration for showing a list of markdown pages.
   // TODO: Settle themeing.
-  docLayoutComponent: '@theme/DocPage',
-  docItemComponent: '@theme/DocItem',
+  docLayoutComponent: '@theme/DocLegacyPage',
+  docItemComponent: '@theme/DocLegacyItem',
   remarkPlugins: [],
   rehypePlugins: [],
 };

packages/docusaurus-preset-classic/package.json

@@ -9,7 +9,7 @@
   "license": "MIT",
   "dependencies": {
     "@docusaurus/plugin-content-blog": "^2.0.0-alpha.19",
-    "@docusaurus/plugin-content-docs": "^2.0.0-alpha.19",
+    "@docusaurus/plugin-content-docs-legacy": "^2.0.0-alpha.19",
     "@docusaurus/plugin-content-pages": "^2.0.0-alpha.19",
     "@docusaurus/plugin-sitemap": "^2.0.0-alpha.19",
     "@docusaurus/theme-classic": "^2.0.0-alpha.19",

packages/docusaurus-preset-classic/src/index.js

@@ -17,7 +17,7 @@ module.exports = function preset(context, opts = {}) {
       algolia && '@docusaurus/theme-search-algolia',
     ],
     plugins: [
-      ['@docusaurus/plugin-content-docs', opts.docs],
+      ['@docusaurus/plugin-content-docs-legacy', opts.docs],
       ['@docusaurus/plugin-content-blog', opts.blog],
       ['@docusaurus/plugin-content-pages', opts.pages],
       googleAnalytics && '@docusaurus/plugin-google-analytics',

packages/docusaurus-theme-classic/src/theme/DocLegacyItem/index.js

@@ -8,7 +8,7 @@
 import React from 'react';
 
 import Head from '@docusaurus/Head';
-import DocPaginator from '@theme/DocPaginator';
+import DocLegacyPaginator from '@theme/DocLegacyPaginator';
 
 import styles from './styles.module.css';
 
@@ -28,7 +28,7 @@ function Headings({headings, isChild}) {
   );
 }
 
-function DocItem(props) {
+function DocLegacyItem(props) {
   const {metadata, content: DocContent, docsMetadata} = props;
 
   return (
@@ -49,7 +49,10 @@ function DocItem(props) {
                 </div>
               </article>
               <div className="margin-top--xl margin-bottom--lg">
-                <DocPaginator docsMetadata={docsMetadata} metadata={metadata} />
+                <DocLegacyPaginator
+                  docsMetadata={docsMetadata}
+                  metadata={metadata}
+                />
               </div>
             </div>
           </div>
@@ -66,4 +69,4 @@ function DocItem(props) {
   );
 }
 
-export default DocItem;
+export default DocLegacyItem;

packages/docusaurus-theme-classic/src/theme/DocLegacyPage/index.js

@@ -10,10 +10,10 @@ import {MDXProvider} from '@mdx-js/react';
 
 import renderRoutes from '@docusaurus/renderRoutes';
 import Layout from '@theme/Layout';
-import DocSidebar from '@theme/DocSidebar';
+import DocLegacySidebar from '@theme/DocLegacySidebar';
 import MDXComponents from '@theme/MDXComponents';
 
-function DocPage(props) {
+function DocLegacyPage(props) {
   const {route, docsMetadata, location} = props;
   const {permalinkToId} = docsMetadata;
   const id =
@@ -27,7 +27,7 @@ function DocPage(props) {
       <div className="container container--fluid">
         <div className="row">
           <div className="col col--3">
-            <DocSidebar docsMetadata={docsMetadata} sidebar={sidebar} />
+            <DocLegacySidebar docsMetadata={docsMetadata} sidebar={sidebar} />
           </div>
           <main className="col">
             <MDXProvider components={MDXComponents}>
@@ -40,4 +40,4 @@ function DocPage(props) {
   );
 }
 
-export default DocPage;
+export default DocLegacyPage;

packages/docusaurus-theme-classic/src/theme/DocLegacyPaginator/index.js

@@ -8,7 +8,7 @@
 import React from 'react';
 import Link from '@docusaurus/Link';
 
-function DocPaginator(props) {
+function DocLegacyPaginator(props) {
   const {
     docsMetadata: {docs},
     metadata,
@@ -44,4 +44,4 @@ function DocPaginator(props) {
   );
 }
 
-export default DocPaginator;
+export default DocLegacyPaginator;

packages/docusaurus-theme-classic/src/theme/DocLegacySidebar/index.js

@@ -8,13 +8,13 @@
 import React, {useState} from 'react';
 import classnames from 'classnames';
 
-import Link from '@docusaurus/Link'; // eslint-disable-line
+import Link from '@docusaurus/Link';
 
 import styles from './styles.module.css';
 
 const MOBILE_TOGGLE_SIZE = 24;
 
-function DocSidebar(props) {
+function DocLegacySidebar(props) {
   const [showResponsiveSidebar, setShowResponsiveSidebar] = useState(false);
   const {docsMetadata, sidebar} = props;
 
@@ -127,4 +127,4 @@ function DocSidebar(props) {
   );
 }
 
-export default DocSidebar;
+export default DocLegacySidebar;

packages/docusaurus/src/server/__tests__/__fixtures__/custom-site/docusaurus.config.js

@@ -15,7 +15,7 @@ module.exports = {
   favicon: 'img/docusaurus.ico',
   plugins: [
     [
-      '@docusaurus/plugin-content-docs',
+      '@docusaurus/plugin-content-docs-legacy',
       {
         path: '../docs',
         sidebarPath: require.resolve('./sidebars.js'),

packages/docusaurus/src/server/__tests__/__fixtures__/simple-site/docusaurus.config.js

@@ -15,7 +15,7 @@ module.exports = {
   favicon: 'img/docusaurus.ico',
   plugins: [
     [
-      '@docusaurus/plugin-content-docs',
+      '@docusaurus/plugin-content-docs-legacy',
       {
         path: '../docs',
         sidebarPath: require.resolve('./sidebars.js'),