From 676c7adfc1c64330ca57b119e4bc0af987e6e17a Mon Sep 17 00:00:00 2001
From: "max.mehl" <max.mehl@fsfe.org>
Date: Mon, 9 Mar 2020 14:12:41 +0100
Subject: [PATCH] add and document extra classes and parameters

---
 README.md                      |  3 ++-
 layouts/shortcodes/figure.html | 48 ++++++++++++++++++----------------
 static/css/snap-gallery.css    |  5 ++++
 3 files changed, 32 insertions(+), 24 deletions(-)

diff --git a/README.md b/README.md
index 86adf0e..67638c3 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,8 @@ Specifying your image files:
 Optional parameters:
 
 - All the [features/parameters](https://gohugo.io/content-management/shortcodes/#figure) of Hugo's built-in `figure` shortcode work as normal, i.e. src, link, rel, title, caption, class, attr (attribution), attrlink, alt. width and height might lead to strange results when used inside `{{< gallery >}}`.
-- `class` allows you to set any custom classes you want on the `<figure>` tag.
+- `class` allows you to set any custom classes you want on the `<figure>` tag. The values `no-border`, `small`, `medium`, `pull-left` and `pull-right` are made available by this project.
+- `lightbox` allows you to control the lightbox. The value `none` will disable the lightbox completely.
 
 Optional parameters work for standalone `{{< figure >}}` shortcodes and inside of `{{< gallery >}}`. However, they cannot be applied to `{{< snap-dir >}}`.
 
diff --git a/layouts/shortcodes/figure.html b/layouts/shortcodes/figure.html
index 3621228..b58b09b 100644
--- a/layouts/shortcodes/figure.html
+++ b/layouts/shortcodes/figure.html
@@ -40,7 +40,7 @@
          {{- with .Get "rel" }} rel="{{ . }}"{{ end -}}
          >
     {{ else -}}
-      <a href="#{{ $id }}">
+      {{ if not (eq (.Get "lightbox") "none") }}<a href="#{{ $id }}">{{ end }}
     {{- end -}}
     <!-- THUMBNAIL -->
       <img src="{{ $thumb | relURL }}" class="snap-thumb"
@@ -57,29 +57,31 @@
       {{- end }}
     </a>
     <!-- FULL IMAGE; HIDDEN -->
-    <div class="snap-lightbox" id="{{ $id }}">
-      <a href="#_" class="snap-lightbox-close"></a>
-      <div class="snap-lightbox-inner">
-        <img src="{{ .Get "src" }}" {{ with .Get "alt" }}alt="{{ . }}"{{ end }} />
-        <p>
-        {{- if or (.Get "caption") (.Get "attr") -}}
-          {{- .Get "caption" | markdownify -}}
-          {{- with .Get "attrlink" }} <a href="{{ . }}">{{- end -}}
-          {{- with .Get "attr" }} {{ . | markdownify}}{{ end -}}
-          {{- with .Get "attrlink" }}</a>{{- end -}}
+    {{- if not (eq (.Get "lightbox") "none") -}}
+      <div class="snap-lightbox" id="{{ $id }}">
+        <a href="#_" class="snap-lightbox-close"></a>
+        <div class="snap-lightbox-inner">
+          <img src="{{ .Get "src" }}" {{ with .Get "alt" }}alt="{{ . }}"{{ end }} />
+          <p>
+          {{- if or (.Get "caption") (.Get "attr") -}}
+            {{- .Get "caption" | markdownify -}}
+            {{- with .Get "attrlink" }} <a href="{{ . }}">{{- end -}}
+            {{- with .Get "attr" }} {{ . | markdownify}}{{ end -}}
+            {{- with .Get "attrlink" }}</a>{{- end -}}
+          {{- end }}
+          </p>
+        </div>
+        <a href="#_" class="snap-lightbox-close-button"><i class="snap-lightbox-x"></i></a>
+        {{- if .Parent -}}
+          {{- if not (eq $figid 1) -}}
+            <a href="#{{ $previd }}" class="snap-lightbox-prev"><i class="snap-lightbox-arrow"></i></a>
+          {{- else -}}
+            <span class="snap-lightbox-prev"><i class="snap-lightbox-arrow"></i></span>
+          {{- end -}}
+          <!-- TODO: Somehow try to identify whether this is the last element in the gallery -->
+          <a href="#{{ $nextid }}" class="snap-lightbox-next"><i class="snap-lightbox-arrow"></i></a>
         {{- end }}
-        </p>
       </div>
-      <a href="#_" class="snap-lightbox-close-button"><i class="snap-lightbox-x"></i></a>
-      {{- if .Parent -}}
-        {{- if not (eq $figid 1) -}}
-          <a href="#{{ $previd }}" class="snap-lightbox-prev"><i class="snap-lightbox-arrow"></i></a>
-        {{- else -}}
-          <span class="snap-lightbox-prev"><i class="snap-lightbox-arrow"></i></span>
-        {{- end -}}
-        <!-- TODO: Somehow try to identify whether this is the last element in the gallery -->
-        <a href="#{{ $nextid }}" class="snap-lightbox-next"><i class="snap-lightbox-arrow"></i></a>
-      {{- end }}
-    </div>
+    {{- end -}}
   </div>
 </figure>
diff --git a/static/css/snap-gallery.css b/static/css/snap-gallery.css
index e3a0946..32fcdcf 100644
--- a/static/css/snap-gallery.css
+++ b/static/css/snap-gallery.css
@@ -56,6 +56,11 @@ figure figcaption {
   color: #FFF;
 }
 
+/* Extra classes for figures */
+figure.no-border .snap-wrapper {
+  box-shadow: none;
+}
+
 /** GALLERY MARKUP **/
 .snap-gallery {
   margin: 10px;