split spec from overview (vega#1428)

lukaw3d · Jul 1, 2016 · bc2f766 · bc2f766
1 parent 263474b
commit bc2f766
Show file tree

Hide file tree

Showing 3 changed files with 48 additions and 39 deletions.
diff --git a/_layouts/docs.html b/_layouts/docs.html
@@ -4,6 +4,8 @@
 sidebar:
 - text: Overview
   url: index
+- text: Spec
+  url: spec
 - text: Data
   url: data
 - text: Transform

diff --git a/site/docs/overview.md b/site/docs/overview.md
@@ -17,42 +17,3 @@ Below is the an overview of the documentation for Vega-Lite properties. See [bel
 
 {% include docs_toc.md %}
 
-{:#spec}
-## Vega-Lite Specifications
-
-At its core, Vega-Lite specifications are JSON objects that describe visualizations as [mappings](encoding.html) from data to properties of [graphical marks](mark.html) (e.g., points or bars). By simply providing a mark type and a mapping, Vega-Lite automatically produces other visualization components including axes, legends, and scales. Unless explicitly specified, Vega-Lite determines properties of these components based on a set of carefully designed rules. This approach allows Vega-Lite specifications to be succinct and expressive, but also provide user control.
-
-As it is designed for analysis, Vega-Lite also supports data transformation such as [aggregation](aggregate.html), [binning](bin.html), [time unit conversion](timeunit.html), [filtering](transform.html), and [sorting](sort.html). In addition, it also supports faceting a single plot into [trellis plots or small multiples](https://en.wikipedia.org/wiki/Small_multiple).
-
-{: .suppress-error}
-```json
-{
-  "description": ... ,
-  "data": ... ,
-  "mark": ... ,
-  "transform": ...,
-  "encoding": {
-    "x": {
-      "field": ...,
-      "type": ...,
-      ...
-    },
-    "y": ...,
-    "color": ...,
-    ...
-  },
-  "config": ...
-}
-```
-
-In Vega-Lite, a specification can have the following top-level properties.
-
-| Property             | Type          | Description    |
-| :------------        |:-------------:| :------------- |
-| description   | String     | An _optional_ description of this mark for commenting purpose. This property has no effect on the output visualization. |
-| [data](data.html)    | Object        | An object describing the data source. |
-| [transform](transform.html) | Object | An object describing filter and new field calculation. |
-| [mark](mark.html)    | String        | The mark type. One of `"bar"`, `"circle"`, `"square"`, `"tick"`, `"line"`, `"area"`, `"point"`, and `"text"`. |
-| [encoding](encoding.html) | Object   | A key-value mapping between encoding channels and definition of fields. |
-| [config](config.html)   | Object     | Configuration object. |
-
diff --git a/site/docs/spec.md b/site/docs/spec.md
@@ -0,0 +1,46 @@
+---
+layout: docs
+menu: docs
+title: Vega-Lite Specification
+permalink: /docs/spec.html
+---
+
+{:#spec}
+## Vega-Lite Specifications
+
+At its core, Vega-Lite specifications are JSON objects that describe visualizations as [mappings](encoding.html) from data to properties of [graphical marks](mark.html) (e.g., points or bars). By simply providing a mark type and a mapping, Vega-Lite automatically produces other visualization components including axes, legends, and scales. Unless explicitly specified, Vega-Lite determines properties of these components based on a set of carefully designed rules. This approach allows Vega-Lite specifications to be succinct and expressive, but also provide user control.
+
+As it is designed for analysis, Vega-Lite also supports data transformation such as [aggregation](aggregate.html), [binning](bin.html), [time unit conversion](timeunit.html), [filtering](transform.html), and [sorting](sort.html). In addition, it also supports faceting a single plot into [trellis plots or small multiples](https://en.wikipedia.org/wiki/Small_multiple).
+
+{: .suppress-error}
+```json
+{
+  "description": ... ,
+  "data": ... ,
+  "mark": ... ,
+  "transform": ...,
+  "encoding": {
+    "x": {
+      "field": ...,
+      "type": ...,
+      ...
+    },
+    "y": ...,
+    "color": ...,
+    ...
+  },
+  "config": ...
+}
+```
+
+In Vega-Lite, a specification can have the following top-level properties.
+
+| Property             | Type          | Description    |
+| :------------        |:-------------:| :------------- |
+| description   | String     | An _optional_ description of this mark for commenting purpose. This property has no effect on the output visualization. |
+| [data](data.html)    | Object        | An object describing the data source. |
+| [transform](transform.html) | Object | An object describing filter and new field calculation. |
+| [mark](mark.html)    | String        | The mark type. One of `"bar"`, `"circle"`, `"square"`, `"tick"`, `"line"`, `"area"`, `"point"`, and `"text"`. |
+| [encoding](encoding.html) | Object   | A key-value mapping between encoding channels and definition of fields. |
+| [config](config.html)   | Object     | Configuration object. |
+