package.json: update

jekyll-github.md

@@ -29,7 +29,7 @@ Jekyll
 * jekyll-sitemap
 {: .-four-column}
 
-As of github-pages v156.
+As of github-pages v156. For an updated list, see: [Dependency versions](https://pages.github.com/versions/) _(pages.github.com)_
 
 GitHub Metadata
 ---------------

package.json.md

@@ -2,64 +2,80 @@
 title: package.json
 category: Node.js
 layout: 2017/sheet
-redirect_from:
+prism_languages: [json]
-- /package.html
+updated: 201708.30
-- /package
+weight: -3
 ---
 
 ### Basic
 
-    {
+```json
-      "name": "expo",
+{
-      "description": "",
+  "name": "expo",
-      "keywords": [""],
+  "description": "My package",
-      "author": "Rico Sta. Cruz <hi@ricostacruz.com>",
+  "version": "0.1.0",
-      "version": "0.1.0",
+  "license": "MIT",
-      "engines": {
+  "keywords": ["http", "server"],
-        "node": ">=0.8.0"
+  "author": "Rico Sta. Cruz <hi@ricostacruz.com>",
-      },
+  "engines": {
-      "main": "index",
+    "node": ">=0.8.0"
-      "bin": {
+  },
-        "command": "./bin/command"
+  "main": "index",
-      },
+  "bin": {
-      "repository": {
+    "command": "./bin/command"
-        "type": "git",
+  },
-        "url": "https://github.com/rstacruz/___.git"
+  "repository": {
-      },
+    "type": "git",
-      "license": "MIT"
+    "url": "https://github.com/rstacruz/___.git"
-    }
+  },
+}
+```
+{: data-line="2,3,4,5"}
+
+Highlighted lines are required.
 
 ### Dependencies
 
-    "dependencies": {
+```json
-      "colors"   : "*",
+"dependencies": {
-      "flatiron" : "0.1.x",
+  "colors":   "*",
-      "flatiron" : "~0.1.0",
+  "flatiron": "0.1.x",
-      "plates"   : "https://github.com/user/project/tarball/branch",
+  "flatiron": "~0.1.0",
-      "stuff"    : "git://github.com/user/project.git#commit-ish"
+  "plates":   "https://github.com/user/project/tarball/branch",
-    },
+  "stuff":    "git://github.com/user/project.git#commit-ish"
-    "devDependencies": {
+},
-      ...
+```
-    },
+
+```json
+"devDependencies": { ··· },
+"peerDependencies": { ··· },
+"optionalDependencies": { ··· },
+```
+
+See [Semver cheatsheet](./semver) for explanation of version ranges.
 
 ### Scripts
 
-    "scripts": {
+```json
-      "start": "node ./bin/xxx",       /* npm start */
+"scripts": {
-      "test": "vows --spec --isolate", /* npm test */
+  "start": "node ./bin/xxx",       /* npm start */
-      "postinstall": "...",
+  "test": "vows --spec --isolate", /* npm test */
-      "prepublish": "grunt build",     /* after 'npm install' and before 'npm 
+  "postinstall": "...",
-                                          publish' */
+  "prepublish": "grunt build",     /* after 'npm install' and before 'npm 
-    }
+                                      publish' */
+}
+```
 
 ### Misc
 
-    "private": true,
+```json
-    "preferGlobal": true
+"private": true,
+"preferGlobal": true
+```
 
 ### Config
 
-```js
+```json
 {
   "config": {
     "foobar": "hello"
@@ -70,6 +86,8 @@ redirect_from:
 }
 ```
 
+Keys in `config` are exposed as env vars to scripts.
+
 ## References
 {: .-one-column}
 

package.md

@@ -0,0 +1,5 @@
+---
+title: package.json
+category: Hidden
+redirect_to: /package.json
+---