Update example files and examples script

examples/basics/blog-examples-from-docusaurus/2016-03-11-blog-post.md

@@ -2,7 +2,7 @@
 title: Blog Title
 author: Blog Author
 authorURL: http://twitter.com/
-authorFBID: 0
+authorFBID: 100002976521003
 ---
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus elementum massa eget nulla aliquet sagittis. Proin odio tortor, vulputate ut odio in, ultrices ultricies augue. Cras ornare ultrices lorem malesuada iaculis. Etiam sit amet libero tempor, pulvinar mauris sed, sollicitudin sapien.
@@ -15,4 +15,4 @@ Nulla facilisi. Maecenas sodales nec purus eget posuere. Sed sapien quam, pretiu
 
 Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin venenatis lectus dui, vel ultrices ante bibendum hendrerit. Aenean egestas feugiat dui id hendrerit. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Curabitur in tellus laoreet, eleifend nunc id, viverra leo. Proin vulputate non dolor vel vulputate. Curabitur pretium lobortis felis, sit amet finibus lorem suscipit ut. Sed non mollis risus. Duis sagittis, mi in euismod tincidunt, nunc mauris vestibulum urna, at euismod est elit quis erat. Phasellus accumsan vitae neque eu placerat. In elementum arcu nec tellus imperdiet, eget maximus nulla sodales. Curabitur eu sapien eget nisl sodales fermentum.
 
-Phasellus pulvinar ex id commodo imperdiet. Praesent odio nibh, sollicitudin sit amet faucibus id, placerat at metus. Donec vitae eros vitae tortor hendrerit finibus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Quisque vitae purus dolor. Duis suscipit ac nulla et finibus. Phasellus ac sem sed dui dictum gravida. Phasellus eleifend vestibulum facilisis. Integer pharetra nec enim vitae mattis. Duis auctor, lectus quis condimentum bibendum, nunc dolor aliquam massa, id bibendum orci velit quis magna. Ut volutpat nulla nunc, sed interdum magna condimentum non. Sed urna metus, scelerisque vitae consectetur a, feugiat quis magna. Donec dignissim ornare nisl, eget tempor risus malesuada quis.
+Phasellus pulvinar ex id commodo imperdiet. Praesent odio nibh, sollicitudin sit amet faucibus id, placerat at metus. Donec vitae eros vitae tortor hendrerit finibus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Quisque vitae purus dolor. Duis suscipit ac nulla et finibus. Phasellus ac sem sed dui dictum gravida. Phasellus eleifend vestibulum facilisis. Integer pharetra nec enim vitae mattis. Duis auctor, lectus quis condimentum bibendum, nunc dolor aliquam massa, id bibendum orci velit quis magna. Ut volutpat nulla nunc, sed interdum magna condimentum non. Sed urna metus, scelerisque vitae consectetur a, feugiat quis magna. Donec dignissim ornare nisl, eget tempor risus malesuada quis.

examples/basics/blog-examples-from-docusaurus/2017-04-10-blog-post-two.md

@@ -2,7 +2,7 @@
 title: New Blog Post
 author: Blog Author
 authorURL: http://twitter.com/
-authorFBID: 0
+authorFBID: 100002976521003
 ---
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus elementum massa eget nulla aliquet sagittis. Proin odio tortor, vulputate ut odio in, ultrices ultricies augue. Cras ornare ultrices lorem malesuada iaculis. Etiam sit amet libero tempor, pulvinar mauris sed, sollicitudin sapien.
@@ -15,4 +15,4 @@ Nulla facilisi. Maecenas sodales nec purus eget posuere. Sed sapien quam, pretiu
 
 Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin venenatis lectus dui, vel ultrices ante bibendum hendrerit. Aenean egestas feugiat dui id hendrerit. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Curabitur in tellus laoreet, eleifend nunc id, viverra leo. Proin vulputate non dolor vel vulputate. Curabitur pretium lobortis felis, sit amet finibus lorem suscipit ut. Sed non mollis risus. Duis sagittis, mi in euismod tincidunt, nunc mauris vestibulum urna, at euismod est elit quis erat. Phasellus accumsan vitae neque eu placerat. In elementum arcu nec tellus imperdiet, eget maximus nulla sodales. Curabitur eu sapien eget nisl sodales fermentum.
 
-Phasellus pulvinar ex id commodo imperdiet. Praesent odio nibh, sollicitudin sit amet faucibus id, placerat at metus. Donec vitae eros vitae tortor hendrerit finibus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Quisque vitae purus dolor. Duis suscipit ac nulla et finibus. Phasellus ac sem sed dui dictum gravida. Phasellus eleifend vestibulum facilisis. Integer pharetra nec enim vitae mattis. Duis auctor, lectus quis condimentum bibendum, nunc dolor aliquam massa, id bibendum orci velit quis magna. Ut volutpat nulla nunc, sed interdum magna condimentum non. Sed urna metus, scelerisque vitae consectetur a, feugiat quis magna. Donec dignissim ornare nisl, eget tempor risus malesuada quis.
+Phasellus pulvinar ex id commodo imperdiet. Praesent odio nibh, sollicitudin sit amet faucibus id, placerat at metus. Donec vitae eros vitae tortor hendrerit finibus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Quisque vitae purus dolor. Duis suscipit ac nulla et finibus. Phasellus ac sem sed dui dictum gravida. Phasellus eleifend vestibulum facilisis. Integer pharetra nec enim vitae mattis. Duis auctor, lectus quis condimentum bibendum, nunc dolor aliquam massa, id bibendum orci velit quis magna. Ut volutpat nulla nunc, sed interdum magna condimentum non. Sed urna metus, scelerisque vitae consectetur a, feugiat quis magna. Donec dignissim ornare nisl, eget tempor risus malesuada quis.

examples/basics/pages/en/help.js

