Error: error building site: render: failed to render pages about documentation HOT 7 OPEN

I updated hugo to https://github.com/gohugoio/hugo/releases/tag/v0.123.4 and got a different error now:

Error: "/home/sebastian/devel/EGI-Federation/documentation/layouts/shortcodes/tabx.html:2:1": parse failed: template: shortcodes/tabx.html:2: unterminated quoted string

Prettier broke the template:

-{{ with $.Parent }}
-{{ if ne $.Parent.Name "tabpanex" }}
-{{ errorf "tabx must be used within a tabpanex block" }}
-{{ end }}
-{{ end }}
+{{ with $.Parent }} {{ if ne $.Parent.Name "tabpanex" }} {{ errorf "tabx must be
+used within a tabpanex 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 $.Inner }}
-{{ $tab = merge $tab (dict "content" $.Inner) }}
-{{ end }}
+{{ $tab := dict "header" $header }} {{ with $.Inner }} {{ $tab = merge $tab
+(dict "content" $.Inner) }} {{ end }}
 
 <!-- add dict tab to parent's scratchpad -->
-{{ with .Parent }}
-{{ $.Parent.Scratch.SetInMap "tabs" (printf "%v" $.Ordinal) $tab }}
-{{ end }}
+{{ with .Parent }} {{ $.Parent.Scratch.SetInMap "tabs" (printf "%v" $.Ordinal)
+$tab }} {{ end }}

My bad - I forgot to include layous/** (there were only the partials included in the orginal prettier config).
I've tested and it works. If you like, I can push the update to the branch you're working on, or you can just apply this patch in .prettierrc.toml:

 [[overrides]]
-files = ["layouts/partials/*.html"]
+files = ["layouts/**/*.html"]

This is a different story though:

Sorry, how can I pin docsy to 0.9.1? I think I get it installed with:

git submodule update --init --recursive --depth 1

Docsy's own documentation recommends using Hugo modules, which I would vastly prefer to using a submodule. I tried it last night, and:

1. It works
2. It removes ~ 80M from the repo
3. We can explicitly declare the dependency and pin the version hugo mod get github.com/google/[email protected]

I will propose in a new issue a move from using the submodule to using a hugo module which we can better manage.

from documentation.

Error message links to: https://gohugo.io/content-management/multilingual/#changes-in-hugo-01120

from documentation.

Ok, so the deprecation warnings can be removed with:

diff --git a/config.toml b/config.toml
index 6243e825dc..af510abab2 100644
--- a/config.toml
+++ b/config.toml
@@ -16,7 +16,7 @@ defaultContentLanguageInSubdir = false
 # Useful when translating.
 enableMissingTranslationPlaceholders = false
 
-disableKinds = ["taxonomy", "taxonomyTerm"]
+disableKinds = ["taxonomy"]
 
 # Highlighting config
 pygmentsCodeFences = true
@@ -63,10 +63,12 @@ anchor = "smart"
 [languages]
   [languages.en]
   title = "Documentation"
-  description = "EGI documentation"
   languageName = "English"
   # Weight used for sorting.
   weight = 1
+    [languages.en.params]
+    description = "EGI documentation"
+
 
 [markup]
   [markup.goldmark]

from documentation.

However, the issue is with docsy instead. Not sure how to solve that one.

from documentation.

@sebastian-luna-valero It's probably a good idea to pin the version of the module we're using, since it's pulling directly from the main branch of the upstream repo which the maintainers themselves say is volatile.

I got this working with: 1.123.4 and docsy 0.9.1 (same deprecation warning, but no error)

from documentation.

Thanks @brucellino

I updated hugo to https://github.com/gohugoio/hugo/releases/tag/v0.123.4 and got a different error now:

Error: "/home/sebastian/devel/EGI-Federation/documentation/layouts/shortcodes/tabx.html:2:1": parse failed: template: shortcodes/tabx.html:2: unterminated quoted string

Sorry, how can I pin docsy to 0.9.1? I think I get it installed with:

git submodule update --init --recursive --depth 1

which seems to get:

Submodule path 'themes/docsy': checked out 'f85c845226f30a4b2a55085d142e96def89e4c3f'

from documentation.

I can push the update to the branch you're working on

Please push to https://github.com/brucellino/egi-documentation/tree/main so it stays on the same PR

I will propose in a new issue a move from using the submodule to using a hugo module which we can better manage.

Thank you very much, really appreciated!

from documentation.