directory-level configuration

Author: shigma

rfcs/001.blog-plugin.md

@@ -4,16 +4,16 @@
 
 # Summary
 
-- a new `@vuepress/plugin-blog`, featured with tags, categories, drafting, pagination
-- a `@vuepress/theme-plog`
+- `@vuepress/plugin-blog`, featured with tags, categories, drafting, pagination
+- `@vuepress/theme-plog`, featured with
 
 # Basic example
 
 See [detailed design](#detailed-design) section.
 
 # Motivation
 
-By popular demand, VuePress will provide some official blog supports, including a blog plugin and an atomic blog theme.
+With popular demand, VuePress will provide some official blog supports, including a blog plugin and an atomic blog theme.
 
 See: [#36](https://github.com/vuejs/vuepress/issues/36)
 
@@ -33,8 +33,8 @@ module.exports = {
       postsSorter(postA, postB) {
         // default: Array.prototype.sort
       },
-      perPagePosts: 10,
-      layout: 'Layout',
+      postsPerPage: 10,
+      layout: 'Pagination',
     },
   }
 }
@@ -69,24 +69,6 @@ And there are pages automatically generated:
 - /categories/
 - /categories/cat/
 
-### specify via config
-
-```js
-module.exports = {
-  themeConfig: {
-    directories: [
-      {
-        path: 'dog',
-        category: 'dog',
-        layout: 'DogLayout',
-      }
-    ]
-  }
-}
-```
-
-### prev/next pages
-
 If a post has its category, its previous/next page will be posts next to it under the same category.
 
 ## Drafting
@@ -97,20 +79,7 @@ draft: true
 ---
 ```
 
-And this page will only be rendered with dev mode. Drafting can also be specified via config:
-
-```js
-module.exports = {
-  themeConfig: {
-    directories: [
-      {
-        path: '_draft',
-        draft: true,
-      }
-    ]
-  }
-}
-```
+And this page will only be rendered with dev mode.
 
 ## Authoring
 
@@ -148,6 +117,28 @@ And there are pages automatically generated if there are more than one authors:
 - /authors/
 - /authors/Shigma/
 
+## Directory-level Configuration
+
+Drafting can also be specified via config:
+
+```js
+module.exports = {
+  themeConfig: {
+    directories: [
+      {
+        path: '_draft',
+        draft: true,
+      },
+      {
+        path: 'cat',
+        category: 'cat',
+        layout: 'CatLayout',
+      },
+    ]
+  }
+}
+```
+
 # Drawbacks
 
 N/A