diff options
author | David Zaslavsky <diazona@ellipsix.net> | 2020-04-15 01:35:04 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-04-15 10:35:04 +0200 |
commit | 9eb259af82567a568b0c5a57e97859d04c1a8ec8 (patch) | |
tree | 7cc07df809b35562efa613bb2bd5ebec2c9fb65c /docs/content.rst | |
parent | cefe984c7e230c32b2c1b6921c9d55039277ebb0 (diff) | |
download | pelican-9eb259af82567a568b0c5a57e97859d04c1a8ec8.tar.gz |
Wrong path for attached static content urls (#2158)
* Document _URL/_SAVE_AS path matching req. Fix #2158
This commit addresses the fact that some URLs (primarily {attach}) are based
on the *_SAVE_AS path instead of the *_URL path. It updates the documentation
to point out that the paths of corresponding _URL and _SAVE_AS settings should
match, and that the OUTPUT directory should correspond to the web server's
document root, in order to avoid producing these incorrect URLs.
* Clarify {attach} and *_URL / *_SAVE_AS caveat
Co-authored-by: Justin Mayer <entroP@gmail.com>
Diffstat (limited to 'docs/content.rst')
-rw-r--r-- | docs/content.rst | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/content.rst b/docs/content.rst index a52425a4..6affecce 100644 --- a/docs/content.rst +++ b/docs/content.rst @@ -370,6 +370,10 @@ of ``{attach}``, and letting the file's location be determined by the project's ``STATIC_SAVE_AS`` and ``STATIC_URL`` settings. (Per-file ``save_as`` and ``url`` overrides can still be set in ``EXTRA_PATH_METADATA``.) +.. note:: + When using ``{attach}``, any parent directory in ``*_URL`` / ``*_SAVE_AS`` + settings should match each other. See also: :ref:`url-settings` + Linking to authors, categories, index and tags ---------------------------------------------- |