Merge pull request #6 from changkun/master

Optimize [excerpt] and add [cover/covers/pages] option

Author: yscoder

README.md

@@ -28,13 +28,15 @@ restful:
     comments: true
     path: true
     excerpt: false
+    cover: true
     content: false
     keywords: false
     categories: true
     tags: true
   categories: true  # 分类数据
   tags: true        # 标签数据
   post: true        # 文章数据
+  pages: false      # 额外的 Hexo 页面数据, 如 About
 ```
 
 ## Document
@@ -152,3 +154,19 @@ GET /api/articles/:Slug.json
 ###### Response
 
 [/api/articles/javascript-advanced-functions.json](http://www.imys.net/api/articles/javascript-advanced-functions.json)
+
+### Get Implecit Pages
+
+获取来自主题的 Hexo 隐式页面内容，如 About 等。因隐式页面（除 About 等导航栏入口页外）一般在 Hexo 不提供直接访问入口，调用此 API 的开发者需要了解其完整路径，此接口默认关闭。
+
+例如: 
+
+###### Request
+
+```
+GET /api/pages/about.json
+```
+
+###### Response
+
+格式类似于于 Get Post By Slug。

lib/generator.js

@@ -3,6 +3,26 @@
 var pagination = require('hexo-pagination');
 var _pick = require('lodash.pick');
 
+function filterHTMLTags(str) {
+    return str ? str
+            .replace(/\<(?!img|br).*?\>/g, "")
+            .replace(/\r?\n|\r/g, '')
+            .replace(/<img(.*)>/g, ' [Figure] ') : null
+}
+function fetchCovers(str) {
+    var temp,
+        imgURLs = [],
+        rex = /<img[^>]+src="?([^"\s]+)"(.*)>/g;
+    while ( temp = rex.exec( str ) ) {
+        imgURLs.push( temp[1] );
+    }
+    return imgURLs.length > 0 ? imgURLs : null;
+}
+function fetchCover(str) {
+    var covers = fetchCovers(str)
+    return covers ? covers[0] : null; 
+}
+
 module.exports = function (cfg, site) {
 
     var restful = cfg.hasOwnProperty('restful') ? cfg.restful :
@@ -15,6 +35,7 @@ module.exports = function (cfg, site) {
                 date: true,
                 updated: true,
                 comments: true,
+                cover: true,
                 path: true,
                 raw: false,
                 excerpt: false,
@@ -24,7 +45,8 @@ module.exports = function (cfg, site) {
             },
             categories: true,
             tags: true,
-            post: true
+            post: true,
+            pages: false,
         },
 
         posts = site.posts.sort('-date').filter(function (post) {
@@ -47,8 +69,9 @@ module.exports = function (cfg, site) {
                 updated: posts_props('updated', post.updated),
                 comments: posts_props('comments', post.comments),
                 path: posts_props('path', 'api/articles/' + post.slug + '.json'),
-                excerpt: posts_props('excerpt', post.excerpt),
+                excerpt: posts_props('excerpt', filterHTMLTags(post.excerpt)),
                 keywords: posts_props('keywords', cfg.keywords),
+                cover: posts_props('cover',  fetchCover(post.content)),
                 content: posts_props('content', post.content),
                 raw: posts_props('raw', post.raw),
                 categories: posts_props('categories', function () {
@@ -193,7 +216,8 @@ module.exports = function (cfg, site) {
                     updated: post.updated,
                     comments: post.comments,
                     path: path,
-                    excerpt: post.excerpt,
+                    excerpt: filterHTMLTags(post.excerpt),
+                    covers: fetchCovers(post.content),
                     keywords: cfg.keyword,
                     content: post.content,
                     categories: post.categories.map(function (cat) {
@@ -213,5 +237,26 @@ module.exports = function (cfg, site) {
         }));
     }
 
+    if (restful.pages) {
+        apiData = apiData.concat(site.pages.data.map(function (page) {
+            var safe_title = page.title.replace(/[^a-z0-9]/gi, '-').toLowerCase()
+            var path = 'api/pages/' + safe_title + '.json';
+
+            return {
+                path: path,
+                data: JSON.stringify({
+                    title: page.title,
+                    date: page.date,
+                    updated: page.updated,
+                    comments: page.comments,
+                    path: path,
+                    covers: fetchCovers(page.content),
+                    excerpt: filterHTMLTags(page.excerpt),
+                    content: page.content
+                })
+            };
+        }));
+    }
+
     return apiData;
 };