Merge branch 'refactor-index'

Author: bvaughn

content/home/examples/a-component-using-external-plugins.js

@@ -0,0 +1,35 @@
+class MarkdownEditor extends React.Component {
+  constructor(props) {
+    super(props);
+    this.handleChange = this.handleChange.bind(this);
+    this.state = { value: 'Type some *markdown* here!' };
+  }
+
+  handleChange(e) {
+    this.setState({ value: e.target.value });
+  }
+
+  getRawMarkup() {
+    const md = new Remarkable();
+    return { __html: md.render(this.state.value) };
+  }
+
+  render() {
+    return (
+      <div className="MarkdownEditor">
+        <h3>Input</h3>
+        <textarea
+          onChange={this.handleChange}
+          defaultValue={this.state.value}
+        />
+        <h3>Output</h3>
+        <div
+          className="content"
+          dangerouslySetInnerHTML={this.getRawMarkup()}
+        />
+      </div>
+    );
+  }
+}
+
+ReactDOM.render(<MarkdownEditor />, mountNode);

content/home/examples/a-component-using-external-plugins.md

@@ -0,0 +1,6 @@
+---
+title: A Component Using External Plugins
+order: 3
+---
+
+React is flexible and provides hooks that allow you to interface with other libraries and frameworks. This example uses **remarkable**, an external Markdown library, to convert the `<textarea>`'s value in real time.

content/home/examples/a-simple-component.js

@@ -0,0 +1,14 @@
+class HelloMessage extends React.Component {
+  render() {
+    return (
+      <div>
+        Hello {this.props.name}
+      </div>
+    );
+  }
+}
+
+ReactDOM.render(
+  <HelloMessage name="Taylor" />,
+  mountNode
+);

content/home/examples/a-simple-component.md

@@ -0,0 +1,8 @@
+---
+title: A Simple Component
+order: 0
+---
+
+React components implement a `render()` method that takes input data and returns what to display. This example uses an XML-like syntax called JSX. Input data that is passed into the component can be accessed by `render()` via `this.props`.
+
+**JSX is optional and not required to use React.** Try the [Babel REPL](http://babeljs.io/repl#?babili=false&browsers=&build=&builtIns=false&code_lz=MYGwhgzhAEASCmIQHsCy8pgOb2vAHgC7wB2AJjAErxjCEB0AwsgLYAOyJph0A3gFDRoAJ1Jl4wgBQBKPoKEj4hAK7CS0SfIXQAPGQCWANwB8W7XEQo-hABb6I9NsORsHJMC3gBfM0J0B6AxMzaQBueR8ffmpaQgARAHlUelFyCU0_BCQ0DAhsXHdPAF4AIgAVMABPFGES6H9jABp5FmRlEkIAOWRxfjCgA&debug=false&circleciRepo=&evaluate=false&lineWrap=false&presets=react&targets=&version=6.26.0) to see the raw JavaScript code produced by the JSX compilation step.

content/home/examples/a-stateful-component.js

@@ -0,0 +1,30 @@
+class Timer extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = { seconds: 0 };
+  }
+
+  tick() {
+    this.setState(prevState => ({
+      seconds: prevState.seconds + 1
+    }));
+  }
+
+  componentDidMount() {
+    this.interval = setInterval(() => this.tick(), 1000);
+  }
+
+  componentWillUnmount() {
+    clearInterval(this.interval);
+  }
+
+  render() {
+    return (
+      <div>
+        Seconds: {this.state.seconds}
+      </div>
+    );
+  }
+}
+
+ReactDOM.render(<Timer />, mountNode);

content/home/examples/a-stateful-component.md

@@ -0,0 +1,6 @@
+---
+title: A Stateful Component
+order: 1
+---
+
+In addition to taking input data (accessed via `this.props`), a component can maintain internal state data (accessed via `this.state`). When a component's state data changes, the rendered markup will be updated by re-invoking `render()`.

content/home/examples/an-application.js

@@ -0,0 +1,59 @@
+class TodoApp extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = { items: [], text: '' };
+    this.handleChange = this.handleChange.bind(this);
+    this.handleSubmit = this.handleSubmit.bind(this);
+  }
+
+  render() {
+    return (
+      <div>
+        <h3>TODO</h3>
+        <TodoList items={this.state.items} />
+        <form onSubmit={this.handleSubmit}>
+          <input
+            onChange={this.handleChange}
+            value={this.state.text}
+          />
+          <button>
+            Add #{this.state.items.length + 1}
+          </button>
+        </form>
+      </div>
+    );
+  }
+
+  handleChange(e) {
+    this.setState({ text: e.target.value });
+  }
+
+  handleSubmit(e) {
+    e.preventDefault();
+    if (!this.state.text.length) {
+      return;
+    }
+    const newItem = {
+      text: this.state.text,
+      id: Date.now()
+    };
+    this.setState(prevState => ({
+      items: prevState.items.concat(newItem),
+      text: ''
+    }));
+  }
+}
+
+class TodoList extends React.Component {
+  render() {
+    return (
+      <ul>
+        {this.props.items.map(item => (
+          <li key={item.id}>{item.text}</li>
+        ))}
+      </ul>
+    );
+  }
+}
+
+ReactDOM.render(<TodoApp />, mountNode);

