github/pelican
1
0
Fork 1
mirror of https://github.com/getpelican/pelican.git synced 2025-10-15 20:28:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Clarify {attach} and *_URL / *_SAVE_AS caveat

Browse source
This commit is contained in:
Justin Mayer 2020-04-15 10:12:53 +02:00 • committed by GitHub
commit 180c66fed4
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/settings.rst
View file

@ -168,8 +168,8 @@ Basic settings
.. data:: OUTPUT_PATH = 'output/'
Where to output the generated files. This should correspond to the document
root of the web server.
Where to output the generated files. This should correspond to your web
server's virtual host root directory.
.. data:: PATH
@ -380,10 +380,10 @@ variables allow you to place your articles in a location such as
example below).
.. note::
If the parent directory of a ``*_SAVE_AS`` setting doesn't match the
directory portion of the corresponding ``*_URL`` setting, this may cause
Pelican to generate incorrect URLs in a few cases, such as when using
``{attach}``.
If a ``*_SAVE_AS`` setting contains a parent directory that doesn't match
the parent directory inside the corresponding ``*_URL`` setting, this may
cause Pelican to generate unexpected URLs in a few cases, such as when
using the ``{attach}`` syntax.
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