feat: add the docs/repo widget

assets/icons/index.js

@@ -3,7 +3,7 @@ import {
   faAdjust, faArrowsAltV, faBars, faBuilding, faCheckCircle, faChevronCircleDown,
   faCode, faCoffee, faComments, faColumns, faCopy, faCopyright, faEdit, faEllipsisV,
   faEnvelope, faExclamationTriangle, faExpandAlt, faEyeDropper, faFont, faFileAlt, faFileArchive,
-  faFolder, faHome, faInfoCircle, faLanguage, faLink, faList, faListAlt, faMapMarkerAlt, faPalette,
+  faFolder, faHistory, faHome, faInfoCircle, faLanguage, faLink, faList, faListAlt, faMapMarkerAlt, faPalette,
   faQuestion, faQuestionCircle, faRedoAlt, faRss, faSearch, faShareAlt, faSkullCrossbones,
   faSpinner, faTags, faThumbtack, faTimes, faTv, faUndo, faUser, faExternalLinkAlt,
 } from '@fortawesome/free-solid-svg-icons';
@@ -24,7 +24,7 @@ let icons = [
   faAdjust, faArrowsAltV, faBars, faBuilding, faCheckCircle, faChevronCircleDown,
   faCode, faCoffee, faComments, faColumns, faCopy, faCopyright, faEdit, faEllipsisV,
   faEnvelope, faExclamationTriangle, faExpandAlt, faEyeDropper, faFont, faFileAlt, faFileArchive,
-  faFolder, faHome, faInfoCircle, faLanguage, faLink, faList, faListAlt, faMapMarkerAlt, faPalette,
+  faFolder, faHistory, faHome, faInfoCircle, faLanguage, faLink, faList, faListAlt, faMapMarkerAlt, faPalette,
   faQuestion, faQuestionCircle, faRedoAlt, faRss, faSearch, faShareAlt, faSkullCrossbones,
   faSpinner, faTags, faThumbtack, faTimes, faTv, faUndo, faUser, faExternalLinkAlt,
 

exampleSite/config/_default/params.toml

@@ -160,3 +160,9 @@ viewer = true # Image Viewer
   endpoint = "https://getform.io/f/56041c81-9e03-4c24-b9c5-61238854d4cd" # Backend endpoint, remove this line if you're using Netlify.
   # file = true # Enable file upload
   # fileField = "image" # The name of file field.
+
+[repo]
+  url = "https://github.com/razonyang/hugo-theme-bootstrap"
+  # branch = "main"
+  subPath = "exampleSite"
+  # dateFormat = "02/01/2006, 15:04:05 PM"

exampleSite/layouts/partials/hooks/docs/sidebar-end.html

@@ -1 +1,2 @@
+{{ partial "docs/repo" . }}
 {{ partial "sidebar/recent-posts" . }}

i18n/en.toml

@@ -155,6 +155,15 @@ other = "Recent Posts"
 [related_posts]
 other = "Related Posts"
 
+[repo_action_edit]
+other = "Edit this page"
+
+[repo_action_view]
+other = "View page source"
+
+[repo_title]
+other = "Repository"
+
 [search]
 other = "Search"
 

i18n/zh-cn.toml

@@ -145,6 +145,15 @@ other = "最近文章"
 [related_posts]
 other = "相关文章"
 
+[repo_action_edit]
+other = "编辑当前页"
+
+[repo_action_view]
+other = "查看源代码"
+
+[repo_title]
+other = "仓库"
+
 [search]
 other = "搜索"
 

i18n/zh-hk.toml

@@ -145,6 +145,15 @@ other = "最近文章"
 [related_posts]
 other = "相關文章"
 
+[repo_action_edit]
+other = "編輯當前頁"
+
+[repo_action_view]
+other = "查看源代碼"
+
+[repo_title]
+other = "倉庫"
+
 [search]
 other = "搜索"
 

i18n/zh-tw.toml

@@ -145,6 +145,15 @@ other = "最近文章"
 [related_posts]
 other = "相關文章"
 
+[repo_action_edit]
+other = "編輯當前頁"
+
+[repo_action_view]
+other = "查看源代碼"
+
+[repo_title]
+other = "倉庫"
+
 [search]
 other = "搜尋"
 

layouts/partials/docs/repo.html

@@ -0,0 +1,37 @@
+{{- with $.Site.Params.repo -}}
+{{- $url := .url -}}
+{{- $branch := default "master" .branch -}}
+{{- $dateFormat := default "02/01/2006, 15:04:05 PM" .dateFormat -}}
+{{- $subPath := default "" .subPath -}}
+{{- if $subPath -}}{{ $subPath = printf "/%s" $subPath }}{{- end -}}
+<div class="docs-repo row card component">
+    <div class="card-header">
+        <h2 class="card-title">{{ i18n "repo_title" }}</h2>
+    </div>
+    <div class="card-body">
+        <ul class="list-unstyled">
+            {{- if $.File -}}
+            {{- $filePath := printf "%s%s/content/%s" $branch $subPath $.File.Path -}}
+            <li>
+                <a href="{{ printf "%s/blob/%s" $url $filePath }}" target="_blank" rel="noopener noreferrer">
+                    <i class="fas fa-fw fa-file-archive"></i> {{ i18n "repo_action_view" }}
+                </a>
+            </li>
+            <li>
+                <a href="{{ printf "%s/edit/%s" $url $filePath  }}" target="_blank" rel="noopener noreferrer">
+                    <i class="fas fa-fw fa-edit"></i> {{ i18n "repo_action_edit" }}
+                </a>
+            </li>
+            {{- end -}}
+            {{- with $.GitInfo -}}
+            <li>
+                <i class="fas fa-fw fa-code"></i> <a href="{{ printf "%s/commit/%s" $url .Hash }}" target="_blank" rel="noopener noreferrer">{{ .AbbreviatedHash }}</a>
+            </li>
+            <li>
+                <i class="fas fa-fw fa-history"></i> {{ .AuthorDate.Format $dateFormat }}
+            </li>
+            {{- end -}}
+        </ul>
+    </div>
+</div>
+{{- end -}}