From fd40fe39bcf2a0793e18bb305e05e586360d93b6 Mon Sep 17 00:00:00 2001 From: Cameron Moore 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 ddd6fed7c..95e80a0cf 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/`.