From: Cameron Moore <moorereason@gmail.com>
Date: Sat, 7 May 2016 19:39:40 +0000 (-0500)
Subject: docs: Document relativeURLs
X-Git-Tag: v0.16~29
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=fd40fe39bcf2a0793e18bb305e05e586360d93b6;p=brevno-suite%2Fhugo

docs: Document relativeURLs

Fixes #1342
---

diff --git a/docs/content/extras/urls.md b/docs/content/extras/urls.md
index ddd6fed7..95e80a0c 100644
--- a/docs/content/extras/urls.md
+++ b/docs/content/extras/urls.md
@@ -1,7 +1,7 @@
 ---
 aliases:
 - /doc/urls/
-lastmod: 2015-12-08
+lastmod: 2016-05-07
 date: 2014-01-03
 menu:
   main:
@@ -61,3 +61,11 @@ Or, if you are on Windows and do not have `grep` installed:
 
     hugo config | FINDSTR /I canon
 
+## Relative URLs
+
+By default, all relative URLs are left unchanged by Hugo,
+which can be problematic when you want to make your site browsable from a local file system.
+
+Setting `relativeURLs` to `true` in the site configuration will cause Hugo to rewrite all relative URLs to be relative to the current content.
+
+For example, if the `/post/first/` page contained a link with a relative URL of `/about/`, Hugo would rewrite that URL to `../../about/`.