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,19 +2,21 @@
 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": "",
+  "description": "My package",
-      "keywords": [""],
-      "author": "Rico Sta. Cruz <hi@ricostacruz.com>",
   "version": "0.1.0",
+  "license": "MIT",
+  "keywords": ["http", "server"],
+  "author": "Rico Sta. Cruz <hi@ricostacruz.com>",
   "engines": {
     "node": ">=0.8.0"
   },
@@ -26,40 +28,54 @@ redirect_from:
     "type": "git",
     "url": "https://github.com/rstacruz/___.git"
   },
-      "license": "MIT"
+}
-    }
+```
+{: 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
+"scripts": {
   "start": "node ./bin/xxx",       /* npm start */
   "test": "vows --spec --isolate", /* npm test */
   "postinstall": "...",
   "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
+---