diff options
Diffstat (limited to 'docs/path_handlers.txt')
| -rw-r--r-- | docs/path_handlers.txt | 28 |
1 files changed, 24 insertions, 4 deletions
diff --git a/docs/path_handlers.txt b/docs/path_handlers.txt index 258f5a9..2a03d77 100644 --- a/docs/path_handlers.txt +++ b/docs/path_handlers.txt @@ -2,8 +2,8 @@ .. slug: path-handlers .. author: The Nikola Team -Nikola supports special links with the syntax ``link://kind/name``. Here is -the description for all the supported kinds. +Nikola supports special links with the syntax ``link://kind/name``. In the templates you can also +use ``_link(kind, name)`` Here is the description for all the supported kinds. .. class:: dl-horizontal @@ -88,7 +88,7 @@ category_rss filename - Link to post or story by source filename. + Link to post or page by source filename. Example: @@ -157,6 +157,18 @@ listing link://listing/tutorial/hello.py => /listings/tutorial/hello.py.html +listing_source + A link to the source code for a listing. + + It will try to use the file name if it's not ambiguous, or the file path. + + Example: + + link://listing_source/hello.py => /listings/tutorial/hello.py + + link://listing_source/tutorial/hello.py => /listings/tutorial/hello.py + + post_path Link to the destination of an element in the POSTS/PAGES settings. @@ -199,12 +211,20 @@ section_index_atom link://section_index_atom/cars => /cars/index.atom +section_index_rss + Link to the RSS feed for a section. + + Example: + + link://section_index_rss/cars => /cars/rss.xml + + slug A link to a post with given slug, if not ambiguous. Example: - links://slug/yellow-camaro => /posts/cars/awful/yellow-camaro/index.html + link://slug/yellow-camaro => /posts/cars/awful/yellow-camaro/index.html tag |