123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228 |
- .. title: Path Handlers for Nikola
- .. slug: path-handlers
- .. author: The Nikola Team
-
- .. DO NOT EDIT, this file is auto-generated by scripts/document_path_handlers.py
-
- Nikola supports special links with the syntax ``link://kind/name``. In
- templates you can also use ``_link(kind, name)``. You can add query strings
- (``?key=value``) for extra arguments, or pass keyword arguments to ``_link`` in
- templates (support and behavior depends on path handlers themselves). Fragments
- (``#anchor``) will be appended to the transformed link.
-
- Here are the descriptions for all the supported kinds.
-
- .. class:: dl-horizontal
-
- archive
- Link to archive path, name is the year.
-
- Example:
-
- link://archive/2013 => /archives/2013/index.html
-
- author
- Link to an author's page.
-
- Example:
-
- link://author/joe => /authors/joe.html
-
- author_atom
- Link to an author's Atom feed.
-
- Example:
-
- link://author_atom/joe => /authors/joe.atom
-
- author_index
- Link to the authors index.
-
- Example:
-
- link://authors/ => /authors/index.html
-
- author_rss
- Link to an author's RSS feed.
-
- Example:
-
- link://author_rss/joe => /authors/joe.xml
-
- category
- A link to a category. Takes page number as optional keyword argument.
-
- Example:
-
- link://category/dogs => /categories/dogs.html
-
- category_atom
- A link to a category's Atom feed.
-
- Example:
-
- link://category_atom/dogs => /categories/dogs.atom
-
- category_index
- A link to the category index.
-
- Example:
-
- link://category_index => /categories/index.html
-
- category_rss
- A link to a category's RSS feed.
-
- Example:
-
- link://category_rss/dogs => /categories/dogs.xml
-
- filename
- Link to post or page by source filename.
-
- Example:
-
- link://filename/manual.txt => /docs/handbook.html
-
-
- gallery
- Link to an image gallery's path.
-
- It will try to find a gallery with that name if it's not ambiguous
- or with that path. For example:
-
- link://gallery/london => /galleries/trips/london/index.html
-
- link://gallery/trips/london => /galleries/trips/london/index.html
-
-
- gallery_global
- Link to the global gallery path, which contains all the images in galleries.
-
- There is only one copy of an image on multilingual blogs, in the site root.
-
- link://gallery_global/london => /galleries/trips/london/index.html
-
- link://gallery_global/trips/london => /galleries/trips/london/index.html
-
- (a ``gallery`` link could lead to eg. /en/galleries/trips/london/index.html)
-
-
- gallery_rss
- Link to an image gallery's RSS feed.
-
- It will try to find a gallery with that name if it's not ambiguous
- or with that path. For example:
-
- link://gallery_rss/london => /galleries/trips/london/rss.xml
-
- link://gallery_rss/trips/london => /galleries/trips/london/rss.xml
-
-
- index
- Link to a numbered index.
-
- Example:
-
- link://index/3 => /index-3.html
-
- index_atom
- Link to a numbered Atom index.
-
- Example:
-
- link://index_atom/3 => /index-3.atom
-
- index_rss
- A link to the RSS feed path.
-
- Example:
-
- link://rss => /blog/rss.xml
-
- listing
- Return a link to a listing.
-
- It will try to use the file name if it's not ambiguous, or the file path.
-
- Example:
-
- link://listing/hello.py => /listings/tutorial/hello.py.html
-
- link://listing/tutorial/hello.py => /listings/tutorial/hello.py.html
-
-
- listing_source
- Return 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.
-
- Example:
-
- link://post_path/posts => /blog
-
-
- root
- Link to the current language's root.
-
- Example:
-
- link://root_path => /
-
- link://root_path => /translations/spanish/
-
-
- rss
- A link to the RSS feed path.
-
- Example:
-
- link://rss => /blog/rss.xml
-
- slug
- Return a link to a post with given slug, if not ambiguous.
-
- Example:
-
- link://slug/yellow-camaro => /posts/cars/awful/yellow-camaro/index.html
-
-
- tag
- A link to a tag's page. Takes page number as optional keyword argument.
-
- Example:
-
- link://tag/cats => /tags/cats.html
-
- tag_atom
- A link to a tag's Atom feed.
-
- Example:
-
- link://tag_atom/cats => /tags/cats.atom
-
- tag_index
- A link to the tag index.
-
- Example:
-
- link://tag_index => /tags/index.html
-
- tag_rss
- A link to a tag's RSS feed.
-
- Example:
-
- link://tag_rss/cats => /tags/cats.xml
-
|