Tweak scss-docs shortcode

site/layouts/shortcodes/scss-docs.html

@@ -5,29 +5,34 @@
     comments in the docs.
 
     Optional parameters:
-    strip-default: Remove the ` !default` flag from variable assignments - default: `true`
+      * strip-default: Remove the ` !default` flag from variable assignments - default: `true`
 */ -}}
 
 {{- $name := .Get "name" -}}
 {{- $file := .Get "file" -}}
 {{- $strip_default := .Get "strip-default" | default "true" -}}
 
-{{- $start := printf "// scss-docs-start %s\n" $name -}}
+{{- /* If any parameters are missing, print an error and exit */ -}}
-{{- $end := printf "\n// scss-docs-end %s" $name -}}
+{{- if or (not $name) (not $file) -}}
-{{- $regex := printf "%s(.|\n)*%s" $start $end -}}
+  {{- errorf "Missing required parameters! Got: name=%q file=%q! (called in %q)" $name $file $.Page.Path -}}
+{{- else -}}
+  {{- $start := printf "// scss-docs-start %s\n" $name -}}
+  {{- $end := printf "\n// scss-docs-end %s" $name -}}
+  {{- $regex := printf "%s(.|\n)*%s" $start $end -}}
 
-{{- $css := readFile $file -}}
+  {{- $css := readFile $file -}}
-{{- $match := findRE $regex $css 1 -}}
+  {{- $match := findRE $regex $css 1 -}}
 
-{{- if (eq (len $match) 0) -}}
+  {{- if (eq (len $match) 0) -}}
-  {{- errorf "Got no matches for %q in %q! (called in %q)" $name $file $.Page.Path -}}
+    {{- errorf "Got no matches for name=%q in file=%q! (called in %q)" $name $file $.Page.Path -}}
+  {{- end -}}
+
+  {{- $remove_start := replace (index $match 0) $start "" -}}
+  {{- $result := replace $remove_start $end "" -}}
+
+  {{- if (ne $strip_default "false") -}}
+    {{- $result = replace $result " !default" "" -}}
+  {{- end -}}
+
+  {{- highlight $result "scss" "" -}}
 {{- end -}}
-
-{{- $remove_start := replace (index $match 0) $start "" -}}
-{{- $result := replace $remove_start $end "" -}}
-
-{{- if (ne $strip_default "false") -}}
-  {{- $result = replace $result " !default" "" -}}
-{{- end -}}
-
-{{- highlight $result "scss" "" -}}