Merge branch 'getpelican:main' into chinese-translation

.gitignore

@@ -17,6 +17,7 @@ samples/output
 *.pem
 *.lock
 .pdm-python
+.vale
 .venv
 
 # direnv

.vale.ini

@@ -0,0 +1,10 @@
+StylesPath = .vale/styles
+
+Vocab = Pelican
+
+MinAlertLevel = suggestion
+
+Packages = proselint, alex
+
+[*]
+BasedOnStyles = Vale, proselint, alex

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?
 =====================================================