From: Vladimír Vondruš <mosra@centrum.cz>
Date: Fri, 16 Nov 2018 23:42:13 +0000 (+0100)
Subject: Adapted to Pelican 3.8 {filename} -> {static} changes.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=e1c031325f6b0b047c2d810f6500fb7d9ec7d0e4;p=blog.git

Adapted to Pelican 3.8 {filename} -> {static} changes.
---

diff --git a/doc/admire/math.rst b/doc/admire/math.rst
index 2bfbc787..2947cddd 100644
--- a/doc/admire/math.rst
+++ b/doc/admire/math.rst
@@ -33,7 +33,7 @@ m.css math
 .. |o| replace:: ·
 
 :url: admire/math/
-:cover: {filename}/static/cover-math.jpg
+:cover: {static}/static/cover-math.jpg
 :summary: The fastest possible math rendering for the modern web
 :footer:
     .. note-dim::
diff --git a/doc/css.rst b/doc/css.rst
index 76d7e521..9215ed9e 100644
--- a/doc/css.rst
+++ b/doc/css.rst
@@ -100,11 +100,11 @@ to include a proper :html:`<meta>` tag. The HTML5 DOCTYPE is also required.
     the code and console Pygments style, all combined in one file:
 
     -   :gh:`m-dark.compiled.css <mosra/m.css$master/css/m-dark.compiled.css>`
-        (:filesize:`{filename}/../css/m-dark.compiled.css`,
-        :filesize-gz:`{filename}/../css/m-dark.compiled.css` compressed)
+        (:filesize:`{static}/../css/m-dark.compiled.css`,
+        :filesize-gz:`{static}/../css/m-dark.compiled.css` compressed)
     -   :gh:`m-light.compiled.css <mosra/m.css$master/css/m-light.compiled.css>`
-        (:filesize:`{filename}/../css/m-light.compiled.css`,
-        :filesize-gz:`{filename}/../css/m-light.compiled.css` compressed)
+        (:filesize:`{static}/../css/m-light.compiled.css`,
+        :filesize-gz:`{static}/../css/m-light.compiled.css` compressed)
 
     I recommend using the original files for development and switching to the
     compiled versions when publishing the website.
diff --git a/doc/css/components-test.rst b/doc/css/components-test.rst
index ed86e0b6..82d9e298 100644
--- a/doc/css/components-test.rst
+++ b/doc/css/components-test.rst
@@ -240,7 +240,7 @@ Badge with lots of text and less text:
 .. raw:: html
 
     <div class="m-block m-badge m-primary">
-      <img src="{filename}/static/mosra.jpg" alt="The Author" />
+      <img src="{static}/static/mosra.jpg" alt="The Author" />
       <h3>About the author</h3>
       <p><a href="#">The Author</a> is lorem ipsum dolor sit amet, consectetur
       adipiscing elit. Aenean id elit posuere, consectetur magna congue,
@@ -250,7 +250,7 @@ Badge with lots of text and less text:
     </div>
 
     <div class="m-block m-badge m-dim">
-      <img src="{filename}/static/mosra.jpg" alt="The Author" />
+      <img src="{static}/static/mosra.jpg" alt="The Author" />
       <h3>About the author</h3>
       <p><a href="#">The Author</a> is lorem ipsum dolor sit amet, consectetur
       adipiscing elit.</p>
@@ -936,28 +936,28 @@ Image, centered:
 
 .. raw:: html
 
-    <img src="{filename}/static/flowers-small.jpg" class="m-image" />
+    <img src="{static}/static/flowers-small.jpg" class="m-image" />
 
 Image, centered, link:
 
 .. raw:: html
 
     <div class="m-image">
-      <a href="http://blog.mosra.cz/"><img src="{filename}/static/flowers-small.jpg" /></a>
+      <a href="http://blog.mosra.cz/"><img src="{static}/static/flowers-small.jpg" /></a>
     </div>
 
 Image, fullwidth (yes, it should be pixelated):
 
 .. raw:: html
 
-    <img src="{filename}/static/flowers-small.jpg" class="m-image m-fullwidth" />
+    <img src="{static}/static/flowers-small.jpg" class="m-image m-fullwidth" />
 
 Image, fullwidth, link (yes, it should be pixelated):
 
 .. raw:: html
 
     <div class="m-image m-fullwidth">
