From fd40fe39bcf2a0793e18bb305e05e586360d93b6 Mon Sep 17 00:00:00 2001
From: Cameron Moore <moorereason@gmail.com>
Date: Sat, 7 May 2016 14:39:40 -0500
Subject: [PATCH] docs: Document relativeURLs
Fixes #1342
---
docs/content/extras/urls.md | 10 +++++++++-
1 file changed, 9 insertions(+), 1 deletion(-)
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/`.
--
2.30.2