Getting Bootie-Docs theme to work with hugo v0.100.1+extended

Hello Hugo Community:

I am very keen on using the bootie-docs theme developed by @key-amb and as is shown at this demo site. I’m just diving into Hugo after learning that it offers optimal compatibility with the R blogdown package.

I first created and navigated to a directory called ~/Sites. I then followed followed the steps from the README.md of demo site’s Github repository to create a replicate that I could play around with locally:

% git clone https://github.com/progrhyme/hugo-theme-bootie-docs.git
% git clone https://github.com/progrhyme/bootie-docs-demo.git
% cd bootie-docs-demo
% mkdir themes
% ln -s /path/to/hugo-theme-bootie-docs themes/bootie-docs
% hugo server 

This throws the following errors:

Start building sites … 
hugo v0.100.1+extended darwin/arm64 BuildDate=unknown
ERROR 2022/06/05 18:38:31 render of "page" failed: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/_default/single.html:1:3": execute of template failed: template: _default/single.html:1:3: executing "_default/single.html" at <partial "header.html" .>: error calling partial: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/partials/header.html:36:14": execute of template failed: template: partials/header.html:36:14: executing "partials/header.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState
ERROR 2022/06/05 18:38:31 render of "home" failed: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/index.html:2:3": execute of template failed: template: index.html:2:3: executing "index.html" at <partial "header.html" .>: error calling partial: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/partials/header.html:36:14": execute of template failed: template: partials/header.html:36:14: executing "partials/header.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState
ERROR 2022/06/05 18:38:31 render of "page" failed: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/_default/single.html:1:3": execute of template failed: template: _default/single.html:1:3: executing "_default/single.html" at <partial "header.html" .>: error calling partial: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/partials/header.html:36:14": execute of template failed: template: partials/header.html:36:14: executing "partials/header.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState
ERROR 2022/06/05 18:38:31 render of "taxonomy" failed: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/_default/list.html:1:3": execute of template failed: template: _default/list.html:1:3: executing "_default/list.html" at <partial "header.html" .>: error calling partial: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/partials/header.html:36:14": execute of template failed: template: partials/header.html:36:14: executing "partials/header.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState
Error: Error building site: failed to render pages: render of "page" failed: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/_default/single.html:1:3": execute of template failed: template: _default/single.html:1:3: executing "_default/single.html" at <partial "header.html" .>: error calling partial: "/Users/<user.name>/Sites/bootie-docs-demo/themes/bootie-docs/layouts/partials/header.html:36:14": execute of template failed: template: partials/header.html:36:14: executing "partials/header.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState
Built in 19 ms

As you can see, the crux of the problem seems to be: can't evaluate field URL in type *hugolib.pageState.

% hugo env
hugo v0.100.1+extended darwin/arm64 BuildDate=unknown
GOOS="darwin"
GOARCH="arm64"
GOVERSION="go1.18.2"

I don’t understand the inner-workings of Hugo enough to get very far troubleshooting myself. I’m aware that there have been various updates to Hugo since the bootie-docs theme was last updated, so there could be a compatibility issue. If the original developer is still active on this forum and can chime in, that would be fantastic. If others can point to possible solution, I’m open ears.

We deprecated and eventually removed URL on Page some time ago. The correct would be to use either RelPermalink (relative) or Permalink (full).

See Replace .URL (removed from Hugo) with .RelPermalink by bep · Pull Request #37 · progrhyme/hugo-theme-bootie-docs · GitHub

Note that I’m not sure that edit alone is enough to fix “all potential problems”, but it at least build without errors.

Many thanks! This is a great start to let me dig further into the docs and figure things out.

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.