-      <a href="http://blog.mosra.cz/"><img src="{filename}/static/flowers-small.jpg" /></a>
+      <a href="http://blog.mosra.cz/"><img src="{static}/static/flowers-small.jpg" /></a>
     </div>
 
 SVG image:
@@ -996,7 +996,7 @@ Figure, centered:
 .. raw:: html
 
     <figure class="m-figure">
-      <img src="{filename}/static/ship-small.jpg" />
+      <img src="{static}/static/ship-small.jpg" />
       <figcaption>A Ship</figcaption>
       <span>Photo © <a href="http://blog.mosra.cz/">The Author</a></span>
     </figure>
@@ -1006,7 +1006,7 @@ Figure, centered, image link, flat:
 .. raw:: html
 
     <figure class="m-figure m-flat">
-      <a href="http://blog.mosra.cz/"><img src="{filename}/static/ship-small.jpg" /></a>
+      <a href="http://blog.mosra.cz/"><img src="{static}/static/ship-small.jpg" /></a>
       <figcaption>A Ship</figcaption>
       <span>Photo © <a href="http://blog.mosra.cz/">The Author</a></span>
     </figure>
@@ -1016,7 +1016,7 @@ Figure, fullwidth, without description (yes, it should be pixelated):
 .. raw:: html
 
     <figure class="m-figure m-fullwidth">
-      <img src="{filename}/static/ship-small.jpg" />
+      <img src="{static}/static/ship-small.jpg" />
       <figcaption>A Ship</figcaption>
     </figure>
 
@@ -1026,7 +1026,7 @@ unnecessary wrapping of the text:
 .. raw:: html
 
     <figure class="m-figure m-fullwidth">
-      <img src="{filename}/static/ship-small.jpg" />
+      <img src="{static}/static/ship-small.jpg" />
       <figcaption>A Somewhat Lengthy Caption For A Photo</figcaption>
       <span>The Photo Displayed Above Was Kindly Taken And Allowed To Be Used
       On This Page By <a href="http://blog.mosra.cz/">The Author</a>. All
@@ -1039,7 +1039,7 @@ leaking of the image outside of the page:
 .. raw:: html
 
     <figure class="m-figure">
-      <img src="{filename}/static/ship.jpg" />
+      <img src="{static}/static/ship.jpg" />
       <figcaption>A Somewhat Lengthy Caption For A Photo</figcaption>
       <span>The Photo Displayed Above Was Kindly Taken And Allowed To Be Used
       On This Page By <a href="http://blog.mosra.cz/">The Author</a>. All
@@ -1052,7 +1052,7 @@ instead of extending the border and there should be proper padding on bottom):
 .. raw:: html
 
     <figure class="m-figure">
-      <img src="{filename}/static/ship-small.jpg" />
+      <img src="{static}/static/ship-small.jpg" />
       <figcaption>A Somewhat Lengthy Caption For A Photo</figcaption>
       <span>The Photo Displayed Above Was Kindly Taken And Allowed To Be Used
       On This Page By <a href="http://blog.mosra.cz/">The Author</a>. All
@@ -1062,7 +1062,7 @@ instead of extending the border and there should be proper padding on bottom):
 .. raw:: html
 
     <figure class="m-figure">
-      <img src="{filename}/static/ship-small.jpg" />
+      <img src="{static}/static/ship-small.jpg" />
       <figcaption>A Somewhat Lengthy Caption For A Photo</figcaption>
     </figure>
 
@@ -1073,28 +1073,28 @@ Figures of varying colors:
     <div class="m-row">
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-default">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Default figure</figcaption>
           <span>Text.</span>
         </figure>
       </div>
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-primary">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Primary figure</figcaption>
           <span>Text.</span>
         </figure>
       </div>
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-success">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Success figure</figcaption>
           <span>Text.</span>
         </figure>
       </div>
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-warning">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Warning figure</figcaption>
           <span>Text.</span>
         </figure>
@@ -1103,21 +1103,21 @@ Figures of varying colors:
     <div class="m-row">
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-danger">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Danger figure</figcaption>
           <span>Text.</span>
         </figure>
       </div>
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-info">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Info figure</figcaption>
           <span>Text.</span>
         </figure>
       </div>
       <div class="m-col-m-3 m-col-s-6">
         <figure class="m-figure m-dim">
