enable optional sidebar and anchor

Author: cvluca

contents/blog/first-blog.md

@@ -4,5 +4,6 @@ title: First Blog
 rootPage: /blog
 sidebar: Blog
 showTitle: true
+hideAnchor: true
 ---
 [Next Blog](/blog/second-blog)

contents/blog/second-blog.md

@@ -4,5 +4,6 @@ title: Second Blog
 rootPage: /blog
 sidebar: Blog
 showTitle: true
+hideAnchor: true
 ---
 [Previous Blog](/blog/first-blog)

contents/docs/guide/anchor.md

@@ -22,3 +22,7 @@ The anchor will be generated with different layers based on the size of the head
 Check the anchor on the right.
 
 #### The smaller heading
+
+## Hide Anchor
+
+The anchor can be hide by setting `hideAnchor` on the top of the markdown file (see [contents](/docs/guide/contents#information-of-the-page)).

contents/docs/guide/contents.md

@@ -2,6 +2,7 @@
 title: Contents
 sidebar: Docs
 showTitle: true
+hideAnchor: false
 ---
 ## Source of contents
 
@@ -23,11 +24,12 @@ The information of the page is stored on the top of the markdown files used to g
 
 * `title`: the title of the page
 * `showTitle`: show the title on the center at the beginning
-* `date`: the date created
 * `sidebar`: entry of the sidebar (see [sidebar](/docs/guide/sidebar)).
+* `hideAnchor`: hide anchor (false by default)
 
-You can add any additional information and querying with GraphQL. For blog in the example:
+If you use the default setting, you should have at least one file contains each setting. You can add any additional information and querying with GraphQL. For blog in the example:
 
+* `date`: the date created
 * `rootPage`: is used to filter the posts by the root page (i.e. [/blog](/blog))
 
 ### Example

contents/docs/guide/menu-items.md

@@ -16,7 +16,7 @@ See the current file. `Docs` is linked directly to the markdown page, and `Blog`
 ```sh
 # /src/menuItems/menuItems.json
 [
-  { 
+  {
     "name": "Docs",
     "link":  "/docs/get-started/introduction"
   },

contents/docs/guide/sidebar.md

@@ -85,3 +85,9 @@ The current page contains a multiple level of sidebar, and it's defined with thr
 If the root entry is `Docs`, the `child_entries` will be added as the SubMenus (i.e. `Get Started` and `Guide`).
 
 It is allowed to contains both `child_entries` and `items` in single entry object, and the posts (i.e. `items`) will be rendered before the SubMenus (i.e. `child_entries`) on the sidebar.
+
+The order of items in the sidebar is based on the order you defined in `child_entries` and `items` in this file.
+
+## Hide Sidebar
+
+If you do not add `sidebar` entry in the markdown file (see [contents](/docs/guide/contents#information-of-the-page)), or set it to null, the sidebar will be hided.

package-lock.json

@@ -6,15 +6,15 @@
   "dependencies": {
     "antd": "^3.23.2",
     "eslint-plugin-flowtype": "^2.50.3",
-    "gatsby": "^2.15.14",
+    "gatsby": "^2.15.15",
     "gatsby-cli": "^2.7.47",
-    "gatsby-image": "^2.2.18",
+    "gatsby-image": "^2.2.19",
     "gatsby-plugin-manifest": "^2.2.16",
     "gatsby-plugin-offline": "^2.2.10",
     "gatsby-plugin-react-helmet": "^3.1.7",
-    "gatsby-plugin-sharp": "^2.2.21",
+    "gatsby-plugin-sharp": "^2.2.22",
     "gatsby-remark-autolink-headers": "^2.1.10",
-    "gatsby-remark-images": "^3.1.21",
+    "gatsby-remark-images": "^3.1.22",
     "gatsby-remark-katex": "^3.1.8",
     "gatsby-source-filesystem": "^2.1.22",
     "gatsby-transformer-json": "^2.2.8",
@@ -43,8 +43,8 @@
   "devDependencies": {
     "gatsby-plugin-remove-trailing-slashes": "^2.1.6",
     "gh-pages": "^2.1.1",
-    "prettier": "^1.18.2",
-    "mem": ">=4.0.0"
+    "mem": "^5.1.1",
+    "prettier": "^1.18.2"
   },
   "repository": {
     "type": "git",

package.json

@@ -1,6 +1,7 @@
 // sidebar
 export const SET_SIDEBAR_OPEN = "SET_SIDEBAR_OPEN";
 export const SET_SIDEBAR_DOCKED = "SET_SIDEBAR_DOCKED";
+export const SET_SIDEBAR_HIDE = "SET_SIDEBAR_HIDE";
 
 // sidebar content
 export const SET_SIDEBAR_CONTENT_ENTRY = "SET_SIDEBAR_CONTENT_ENTRY";
@@ -10,6 +11,7 @@ export const ON_SIDEBAR_CONTENT_SELECTED = "ON_SIDEBAR_CONTENT_SELECTED";
 
 // anchor
 export const SET_ANCHOR_OPEN = "SET_ANCHOR_OPEN";
+export const SET_ANCHOR_HIDE = "SET_ANCHOR_HIDE";
 
 // menu
 export const ON_CHANGE_MENU_STATE = "ON_CHANGE_MENU_STATE";