md-import refactoring

Author: hoichi

.gitignore

@@ -0,0 +1,55 @@
+# Created by https://www.gitignore.io
+
+### WebStorm ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm
+
+*.iml
+
+## Directory-based project format:
+.idea/
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+
+
+### Node ###
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+node_modules

dist/index.html

@@ -436,6 +436,12 @@ <h2 class="List-Header">Testing / Lint / Quality checkers</h2>
             </header>
             <p class="List-Item-Description List-Item-Description--Short">Forbid the ES6 `class` keyword. [Why?](https://github.com/eslint/eslint/pull/2096#issuecomment-83044888)</p>
           </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://github.com/johnstonbl01/eslint-no-inferred-method-name">ESLint no-inferred-methodname</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">A custom rule for a common problem.</p>
+          </article>
           <article class="List-Item">
             <header class="List-Item-Header">
               <cite class="List-Item-Title"><a href="https://github.com/gotwarlost/istanbul">Istanbul</a></cite>
@@ -690,6 +696,12 @@ <h2 class="List-Header">React</h2>
             </header>
             <p class="List-Item-Description List-Item-Description--Short"></p>
           </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://medium.com/javascript-scene/jsx-looks-like-an-abomination-1c1ec351a918">JSX Looks Like an Abomination but it's Good for You</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">My take on JSX</p>
+          </article>
           <article class="List-Item">
             <header class="List-Item-Header">
               <cite class="List-Item-Title"><a href="https://www.youtube.com/watch?v=I7IdS-PbEgI&amp;list=PLb0IAmt7-GS1cbw4qonlQztYV1TAW0sCr">Immutable Data and React</a></cite>
@@ -720,6 +732,36 @@ <h2 class="List-Header">React</h2>
             </header>
             <p class="List-Item-Description List-Item-Description--Short"></p>
           </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://github.com/paypal/react-engine">react-engine</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">PayPal's isomorphic React view engine for Express or Kraken</p>
+          </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="http://projects.formidablelabs.com/radium/">Radium</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">Simplify inline styles</p>
+          </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://github.com/yannickcr/eslint-plugin-react">eslint-plugin-react</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short"></p>
+          </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://gaearon.github.io/react-hot-loader/">React Hot Loader</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">for Webpack</p>
+          </article>
+          <article class="List-Item">
+            <header class="List-Item-Header">
+              <cite class="List-Item-Title"><a href="https://github.com/milankinen/livereactload">livereactload</a></cite>
+            </header>
+            <p class="List-Item-Description List-Item-Description--Short">for Browserify</p>
+          </article>
         </div>
       </section>
       <section id="0011-Web-Components" class="List">

dist/js/vendor/jquery-1.11.2.min.js

@@ -8,12 +8,11 @@ var gulp = require('gulp'),
     path = require('path'),
     sass = require('gulp-sass'),
     sourcemaps = require('gulp-sourcemaps'),
-    watch = require('gulp-watch'),
-    yaml = require('read-yaml');
- 
+    watch = require('gulp-watch')
+
 var paths = {
   sass:         ['./src/sass/**/*.scss'],
-  static:       ['./src/static/*.*'],
+  assets:       ['./src/assets/*.*'],
   js:           ['./src/js/**/*.js'],
   dist:         './dist'
 };
@@ -35,15 +34,15 @@ gulp.task('sass', function () {
     .pipe( gulp.dest(path.join(paths.dist, 'css')) );
 });
 
-gulp.task('static', function() {
-  return gulp.src(paths.static)
+gulp.task('assets', function() {
+  return gulp.src(paths.assets)
     .pipe(gulp.dest(paths.dist));
 });
 
 gulp.task('templates', function() {
   return gulp.src('./src/jade/*.jade')
     .pipe(data( function(file) {
-        var json = require('./src/data/the-big-data.json');
+        var json = require('./src/data/essential-javascript-links.json');
         json._ = lodash;
         return json;
       } ))
@@ -57,13 +56,13 @@ gulp.task('js', function() {
 });
 
 gulp.task('deploy', function() {
- ghPages.publish(paths.dist);
+  ghPages.publish(paths.dist);
 });
 
 // Rerun the task when a file changes
 gulp.task('watch', function() {
-  gulp.watch('./src/**/*', ['sass', 'static', 'templates', 'js']);
+  gulp.watch('./src/**/*', ['sass', 'assets', 'templates', 'js']);
 });
 
 // The default task (called when you run `gulp` from cli)
-gulp.task('default', ['sass', 'static', 'templates', 'js']);
+gulp.task('default', ['sass', 'assets', 'templates', 'js']);

gulpfile.js

@@ -3,7 +3,8 @@
   "version": "0.0.1",
   "description": "Essential JavaScript Links website.",
   "scripts": {
-    "cleanup": "cat README.md | node scripts/cleanup.js > build/README.md"
+    "cleanup": "cat README.md | node scripts/cleanup.js > build/README.md",
+    "md-import": "node scripts/md-import.js src/data/essential-javascript-links.md src/data/essential-javascript-links.json src/data/theBookData.json theBookData"
   },
   "engines": {
     "node": "0.10.x"
@@ -23,18 +24,15 @@
   },
   "devDependencies": {
     "autoprefixer-core": "^5.1.10",
+    "gh-pages": "^0.3.0",
     "gulp": "^3.8.11",
     "gulp-data": "^1.2.0",
-    "gulp-gh-pages": "^0.5.1",
     "gulp-jade": "^1.0.0",
     "gulp-postcss": "^5.1.3",
     "gulp-print": "^1.1.0",
     "gulp-sass": "^1.3.3",
     "gulp-sourcemaps": "^1.5.1",
     "gulp-watch": "^4.2.4",
-    "gulp-yaml": "^0.2.4",
-    "js-yaml": "^3.3.0",
-    "node-sass": "^2.1.1",
-    "read-yaml": "^1.0.0"
+    "node-sass": "^2.1.1"
   }
 }

package.json

@@ -1,15 +1,22 @@
 var fs = require('fs'),
-		md = require('markdown').markdown;
+    path = require('path');
 
-var markdownPath = 'essential-javascript-links.md',
-    moreMetaData = {
-      path: 'theBookData.json',
-      id: 'theBookData'
-    },
-    jsonOutPath = 'the-big-data.json';
+var argv = process.argv,
+    markdownPath, jsonOutPath, moreMetaData;
+
+if ( !(markdownPath = argv[2]) ||
+     !(jsonOutPath = argv[3]) )
+  return console.error('Usage: <source.md> <destination.json> [<data-to-merge.json> [varInTheMergeData]]');
+
+if (argv[4])
+  moreMetaData = {
+    path: argv[4],
+    id: argv[5] || path.base(argv[4], '.json')
+  };
 
 fs.readFile(markdownPath, {encoding: 'UTF-8', flag: 'r'}, function (err, data) {
-	if (err) return;
+	if (err)
+    return console.error('Couldn\'t open ' + path.resolve(markdownPath));
 
   var allLinks = [],
       categories = [];
@@ -20,10 +27,21 @@ fs.readFile(markdownPath, {encoding: 'UTF-8', flag: 'r'}, function (err, data) {
       currentMeta = {},
       currentMetaIndex = {};
 
-  moreMeta = JSON.parse(fs.readFileSync(moreMetaData.path, 'utf8'))[moreMetaData.id];
-  moreMeta.forEach(function(el) {
-    moreMetaIndex[el.title] = el.items;
-  });
+  if (moreMetaData) {
+    try {
+      var moreMetaString = fs.readFileSync(moreMetaData.path, 'utf8');
+    }
+    catch (e) {
+      return console.error('Couldn\'t open ' + path.resolve(moreMetaData.path));
+    }
+
+    if (!(moreMeta = JSON.parse(moreMetaString)[moreMetaData.id]))
+      return console.error('Couln\'t get a value of ' + moreMetaData.id + ' from ' + moreMetaData.path);
+
+    moreMeta.forEach(function(el) {
+      moreMetaIndex[el.title] = el.items;
+    });
+  }
 
 	data.split(/\r?\n/).forEach( function(line) {
     var match;
@@ -46,8 +64,9 @@ fs.readFile(markdownPath, {encoding: 'UTF-8', flag: 'r'}, function (err, data) {
         short_description: match[4],
         categories: [currentCategory]
       };
-      enhanceMeta(current, currentMetaIndex[current.title]);
-//      current.rank = current.rank || 0; // no rank? end of the line for you.
+
+      if (moreMetaData)
+        enhanceMeta(current, currentMetaIndex[current.title]);
       allLinks.push(current);
     }
 
@@ -78,5 +97,8 @@ fs.readFile(markdownPath, {encoding: 'UTF-8', flag: 'r'}, function (err, data) {
   });
 
   var theBigString = JSON.stringify({allTheLinks: allLinks, linkCategories: categories}, null, 2);
-  fs.writeFile(jsonOutPath, theBigString);
+  fs.writeFile(jsonOutPath, theBigString, function(err){
+    if (err)
+      console.error('Couldn\'t write' + path.resolve(jsonOutPath));
+  });
 });