-          <img src="{filename}/static/ship-small.jpg" />
+          <img src="{static}/static/ship-small.jpg" />
           <figcaption>Dim figure</figcaption>
           <span>Text.</span>
         </figure>
@@ -1134,11 +1134,11 @@ Without the link:
     <div class="m-imagegrid m-container-inflate">
       <div>
         <figure style="width: 69.127%">
-          <img src="{filename}/static/ship.jpg" />
+          <img src="{static}/static/ship.jpg" />
           <figcaption>F9.0, 1/250 s, ISO 100</figcaption>
         </figure>
         <figure style="width: 30.873%">
-          <img src="{filename}/static/flowers.jpg" />
+          <img src="{static}/static/flowers.jpg" />
           <figcaption>F2.8, 1/1600 s, ISO 100</figcaption>
         </figure>
       </div>
@@ -1151,14 +1151,14 @@ With link, without caption, not inflated:
     <div class="m-imagegrid">
       <div>
         <figure style="width: 30.873%">
-          <a href="{filename}/static/flowers.jpg">
-            <img src="{filename}/static/flowers.jpg" />
+          <a href="{static}/static/flowers.jpg">
+            <img src="{static}/static/flowers.jpg" />
             <div></div>
           </a>
         </figure>
         <figure style="width: 69.127%">
-          <a href="{filename}/static/ship.jpg">
-            <img src="{filename}/static/ship.jpg" />
+          <a href="{static}/static/ship.jpg">
+            <img src="{static}/static/ship.jpg" />
             <div></div>
           </a>
         </figure>
@@ -1172,11 +1172,11 @@ Without link or caption:
     <div class="m-imagegrid m-container-inflate">
       <div>
         <figure style="width: 69.127%">
-          <img src="{filename}/static/ship.jpg" />
+          <img src="{static}/static/ship.jpg" />
           <div></div>
         </figure>
         <figure style="width: 30.873%">
-          <img src="{filename}/static/flowers.jpg" />
+          <img src="{static}/static/flowers.jpg" />
           <div></div>
         </figure>
       </div>
diff --git a/doc/css/components.rst b/doc/css/components.rst
index 8e4f7a64..423f641f 100644
--- a/doc/css/components.rst
+++ b/doc/css/components.rst
@@ -164,7 +164,7 @@ Only :html:`<h3>` is supported for a badge.
     .. raw:: html
 
         <div class="m-block m-badge m-success">
-          <img src="{filename}/static/mosra.jpg" alt="The Author" />
+          <img src="{static}/static/mosra.jpg" alt="The Author" />
           <h3>About the author</h3>
           <p><a href="http://blog.mosra.cz">The Author</a> is not really
           smiling at you from this avatar. Sorry about that. He knows that and
@@ -624,7 +624,7 @@ reasons it's a good practice to include the ``alt`` attribute.
 
     .. raw:: html
 
-        <img src="{filename}/static/flowers-small.jpg" alt="Flowers" class="m-image" />
+        <img src="{static}/static/flowers-small.jpg" alt="Flowers" class="m-image" />
 
 To make the image clickable, wrap the :html:`<a>` tag in an additional
 :html:`<div>` and put the :css:`.m-image` class on the :html:`<div>` element
@@ -642,7 +642,7 @@ not the surrounding area:
     .. raw:: html
 
         <div class="m-image">
-          <a href="{filename}/static/flowers.jpg"><img src="{filename}/static/flowers-small.jpg" /></a>
+          <a href="{static}/static/flowers.jpg"><img src="{static}/static/flowers-small.jpg" /></a>
         </div>
 
 .. note-info::
@@ -682,7 +682,7 @@ Optionally you can color the figure border and caption by adding one of the
     .. raw:: html
 
         <figure class="m-figure">
-          <img src="{filename}/static/ship-small.jpg" alt="Ship" />
+          <img src="{static}/static/ship-small.jpg" alt="Ship" />
           <figcaption>A Ship</figcaption>
           <span>Photo © <a href="http://blog.mosra.cz/">The Author</a></span>
         </figure>
@@ -752,28 +752,28 @@ Example usage (stupidly showing the two images all over again --- sorry):
     <div class="m-imagegrid m-container-inflate">
       <div>
         <figure style="width: 69.127%">
-          <a href="{filename}/static/ship.jpg">
-            <img src="{filename}/static/ship.jpg" />
+          <a href="{static}/static/ship.jpg">
+            <img src="{static}/static/ship.jpg" />
             <figcaption>F9.0, 1/250 s, ISO 100</figcaption>
           </a>
         </figure>
         <figure style="width: 30.873%">
-          <a href="{filename}/static/flowers.jpg">
-            <img src="{filename}/static/flowers.jpg" />
+          <a href="{static}/static/flowers.jpg">
+            <img src="{static}/static/flowers.jpg" />
             <figcaption>F2.8, 1/1600 s, ISO 100</figcaption>
           </a>
         </figure>
       </div>
       <div>
         <figure style="width: 30.873%">
-          <a href="{filename}/static/flowers.jpg">
-            <img src="{filename}/static/flowers.jpg" />
+          <a href="{static}/static/flowers.jpg">
+            <img src="{static}/static/flowers.jpg" />
             <figcaption>F2.8, 1/1600 s, ISO 100</figcaption>
           </a>
         </figure>
         <figure style="width: 69.127%">
-          <a href="{filename}/static/ship.jpg">
-            <img src="{filename}/static/ship.jpg" />
+          <a href="{static}/static/ship.jpg">
+            <img src="{static}/static/ship.jpg" />
             <figcaption>F9.0, 1/250 s, ISO 100</figcaption>
           </a>
         </figure>
diff --git a/doc/doxygen-test.rst b/doc/doxygen-test.rst
index 3de1aa87..114a0456 100644
--- a/doc/doxygen-test.rst
+++ b/doc/doxygen-test.rst
@@ -27,7 +27,7 @@ Test
 
 :save_as: doxygen/test/index.html
 :breadcrumb: {filename}/doxygen.rst Doxygen theme
-:css: {filename}/static/m-dark.doxygen.compiled.css
+:css: {static}/static/m-dark.doxygen.compiled.css
 
 Lists
 =====
diff --git a/doc/doxygen.rst b/doc/doxygen.rst
index fe5d687e..57bec932 100644
--- a/doc/doxygen.rst
+++ b/doc/doxygen.rst
@@ -162,7 +162,7 @@ If you see something unexpected or not see something expected, check the
 -   Search for symbols using any prefix
 -   Fully controllable by keyboard
 
-.. image:: {filename}/static/opengl-search.png
+.. image:: {static}/static/opengl-search.png
 
 .. note-success::
 
diff --git a/doc/examples/authors/an-author.rst b/doc/examples/authors/an-author.rst
index 1e45b841..301db288 100644
--- a/doc/examples/authors/an-author.rst
+++ b/doc/examples/authors/an-author.rst
@@ -1,7 +1,7 @@
 An Author
 #########
 
-:image: {filename}/static/mosra.jpg
+:image: {static}/static/mosra.jpg
 :badge: Info badge for `An Author <{author}an-author>`_ provided by the
     `Metadata <{filename}/plugins/metadata.rst>`_ plugin.
 
diff --git a/doc/examples/categories/examples.rst b/doc/examples/categories/examples.rst
index a812bba9..bcdfa0c6 100644
--- a/doc/examples/categories/examples.rst
+++ b/doc/examples/categories/examples.rst
@@ -1,7 +1,7 @@
 Examples
 ########
 
-:image: {filename}/static/site.jpg
+:image: {static}/static/site.jpg
 :badge: Info badge for the `Examples <{category}examples>`_ category provided
     by the `Metadata <{filename}/plugins/metadata.rst>`_ plugin.
 
diff --git a/doc/examples/jumbo-article-hide-summary.rst b/doc/examples/jumbo-article-hide-summary.rst
index 75915b11..bdc017a6 100644
--- a/doc/examples/jumbo-article-hide-summary.rst
+++ b/doc/examples/jumbo-article-hide-summary.rst
@@ -28,7 +28,7 @@ Article with hidden summary --- a jumbo one
 .. role:: language-la
     :class: language-la
 
-:cover: {filename}/static/ship.jpg
+:cover: {static}/static/ship.jpg
 :date: 2017-12-06 1:00
 :category: Examples
 :tags: Jumbo, Special
