aboutsummaryrefslogtreecommitdiffstats
path: root/docs/path_handlers.txt
diff options
context:
space:
mode:
authorLibravatarDererk <dererk@satellogic.com>2016-11-15 14:18:46 -0300
committerLibravatarDererk <dererk@satellogic.com>2016-11-15 14:18:46 -0300
commitffb671c61a24a9086343b54bad080e145ff33fc5 (patch)
tree2c5291f7a34edf4afdc8e07887a148291bfa3fa1 /docs/path_handlers.txt
parent4e3224c012df9f74f010eb92203520515e8537b9 (diff)
New upstream version 7.8.1upstream/7.8.1
Diffstat (limited to 'docs/path_handlers.txt')
-rw-r--r--docs/path_handlers.txt28
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