feat: support host customization for third-party libraries (#389)

Co-authored-by: reuixiy <reuixiy@gmail.com>

14 files changed, 187 insertions, 37 deletions

diff --git a/layouts/partials/third-party/algolia-search.html b/layouts/partials/third-party/algolia-search.html
index 9507fdb..cd5fd8e 100644
--- a/layouts/partials/third-party/algolia-search.html
+++ b/layouts/partials/third-party/algolia-search.html
@@ -1,4 +1,5 @@
-{{- $scripts := slice "https://cdn.jsdelivr.net/npm/instantsearch.js@2/dist/instantsearch.min.js" -}}
+{{- $src := partial "utils/lib.html" (dict "type" "instantsearch") -}}
 
+{{- $scripts := slice $src -}}
 {{- $scripts = union $scripts (slice "js/algolia-search.js") -}}
 {{- return $scripts -}}
diff --git a/layouts/partials/third-party/busuanzi.html b/layouts/partials/third-party/busuanzi.html
index 3c2f17c..7b96f2e 100644
--- a/layouts/partials/third-party/busuanzi.html
+++ b/layouts/partials/third-party/busuanzi.html
@@ -1,5 +1,7 @@
+{{- $src := partial "utils/lib.html" (dict "type" "busuanzi") -}}
+
 {{ if or .Site.Params.displayBusuanziPagePV .Site.Params.displayBusuanziSiteUVAndPV }}
     {{ if eq hugo.Environment "production" }}
-        <script async src="https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>
+        <script async src="{{ $src }}"></script>
     {{ end }}
 {{ end }}
\ No newline at end of file
diff --git a/layouts/partials/third-party/disqus.html b/layouts/partials/third-party/disqus.html
index a7b8c47..f6dcdb0 100644
--- a/layouts/partials/third-party/disqus.html
+++ b/layouts/partials/third-party/disqus.html
@@ -5,13 +5,13 @@
             return;
         }
         if (typeof DISQUS === 'undefined') {
-            var disqus_config = function() {
+            const disqus_config = function() {
                 {{ with .Params.disqus_url | default .Permalink }}this.page.url = '{{ . }}';{{ end }}
                 {{ with .Params.disqus_identifier | default .RelPermalink }}this.page.identifier = '{{ . }}';{{ end }}
                 {{ with .Params.disqus_title | default $rawTitle }}this.page.title = '{{ . }}';{{ end }}
             };
             (function() {
-                var d = document, s = d.createElement('script'); s.async = true;
+                const d = document, s = d.createElement('script'); s.async = true;
                 s.src = 'https://{{ .Site.Params.disqusShortname }}.disqus.com/embed.js';
                 s.setAttribute('data-timestamp', +new Date());
                 (d.head || d.body).appendChild(s);
diff --git a/layouts/partials/third-party/gitalk.html b/layouts/partials/third-party/gitalk.html
index d050bfe..5ba2934 100644
--- a/layouts/partials/third-party/gitalk.html
+++ b/layouts/partials/third-party/gitalk.html
@@ -1,12 +1,15 @@
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.css">
+{{- $src := partial "utils/lib.html" (dict "type" "gitalk") -}}
+{{- $srcCSS := partial "utils/lib.html" (dict "type" "gitalk-css") -}}
+
+<link rel="stylesheet" href="{{ $srcCSS }}">
 <script>
     function loadComments() {
         if (!document.getElementById('gitalk-container')) {
             return;
         }
         if (typeof Gitalk === 'undefined') {
-            var getScript = (options) => {
-                var script = document.createElement('script');
+            const getScript = (options) => {
+                const script = document.createElement('script');
                 script.defer = true;
                 script.crossOrigin = 'anonymous';
                 Object.keys(options).forEach((key) => {
@@ -15,7 +18,7 @@
                 document.body.appendChild(script);
             };
             getScript({
-                src: 'https://cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js',
+                src: '{{ $src }}',
                 onload: () => {
                     newGitalk();
                 }
diff --git a/layouts/partials/third-party/instant-page.html b/layouts/partials/third-party/instant-page.html
index 83a2899..1c9166c 100644
--- a/layouts/partials/third-party/instant-page.html
+++ b/layouts/partials/third-party/instant-page.html
@@ -1 +1,3 @@
-<script src="https://cdn.jsdelivr.net/npm/instant.page@5.1.0/instantpage.min.js" type="module" defer></script>
+{{- $src := partial "utils/lib.html" (dict "type" "instantpage") -}}
+
+<script src="{{ $src }}" type="module" defer></script>
\ No newline at end of file
diff --git a/layouts/partials/third-party/katex.html b/layouts/partials/third-party/katex.html
index 1cd51cf..9fab26a 100644
--- a/layouts/partials/third-party/katex.html
+++ b/layouts/partials/third-party/katex.html
@@ -1,8 +1,13 @@
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.13.0/dist/katex.min.css" integrity="sha256-gPJfuwTULrEAAcI3X4bALVU/2qBU+QY/TpoD3GO+Exw=" crossorigin="anonymous">
+{{- $src := partial "utils/lib.html" (dict "type" "katex") -}}
+{{- $srcCSS := partial "utils/lib.html" (dict "type" "katex-css") -}}
+{{- $srcMhchem := partial "utils/lib.html" (dict "type" "katex-mhchem") -}}
+{{- $srcAutoRender := partial "utils/lib.html" (dict "type" "katex-auto-render") -}}
+
+<link rel="stylesheet" href="{{ $srcCSS }}">
 <script>
     if (typeof renderMathInElement === 'undefined') {
-        var getScript = (options) => {
-            var script = document.createElement('script');
+        const getScript = (options) => {
+            const script = document.createElement('script');
             script.defer = true;
             script.crossOrigin = 'anonymous';
             Object.keys(options).forEach((key) => {
@@ -11,16 +16,13 @@
             document.body.appendChild(script);
         };
         getScript({
-            src: 'https://cdn.jsdelivr.net/npm/katex@0.13.0/dist/katex.min.js',
-            integrity: 'sha256-YTW9cMncW/ZQMhY69KaUxIa2cPTxV87Uh627Gf5ODUw=',
+            src: '{{ $src }}',
             onload: () => {
                 getScript({
-                    src: 'https://cdn.jsdelivr.net/npm/katex@0.13.0/dist/contrib/mhchem.min.js',
-                    integrity: 'sha256-yzSfYeVsWJ1x+2g8CYHsB/Mn7PcSp8122k5BM4T3Vxw=',
+                    src: '{{ $srcMhchem }}',
                     onload: () => {
                         getScript({
-                            src: 'https://cdn.jsdelivr.net/npm/katex@0.13.0/dist/contrib/auto-render.min.js',
-                            integrity: 'sha256-fxJzNV6hpc8tgW8tF0zVobKa71eTCRGTgxFXt1ZpJNM=',
+                            src: '{{ $srcAutoRender }}',
                             onload: () => {
                                 renderKaTex();
                             }
diff --git a/layouts/partials/third-party/lunr-search.html b/layouts/partials/third-party/lunr-search.html
index 90e9aaa..a7214df 100644
--- a/layouts/partials/third-party/lunr-search.html
+++ b/layouts/partials/third-party/lunr-search.html
@@ -1,12 +1,17 @@
-{{- $scripts := slice "https://cdn.jsdelivr.net/npm/lunr@2.3.9/lunr.min.js" -}}
+{{- $src := partial "utils/lib.html" (dict "type" "lunr") -}}
+{{- $srcTinyseg := partial "utils/lib.html" (dict "type" "lunr-tinyseg") -}}
+{{- $srcStemmer := partial "utils/lib.html" (dict "type" "lunr-stemmer") -}}
+{{- $srcLang := partial "utils/lib.html" (dict "type" "lunr-lang" "lang" .Site.Language.Lang) -}}
+
+{{- $scripts := slice $src -}}
 {{- if ne .Site.Language.Lang "en" -}}
     {{- $supported := slice "ar" "da" "de" "du" "es" "fi" "fr" "hu" "it" "ja" "nl" "no" "pt" "ro" "ru" "sv" "tr" "vi" -}}
     {{- if in $supported .Site.Language.Lang -}}
         {{- if eq .Site.Language.Lang "ja" -}}
-            {{- $scripts = union $scripts (slice "https://cdn.jsdelivr.net/npm/lunr-languages@1.4.0/tinyseg.js") -}}
+            {{- $scripts = union $scripts (slice $srcTinyseg) -}}
         {{- end -}}
-        {{- $scripts = union $scripts (slice "https://cdn.jsdelivr.net/npm/lunr-languages@1.4.0/min/lunr.stemmer.support.min.js") -}}
-        {{- $scripts = union $scripts (slice (printf "https://cdn.jsdelivr.net/npm/lunr-languages@1.4.0/min/lunr.%s.min.js" .Site.Language.Lang)) -}}
+        {{- $scripts = union $scripts (slice $srcStemmer) -}}
+        {{- $scripts = union $scripts (slice $srcLang) -}}
     {{- else -}}
         {{- warnf "The site language %q isn't supported by lunr, the search results might be suboptimal. Supported languages are: %q" .Site.Language.Lang $supported -}}
     {{- end -}}
diff --git a/layouts/partials/third-party/mathjax.html b/layouts/partials/third-party/mathjax.html
index ad918f4..e221f46 100644
--- a/layouts/partials/third-party/mathjax.html
+++ b/layouts/partials/third-party/mathjax.html
@@ -1,3 +1,5 @@
+{{- $src := partial "utils/lib.html" (dict "type" "mathjax") -}}
+
 <script>
     if (typeof MathJax === 'undefined') {
         window.MathJax = {
@@ -18,8 +20,8 @@
             }
         };
         (function() {
-            var script = document.createElement('script');
-            script.src = 'https://cdn.jsdelivr.net/npm/mathjax@3.1.2/es5/tex-mml-chtml.js';
+            const script = document.createElement('script');
+            script.src = '{{ $src }}';
             script.defer = true;
             document.head.appendChild(script);
         })();
diff --git a/layouts/partials/third-party/medium-zoom.html b/layouts/partials/third-party/medium-zoom.html
index c9f59e6..b2abf4e 100644
--- a/layouts/partials/third-party/medium-zoom.html
+++ b/layouts/partials/third-party/medium-zoom.html
@@ -1,4 +1,6 @@
-<script src="https://cdn.jsdelivr.net/npm/medium-zoom@latest/dist/medium-zoom.min.js"></script>
+{{- $src := partial "utils/lib.html" (dict "type" "medium-zoom") -}}
+
+<script src="{{ $src }}"></script>
 
 <script>
     let imgNodes = document.querySelectorAll('div.post-body img');
diff --git a/layouts/partials/third-party/mermaid.html b/layouts/partials/third-party/mermaid.html
index e4442e2..8c46ccf 100644
--- a/layouts/partials/third-party/mermaid.html
+++ b/layouts/partials/third-party/mermaid.html
@@ -1,6 +1,8 @@
-<script src="https://cdn.jsdelivr.net/npm/mermaid@8.8.3/dist/mermaid.min.js"></script>
+{{- $src := partial "utils/lib.html" (dict "type" "mermaid") -}}
+
+<script src="{{ $src }}"></script>
 <script>
-    let mermaidConfig = {
+    const mermaidConfig = {
         startOnLoad: true,
         flowchart: {
             useMaxWidth: false,
diff --git a/layouts/partials/third-party/qrcode-generator.html b/layouts/partials/third-party/qrcode-generator.html
index e25bec7..98a00ef 100644
--- a/layouts/partials/third-party/qrcode-generator.html
+++ b/layouts/partials/third-party/qrcode-generator.html
@@ -1,9 +1,11 @@
-<script src="https://cdn.jsdelivr.net/npm/qrcode-generator@1.4.4/qrcode.min.js"></script>
+{{- $src := partial "utils/lib.html" (dict "type" "qrcode") -}}
+
+<script src="{{ $src }}"></script>
 
 <script>
-    var typeNumber = 0;
-    var errorCorrectionLevel = 'L';
-    var qr = qrcode(typeNumber, errorCorrectionLevel);
+    const typeNumber = 0;
+    const errorCorrectionLevel = 'L';
+    const qr = qrcode(typeNumber, errorCorrectionLevel);
     qr.addData('{{ .Permalink }}');
     qr.make();
     document.getElementById('qrcode-img').innerHTML = qr.createImgTag();
diff --git a/layouts/partials/third-party/utterances.html b/layouts/partials/third-party/utterances.html
index d057fda..d04543b 100644
--- a/layouts/partials/third-party/utterances.html
+++ b/layouts/partials/third-party/utterances.html
@@ -1,12 +1,14 @@
+{{- $src := partial "utils/lib.html" (dict "type" "utterances") -}}
+
 <script>
     function loadComments() {
         (function() {
-            var utterances = document.getElementById("utterances");
+            const utterances = document.getElementById("utterances");
             if (!utterances) {
                 return;
             }
-            var script = document.createElement('script');
-            script.src = 'https://utteranc.es/client.js';
+            const script = document.createElement('script');
+            script.src = '{{ $src }}';
             script.async = true;
             script.crossOrigin = 'anonymous';
             script.setAttribute('repo', '{{ .Site.Params.utterancesRepo }}');
diff --git a/layouts/partials/third-party/valine.html b/layouts/partials/third-party/valine.html
index e372eac..04b0575 100644
--- a/layouts/partials/third-party/valine.html
+++ b/layouts/partials/third-party/valine.html
@@ -1,11 +1,13 @@
+{{- $src := partial "utils/lib.html" (dict "type" "valine") -}}
+
 <script>
     function loadComments() {
         if (!document.getElementById('vcomments')) {
             return;
         }
         if (typeof Valine === 'undefined') {
-            var getScript = (options) => {
-                var script = document.createElement('script');
+            const getScript = (options) => {
+                const script = document.createElement('script');
                 script.defer = true;
                 script.crossOrigin = 'anonymous';
                 Object.keys(options).forEach((key) => {
@@ -14,7 +16,7 @@
                 document.body.appendChild(script);
             };
             getScript({
-                src: 'https://cdn.jsdelivr.net/npm/valine@1.4.14/dist/Valine.min.js',
+                src: '{{ $src }}',
                 onload: () => {
                     newValine();
                 }
diff --git a/layouts/partials/utils/lib.html b/layouts/partials/utils/lib.html
new file mode 100644
index 0000000..7f54707
--- /dev/null
+++ b/layouts/partials/utils/lib.html
@@ -0,0 +1,123 @@
+{{- $host := $.Site.Params.lib.host | default "https://cdn.jsdelivr.net" -}}
+{{- $path := "" -}}
+{{- $type := .type -}}
+{{- $lang := .lang -}}
+
+<!--
+
+  Common libraries
+
+--->
+
+{{- if eq $type "clipboard" -}}
+    {{- $defalut := "/npm/clipboard-polyfill@2.8.6/dist/clipboard-polyfill.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.clipboard | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "instantsearch" -}}
+    {{- $defalut := "/npm/instantsearch.js@2/dist/instantsearch.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.instantsearch | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "gitalk" -}}
+    {{- $defalut := "/npm/gitalk@1/dist/gitalk.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.gitalk | default $defalut -}}
+{{- end -}}
+{{- if eq $type "gitalk-css" -}}
+    {{- $dafault := "/npm/gitalk@1/dist/gitalk.css" -}}
+    {{- $path = $.Site.Params.lib.path.gitalk-css | default $dafault -}}
+{{- end -}}
+
+{{- if eq $type "instantpage" -}}
+    {{- $default := "/npm/instant.page@5.1.0/instantpage.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.instantpage | default $default -}}
+{{- end -}}
+
+{{- if eq $type "katex" -}}
+    {{- $defalut := "/npm/katex@0.13.0/dist/katex.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.katex | default $defalut -}}
+{{- end -}}
+{{- if eq $type "katex-css" -}}
+    {{- $defalut := "/npm/katex@0.13.0/dist/katex.min.css" -}}
+    {{- $path = $.Site.Params.lib.path.katex-css | default $defalut -}}
+{{- end -}}
+{{- if eq $type "katex-mhchem" -}}
+    {{- $defalut := "/npm/katex@0.13.0/dist/contrib/mhchem.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.katex-mhchem | default $defalut -}}
+{{- end -}}
+{{- if eq $type "katex-auto-render" -}}
+    {{- $defalut := "/npm/katex@0.13.0/dist/contrib/auto-render.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.katex-auto-render | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "lunr" -}}
+    {{- $defalut := "/npm/lunr@2.3.9/lunr.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.lunr | default $defalut -}}
+{{- end -}}
+{{- if eq $type "lunr-tinyseg" -}}
+    {{- $defalut := "/npm/lunr-languages@1.4.0/tinyseg.js" -}}
+    {{- $path = $.Site.Params.lib.path.lunr-tinyseg | default $defalut -}}
+{{- end -}}
+{{- if eq $type "lunr-stemmer" -}}
+    {{- $defalut := "/npm/lunr-languages@1.4.0/min/lunr.stemmer.support.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.lunr-stemmer | default $defalut -}}
+{{- end -}}
+{{- if eq $type "lunr-lang" -}}
+    {{- $defalut := printf "/npm/lunr-languages@1.4.0/min/lunr.%s.min.js" $lang -}}
+    {{- $path = $.Site.Params.lib.path.lunr-lang | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "mathjax" -}}
+    {{- $defalut := "/npm/mathjax@3.1.2/es5/tex-mml-chtml.js" -}}
+    {{- $path = $.Site.Params.lib.path.mathjax | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "medium-zoom" -}}
+    {{- $defalut := "/npm/medium-zoom@latest/dist/medium-zoom.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.medium-zoom | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "mermaid" -}}
+    {{- $defalut := "/npm/mermaid@8.8.3/dist/mermaid.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.mermaid | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "qrcode" -}}
+    {{- $defalut := "/npm/qrcode-generator@1.4.4/qrcode.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.qrcode | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "valine" -}}
+    {{- $defalut := "/npm/valine@1.4.14/dist/Valine.min.js" -}}
+    {{- $path = $.Site.Params.lib.path.valine | default $defalut -}}
+{{- end -}}
+
+<!--
+
+  Third-party services
+
+--->
+
+{{- if eq $type "busuanzi" -}}
+    {{- $defalut := "https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js" -}}
+    {{- $host = $.Site.Params.lib.path.busuanzi | default $defalut -}}
+{{- end -}}
+
+{{- if eq $type "utterances" -}}
+    {{- $defalut := "https://utteranc.es/client.js" -}}
+    {{- $host = $.Site.Params.lib.path.utterances | default $defalut -}}
+{{- end -}}
+
+<!--
+
+  Third-party libraries/services/resources which not included in this file:
+
+    1. Disqus
+    2. Google Analytics
+    3. Google Adsense
+    4. Yandex Metrika
+    5. Other hosts customized in config.toml
+
+--->
+
+{{- return printf `%s%s` $host $path -}}