feat: Add support for icons in `url_custom`

Close #787
Close #326

archetypes/project/index.md

@@ -30,6 +30,10 @@ url_slides = ""
 url_video = ""
 url_poster = ""
 
+# Custom links (optional).
+#   Uncomment line below to enable. For multiple links, use the form `[{...}, {...}, {...}]`.
+# url_custom = [{icon_pack = "fab", icon="twitter", name="Follow", url = "https://twitter.com"}]
+
 # Featured image
 # To use, add an image named `featured.jpg/png` to your page's folder. 
 [image]

exampleSite/content/project/internal-project/index.md

@@ -29,6 +29,10 @@ url_slides = ""
 url_video = ""
 url_code = ""
 
+# Custom links (optional).
+#   Uncomment line below to enable. For multiple links, use the form `[{...}, {...}, {...}]`.
+url_custom = [{icon_pack = "fab", icon="twitter", name="Follow", url = "https://twitter.com/georgecushen"}]
+
 # Featured image
 # To use, add an image named `featured.jpg/png` to your project's folder. 
 [image]

layouts/partials/css/academic.css

@@ -694,6 +694,12 @@ article {
   box-sizing: border-box;
 }
 
+/* Prevent FA's line height of 1 causing FA button links to be taller than other button links. */
+.btn-links .fab,
+.btn-links .fas {
+  line-height: inherit !important;
+}
+
 .split-header-image {
   position: relative; /* Required for caption positioning */
   clear: both;
@@ -983,7 +989,7 @@ article .article-metadata {
   color: rgba(255,255,255,0.54);
 }
 
-.pub-list-item .pub-links {
+.pub-list-item .btn-links {
   padding-top: 10px;
 }
 

layouts/partials/page_links.html

@@ -120,11 +120,21 @@
 </a>
 {{ end }}
 {{ range $.Params.url_custom }}
-{{ $link := .url }}
-{{ if not (urls.Parse .url).Scheme }}
-{{ $link = (printf "%s%s" $.Dir .url) | relURL }}
-{{ end }}
-<a class="btn btn-outline-primary my-1 mr-1{{ if $is_list }} btn-sm{{end}}" href="{{ $link }}" target="_blank" rel="noopener">
-  {{ .name }}
-</a>
+  {{ $pack := or .icon_pack "fas" }}
+  {{ $pack_prefix := $pack }}
+  {{ if in (slice "fab" "fas" "far" "fal") $pack }}
+    {{ $pack_prefix = "fa" }}
+  {{ end }}
+  {{ $link := .url }}
+  {{ $scheme := (urls.Parse $link).Scheme }}
+  {{ $target := "" }}
+  {{ if not $scheme }}
+    {{ $link = (printf "%s%s" $.Dir .url) | relURL }}
+  {{ else if in (slice "http" "https") $scheme }}
+    {{ $target = "target=\"_blank\" rel=\"noopener\"" }}
+  {{ end }}
+  <a class="btn btn-outline-primary my-1 mr-1{{ if $is_list }} btn-sm{{end}}" href="{{ $link | safeURL }}" {{ $target | safeHTMLAttr }}>
+    {{ if .icon }}<i class="{{ $pack }} {{ $pack_prefix }}-{{ .icon }} {{if .name}}mr-1{{end}}"></i>{{end}}
+    {{ with .name }}{{ . | safeHTML }}{{end}}
+  </a>
 {{ end }}

layouts/partials/page_links_div.html

@@ -19,7 +19,7 @@
 {{ end }}
 
 {{ if $cite_link | or $pdf_link | or .Params.external_link | or .Params.url_preprint | or .Params.url_pdf | or .Params.url_slides | or .Params.url_video | or .Params.url_source | or .Params.url_code | or .Params.url_dataset | or .Params.url_poster | or .Params.url_project | or .Params.url_custom | or .Params.projects | or .Params.slides }}
-<div class="mb-3">
+<div class="btn-links mb-3">
   {{ with .Params.external_link }}
   <a class="btn btn-outline-primary my-1" href="{{ . }}" target="_blank" rel="noopener">{{ i18n "open_project_site" }}</a>
   {{ end }}

layouts/partials/project_li_showcase.html

@@ -39,7 +39,7 @@
       </div>
       {{ end }}
 
-      <div class="talk-links">
+      <div class="btn-links">
         {{ partial "page_links" (dict "content" $item "is_list" 0) }}
       </div>
 

layouts/partials/publication_li_detailed.html

@@ -38,7 +38,7 @@
     {{ .Date.Format "2006" }}
   </div>
 
-  <div class="pub-links">
+  <div class="btn-links">
     {{ partial "page_links" (dict "content" . "is_list" 1) }}
   </div>
 

layouts/partials/publication_li_stream.html

@@ -27,7 +27,7 @@
       </div>
     </div>
 
-    <div class="talk-links">
+    <div class="btn-links">
       {{ partial "page_links" (dict "content" . "is_list" 1) }}
     </div>
 

layouts/partials/talk_li_detailed.html

@@ -42,7 +42,7 @@
     {{ end }}
   </div>
 
-  <div class="talk-links">
+  <div class="btn-links">
     {{ partial "page_links" (dict "content" . "is_list" 1) }}
   </div>
 

layouts/partials/talk_li_simple.html

@@ -15,7 +15,7 @@
             {{ .Params.event | markdownify }}
     {{ end }}
   </div>
-  <div class="talk-links">
+  <div class="btn-links">
     {{ partial "page_links" (dict "content" . "is_list" 1) }}
   </div>
 </div>

layouts/partials/talk_li_stream.html

@@ -43,7 +43,7 @@
       </div>
     </div>
 
-    <div class="talk-links">
+    <div class="btn-links">
       {{ partial "page_links" (dict "content" . "is_list" 1) }}
     </div>