Initial doc file: Dynamic Content

diff --git a/docs/content/extras/datafiles.md b/docs/content/extras/datafiles.md
index 60e89b858ab2257aecc9b8d08851438bd6a92293..ba57f748fb59e5449f86a52378710c054bc8a5c3 100644 (file)
--- a/docs/content/extras/datafiles.md
+++ b/docs/content/extras/datafiles.md
@@ -5,7 +5,7 @@ date: 2015-01-22
 menu:
   main:
     parent: extras
-next: /extras/highlighting
+next: /extras/dynamiccontent
 prev: /extras/scratch
 title: Data Files
 weight: 90

diff --git a/docs/content/extras/dynamiccontent.md b/docs/content/extras/dynamiccontent.md
new file mode 100644 (file)
index 0000000..67794a6
--- /dev/null
+++ b/docs/content/extras/dynamiccontent.md
@@ -0,0 +1,28 @@
+---
+aliases:
+- /doc/dynamiccontent/
+date: 2015-02-14
+menu:
+  main:
+    parent: extras
+next: /extras/highlighting
+prev: /extras/datafiles
+title: Dynamic Content
+weight: 91
+---
+
+Dynamic content with a static site generator? Yes it is possible!
+
+In addition to the [built-in variables](/templates/variables/) available from Hugo, you can specify your own custom data that can be accessed via templates or shortcodes.
+
+Hugo supports loading data from [YAML](http://yaml.org/), [JSON](http://www.json.org/), and [TOML](https://github.com/toml-lang/toml) files located in the `data` directory.
+
+**It even works with [LiveReload](/extras/livereload/).**
+
+## The Data Folder
+
+As explained in [Source Organization](/overview/source-directory/), the `data` folder is where you can store additional data for Hugo to use when generating your site. These files must be YAML, JSON or TOML files (using either the `.yml`, `.yaml`, `.json` or `toml` extension) and the data will be accessible as a `map` in `.Site.Data`.
+
+**The keys in this map will be a dot chained set of _path_, _filename_ and _key_ in file (if applicable).**
+
+This is best explained with an example: