From 802c9d1111e832eace3bc24ae6810e72d5e7c7d4 Mon Sep 17 00:00:00 2001
From: Bruno Binet <bruno.binet@gmail.com>
Date: Fri, 7 Dec 2012 01:02:44 +0100
Subject: [PATCH] add docs for save_as/url override from metadata feature

---
 docs/faq.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index a8617b30..9429a44f 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -92,6 +92,22 @@ want to have its own template.
 Then just make sure your theme contains the relevant template file (e.g.
 ``template_name.html``).
 
+How can I override the generated url of a specific page or article?
+===================================================================
+
+It's as simple as specifying the ``url`` and ``save_as`` special metadata to
+any pages or articles you want to override the generated url.
+Here is an example rst page::
+
+    Override url/save_as page
+    #########################
+
+    :url: override/url/
+    :save_as: override/url/index.html
+
+You're done, the page will be written to ``override/url/index.html``
+and Pelican will use url ``override/url/`` to link to this page.
+
 What if I want to disable feed generation?
 ==========================================