content/home/examples/an-application.md

@@ -0,0 +1,6 @@
+---
+title: An Application
+order: 2
+---
+
+Using `props` and `state`, we can put together a small Todo application. This example uses `state` to track the current list of items as well as the text that the user has entered. Although event handlers appear to be rendered inline, they will be collected and implemented using event delegation.

content/home/marketing/component-based.md

@@ -0,0 +1,8 @@
+---
+title: Component-Based
+order: 1
+---
+
+Build encapsulated components that manage their own state, then compose them to make complex UIs.
+
+Since component logic is written in JavaScript instead of templates, you can easily pass rich data through your app and keep state out of the DOM.

content/home/marketing/declarative.md

@@ -0,0 +1,8 @@
+---
+title: Declarative
+order: 0
+---
+
+React makes it painless to create interactive UIs. Design simple views for each state in your application, and React will efficiently update and render just the right components when your data changes.
+
+Declarative views make your code more predictable and easier to debug.

content/home/marketing/learn-once-write-anywhere.md

@@ -0,0 +1,8 @@
+---
+title: Learn Once, Write Anywhere
+order: 2
+---
+
+We don't make assumptions about the rest of your technology stack, so you can develop new features in React without rewriting existing code.
+
+React can also render on the server using Node and power mobile apps using [React Native](https://facebook.github.io/react-native/).

content/index.md

@@ -19,6 +19,7 @@ module.exports = {
   plugins: [
     'gatsby-source-react-error-codes',
     'gatsby-transformer-authors-yaml',
+    'gatsby-transformer-home-example-code',
     'gatsby-plugin-netlify',
     'gatsby-plugin-glamor',
     'gatsby-plugin-react-next',

gatsby-config.js

@@ -32,7 +32,13 @@ exports.createPages = async ({graphql, boundActionCreators}) => {
   const communityTemplate = resolve('./src/templates/community.js');
   const docsTemplate = resolve('./src/templates/docs.js');
   const tutorialTemplate = resolve('./src/templates/tutorial.js');
-  const homeTemplate = resolve('./src/templates/home.js');
+
+  // Redirect /index.html to root.
+  createRedirect({
+    fromPath: '/index.html',
+    redirectInBrowser: true,
+    toPath: '/',
+  });
 
   const allMarkdown = await graphql(
     `
@@ -60,15 +66,7 @@ exports.createPages = async ({graphql, boundActionCreators}) => {
   allMarkdown.data.allMarkdownRemark.edges.forEach(edge => {
     const slug = edge.node.fields.slug;
 
-    if (slug === '/index.html') {
-      createPage({
-        path: '/',
-        component: homeTemplate,
-        context: {
-          slug,
-        },
-      });
-    } else if (slug === 'docs/error-decoder.html') {
+    if (slug === 'docs/error-decoder.html') {
       // No-op so far as markdown templates go.
       // Error codes are managed by a page in src/pages
       // (which gets created by Gatsby during a separate phase).
@@ -210,7 +208,7 @@ exports.onCreateNode = ({node, boundActionCreators, getNode}) => {
       if (!slug) {
         slug = `/${relativePath.replace('.md', '.html')}`;
 
-        // This should (probably) only happen for the index.md,
+        // This should only happen for the partials in /content/home,
         // But let's log it in case it happens for other files also.
         console.warn(
           `Warning: No slug found for "${relativePath}". Falling back to default "${slug}".`,

gatsby-node.js

@@ -0,0 +1,28 @@
+const {readdirSync, readFileSync} = require('fs');
+const {join, resolve} = require('path');
+
+// Store code snippets in GraphQL for the home page examples.
+// Snippets will be matched with markdown templates of the same name.
+exports.sourceNodes = ({graphql, boundActionCreators}) => {
+  const {createNode} = boundActionCreators;
+
+  const path = resolve(__dirname, '../../content/home/examples');
+  const files = readdirSync(path);
+
+  files.forEach(file => {
+    if (file.match(/\.js$/)) {
+      const code = readFileSync(join(path, file), 'utf8');
+      const id = file.replace(/\.js$/, '');
+
+      createNode({
+        id,
+        children: [],
+        parent: 'EXAMPLES',
+        internal: {
+          type: 'ExampleCode',
+          contentDigest: JSON.stringify(code),
+        },
+      });
+    }
+  });
+};

plugins/gatsby-transformer-home-example-code/gatsby-node.js

@@ -0,0 +1,4 @@
+{
+  "name": "gatsby-transformer-home-example-code",
+  "version": "0.0.1"
+}