Add image shortcode (#505)

Author: jarrodmillman

assets/theme-css/bulma.css

@@ -11,7 +11,6 @@ input,
 select {
   margin: 0;
 }
-img,
 video {
   height: auto;
   max-width: 100%;
@@ -85,15 +84,6 @@ a.box:active {
   height: 1.5rem;
   width: 1.5rem;
 }
-.image {
-  display: block;
-  position: relative;
-}
-.image img {
-  display: block;
-  height: auto;
-  width: 100%;
-}
 .field:not(:last-child) {
   margin-bottom: 0.75rem;
 }

assets/theme-css/styles.css

@@ -8,6 +8,57 @@ body {
   box-sizing: border-box;
 }
 
+img.align-left,
+figure.align-left,
+.figure.align-left,
+object.align-left {
+  clear: left;
+  float: left;
+  margin-right: 1em;
+}
+
+img.align-right,
+figure.align-right,
+.figure.align-right,
+object.align-right {
+  clear: right;
+  float: right;
+  margin-left: 1em;
+}
+
+img.align-center,
+figure.align-center,
+.figure.align-center,
+object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+img.align-default,
+figure.align-default,
+.figure.align-default {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+  text-align: left;
+}
+
+.align-center {
+  text-align: center;
+}
+
+.align-default {
+  text-align: center;
+}
+
+.align-right {
+  text-align: right;
+}
+
 /**
  * See `code.literal` in
  * src/pydata_sphinx_theme/assets/styles/content/_code.scss

layouts/shortcodes/image.html

@@ -0,0 +1,47 @@
+{{/*
+
+doc: Images
+
+{{< image >}}
+src = 'https://source.unsplash.com/200x200/daily?cute+puppy'
+alt = 'Cute puppies laying in the door of a tiny plastic house'
+{{< /image >}}
+
+A clickable image:
+
+{{< image >}}
+src = 'https://source.unsplash.com/200x200/daily?cute+puppy'
+alt = 'Cute puppies laying in the door of a tiny plastic house'
+target = 'https://unsplash.com/'
+height = 200
+width = 200
+{{< /image >}}
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+{{< image >}}
+src = 'https://source.unsplash.com/200x200/daily?cute+puppy'
+alt = 'Cute puppies laying in the door of a tiny plastic house'
+align = 'right'
+height = 200
+width = 200
+{{< /image >}}
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+{{< admonition note >}}
+For more options, see Hugo embedded [figure shortcode](https://gohugo.io/content-management/shortcodes/#figure).
+{{< /admonition >}}
+
+*/}}
+
+{{- $data := .Inner | transform.Unmarshal -}}
+{{- if $data.target -}}<a href="{{ $data.target }}">{{- end -}}
+<img src="{{ $data.src }}" alt="{{ $data.alt }}"
+         {{- with $data.align }} class="align-{{ . }}"{{ end -}}
+         {{- with $data.width }} width="{{ . }}"{{ end -}}
+         {{- with $data.height }} height="{{ . }}"{{ end -}}
+><!-- Closing img tag -->
+{{- if $data.target }}</a>{{ end -}}