From bb0ed26fdd3c1bbfbca6f384a01a304fab954a00 Mon Sep 17 00:00:00 2001
From: Justin Mayer <entroP@gmail.com>
Date: Tue, 30 Jul 2024 10:00:36 +0200
Subject: [PATCH] Document how to have same source & output hierarchy

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

diff --git a/docs/faq.rst b/docs/faq.rst
index cecc11575..bbf058cd5 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -99,6 +99,15 @@ If you want to include metadata in templates outside the article context (e.g.,
 
     {% if article and article.modified %}
 
+How do I make my output folder structure identical to my content hierarchy?
+===========================================================================
+
+Try these settings::
+
+    USE_FOLDER_AS_CATEGORY = False
+    PATH_METADATA = "(?P<path_no_ext>.*)\..*"
+    ARTICLE_URL = ARTICLE_SAVE_AS = PAGE_URL = PAGE_SAVE_AS = "{path_no_ext}.html"
+
 How do I assign custom templates on a per-page basis?
 =====================================================