From a046ccccfb7d5a8ec82e8246c546d4946c08047a Mon Sep 17 00:00:00 2001
From: Yangshun Tay <tay.yang.shun@gmail.com>
Date: Sun, 5 Apr 2020 17:18:28 +0800
Subject: [PATCH] docs(v2): document editUrl

---
 .../src/theme/BlogPostPage/index.js           | 22 +++++++++++-
 .../src/theme/DocItem/index.js                | 24 +++++++++++--
 .../src/theme/EditPage/index.js               | 36 -------------------
 website/docs/using-plugins.md                 |  5 +++
 4 files changed, 48 insertions(+), 39 deletions(-)
 delete mode 100644 packages/docusaurus-theme-classic/src/theme/EditPage/index.js

diff --git a/packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.js b/packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.js
index 099c227540e2..b2d14bba3a7d 100644
--- a/packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.js
+++ b/packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.js
@@ -29,7 +29,27 @@ function BlogPostPage(props) {
                 isBlogPostPage>
                 <BlogPostContents />
               </BlogPostItem>
-              <EditPage url={editUrl} />
+              <div>
+                {editUrl && (
+                  <a href={editUrl} target="_blank" rel="noreferrer noopener">
+                    <svg
+                      fill="currentColor"
+                      height="1.2em"
+                      width="1.2em"
+                      preserveAspectRatio="xMidYMid meet"
+                      viewBox="0 0 40 40"
+                      style={{
+                        marginRight: '0.3em',
+                        verticalAlign: 'sub',
+                      }}>
+                      <g>
+                        <path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z" />
+                      </g>
+                    </svg>
+                    Edit this page
+                  </a>
+                )}
+              </div>
               {(nextItem || prevItem) && (
                 <div className="margin-vert--xl">
                   <BlogPostPaginator nextItem={nextItem} prevItem={prevItem} />
diff --git a/packages/docusaurus-theme-classic/src/theme/DocItem/index.js b/packages/docusaurus-theme-classic/src/theme/DocItem/index.js
index d8631883469a..c96619e1cf06 100644
--- a/packages/docusaurus-theme-classic/src/theme/DocItem/index.js
+++ b/packages/docusaurus-theme-classic/src/theme/DocItem/index.js
@@ -13,7 +13,6 @@ import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import useBaseUrl from '@docusaurus/useBaseUrl';
 import DocPaginator from '@theme/DocPaginator';
 import useTOCHighlight from '@theme/hooks/useTOCHighlight';
-import EditPage from '@theme/EditPage';
 
 import classnames from 'classnames';
 import styles from './styles.module.css';
@@ -128,7 +127,28 @@ function DocItem(props) {
                   <div className="margin-vert--xl">
                     <div className="row">
                       <div className="col">
-                        <EditPage url={editUrl} />
+                        {editUrl && (
+                          <a
+                            href={editUrl}
+                            target="_blank"
+                            rel="noreferrer noopener">
+                            <svg
+                              fill="currentColor"
+                              height="1.2em"
+                              width="1.2em"
+                              preserveAspectRatio="xMidYMid meet"
+                              viewBox="0 0 40 40"
+                              style={{
+                                marginRight: '0.3em',
+                                verticalAlign: 'sub',
+                              }}>
+                              <g>
+                                <path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z" />
+                              </g>
+                            </svg>
+                            Edit this page
+                          </a>
+                        )}
                       </div>
                       {(lastUpdatedAt || lastUpdatedBy) && (
                         <div className="col text--right">
diff --git a/packages/docusaurus-theme-classic/src/theme/EditPage/index.js b/packages/docusaurus-theme-classic/src/theme/EditPage/index.js
deleted file mode 100644
index 33b7bf1992c2..000000000000
--- a/packages/docusaurus-theme-classic/src/theme/EditPage/index.js
+++ /dev/null
@@ -1,36 +0,0 @@
-/**
- * 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.
- */
-
-import React from 'react';
-
-function EditPage({url}) {
-  return (
-    <div>
-      {url && (
-        <a href={url} target="_blank" rel="noreferrer noopener">
-          <svg
-            fill="currentColor"
-            height="1.2em"
-            width="1.2em"
-            preserveAspectRatio="xMidYMid meet"
-            viewBox="0 0 40 40"
-            style={{
-              marginRight: '0.3em',
-              verticalAlign: 'sub',
-            }}>
-            <g>
-              <path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z" />
-            </g>
-          </svg>
-          Edit this page
-        </a>
-      )}
-    </div>
-  );
-}
-
-export default EditPage;
diff --git a/website/docs/using-plugins.md b/website/docs/using-plugins.md
index cbce525bf1d1..4d9c9c1fc5da 100644
--- a/website/docs/using-plugins.md
+++ b/website/docs/using-plugins.md
@@ -149,6 +149,11 @@ module.exports = {
          * relative to site dir
          */
         path: 'blog',
+        /**
+         * URL for editing a blog post, example: 'https://github.com/facebook/docusaurus/edit/master/website/blog/'
+         */
+        editUrl:
+          'https://github.com/facebook/docusaurus/edit/master/website/blog',
         /**
          * URL route for the blog section of your site
          * do not include trailing slash