Migrate to Docusaurus - Attempt #2

Summary: This PR continues #1607 (by aadsm) to update the website to https://github.com/facebook/docusaurus. Changes from the original PR: * Removing the `./setup.sh` line in .travis.yml (since the file was removed). * Upgrading to the latest Docusaurus and React. * Adding Google Analytics to Docusaurus config. * Adding cname to Docusaurus config. * Wiring the correct footer links. Live Example: https://noamelb.github.io/draft-js/ Thanks flarnie & yangshun for all the help ☺️ ![screencapture-localhost-3000-2018-05-10-23_18_05](https://user-images.githubusercontent.com/7422547/39892600-d14dc6be-54a9-11e8-953e-51be1cf48637.png) ![screencapture-localhost-3000-docs-getting-started-html-2018-05-10-23_18_26](https://user-images.githubusercontent.com/7422547/39892604-d3d9bdac-54a9-11e8-8306-e878775c1f79.png) <img width="1055" alt="ga" src="https://user-images.githubusercontent.com/7422547/39892610-d6dc2c7e-54a9-11e8-8f58-9d256d2247ee.png"> Co-authored-by: António Afonso <aadsm@users.noreply.github.com> Closes #1759 Reviewed By: flarnie Differential Revision: D8026140 Pulled By: flarnie fbshipit-source-id: 975fcde309a8ab24af90c5363acf1b601dfdcde7
facebookarchive · May 16, 2018 · 710919b · 710919b
1 parent b2f6ed0
commit 710919b
Show file tree

Hide file tree

Showing 71 changed files with 20,078 additions and 3,347 deletions.
diff --git a/.travis.yml b/.travis.yml
@@ -43,18 +43,15 @@ script:
   else
     set -e
     ./node_modules/.bin/gulp
-    cd website
-    yarn install
-    ./setup.sh
     if [ "$TRAVIS_PULL_REQUEST" = false ] && [ "$TRAVIS_BRANCH" = master ]; then
       # Automatically publish the website
       git config --global user.name "Travis CI"
       git config --global user.email "travis@reactjs.org"
-      echo "machine github.com login reactjs-bot password $GITHUB_TOKEN" >~/.netrc
-      ./publish.sh
+      echo "machine github.com login reactjs-bot password $GITHUB_TOKEN" > ~/.netrc
+      cd website && yarn install && GIT_USER=reactjs-bot npm run publish-gh-pages
     else
       # Make sure the website builds without error
-      node server/generate.js
+      cd website && yarn install && yarn build
     fi
 
   fi

diff --git a/docs/APIReference-APIMigration.md b/docs/APIReference-APIMigration.md
@@ -1,10 +1,6 @@
 ---
 id: v0-10-api-migration
 title: v0.10 API Migration
-layout: docs
-category: Advanced Topics
-next: advanced-topics-decorators
-permalink: docs/v0-10-api-migration.html
 ---
 
 The Draft.js v0.10 release includes a change to the API for managing
