Skip to content
Permalink
Browse files
added note mentioned in #915
  • Loading branch information
ralsina committed Sep 15, 2015
1 parent acd7b15 commit f5f3cd2f270ab3a26227bb683bc7769f181f55e1
Showing with 8 additions and 0 deletions.
  1. +8 −0 docs/manual.txt
@@ -454,6 +454,14 @@ and ``PAGES`` configuration options:
("stories/*.rst", "stories", "story.tmpl"),
)

.. note:: POSTS and PAGES are not flat!

Even if the syntax may suggest you can't, you can create any directory structure you want
inside ``posts/`` or ``stories/`` and it will be reflected in the output. For example,
``posts/foo/bar.txt`` would produce ``output/posts/foo/bar.html``, assuming the slug is also ``bar``.

If you have ``PRETTY_URLS`` enabled, that would be ``output/posts/foo/bar/index.html``.

``new_post`` will use the *first* path in ``POSTS`` (or ``PAGES`` if ``-p`` is
supplied) that ends with the extension of your desired markup format (as
defined in ``COMPILERS`` in ``conf.py``) as the directory that the new post will be

0 comments on commit f5f3cd2

Please sign in to comment.