From b8f2326fa656dc1e990c0a8ca4f6573ba3e205e5 Mon Sep 17 00:00:00 2001 From: Justin Mayer Date: Sat, 28 Dec 2019 10:02:48 +0100 Subject: [PATCH] Document mirroring content & output path hierarchies --- docs/settings.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/settings.rst b/docs/settings.rst index 1242205e..b4ec4761 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -362,7 +362,15 @@ variables allow you to place your articles in a location such as example below). These settings give you the flexibility to place your articles and pages anywhere you want. -Also, you can use other file metadata attributes as well: +If you don't want that flexibility and instead prefer that your generated +output paths mirror your source content's filesystem path hierarchy, try the +following settings:: + + PATH_METADATA = '(?P.*)\..*' + ARTICLE_URL = ARTICLE_SAVE_AS = PAGE_URL = PAGE_SAVE_AS = '{path_no_ext}.html' + +Otherwise, you can use a variety of file metadata attributes within URL-related +settings: * slug * date