From b99013cc3d945aeefdff5643a166c8d17e698185 Mon Sep 17 00:00:00 2001
From: kimbaudi <kimbaudi@gmail.com>
Date: Sat, 10 Dec 2016 23:03:59 -0800
Subject: [PATCH] Improve Permalinks documentation.

Add special note: built-in permalink styles are not recognized in the YAML Front Matter.
---
 docs/_docs/permalinks.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/_docs/permalinks.md b/docs/_docs/permalinks.md
index 254c5d6d..31eeb30b 100644
--- a/docs/_docs/permalinks.md
+++ b/docs/_docs/permalinks.md
@@ -14,6 +14,16 @@ Permalinks are constructed by creating a template URL where dynamic elements
 are represented by colon-prefixed keywords. For example, the default `date`
 permalink is defined according to the format `/:categories/:year/:month/:day/:title.html`.
 
+<div class="note info">
+  <h5>Specifying permalinks through the YAML Front Matter</h5>
+  <p>
+    Built-in permalink styles are not recognized in YAML Front Matter. So
+    <code>permalink: pretty</code> will not work, but the equivalent 
+    <code>/:categories/:year/:month/:day/:title/</code>
+    using template variables will.
+  </p>
+</div>
+
 ## Template variables
 
 <div class="mobile-side-scroller">