@@ -16,6 +16,7 @@ const GridBlock = CompLibrary.GridBlock;
 const siteConfig = require(process.cwd() + "/siteConfig.js");
 
 class Help extends React.Component {
+
   render() {
     const supportLinks = [
       {
@@ -49,8 +50,4 @@ class Help extends React.Component {
   }
 }
 
-Help.defaultProps = {
-  language: "en"
-};
-
 module.exports = Help;

examples/basics/pages/en/index.js

@@ -44,7 +44,9 @@ class HomeSplash extends React.Component {
             <div className="inner">
               <h2 className="projectTitle">
                 {siteConfig.title}
-                <small>{siteConfig.tagline}</small>
+                <small>
+                  {siteConfig.tagline}
+                </small>
               </h2>
               <div className="section promoSection">
                 <div className="promoRow">
@@ -52,14 +54,20 @@ class HomeSplash extends React.Component {
                     <Button href="#try">Try It Out</Button>
                     <Button
                       href={
-                        siteConfig.baseUrl + "docs/" + this.props.language + "/doc1.html"
+                        siteConfig.baseUrl +
+                        "docs/" +
+                        this.props.language +
+                        "/doc1.html"
                       }
                     >
                       Example Link
                     </Button>
                     <Button
                       href={
-                        siteConfig.baseUrl + "docs/" + this.props.language + "/doc2.html"
+                        siteConfig.baseUrl +
+                        "docs/" +
+                        this.props.language +
+                        "/doc2.html"
                       }
                     >
                       Example Link 2
@@ -177,9 +185,8 @@ class Index extends React.Component {
                 href={
                   siteConfig.baseUrl + this.props.language + "/" + "users.html"
                 }
-                target="_self"
               >
-                More "Docusaurus" Users
+                More Docusaurus Users
               </a>
             </div>
           </div>

examples/basics/pages/en/users.js

@@ -49,8 +49,4 @@ class Users extends React.Component {
   }
 }
 
-Users.defaultProps = {
-  language: "en"
-};
-
 module.exports = Users;

examples/basics/siteConfig.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2017-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree. An additional grant
+ * of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+/* List of projects/orgs using your project for the users page */
+const users = [
+  {
+    caption: "User1",
+    image: "/test-site/img/docusaurus.svg",
+    infoLink: "https://www.example.com",
+    pinned: true
+  }
+];
+
+const siteConfig = {
+  title: "Test Site" /* title for your website */,
+  tagline: "A website for testing",
+  url: "https://deltice.github.io" /* your github url */,
+  baseUrl: "/test-site/" /* base url for your project */,
+  projectName: "test-site",
+  headerLinks: [
+    { doc: "doc1", label: "Docs" },
+    { doc: "doc4", label: "API" },
+    { page: "help", label: "Help" },
+    { blog: true, label: "Blog" }
+  ],
+  users,
+  /* path to images for header/footer */
+  headerIcon: "img/docusaurus.svg",
+  footerIcon: "img/docusaurus.svg",
+  favicon: "img/favicon.png",
+  /* colors for website */
+  colors: {
+    primaryColor: "#2E8555",
+    secondaryColor: "#205C3B",
+    prismColor:
+      "rgba(46, 133, 85, 0.03)" /* primaryColor in rgba form, with 0.03 alpha */
+  }
+};
+
+module.exports = siteConfig;

examples/siteConfig.js

@@ -1,74 +0,0 @@
-/**
- * Copyright (c) 2017-present, Facebook, Inc.
- * All rights reserved.
- *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
- */
-
-/* List of projects/orgs using your project for the users page */
-const users = [
-  {
-    caption: "User1",
-    image: "/test-site/img/docusaurus.svg",
-    infoLink: "https://www.example.com",
-    pinned: true
-  }
-];
-
-const siteConfig = {
-  title: "Test Site" /* title for your website */,
-  url: "https://deltice.github.io" /* your github url */,
-  baseUrl: "/test-site/" /* base url for your project */,
-  projectName: "test-site",
-  repo: "deltice/test-site" /* repo for your project */,
-  users,
-  /* base url for editing docs, usage example: editUrl + 'en/doc1.md' */
-  editUrl: "https://github.com/deltice/test-site/edit/master/docs/",
-  /* header links for links on this site, 'LANGUAGE' will be replaced by whatever
-     language the page is for, ex: 'en' */
-  headerLinksInternal: [
-    {
-      section: "docs",
-      href: "/test-site/docs/LANGUAGE/doc1.html",
-      text: "Docs"
-    },
-    { section: "api", href: "/test-site/docs/LANGUAGE/doc4.html", text: "API" },
-    { section: "help", href: "/test-site/LANGUAGE/help.html", text: "Help" },
-    { section: "blog", href: "/test-site/blog", text: "Blog" }
-  ],
-  /* header links for links outside the site */
-  headerLinksExternal: [
-    {
-      section: "github",
-      href: "https://github.com/deltice/test-site",
-      text: "GitHub"
-    }
-  ],
-  /* path to images for header/footer */
-  headerIcon: "img/docusaurus.svg",
-  disableHeaderTitle: false /* disable title text in header (only show headerIcon) */,
-  footerIcon: "img/docusaurus.svg",
-  favicon: "img/favicon.png",
-  /* colors for website */
-  colors: {
-    primaryColor: "#2E8555",
-    secondaryColor: "#205C3B",
-    prismColor:
-      "rgba(46, 133, 85, 0.03)" /* primaryColor in rgba form, with 0.03 alpha */
-  },
-  tagline: "My Tagline",
-  recruitingLink:
-    "https://crowdin.com/project/test-site" /* translation site "help translate" link */,
-  /* remove this section to disable search bar */
-  algolia: {
-    apiKey:
-      "0f9f28b9ab9efae89810921a351753b5" /* use your search-only api key */,
-    indexName: "github"
-  }
-  /* remove this to disable google analytics tracking */
-  /* gaTrackingId: "" */
-};
-
-module.exports = siteConfig;

examples/translations/crowdin.yaml

@@ -6,7 +6,7 @@ preserve_hierarchy: true
 files:
   -
     source: '/docs/en/*.md'
-    translation: '/docs/%locale%/%original_file_name%'
+    translation: '/website/translated_docs/%locale%/%original_file_name%'
     languages_mapping: &anchor
       locale:
         'af': 'af'

examples/versions/pages/en/versions.js

@@ -0,0 +1,92 @@
+const React = require("react");
+
+const CompLibrary = require("../../core/CompLibrary");
+const Container = CompLibrary.Container;
+const GridBlock = CompLibrary.GridBlock;
+
+const CWD = process.cwd();
+
+const siteConfig = require(CWD + "/siteConfig.js");
+const versions = require(CWD + "/versions.json");
+
+class Versions extends React.Component {
+  render() {
+    const latestVersion = versions[0];
+    return (
+      <div className="docMainWrapper wrapper">
+        <Container className="mainContainer versionsContainer">
+          <div className="post">
+            <header className="postHeader">
+              <h2>{siteConfig.title + " Versions"}</h2>
+            </header>
+            <p>New versions of this project are released every so often.</p>
+            <a name="latest" />
+            <h3>Current version (Stable)</h3>
+            <table className="versions">
+              <tbody>
+                <tr>
+                  <th>
+                    {latestVersion}
+                  </th>
+                  <td>
+                    <a href={""}>Documentation</a>
+                  </td>
+                  <td>
+                    <a href={""}>Release Notes</a>
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+            <p>
+              This is the version that is configured automatically when you
+              first install this project.
+            </p>
+            <a name="rc" />
+            <h3>Pre-release versions</h3>
+            <table className="versions">
+              <tbody>
+                <tr>
+                  <th>master</th>
+                  <td>
+                    <a href={""}>Documentation</a>
+                  </td>
+                  <td>
+                    <a href={""}>Release Notes</a>
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+            <p>Other text describing this section.</p>
+            <a name="archive" />
+            <h3>Past Versions</h3>
+            <table className="versions">
+              <tbody>
+                {versions.map(
+                  version =>
+                    version !== latestVersion &&
+                    <tr>
+                      <th>
+                        {version}
+                      </th>
+                      <td>
+                        <a href={""}>Documentation</a>
+                      </td>
+                      <td>
+                        <a href={""}>Release Notes</a>
+                      </td>
+                    </tr>
+                )}
+              </tbody>
+            </table>
+            <p>
+              You can find past versions of this project{" "}
+              <a href="https://github.com/"> on GitHub </a>.
+            </p>
+          </div>
+        </Container>
+      </div>
+    );
+  }
+}
+
+module.exports = Versions;

lib/copy-examples.js

@@ -13,34 +13,176 @@ const CWD = process.cwd();
 const fs = require("fs-extra");
 const path = require("path");
 const glob = require("glob");
+const chalk = require("chalk");
 
-let examplesFolder = "examples";
+let feature;
-if (process.argv.indexOf("translations") !== -1) {
+
-  examplesFolder = "examples-translations";
+const program = require("commander");
-}
+program
-const files = glob.sync(path.join(__dirname, "..", examplesFolder, "**"));
+  .arguments("[feature]")
-files.forEach(file => {
+  .action(feat => {
-  if (!fs.lstatSync(file).isDirectory()) {
+    feature = feat;
-    let target = CWD;
+  })
-    if (file.includes("-examples")) {
+  .parse(process.argv);
-      target = path.join(CWD, "..");
+
-    }
+const outerFolder = path.basename(path.dirname(CWD));
-    let fileName = file.substring(
+if (feature === "translations") {
-      file.indexOf(examplesFolder) + examplesFolder.length
+  const folder = path.join(__dirname, "..", "examples", "translations");
+  if (fs.existsSync(CWD + "/../crowdin.yaml")) {
+    console.log(
+      `${chalk.yellow("crowdin.yaml already exists")} in ${chalk.yellow(
+        outerFolder + "/"
+      )}. Rename or remove the file to regenerate an example version.\n`
     );
+  } else {
+    fs.copySync(folder + "/crowdin.yaml", CWD + "/../crowdin.yaml");
+    console.log(
+      `${chalk.green("Example crowdin.yaml file created")} in ${chalk.yellow(
+        outerFolder + "/"
+      )}.\n`
+    );
+  }
+  let files = glob.sync(folder + "/**/*");
+  files.forEach(file => {
+    if (fs.lstatSync(file).isDirectory()) {
+      return;
+    }
+    if (path.basename(file) === "crowdin.yaml") {
+      return;
+    }
+    const filePath = file.split(folder)[1];
     try {
-      fs.copySync(file, path.join(target, fileName), {
+      fs.copySync(file, CWD + filePath, {
         overwrite: false,
         errorOnExist: true
       });
-      console.log(fileName + " created in " + path.basename(target));
+      console.log(
+        `${chalk.green(
+          "Example " + path.basename(filePath) + " file created"
+        )} in ${chalk.yellow(
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}.\n`
+      );
     } catch (e) {
       console.log(
-        fileName +
+        `${chalk.yellow(
-          " already exists in " +
+          path.basename(filePath) + " already exists"
-          path.basename(target) +
+        )} in ${chalk.yellow(
-          ". Remove or rename the file to regenerate this example file."
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}. Rename or remove the file to regenerate an example version.\n`
       );
     }
+  });
+} else if (feature === "versions") {
+  const folder = path.join(__dirname, "..", "examples", "versions");
+  let files = glob.sync(folder + "/**/*");
+  files.forEach(file => {
+    if (fs.lstatSync(file).isDirectory()) {
+      return;
+    }
+    const filePath = file.split(folder)[1];
+    try {
+      fs.copySync(file, CWD + filePath, {
+        overwrite: false,
+        errorOnExist: true
+      });
+      console.log(
+        `${chalk.green(
+          "Example " + path.basename(filePath) + " file created"
+        )} in ${chalk.yellow(
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}.\n`
+      );
+    } catch (e) {
+      console.log(
+        `${chalk.yellow(
+          path.basename(filePath) + " already exists"
+        )} in ${chalk.yellow(
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}. Rename or remove the file to regenerate an example version.\n`
+      );
+    }
+  });
+} else {
+  const folder = path.join(__dirname, "..", "examples", "basics");
+  // copy docs examples
+  if (fs.existsSync(CWD + "/../docs-examples-from-docusaurus")) {
+    console.log(
+      `${chalk.yellow(
+        "Example docs already exist!"
+      )} Rename or remove ${chalk.yellow(
+        outerFolder + "/docs-examples-from-docusaurus"
+      )} to regenerate example docs.\n`
+    );
+  } else {
+    fs.copySync(
+      folder + "/docs-examples-from-docusaurus",
+      CWD + "/../docs-examples-from-docusaurus"
+    );
+    console.log(
+      `${chalk.green("Example docs created")} in ${chalk.yellow(
+        outerFolder + "/docs-examples-from-docusaurus"
+      )}! Rename the folder to ${chalk.yellow(
+        outerFolder + "/docs"
+      )} to see the example docs on your site.\n`
+    );
   }
-});
+  // copy blog examples
+  if (fs.existsSync(CWD + "/blog-examples-from-docusaurus")) {
+    console.log(
+      `${chalk.yellow(
+        "Example blog posts already exist!"
+      )} Rename or remove ${chalk.yellow(
+        outerFolder + "/website/blog-examples-from-docusaurus"
+      )} to regenerate example blog posts.\n`
+    );
+  } else {
+    fs.copySync(
+      path.join(folder, "blog-examples-from-docusaurus"),
+      path.join(CWD, "blog-examples-from-docusaurus")
+    );
+    console.log(
+      `${chalk.green("Example blog posts created")} in ${chalk.yellow(
+        outerFolder + "/website/blog-examples-from-docusaurus"
+      )}! Rename the folder to ${chalk.yellow(
+        outerFolder + "/website/blog"
+      )} to see the example blog posts on your site.\n`
+    );
+  }
+  // copy other files
+  let files = glob.sync(folder + "/**/*");
+  files.forEach(file => {
+    if (fs.lstatSync(file).isDirectory()) {
+      return;
+    }
+    const containingFolder = path.basename(path.dirname(file));
+    if (
+      containingFolder === "blog-examples-from-docusaurus" ||
+      containingFolder === "docs-examples-from-docusaurus"
+    ) {
+      return;
+    }
+    const filePath = file.split(folder)[1];
+    try {
+      fs.copySync(file, CWD + filePath, {
+        overwrite: false,
+        errorOnExist: true
+      });
+      console.log(
+        `${chalk.green(
+          "Example " + path.basename(filePath) + " file created"
+        )} in ${chalk.yellow(
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}.\n`
+      );
+    } catch (e) {
+      console.log(
+        `${chalk.yellow(
+          path.basename(filePath) + " already exists"
+        )} in ${chalk.yellow(
+          "website" + filePath.split(path.basename(filePath))[0]
+        )}. Rename or remove the file to regenerate an example version.\n`
+      );
+    }
+  });
+}

package.json

@@ -11,6 +11,7 @@
     "babel-register": "^6.24.1",
     "babel-traverse": "^6.25.0",
     "babylon": "^6.17.4",
+    "chalk": "^2.1.0",
     "classnames": "^2.2.5",
     "commander": "^2.11.0",
     "diff": "^3.3.0",