implement a github reference for auto-code blocks

Author: titusfortner

website_and_docs/assets/scss/_tabpane.scss

@@ -1,5 +1,11 @@
-div.nocode {
+.tab-pane .nocode {
   border-bottom: 1px solid #dee2e6;
   margin: 2rem 0 2rem 0;
   padding-bottom: 1rem;
 }
+
+.tab-pane .github {
+  text-align: center;
+  margin: 0 0 1rem 0;
+  font-weight: 600;
+}

website_and_docs/content/documentation/about/style.en.md

@@ -173,6 +173,32 @@ You need to specify which parts are code and which are not yourself now, like th
     < ... >
     {{</* /tabpane */>}}
 
+### Link to GitHub
+
+If you disable code blocks, you can create whatever kind of link anywhere you want.
+But say you want to add a GitHub link associated with a given tab when using the default code block:
+{{< tabpane >}}
+  {{< tab header="Link" github="seleniumhq/seleniumhq.github.io/blob/dev/website_and_docs/content/documentation/about/style.en.md#L205" >}}
+    Content in automatic code block that refers to something on GitHub
+  {{< /tab >}}
+  {{< tab header="No Link" >}}
+    This content should not get linked to GitHub
+  {{< /tab >}}
+{{< /tabpane >}}
+
+To add a link to a particular tab, pass in a `github` value
+to that tab. Note that only the tabs that have this value will have the link added.
+
+    {{</* tabpane */>}}
+      {{</* tab header="Link" github="seleniumhq/seleniumhq.github.io/blob/dev/website_and_docs/content/documentation/about/style.en.md#L205" */>}}
+        Content in automatic code block that refers to something on GitHub
+      {{</* /tab */>}}
+      {{</* tab header="No Link" */>}}
+        This content should not get linked to GitHub
+      {{</* /tab */>}}
+    {{</* /tabpane */>}}
+
+
 ### Code Comments
 
 Minimize code comments because they are difficult to translate.

website_and_docs/layouts/shortcodes/tab.html

@@ -0,0 +1,31 @@
+<!-- Make sure that we are enclosed within a tabpane shortcode block -->
+{{ with $.Parent }}
+{{- if ne $.Parent.Name "tabpane" -}}
+{{- errorf "tab must be used within a tabpane block" -}}
+{{- end -}}
+{{- end -}}
+
+<!-- Prefill header if not given as parameter -->
+{{ $header := default (printf "Tab %v" ( add $.Ordinal 1)) (.Get "header") }}
+
+<!-- store all tab info in dict tab -->
+{{ $tab := dict "header" $header }}
+{{ with $.Get "lang" }}
+{{ $tab = merge $tab (dict "language" ($.Get "lang")) }}
+{{ end }}
+{{ with $.Get "github" }}
+{{ $tab = merge $tab (dict "github" ($.Get "github")) }}
+{{ end }}
+{{ with $.Get "highlight" }}
+{{ $tab = merge $tab (dict "highlight" ($.Get "highlight")) }}
+{{ end }}
+{{ with $.Inner }}
+<!-- Trim any leading and trailing newlines from .Inner, this avoids
+     spurious lines during syntax highlighting -->
+{{ $tab = merge $tab (dict "content" (trim $.Inner "\n")) }}
+{{ end }}
+
+<!-- add dict tab to parent's scratchpad -->
+{{ with .Parent }}
+{{- $.Parent.Scratch.SetInMap "tabs" (printf "%v" $.Ordinal) $tab -}}
+{{ end }}

website_and_docs/layouts/shortcodes/tabpane.html

@@ -49,6 +49,11 @@
     {{- $entryid := printf "tabs-%v-%v" $.Ordinal $index | anchorize -}}
 
     {{- highlight (index . "content") $lang $hloptions -}}
+    {{ if $element.github }}
+      <div class="github nocode">
+        <a href ="https://www.github.com/{{- $element.github -}}">See full example on GitHub.</a>
+      </div>
+    {{end}}
   {{end}}
 
     </div>