diff --git a/doc/examples/jumbo-article.rst b/doc/examples/jumbo-article.rst
index ba7de9e9..9bbc30eb 100644
--- a/doc/examples/jumbo-article.rst
+++ b/doc/examples/jumbo-article.rst
@@ -28,7 +28,7 @@ An article --- a jumbo one
 .. role:: language-la
     :class: language-la
 
-:cover: {filename}/static/ship.jpg
+:cover: {static}/static/ship.jpg
 :date: 2017-09-08 1:00
 :category: Examples
 :tags: Jumbo
diff --git a/doc/index.rst b/doc/index.rst
index f2cc3c6c..102e3d6d 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -27,7 +27,7 @@ m.css
 
 :save_as: index.html
 :url:
-:cover: {filename}/static/cover.jpg
+:cover: {static}/static/cover.jpg
 :summary: A no-nonsense, no-JavaScript CSS framework and Pelican theme for
     content-oriented websites
 :hide_navbar_brand: True
@@ -60,7 +60,7 @@ m.css
 
                 Get the essence
 
-                | :filesize-gz:`{filename}/../css/m-dark.compiled.css` of gzipped CSS,
+                | :filesize-gz:`{static}/../css/m-dark.compiled.css` of gzipped CSS,
                 | licensed under MIT
 
 .. container:: m-row m-container-inflate
@@ -69,7 +69,7 @@ m.css
 
         .. block-success:: *Pure* CSS and HTML
 
-            Everything you need is :filesize-gz:`{filename}/../css/m-dark.compiled.css`
+            Everything you need is :filesize-gz:`{static}/../css/m-dark.compiled.css`
             of compressed CSS. This framework has exactly 0 bytes of JavaScript
             because *nobody actually needs it*. Even for responsive websites.
 
diff --git a/doc/pelican/theme.rst b/doc/pelican/theme.rst
index ddcdfe45..7a84eb70 100644
--- a/doc/pelican/theme.rst
+++ b/doc/pelican/theme.rst
@@ -353,10 +353,10 @@ element. Indenting the lines is possible by putting an escaped space in front
     ########
 
     :css:
-        {filename}/static/webgl.css
-        {filename}/static/canvas-controls.css
+        {static}/static/webgl.css
+        {static}/static/canvas-controls.css
     :js:
