Migration to docsy theme version v0.7.1

Author: deining

.gitignore

@@ -1,5 +1,7 @@
 Thumbs.db
+.hugo_build.lock
 public/
+resources/
 node_modules/
 tech-doc-hugo
 

.gitmodules

@@ -6,11 +6,11 @@
 
 {{< blocks/cover title="Welcome to Lisp-Stat: An environment for Statistical Computing" image_anchor="top" height="full" color="orange" >}}
 <div class="mx-auto">
-	<a class="btn btn-lg btn-primary mr-3 mb-4" href="{{< relref "/docs" >}}">
-		Learn More <i class="fas fa-arrow-alt-circle-right ml-2"></i>
+	<a class="btn btn-lg btn-primary me-3 mb-4" href="{{< relref "/docs" >}}">
+		Learn More <i class="fas fa-arrow-alt-circle-right ms-2"></i>
 	</a>
-	<a class="btn btn-lg btn-secondary mr-3 mb-4" href="https://github.com/lisp-stat">
-		Download <i class="fab fa-github ml-2 "></i>
+	<a class="btn btn-lg btn-secondary me-3 mb-4" href="https://github.com/lisp-stat">
+		Download <i class="fab fa-github ms-2 "></i>
 	</a>
 	<p class="lead mt-5">A full stack statistical computing environment</p>
 	{{< blocks/link-down color="info" >}}
@@ -28,7 +28,7 @@
 
 {{% /blocks/lead %}}
 
-{{< blocks/section color="dark" >}}
+{{< blocks/section color="dark" type="row" >}}
 {{% blocks/feature icon="fa-lightbulb" title="See Lisp-Stat in action" url="/docs/examples" %}}
 See practical examples of using Lisp-Stat for statistical computation
 
@@ -48,7 +48,7 @@
 {{< /blocks/section >}}
 
 <!-- Some quick examples -->
-{{< blocks/section >}}
+{{< blocks/section  type="row" >}}
 
 {{% blocks/feature icon="fas fa-power-off" title="Get Started" url="/docs/getting-started/" %}}
 Install to plotting in five minutes

content/en/_index.html

@@ -14,8 +14,8 @@ for Common Lisp that includes Emacs, SBCL, Git, Quicklisp, all
 configured and ready to use.
 
 <div class="mx-auto">
-	<a class="btn btn-lg btn-primary mr-3 mb-4" href="https://portacle.github.io/">
-		Download Portacle<i class="fas fa-arrow-alt-circle-right ml-2"></i>
+	<a class="btn btn-lg btn-primary me-3 mb-4" href="https://portacle.github.io/">
+		Download Portacle<i class="fas fa-arrow-alt-circle-right ms-2"></i>
 	</a>
 </div>
 

content/en/docs/Getting started/installation.md

@@ -0,0 +1,5 @@
+module github.com/Lisp-Stat/documentation
+
+go 1.20
+
+require github.com/google/docsy v0.7.1 // indirect

go.mod

@@ -0,0 +1,5 @@
+github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
+github.com/google/docsy v0.7.1 h1:DUriA7Nr3lJjNi9Ulev1SfiG1sUYmvyDeU4nTp7uDxY=
+github.com/google/docsy v0.7.1/go.mod h1:JCmE+c+izhE0Rvzv3y+AzHhz1KdwlA9Oj5YBMklJcfc=
+github.com/google/docsy/dependencies v0.7.1/go.mod h1:gihhs5gmgeO+wuoay4FwOzob+jYJVyQbNaQOh788lD4=
+github.com/twbs/bootstrap v5.2.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=

go.sum

@@ -3,9 +3,6 @@ title = "Lisp-Stat"
 
 enableRobotsTXT = true
 
-# Hugo allows theme composition (and inheritance). The precedence is from left to right.
-theme = ["docsy"]
-
 # Will give values to .Lastmod etc.
 enableGitInfo = true
 
@@ -16,7 +13,7 @@ defaultContentLanguageInSubdir = false
 # Useful when translating.
 enableMissingTranslationPlaceholders = true
 
-disableKinds = ["taxonomy", "taxonomyTerm"]
+disableKinds = ["taxonomy"]
 
 # Highlighting config
 pygmentsCodeFences = true
@@ -54,8 +51,9 @@ id = "G-4JNEYSENWT"
 [languages]
 [languages.en]
 title = "Lisp-Stat"
-description = "Lisp-Stat Documentation"
 languageName ="English"
+[languages.en.params]
+description = "Lisp-Stat Documentation"
 time_format_blog = "Monday, 02 January 2006"
 time_format_default = "02 January 2006"
 
@@ -223,4 +221,11 @@ enable = false
 #   [[module.imports.mounts]]
 #     source="special-functions/docs"
 #     target="content/docs/Reference/special-functions"
-#     language="en"
+#     language="en"
+
+[module]
+proxy = "direct"
+[[module.imports]]
+path = "github.com/google/docsy"
+[[module.imports]]
+path = "github.com/google/docsy/dependencies"

config.toml hugo.toml

@@ -18,7 +18,7 @@
       </div>
       <div class="col-12 col-sm-4 text-center py-2 order-sm-2">
         {{ with .Site.Params.copyright }}<small class="text-white">&copy; {{ now.Year}} {{ .}} {{ T "footer_all_rights_reserved" }}</small><br/>{{ end }}
-        {{ with .Site.Params.privacy_policy }}<small class="ml-1"><a href="{{ . }}" target="_blank">{{ T "footer_privacy_policy" }}</a></small>{{ end }}
+        {{ with .Site.Params.privacy_policy }}<small class="ms-1"><a href="{{ . }}" target="_blank">{{ T "footer_privacy_policy" }}</a></small>{{ end }}
 	{{ if not .Site.Params.ui.footer_about_disable }}
 		{{ with .Site.GetPage "about" }}<p class="mt-2"><a href="{{ .RelPermalink }}">{{ .Title }}</a></p>{{ end }}
 	{{ end }}

layouts/partials/footer.html

@@ -16,7 +16,6 @@
 {{ partialCached "favicons.html" . }}
 <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
 {{- template "_internal/opengraph.html" . -}}
-{{- template "_internal/google_news.html" . -}}
 {{- template "_internal/schema.html" . -}}
 {{- template "_internal/twitter_cards.html" . -}}
 {{ if hugo.IsProduction }}

layouts/partials/head.html

@@ -1,11 +1,13 @@
 [build]
   publish = "public"
-  command = "cd themes/docsy && git submodule update -f --init && cd ../.. && hugo"
+  command = "hugo"
 
 [context.production.environment]
-  HUGO_VERSION = "0.82.0"
+  HUGO_VERSION = "0.117.0"
   HUGO_ENV = "production"
   HUGO_ENABLEGITINFO = "true"
+  GO_VERSION = "1.21.0"
+  NODE_VERSION = "18"
 
 # Not using preview nor branch deployment yet
 # See:
@@ -14,7 +16,11 @@
 #  https://gohugo.io/hosting-and-deployment/hosting-on-netlify/
 
 [context.branch-deploy.environment]
-  HUGO_VERSION = "0.82.0"
+  HUGO_VERSION = "0.117.0"
+  GO_VERSION = "1.21.0"
+  NODE_VERSION = "18"
 
 [context.deploy-preview.environment]
-  HUGO_VERSION = "0.82.0"
+  HUGO_VERSION = "0.117.0"
+  GO_VERSION = "1.21.0"
+  NODE_VERSION = "18"