@@ -152,4 +148,3 @@ function findLinkEntities(contentBlock, callback, contentState) {
 ## More Information
 
 For more information see the [updated examples](https://github.com/facebook/draft-js/tree/master/examples/draft-0-10-0).
-
diff --git a/docs/APIReference-AtomicBlockUtils.md b/docs/APIReference-AtomicBlockUtils.md
@@ -1,13 +1,9 @@
 ---
 id: api-reference-atomic-block-utils
 title: AtomicBlockUtils
-layout: docs
-category: API Reference
-next: api-reference-key-binding-util
-permalink: docs/api-reference-atomic-block-utils.html
 ---
 
-The `AtomicBlockUtils` module is a static set of utility functions for atomic 
+The `AtomicBlockUtils` module is a static set of utility functions for atomic
 block editing.
 
 In each case, these methods accept `EditorState` objects with relevant

diff --git a/docs/APIReference-CharacterMetadata.md b/docs/APIReference-CharacterMetadata.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-character-metadata
 title: CharacterMetadata
-layout: docs
-category: API Reference
-next: api-reference-entity
-permalink: docs/api-reference-character-metadata.html
 ---
 
 `CharacterMetadata` is an Immutable

diff --git a/docs/APIReference-CompositeDecorator.md b/docs/APIReference-CompositeDecorator.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-composite-decorator
 title: CompositeDecorator
-layout: docs
-category: API Reference
-next: api-reference-data-conversion
-permalink: docs/api-reference-composite-decorator.html
 ---
 
 See the [advanced topic article on Decorators](/docs/advanced-topics-decorators.html#compositedecorator).
diff --git a/docs/APIReference-ContentBlock.md b/docs/APIReference-ContentBlock.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-content-block
 title: ContentBlock
-layout: docs
-category: API Reference
-next: api-reference-character-metadata
-permalink: docs/api-reference-content-block.html
 ---
 
 `ContentBlock` is an Immutable

diff --git a/docs/APIReference-ContentState.md b/docs/APIReference-ContentState.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-content-state
 title: ContentState
-layout: docs
-category: API Reference
-next: api-reference-content-block
-permalink: docs/api-reference-content-state.html
 ---
 
 `ContentState` is an Immutable

diff --git a/docs/APIReference-Data-Conversion.md b/docs/APIReference-Data-Conversion.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-data-conversion
 title: Data Conversion
-layout: docs
-category: API Reference
-next: api-reference-rich-utils
-permalink: docs/api-reference-data-conversion.html
 ---
 
 Because a text editor doesn't exist in a vacuum and it's important to save

diff --git a/docs/APIReference-Editor.md b/docs/APIReference-Editor.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-editor
 title: Editor Component
-layout: docs
-category: API Reference
-next: api-reference-editor-change-type
-permalink: docs/api-reference-editor.html
 ---
 
 This article discusses the API and props of the core controlled contentEditable

diff --git a/docs/APIReference-EditorChangeType.md b/docs/APIReference-EditorChangeType.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-editor-change-type
 title: EditorChangeType
-layout: docs
-category: API Reference
-next: api-reference-editor-state
-permalink: docs/api-reference-editor-change-type.html
 ---
 
 [EditorChangeType](https://github.com/facebook/draft-js/blob/master/src/model/immutable/EditorChangeType.js)

diff --git a/docs/APIReference-EditorState.md b/docs/APIReference-EditorState.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-editor-state
 title: EditorState
-layout: docs
-category: API Reference
-next: api-reference-content-state
-permalink: docs/api-reference-editor-state.html
 ---
 
 `EditorState` is the top-level state object for the editor.

diff --git a/docs/APIReference-Entity.md b/docs/APIReference-Entity.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-entity
 title: Entity
-layout: docs
-category: API Reference
-next: api-reference-selection-state
-permalink: docs/api-reference-entity.html
 ---
 
 `Entity` is a static module containing the API for creating, retrieving, and

diff --git a/docs/APIReference-KeyBindingUtil.md b/docs/APIReference-KeyBindingUtil.md
@@ -1,13 +1,9 @@
 ---
 id: api-reference-key-binding-util
 title: KeyBindingUtil
-layout: docs
-category: API Reference
-next: api-reference-modifier
-permalink: docs/api-reference-key-binding-util.html
 ---
 
-The `KeyBindingUtil` module is a static set of utility functions for 
+The `KeyBindingUtil` module is a static set of utility functions for
 defining key bindings.
 
 ## Static Methods

diff --git a/docs/APIReference-Modifier.md b/docs/APIReference-Modifier.md
@@ -1,9 +1,6 @@
 ---
 id: api-reference-modifier
 title: Modifier
-layout: docs
-category: API Reference
-permalink: docs/api-reference-modifier.html
 ---
 
 The `Modifier` module is a static set of utility functions that encapsulate common

diff --git a/docs/APIReference-RichUtils.md b/docs/APIReference-RichUtils.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-rich-utils
 title: RichUtils
-layout: docs
-category: API Reference
-next: api-reference-atomic-block-utils
-permalink: docs/api-reference-rich-utils.html
 ---
 
 The `RichUtils` module is a static set of utility functions for rich text

diff --git a/docs/APIReference-SelectionState.md b/docs/APIReference-SelectionState.md
@@ -1,10 +1,6 @@
 ---
 id: api-reference-selection-state
 title: SelectionState
-layout: docs
-category: API Reference
-next: api-reference-composite-decorator
-permalink: docs/api-reference-selection-state.html
 ---
 
 `SelectionState` is an Immutable

diff --git a/docs/Advanced-Topics-Block-Components.md b/docs/Advanced-Topics-Block-Components.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-block-components
 title: Custom Block Components
-layout: docs
-category: Advanced Topics
-next: advanced-topics-inline-styles
-permalink: docs/advanced-topics-block-components.html
 ---
 
 Draft is designed to solve problems for straightforward rich text interfaces

diff --git a/docs/Advanced-Topics-Block-Styling.md b/docs/Advanced-Topics-Block-Styling.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-block-styling
 title: Block Styling
-layout: docs
-category: Advanced Topics
-next: advanced-topics-custom-block-render-map
-permalink: docs/advanced-topics-block-styling.html
 ---
 
 Within `Editor`, some block types are given default CSS styles to limit the amount

diff --git a/docs/Advanced-Topics-Custom-Block-Render.md b/docs/Advanced-Topics-Custom-Block-Render.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-custom-block-render-map
 title: Custom Block Rendering
-layout: docs
-category: Advanced Topics
-next: advanced-topics-block-components
-permalink: docs/advanced-topics-custom-block-render-map.html
 ---
 
 This article discusses how to customize Draft default block rendering.

diff --git a/docs/Advanced-Topics-Decorators.md b/docs/Advanced-Topics-Decorators.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-decorators
 title: Decorators
-layout: docs
-category: Advanced Topics
-next: advanced-topics-key-bindings
-permalink: docs/advanced-topics-decorators.html
 ---
 
 Inline and block styles aren't the only kind of rich styling that we might

diff --git a/docs/Advanced-Topics-EditorState-Race-Conditions.md b/docs/Advanced-Topics-EditorState-Race-Conditions.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-editorstate-race-conditions
 title: EditorState Race Conditions
-layout: docs
-category: Advanced Topics
-next: advanced-topics-issues-and-pitfalls
-permalink: docs/advanced-topics-editorstate-race-conditions.html
 ---
 
 Draft `Editor` is a *controlled input* component (you can read about this in detail in the [API Basics](/docs/quickstart-api-basics.html) section), meaning that changes made to the `Editor` state are propagated upwards through `onChange` and it's up to the app to feed it back to the `Editor` component.

diff --git a/docs/Advanced-Topics-Entities.md b/docs/Advanced-Topics-Entities.md
@@ -1,15 +1,11 @@
 ---
 id: advanced-topics-entities
 title: Entities
-layout: docs
-category: Advanced Topics
-next: v0-10-api-migration
-permalink: docs/advanced-topics-entities.html
 ---
 
 This article discusses the Entity system, which Draft uses for annotating
 ranges of text with metadata. Entities introduce levels of richness beyond
-styled text. Links, mentions, and embedded content can all be implemented 
+styled text. Links, mentions, and embedded content can all be implemented
 using entities.
 
 In the Draft repository, the

diff --git a/docs/Advanced-Topics-Inline-Styles.md b/docs/Advanced-Topics-Inline-Styles.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-inline-styles
 title: Complex Inline Styles
-layout: docs
-category: Advanced Topics
-next: advanced-topics-nested-lists
-permalink: docs/advanced-topics-inline-styles.html
 ---
 
 Within your editor, you may wish to provide a wide variety of inline style

diff --git a/docs/Advanced-Topics-Issues-and-Pitfalls.md b/docs/Advanced-Topics-Issues-and-Pitfalls.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-issues-and-pitfalls
 title: Issues and Pitfalls
-layout: docs
-category: Advanced Topics
-next: api-reference-editor
-permalink: docs/advanced-topics-issues-and-pitfalls.html
 ---
 
 This article addresses some known issues with the Draft editor framework, as

diff --git a/docs/Advanced-Topics-Key-Bindings.md b/docs/Advanced-Topics-Key-Bindings.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-key-bindings
 title: Key Bindings
-layout: docs
-category: Advanced Topics
-next: advanced-topics-managing-focus
-permalink: docs/advanced-topics-key-bindings.html
 ---
 
 The `Editor` component offers flexibility to define custom key bindings
@@ -75,7 +71,7 @@ class MyEditor extends React.Component {
     this.handleKeyCommand = this.handleKeyCommand.bind(this);
   }
   // ...
-  
+
   handleKeyCommand(command: string): DraftHandleValue {
     if (command === 'myeditor-save') {
       // Perform a request to save your contents, set

diff --git a/docs/Advanced-Topics-Managing-Focus.md b/docs/Advanced-Topics-Managing-Focus.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-managing-focus
 title: Managing Focus
-layout: docs
-category: Advanced Topics
-next: advanced-topics-block-styling
-permalink: docs/advanced-topics-managing-focus.html
 ---
 
 Managing text input focus can be a tricky task within React components. The browser

diff --git a/docs/Advanced-Topics-Nested-Lists.md b/docs/Advanced-Topics-Nested-Lists.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-nested-lists
 title: Nested Lists
-layout: docs
-category: Advanced Topics
-next: advanced-topics-text-direction
-permalink: docs/advanced-topics-nested-lists.html
 ---
 
 The Draft framework provides support for nested lists, as demonstrated in the

diff --git a/docs/Advanced-Topics-Text-Direction.md b/docs/Advanced-Topics-Text-Direction.md
@@ -1,10 +1,6 @@
 ---
 id: advanced-topics-text-direction
 title: Text Direction
-layout: docs
-category: Advanced Topics
-next: advanced-topics-editorstate-race-conditions
-permalink: docs/advanced-topics-text-direction.html
 ---
 
 Facebook supports dozens of languages, which means that our text inputs need

diff --git a/docs/Overview.md b/docs/Overview.md
@@ -1,10 +1,6 @@
 ---
 id: getting-started
 title: Overview
-layout: docs
-category: Quick Start
-next: quickstart-api-basics
-permalink: docs/overview.html
 ---
 
 Draft.js is a framework for building rich text editors in React, powered by an immutable model and abstracting over cross-browser differences.

diff --git a/docs/QuickStart-API-Basics.md b/docs/QuickStart-API-Basics.md
@@ -1,10 +1,6 @@
 ---
 id: quickstart-api-basics
 title: API Basics
-layout: docs
-category: Quick Start
-next: quickstart-rich-styling
-permalink: docs/quickstart-api-basics.html
 ---
 
 This document provides an overview of the basics of the `Draft` API. A

diff --git a/docs/QuickStart-Rich-Styling.md b/docs/QuickStart-Rich-Styling.md
@@ -1,10 +1,6 @@
 ---
 id: quickstart-rich-styling
 title: Rich Styling
-layout: docs
-category: Quick Start
-next: advanced-topics-entities
-permalink: docs/quickstart-rich-styling.html
 ---
 
 Now that we have established the basics of the top-level API, we can go a step

diff --git a/meta/bundle-size-stats/Draft.js.json b/meta/bundle-size-stats/Draft.js.json
diff --git a/meta/bundle-size-stats/Draft.min.js.json b/meta/bundle-size-stats/Draft.min.js.json
diff --git a/src/model/immutable/DraftBlockRenderConfig.js b/src/model/immutable/DraftBlockRenderConfig.js
@@ -12,6 +12,8 @@
 
 'use strict';
 
+const React = require('React');
+
 export type DraftBlockRenderConfig = {
   element: string,
   wrapper?: React.Node,