-        {filename}/static/showcase.js
+        {static}/static/showcase.js
     :html_header:
         <script>
         \   function handleDrop(event) {
@@ -427,7 +427,7 @@ destination and URL.
 
     :save_as: index.html
     :url:
-    :cover: {filename}/static/cover.jpg
+    :cover: {static}/static/cover.jpg
     :hide_navbar_brand: True
     :landing:
         .. container:: m-row
@@ -577,7 +577,7 @@ social links:
 
     :save_as: index.html
     :url:
-    :cover: {filename}/static/cover.jpg
+    :cover: {static}/static/cover.jpg
     :summary: This is the brand you need.
 
 .. block-success:: Recommended sizes for cover images
@@ -645,7 +645,7 @@ title and subtitle that's then rendered in a different font size. Example:
     An article --- a jumbo one
     ##########################
 
-    :cover: {filename}/static/ship.jpg
+    :cover: {static}/static/ship.jpg
     :summary: Article summary paragraph.
 
     Article contents.
@@ -746,7 +746,7 @@ Example:
     An article without explicit summary
     ###################################
 
-    :cover: {filename}/static/ship.jpg
+    :cover: {static}/static/ship.jpg
     :hide_summary: True
 
     Implicit article summary paragraph.
diff --git a/doc/pelican/writing-content.rst b/doc/pelican/writing-content.rst
index 3347b7a9..a4e6e9d9 100644
--- a/doc/pelican/writing-content.rst
+++ b/doc/pelican/writing-content.rst
@@ -195,7 +195,7 @@ Example and corresponding output, note the indentation:
 
         Info block content.
 
-        .. figure:: {filename}/static/ship-small.jpg
+        .. figure:: {static}/static/ship-small.jpg
             :alt: Image alt text
 
             Figure title
diff --git a/doc/plugins/htmlsanity.rst b/doc/plugins/htmlsanity.rst
index 309025fa..98ee485c 100644
--- a/doc/plugins/htmlsanity.rst
+++ b/doc/plugins/htmlsanity.rst
@@ -295,7 +295,7 @@ making use of both fields could look like this:
 
     :date: 2017-06-22
     :legal: This article is released under `CC0 {filename}/license.rst`_.
-    :cover: {filename}/img/article-cover.jpg
+    :cover: {static}/img/article-cover.jpg
 
 `SITEURL formatting`_
 ---------------------
diff --git a/doc/plugins/images-test.rst b/doc/plugins/images-test.rst
index 72fa1144..0bf00f89 100644
--- a/doc/plugins/images-test.rst
+++ b/doc/plugins/images-test.rst
@@ -36,32 +36,32 @@ All images should have no ``alt`` text, unless specified manually.
 
 Image with link:
 
-.. image:: {filename}/static/ship-small.jpg
-    :target: {filename}/static/ship.jpg
+.. image:: {static}/static/ship-small.jpg
+    :target: {static}/static/ship.jpg
 
 Image, class on top, custom alt:
 
-.. image:: {filename}/static/ship.jpg
+.. image:: {static}/static/ship.jpg
     :class: m-fullwidth
     :alt: A Ship
 
 Image with link, class on top:
 
-.. image:: {filename}/static/ship.jpg
-    :target: {filename}/static/ship.jpg
+.. image:: {static}/static/ship.jpg
+    :target: {static}/static/ship.jpg
     :class: m-fullwidth
 
 Figure with link and only a caption:
 
-.. figure:: {filename}/static/ship-small.jpg
-    :target: {filename}/static/ship.jpg
+.. figure:: {static}/static/ship-small.jpg
+    :target: {static}/static/ship.jpg
 
     A Ship
 
 Figure with link and class on top:
 
-.. figure:: {filename}/static/ship-small.jpg
-    :target: {filename}/static/ship.jpg
+.. figure:: {static}/static/ship-small.jpg
+    :target: {static}/static/ship.jpg
     :figclass: m-fullwidth
 
     A Ship
@@ -70,8 +70,8 @@ Image grid, not inflated:
 
 .. image-grid::
 
-    {filename}/static/ship.jpg
-    {filename}/static/flowers.jpg
+    {static}/static/ship.jpg
+    {static}/static/flowers.jpg
 
 Image grid, inflated:
 
@@ -79,5 +79,5 @@ Image grid, inflated:
 
     .. image-grid::
 
-        {filename}/static/flowers.jpg
-        {filename}/static/ship.jpg
+        {static}/static/flowers.jpg
+        {static}/static/ship.jpg
diff --git a/doc/plugins/images.rst b/doc/plugins/images.rst
index c554a5df..f3ab731f 100644
--- a/doc/plugins/images.rst
+++ b/doc/plugins/images.rst
@@ -108,12 +108,12 @@ option for both images and figures.
 
         .. container:: m-col-m-6
 
-            .. image:: {filename}/static/flowers-small.jpg
-                :target: {filename}/static/flowers.jpg
+            .. image:: {static}/static/flowers-small.jpg
+                :target: {static}/static/flowers.jpg
 
         .. container:: m-col-m-6
 
-            .. figure:: {filename}/static/ship-small.jpg
+            .. figure:: {static}/static/ship-small.jpg
 
                 A Ship
 
@@ -138,23 +138,23 @@ with non-repeating images, head over to `my blog <http://blog.mosra.cz/cesty/mai
 
     .. image-grid::
 
-        {filename}/ship.jpg
-        {filename}/flowers.jpg
+        {static}/ship.jpg
+        {static}/flowers.jpg
 
-        {filename}/flowers.jpg
-        {filename}/ship.jpg
+        {static}/flowers.jpg
+        {static}/ship.jpg
 
 .. image-grid::
 
-    {filename}/static/ship.jpg
-    {filename}/static/flowers.jpg
+    {static}/static/ship.jpg
+    {static}/static/flowers.jpg
 
-    {filename}/static/flowers.jpg
-    {filename}/static/ship.jpg
+    {static}/static/flowers.jpg
+    {static}/static/ship.jpg
 
 .. note-warning::
 
     Unlike with the image and figure directives above, Pelican *needs* to have
     the images present on a filesystem to extract size information. It's
-    advised to use the builtin *absolute* ``{filename}`` or ``{attach}`` syntax
+    advised to use the builtin *absolute* ``{static}`` or ``{attach}`` syntax
     for `linking to internal content <http://docs.getpelican.com/en/stable/content.html#linking-to-internal-content>`_.
diff --git a/doc/plugins/links.rst b/doc/plugins/links.rst
index 77de9354..c78c2a8a 100644
--- a/doc/plugins/links.rst
+++ b/doc/plugins/links.rst
@@ -381,16 +381,16 @@ deriving the role and adding the :rst:`:class:` option.
             :class: m-text m-success
 
         The compiled ``m-dark.compiled.css`` CSS file has
-        :filesize:`{filename}/../css/m-dark.compiled.css` but only
-        :filesize-yay:`{filename}/../css/m-dark.compiled.css` when the server
+        :filesize:`{static}/../css/m-dark.compiled.css` but only
+        :filesize-yay:`{static}/../css/m-dark.compiled.css` when the server
         sends it compressed.
 
     .. role:: filesize-yay(filesize-gz)
         :class: m-text m-success
 
     The compiled ``m-dark.compiled.css`` CSS file has
-    :filesize:`{filename}/../css/m-dark.compiled.css` but only
-    :filesize-yay:`{filename}/../css/m-dark.compiled.css` when the server
+    :filesize:`{static}/../css/m-dark.compiled.css` but only
+    :filesize-yay:`{static}/../css/m-dark.compiled.css` when the server
     sends it compressed.
 
 `Aliases`_
diff --git a/doc/plugins/metadata.rst b/doc/plugins/metadata.rst
index 00f351c1..2a5d727b 100644
--- a/doc/plugins/metadata.rst
+++ b/doc/plugins/metadata.rst
@@ -135,7 +135,7 @@ and matching an author named *John Doe*:
 
     :twitter: @se7en
     :twitter_id: 7777777
-    :image: {filename}/authors/john-doe.jpg
+    :image: {static}/authors/john-doe.jpg
     :description: I'm not that serial killer.
     :summary: I'm really not that serial killer.
     :badge: No, really, don't confuse me with that guy.
@@ -206,7 +206,7 @@ and matching a category named *Guest posts*:
     Posts by our users
     ##################
 
-    :image: {filename}/categories/guest-posts.jpg
+    :image: {static}/categories/guest-posts.jpg
     :description: User stories and product reviews
     :summary: Stories of our users and honest reviews of our product.
     :badge: This article is a guest post. Want to share your story as well? Head
diff --git a/pelican-plugins/m/test/images/page.rst b/pelican-plugins/m/test/images/page.rst
index 3be7a03d..3dbbf5b5 100644
--- a/pelican-plugins/m/test/images/page.rst
+++ b/pelican-plugins/m/test/images/page.rst
@@ -5,28 +5,28 @@ m.images
 
 Image:
 
-.. image:: {filename}/ship.jpg
+.. image:: {static}/ship.jpg
 
 Image with link:
 
-.. image:: {filename}/ship.jpg
-    :target: {filename}/ship.jpg
+.. image:: {static}/ship.jpg
+    :target: {static}/ship.jpg
 
 Image, class on top, custom alt:
 
-.. image:: {filename}/ship.jpg
+.. image:: {static}/ship.jpg
     :class: m-fullwidth
     :alt: A Ship
 
 Image with link, class on top:
 
-.. image:: {filename}/ship.jpg
-    :target: {filename}/ship.jpg
+.. image:: {static}/ship.jpg
+    :target: {static}/ship.jpg
     :class: m-fullwidth
 
 Figure:
 
-.. figure:: {filename}/ship.jpg
+.. figure:: {static}/ship.jpg
 
     A Ship
 
@@ -34,15 +34,15 @@ Figure:
 
 Figure with link and only a caption:
 
-.. figure:: {filename}/ship.jpg
-    :target: {filename}/ship.jpg
+.. figure:: {static}/ship.jpg
+    :target: {static}/ship.jpg
 
     A Ship
 
 Figure with link and class on top:
 
-.. figure:: {filename}/ship.jpg
-    :target: {filename}/ship.jpg
+.. figure:: {static}/ship.jpg
+    :target: {static}/ship.jpg
     :figclass: m-fullwidth
 
     A Ship
@@ -51,18 +51,18 @@ Image grid:
 
 .. image-grid::
 
-    {filename}/ship.jpg
-    {filename}/flowers.jpg
+    {static}/ship.jpg
+    {static}/flowers.jpg
 
-    {filename}/flowers.jpg
-    {filename}/ship.jpg
+    {static}/flowers.jpg
+    {static}/ship.jpg
 
 Image grid with a PNG file, JPEG with sparse EXIF data, JPEG with no EXIF data
 and long exposure (>1 second):
 
 .. image-grid::
 
-    {filename}/tiny.png
-    {filename}/sparseexif.jpg
-    {filename}/noexif.jpg
-    {filename}/longexposure.jpg
+    {static}/tiny.png
+    {static}/sparseexif.jpg
+    {static}/noexif.jpg
+    {static}/longexposure.jpg
diff --git a/pelican-plugins/m/test/metadata/authors/an-author.rst b/pelican-plugins/m/test/metadata/authors/an-author.rst
index 60b43bd6..9abc3385 100644
--- a/pelican-plugins/m/test/metadata/authors/an-author.rst
+++ b/pelican-plugins/m/test/metadata/authors/an-author.rst
@@ -3,7 +3,7 @@ Author name, displayed on top of the author page
 
 :twitter: @czmosra
 :twitter_id: 1537427036
-:image: {filename}/mosra.jpg
+:image: {static}/mosra.jpg
 :description: Author description, used for a <meta name="description"> tag.
 :summary: Author summary, used for the social <meta> tags.
 :badge: Contents of the badge, displayed at article bottom.
diff --git a/pelican-plugins/m/test/metadata/categories/a-category.rst b/pelican-plugins/m/test/metadata/categories/a-category.rst
index d092d7a2..07ae2823 100644
--- a/pelican-plugins/m/test/metadata/categories/a-category.rst
+++ b/pelican-plugins/m/test/metadata/categories/a-category.rst
@@ -1,7 +1,7 @@
 A category name, displayed on top of the category badge/details
 ###############################################################
 
-:image: {filename}/category.jpg
+:image: {static}/category.jpg
 :description: Category description, used for a <meta name="description"> tag.
 :summary: Category summary, used for the social <meta> tags.
 :badge: Contents of the badge, displayed at article bottom.
diff --git a/pelican-theme/test/blog/article-jumbo.rst b/pelican-theme/test/blog/article-jumbo.rst
index 951b582c..fe0da7f1 100644
--- a/pelican-theme/test/blog/article-jumbo.rst
+++ b/pelican-theme/test/blog/article-jumbo.rst
@@ -7,7 +7,7 @@ An article — a jumbo one
 :date: 2017-12-08
 :category: Another category
 :tags: Fourth, First, Third
-:cover: {filename}/ship.jpg
+:cover: {static}/ship.jpg
 :summary: A summary.
     On multiple
     lines.
diff --git a/pelican-theme/test/page_cover/page.rst b/pelican-theme/test/page_cover/page.rst
index 7de7350a..b6681ffc 100644
--- a/pelican-theme/test/page_cover/page.rst
+++ b/pelican-theme/test/page_cover/page.rst
@@ -1,7 +1,7 @@
 A page
 ######
 
-:cover: {filename}/ship.jpg
+:cover: {static}/ship.jpg
 :header: This is visible on the top and doesn't break the layout.
 :footer: This is visible on the bottom.
 
diff --git a/pelican-theme/test/page_landing/hide-navbar-brand.rst b/pelican-theme/test/page_landing/hide-navbar-brand.rst
index 3ff5ab23..1005eec6 100644
--- a/pelican-theme/test/page_landing/hide-navbar-brand.rst
+++ b/pelican-theme/test/page_landing/hide-navbar-brand.rst
@@ -1,7 +1,7 @@
 A page
 ######
 
-:cover: {filename}/ship.jpg
+:cover: {static}/ship.jpg
 :hide_navbar_brand: True
 :landing:
     .. container:: m-row
diff --git a/pelican-theme/test/page_landing/page.rst b/pelican-theme/test/page_landing/page.rst
index 42d07b79..b1014c66 100644
--- a/pelican-theme/test/page_landing/page.rst
+++ b/pelican-theme/test/page_landing/page.rst
@@ -1,7 +1,7 @@
 A page title that displays only in title
 ########################################
 
-:cover: {filename}/ship.jpg
+:cover: {static}/ship.jpg
 :header: This shouldn't be visible anywhere.
 :footer: This is visible on the bottom.
 :landing: