fix for issue #385 - support foo.md inside _annotations

* read in *.md files ( not recursive )
* clobber annotations and write
* satisfies existing tests

Author: tevio

core/lib/annotation_exporter.js

@@ -1,6 +1,7 @@
 "use strict";
 
 var path = require('path'),
+  readDir = require('readdir'),
   fs = require('fs-extra'),
   JSON5 = require('json5'),
   _ = require('lodash'),
@@ -42,32 +43,35 @@ var annotations_exporter = function (pl) {
   function parseAnnotationsMD() {
     var markdown_parser = new mp();
     var annotations = [];
-
-    //attempt to read the file
-    var annotationsMD = '';
-    try {
-      annotationsMD = fs.readFileSync(path.resolve(paths.source.annotations, 'annotations.md'), 'utf8');
-    } catch (ex) {
-      if (pl.config.debug) {
-        console.log('annotations.md file missing from ' + paths.source.annotations + '. This may be expected.');
+    var mdFiles = readDir.readSync(paths.source.annotations, ['*.md'])
+
+    mdFiles.forEach(function (file) {
+      var annotationsMD = '';
+      try {
+        annotationsMD = fs.readFileSync(path.resolve(paths.source.annotations, file), 'utf8');
+      } catch (ex) {
+        if (pl.config.debug) {
+          console.log('annotations.md file missing from ' + paths.source.annotations + '. This may be expected.');
+        }
+        return [];
       }
-      return [];
-    }
 
     //take the annotation snippets and split them on our custom delimiter
-    var annotationsYAML = annotationsMD.split('~*~');
+      var annotationsYAML = annotationsMD.split('~*~');
 
-    for (var i = 0; i < annotationsYAML.length; i++) {
-      var annotation = {};
+      for (var i = 0; i < annotationsYAML.length; i++) {
+        var annotation = {};
 
-      var markdownObj = markdown_parser.parse(annotationsYAML[i]);
+        var markdownObj = markdown_parser.parse(annotationsYAML[i]);
 
-      annotation.el = markdownObj.el || markdownObj.selector;
-      annotation.title = markdownObj.title;
-      annotation.comment = markdownObj.markdown;
+        annotation.el = markdownObj.el || markdownObj.selector;
+        annotation.title = markdownObj.title;
+        annotation.comment = markdownObj.markdown;
 
-      annotations.push(annotation);
-    }
+        annotations.push(annotation);
+      }
+      return false;
+    })
     return annotations;
   }
 

package.json

@@ -17,7 +17,8 @@
     "grunt": "~1.0.1",
     "grunt-contrib-concat": "^1.0.1",
     "grunt-contrib-nodeunit": "^1.0.0",
-    "grunt-eslint": "^18.0.0"
+    "grunt-eslint": "^18.0.0",
+    "readdir": "0.0.13"
   },
   "keywords": [
     "Pattern Lab",
@@ -37,7 +38,7 @@
   },
   "contributors": [
     {
-      "name" : "Geoff Pursell"
+      "name": "Geoff Pursell"
     }
   ],
   "license": "MIT",

test/files/annotations.md

@@ -10,9 +10,3 @@ selector: .logo
 title: Logo
 ---
 The _logo image_ is an SVG file.
-~*~
----
-el: #nav
-title : Navigation
----
-Navigation for adaptive web experiences can be tricky. Refer to [these repsonsive patterns](https://bradfrost.github.io/this-is-responsive/patterns.html#navigation) when evaluating solutions.

test/files/nav.md

@@ -0,0 +1,6 @@
+---
+el: #nav
+title : Navigation
+---
+Navigation for adaptive web experiences can be tricky. Refer to [these repsonsive patterns](https://bradfrost.github.io/this-is-responsive/patterns.html#navigation) when evaluating solutions.
+