Trying something new

README.rst

 About
 -----
 
-.. image:: https://buildstream.gitlab.io/buildstream/_static/release.svg
-
-.. image:: https://buildstream.gitlab.io/buildstream/_static/snapshot.svg
+.. include:: release-badge.rst
+   
+.. include:: snapshot-badge.rst
 
 .. image:: https://gitlab.com/BuildStream/buildstream/badges/master/pipeline.svg
    :target: https://gitlab.com/BuildStream/buildstream/commits/master

doc/badges.py

@@ -24,45 +24,46 @@ import re
 
 # The badge template is modeled after the gitlab badge svgs
 #
-BADGE_TEMPLATE = """<svg xmlns="http://www.w3.org/2000/svg"
-                         xmlns:xlink="http://www.w3.org/1999/xlink"
-                         width="116" height="20">
-  <a xlink:href="{url_target}">
-    <linearGradient id="b" x2="0" y2="100%">
-      <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
-      <stop offset="1" stop-opacity=".1"/>
-    </linearGradient>
-
-    <mask id="a">
-      <rect width="116" height="20" rx="3" fill="#fff"/>
-    </mask>
-
-    <g mask="url(#a)">
-      <path fill="#555"
-            d="M0 0 h62 v20 H0 z"/>
-      <path fill="{color}"
-            d="M62 0 h54 v20 H62 z"/>
-      <path fill="url(#b)"
-            d="M0 0 h116 v20 H0 z"/>
-    </g>
-
-    <g fill="#fff" text-anchor="middle">
-      <g font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
-        <text x="31" y="15" fill="#010101" fill-opacity=".3">
-          {badge_name}
-        </text>
-        <text x="31" y="14">
-          {badge_name}
-        </text>
-        <text x="89" y="15" fill="#010101" fill-opacity=".3">
-          {version}
-        </text>
-        <text x="89" y="14">
-          {version}
-        </text>
+BADGE_TEMPLATE = """
+<svg xmlns="http://www.w3.org/2000/svg"
+     xmlns:xlink="http://www.w3.org/1999/xlink"
+     width="116" height="20">
+    <a xlink:href="{url_target}">
+      <linearGradient id="{badge_name}_b" x2="0" y2="100%">
+        <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+        <stop offset="1" stop-opacity=".1"/>
+      </linearGradient>
+
+      <mask id="{badge_name}_a">
+        <rect width="116" height="20" rx="3" fill="#fff"/>
+      </mask>
+
+      <g mask="url(#{badge_name}_a)">
+        <path fill="#555"
+              d="M0 0 h62 v20 H0 z"/>
+        <path fill="{color}"
+              d="M62 0 h54 v20 H62 z"/>
+        <path fill="url(#{badge_name}_b)"
+              d="M0 0 h116 v20 H0 z"/>
       </g>
-    </g>
-  </a>
+
+      <g fill="#fff" text-anchor="middle">
+        <g font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+          <text x="31" y="15" fill="#010101" fill-opacity=".3">
+            {badge_name}
+          </text>
+          <text x="31" y="14">
+            {badge_name}
+          </text>
+          <text x="89" y="15" fill="#010101" fill-opacity=".3">
+            {version}
+          </text>
+          <text x="89" y="14">
+            {version}
+          </text>
+        </g>
+      </g>
+    </a>
 </svg>
 """
 

doc/source/install_versions.rst

@@ -17,8 +17,8 @@ tag to ensure you're getting the latest release.
 
 * Latest release:
 
-  .. image:: https://buildstream.gitlab.io/buildstream/_static/release.svg
+  .. include:: release-badge.rst
 
 * Latest development snapshot:
 
-  .. image:: https://buildstream.gitlab.io/buildstream/_static/snapshot.svg
+  .. include:: snapshot-badge.rst

doc/source/main_install.rst

@@ -5,9 +5,9 @@
 Install
 =======
 
-.. image:: https://buildstream.gitlab.io/buildstream/_static/release.svg
-
-.. image:: https://buildstream.gitlab.io/buildstream/_static/snapshot.svg
+.. include:: release-badge.rst
+   
+.. include:: snapshot-badge.rst
 
 This section provides instructions for installing BuildStream and its
 companion artifact server on various platforms, along with any installation

doc/source/release-badge.rst

+
+.. raw:: html
+
+   <a class="reference external image-reference">
+     <object style="margin-bottom:24px;vertical-align:middle" data="./_static/release.svg" type="image/svg+xml"/></object>
+   </a>

doc/source/snapshot-badge.rst

+
+.. raw:: html
+
+   <a class="reference external image-reference">
+     <object style="margin-bottom:24px;vertical-align:middle" data="./_static/snapshot.svg" type="image/svg+xml"/></object>
+   </a>