From e71b4d902ee54474ca5a85281b2646ee2ef49b31 Mon Sep 17 00:00:00 2001
From: Eric Nakagawa <ericnakagawa@gmail.com>
Date: Mon, 25 Sep 2017 11:26:15 -0700
Subject: [PATCH 1/3] Provide a more useful error in event someone tries to
 build site but hasn't provided localized files

---
 lib/core/nav/HeaderNav.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lib/core/nav/HeaderNav.js b/lib/core/nav/HeaderNav.js
index 75b0e0f9fb..9276b3d910 100644
--- a/lib/core/nav/HeaderNav.js
+++ b/lib/core/nav/HeaderNav.js
@@ -136,6 +136,13 @@ class HeaderNav extends React.Component {
           link.doc;
       }
       if (!Metadata[id]) {
+        if (id != link.doc) {
+          throw new Error(
+            "It looks like you've enabled language support, but haven't provided translated files. The document with id: '" +
+              id +
+              "' doesn't exist."
+          );
+        }
         throw new Error(
           "A headerLink is specified with a document that does not exist. No document exists with id: " +
             link.doc

From a86af92e7c33d97435da7670d89aa58f905d84a0 Mon Sep 17 00:00:00 2001
From: Eric Nakagawa <ericnakagawa@gmail.com>
Date: Mon, 25 Sep 2017 11:34:57 -0700
Subject: [PATCH 2/3] Remove customCssFileName as any css file in /static/css
 gets appended to end of main.css

---
 examples/basics/siteConfig.js | 2 --
 lib/core/Head.js              | 5 -----
 website/siteConfig.js         | 1 -
 3 files changed, 8 deletions(-)

diff --git a/examples/basics/siteConfig.js b/examples/basics/siteConfig.js
index 2f93a1713f..accc9e4abf 100644
--- a/examples/basics/siteConfig.js
+++ b/examples/basics/siteConfig.js
@@ -34,8 +34,6 @@ const siteConfig = {
   headerIcon: "img/docusaurus.svg",
   footerIcon: "img/docusaurus.svg",
   favicon: "img/favicon.png",
-  /* the name of your custom css file that resides in static/css/ */ 
-  // customCssFileName: "custom.css",
   /* colors for website */
   colors: {
     primaryColor: "#2E8555",
diff --git a/lib/core/Head.js b/lib/core/Head.js
index 9135b29bd7..983591e6b2 100644
--- a/lib/core/Head.js
+++ b/lib/core/Head.js
@@ -43,11 +43,6 @@ class Head extends React.Component {
           rel="stylesheet"
           href={this.props.config.baseUrl + "css/main.css"}
         />
-        {this.props.config.customCssFileName &&
-          <link
-            rel="stylesheet"
-            href={this.props.config.baseUrl + "css/" + this.props.config.customCssFileName}
-          />}
         <script async defer src="https://buttons.github.io/buttons.js" />
       </head>
     );
diff --git a/website/siteConfig.js b/website/siteConfig.js
index 4b18ce23db..ddc92fb176 100644
--- a/website/siteConfig.js
+++ b/website/siteConfig.js
@@ -58,7 +58,6 @@ const siteConfig = {
     apiKey: "3eb9507824b8be89e7a199ecaa1a9d2c",
     indexName: "docusaurus"
   },
-  customCssFileName: "custom.css", //the name of your custom css file
   colors: {
     primaryColor: "#2E8555",
     secondaryColor: "#205C3B",

From b241ed440495c7d22f922c0bfbbfc441322f3a1e Mon Sep 17 00:00:00 2001
From: Eric Nakagawa <ericnakagawa@gmail.com>
Date: Mon, 25 Sep 2017 12:11:37 -0700
Subject: [PATCH 3/3] Prints an console error if /blog/ folder has no files.

---
 lib/server/readMetadata.js | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/lib/server/readMetadata.js b/lib/server/readMetadata.js
index 10a7a9739e..8b83f203c2 100644
--- a/lib/server/readMetadata.js
+++ b/lib/server/readMetadata.js
@@ -12,6 +12,7 @@ const CWD = process.cwd();
 const path = require("path");
 const fs = require("fs");
 const glob = require("glob");
+const chalk = require("chalk");
 const siteConfig = require(CWD + "/siteConfig.js");
 const versionFallback = require("./versionFallback.js");
 
@@ -271,6 +272,13 @@ function generateBlogMetadata() {
   const metadatas = [];
 
   let files = glob.sync(CWD + "/blog/**/*.*");
+  if (!files || files.length == 0) {
+    console.error(
+      `${chalk.yellow(
+        CWD + "/blog/ appears to be empty"
+      )} Make sure you've put your blog files in your Docusaurus 'website' folder.`
+    );
+  }
   files.sort().reverse().forEach(file => {
     const extension = path.extname(file);
     if (extension !== ".md" && extension !== ".markdown") {