A new Riff-radio.org site with a static approach.

path-handlers.html 9.4KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1">
  6. <title>Path Handlers for Nikola | Riff</title>
  7. <link href="../assets/css/all-nocdn.css" rel="stylesheet" type="text/css">
  8. <link rel="alternate" type="application/rss+xml" title="RSS" href="../rss.xml">
  9. <link rel="canonical" href="http://media.pagelibre.org/riff/site/pages/path-handlers.html">
  10. <link rel="icon" href="../favicon.ico" sizes="16x16">
  11. <!--[if lt IE 9]><script src="../assets/js/html5.js"></script><![endif]--><meta name="author" content="The Nikola Team">
  12. <meta property="og:site_name" content="Riff">
  13. <meta property="og:title" content="Path Handlers for Nikola">
  14. <meta property="og:url" content="http://media.pagelibre.org/riff/site/pages/path-handlers.html">
  15. <meta property="og:description" content="Nikola supports special links with the syntax link://kind/name. In
  16. templates you can also use _link(kind, name). You can add query strings
  17. (?key=value) for extra arguments, or pass keyword arguments ">
  18. <meta property="og:type" content="article">
  19. <meta property="article:published_time" content="2023-01-27T16:45:44+01:00">
  20. </head>
  21. <body>
  22. <a href="#content" class="sr-only sr-only-focusable">Skip to main content</a>
  23. <!-- Menubar -->
  24. <div class="blog-masthead">
  25. <div class="container">
  26. <!-- This keeps the margins nice -->
  27. <nav class="blog-nav" role="navigation"><a href="../index.html" class="blog-nav-item">Accueil</a>
  28. <a href="about.html" class="blog-nav-item">About Riff</a>
  29. <a href="../rss.xml" class="blog-nav-item">RSS feed</a>
  30. </nav>
  31. </div>
  32. <!-- /.container -->
  33. </div>
  34. <!-- End of Menubar -->
  35. <div class="container" id="content" role="main">
  36. <div class="body-content">
  37. <div class="blog-header">
  38. <h1 class="blog-title">
  39. <a href="http://media.pagelibre.org/riff/site/">
  40. <span id="blog-title">Riff</span>
  41. </a>
  42. </h1>
  43. <p class="lead blog-description">Riff la radio rock</p>
  44. </div>
  45. <!--Body content-->
  46. <div class="row">
  47. <div class="col-sm-8 blog-main">
  48. <article class="post-text storypage" itemscope="itemscope" itemtype="http://schema.org/Article"><header><h2 class="p-name entry-title blog-post-title" itemprop="headline name"><a href="#" class="u-url">Path Handlers for Nikola</a></h2>
  49. </header><div class="e-content entry-content" itemprop="articleBody text">
  50. <!-- DO NOT EDIT, this file is auto-generated by scripts/document_path_handlers.py -->
  51. <p>Nikola supports special links with the syntax <code class="docutils literal"><span class="pre">link://kind/name</span></code>. In
  52. templates you can also use <code class="docutils literal">_link(kind, name)</code>. You can add query strings
  53. (<code class="docutils literal"><span class="pre">?key=value</span></code>) for extra arguments, or pass keyword arguments to <code class="docutils literal">_link</code> in
  54. templates (support and behavior depends on path handlers themselves). Fragments
  55. (<code class="docutils literal">#anchor</code>) will be appended to the transformed link.</p>
  56. <p>Here are the descriptions for all the supported kinds.</p>
  57. <dl class="dl-horizontal">
  58. <dt>archive</dt>
  59. <dd>
  60. <p>Link to archive path, name is the year.</p>
  61. <p>Example:</p>
  62. <p>link://archive/2013 =&gt; /archives/2013/index.html</p>
  63. </dd>
  64. <dt>author</dt>
  65. <dd>
  66. <p>Link to an author's page.</p>
  67. <p>Example:</p>
  68. <p>link://author/joe =&gt; /authors/joe.html</p>
  69. </dd>
  70. <dt>author_atom</dt>
  71. <dd>
  72. <p>Link to an author's Atom feed.</p>
  73. <p>Example:</p>
  74. <p>link://author_atom/joe =&gt; /authors/joe.atom</p>
  75. </dd>
  76. <dt>author_index</dt>
  77. <dd>
  78. <p>Link to the authors index.</p>
  79. <p>Example:</p>
  80. <p>link://authors/ =&gt; /authors/index.html</p>
  81. </dd>
  82. <dt>author_rss</dt>
  83. <dd>
  84. <p>Link to an author's RSS feed.</p>
  85. <p>Example:</p>
  86. <p>link://author_rss/joe =&gt; /authors/joe.xml</p>
  87. </dd>
  88. <dt>category</dt>
  89. <dd>
  90. <p>A link to a category. Takes page number as optional keyword argument.</p>
  91. <p>Example:</p>
  92. <p>link://category/dogs =&gt; /categories/dogs.html</p>
  93. </dd>
  94. <dt>category_atom</dt>
  95. <dd>
  96. <p>A link to a category's Atom feed.</p>
  97. <p>Example:</p>
  98. <p>link://category_atom/dogs =&gt; /categories/dogs.atom</p>
  99. </dd>
  100. <dt>category_index</dt>
  101. <dd>
  102. <p>A link to the category index.</p>
  103. <p>Example:</p>
  104. <p>link://category_index =&gt; /categories/index.html</p>
  105. </dd>
  106. <dt>category_rss</dt>
  107. <dd>
  108. <p>A link to a category's RSS feed.</p>
  109. <p>Example:</p>
  110. <p>link://category_rss/dogs =&gt; /categories/dogs.xml</p>
  111. </dd>
  112. <dt>filename</dt>
  113. <dd>
  114. <p>Link to post or page by source filename.</p>
  115. <p>Example:</p>
  116. <p>link://filename/manual.txt =&gt; /docs/handbook.html</p>
  117. </dd>
  118. <dt>gallery</dt>
  119. <dd>
  120. <p>Link to an image gallery's path.</p>
  121. <p>It will try to find a gallery with that name if it's not ambiguous
  122. or with that path. For example:</p>
  123. <p>link://gallery/london =&gt; /galleries/trips/london/index.html</p>
  124. <p>link://gallery/trips/london =&gt; /galleries/trips/london/index.html</p>
  125. </dd>
  126. <dt>gallery_global</dt>
  127. <dd>
  128. <p>Link to the global gallery path, which contains all the images in galleries.</p>
  129. <p>There is only one copy of an image on multilingual blogs, in the site root.</p>
  130. <p>link://gallery_global/london =&gt; /galleries/trips/london/index.html</p>
  131. <p>link://gallery_global/trips/london =&gt; /galleries/trips/london/index.html</p>
  132. <p>(a <code class="docutils literal">gallery</code> link could lead to eg. /en/galleries/trips/london/index.html)</p>
  133. </dd>
  134. <dt>gallery_rss</dt>
  135. <dd>
  136. <p>Link to an image gallery's RSS feed.</p>
  137. <p>It will try to find a gallery with that name if it's not ambiguous
  138. or with that path. For example:</p>
  139. <p>link://gallery_rss/london =&gt; /galleries/trips/london/rss.xml</p>
  140. <p>link://gallery_rss/trips/london =&gt; /galleries/trips/london/rss.xml</p>
  141. </dd>
  142. <dt>index</dt>
  143. <dd>
  144. <p>Link to a numbered index.</p>
  145. <p>Example:</p>
  146. <p>link://index/3 =&gt; /index-3.html</p>
  147. </dd>
  148. <dt>index_atom</dt>
  149. <dd>
  150. <p>Link to a numbered Atom index.</p>
  151. <p>Example:</p>
  152. <p>link://index_atom/3 =&gt; /index-3.atom</p>
  153. </dd>
  154. <dt>index_rss</dt>
  155. <dd>
  156. <p>A link to the RSS feed path.</p>
  157. <p>Example:</p>
  158. <p>link://rss =&gt; /blog/rss.xml</p>
  159. </dd>
  160. <dt>listing</dt>
  161. <dd>
  162. <p>Return a link to a listing.</p>
  163. <p>It will try to use the file name if it's not ambiguous, or the file path.</p>
  164. <p>Example:</p>
  165. <p>link://listing/hello.py =&gt; /listings/tutorial/hello.py.html</p>
  166. <p>link://listing/tutorial/hello.py =&gt; /listings/tutorial/hello.py.html</p>
  167. </dd>
  168. <dt>listing_source</dt>
  169. <dd>
  170. <p>Return a link to the source code for a listing.</p>
  171. <p>It will try to use the file name if it's not ambiguous, or the file path.</p>
  172. <p>Example:</p>
  173. <p>link://listing_source/hello.py =&gt; /listings/tutorial/hello.py</p>
  174. <p>link://listing_source/tutorial/hello.py =&gt; /listings/tutorial/hello.py</p>
  175. </dd>
  176. <dt>post_path</dt>
  177. <dd>
  178. <p>Link to the destination of an element in the POSTS/PAGES settings.</p>
  179. <p>Example:</p>
  180. <p>link://post_path/posts =&gt; /blog</p>
  181. </dd>
  182. <dt>root</dt>
  183. <dd>
  184. <p>Link to the current language's root.</p>
  185. <p>Example:</p>
  186. <p>link://root_path =&gt; /</p>
  187. <p>link://root_path =&gt; /translations/spanish/</p>
  188. </dd>
  189. <dt>rss</dt>
  190. <dd>
  191. <p>A link to the RSS feed path.</p>
  192. <p>Example:</p>
  193. <p>link://rss =&gt; /blog/rss.xml</p>
  194. </dd>
  195. <dt>slug</dt>
  196. <dd>
  197. <p>Return a link to a post with given slug, if not ambiguous.</p>
  198. <p>Example:</p>
  199. <p>link://slug/yellow-camaro =&gt; /posts/cars/awful/yellow-camaro/index.html</p>
  200. </dd>
  201. <dt>tag</dt>
  202. <dd>
  203. <p>A link to a tag's page. Takes page number as optional keyword argument.</p>
  204. <p>Example:</p>
  205. <p>link://tag/cats =&gt; /tags/cats.html</p>
  206. </dd>
  207. <dt>tag_atom</dt>
  208. <dd>
  209. <p>A link to a tag's Atom feed.</p>
  210. <p>Example:</p>
  211. <p>link://tag_atom/cats =&gt; /tags/cats.atom</p>
  212. </dd>
  213. <dt>tag_index</dt>
  214. <dd>
  215. <p>A link to the tag index.</p>
  216. <p>Example:</p>
  217. <p>link://tag_index =&gt; /tags/index.html</p>
  218. </dd>
  219. <dt>tag_rss</dt>
  220. <dd>
  221. <p>A link to a tag's RSS feed.</p>
  222. <p>Example:</p>
  223. <p>link://tag_rss/cats =&gt; /tags/cats.xml</p>
  224. </dd>
  225. </dl>
  226. </div>
  227. </article>
  228. </div>
  229. <div class="col-sm-3 col-sm-offset-1 blog-sidebar">
  230. <div class="sidebar-module sidebar-module-inset">
  231. <h4>About</h4>
  232. <div id="shoutcastdiv">
  233. <script type="text/javascript">
  234. refreshdiv();
  235. </script>
  236. </div>
  237. </div>
  238. <div class="sidebar-module">
  239. <h4>Links</h4>
  240. <ol class="list-unstyled">
  241. <li><a href="http://getbootstrap.com/examples/blog/">Bootstrap Blog Theme</a></li>
  242. <li><a href="https://getnikola.com/">Nikola</a></li>
  243. <li><a href="https://twitter.com/mdo">@mdo</a></li>
  244. <li><a href="https://twitter.com/Kwpolska">@Kwpolska</a></li>
  245. <li><a href="https://twitter.com/GetNikola">@GetNikola</a></li>
  246. </ol>
  247. </div>
  248. </div>
  249. <!--End of body content-->
  250. </div>
  251. </div>
  252. </div>
  253. <footer class="blog-footer" id="footer">
  254. Contents © 2023 <a href="mailto:contact@riff-radio.org">Riff</a> - Powered by <a href="https://getnikola.com" rel="nofollow">Nikola</a>
  255. </footer><script src="../assets/js/all-nocdn.js"></script><!-- fancy dates --><script>
  256. moment.locale("en");
  257. fancydates(0, "YYYY-MM-DD HH:mm");
  258. </script><!-- end fancy dates --><script>
  259. baguetteBox.run('div#content', {
  260. ignoreClass: 'islink',
  261. captions: function(element) {
  262. return element.getElementsByTagName('img')[0].alt;
  263. }});
  264. </script><script type="text/javascript" src="../refresh.js"></script>
  265. </body>
  266. </html>