[FEATURE] Provide clear theme update documentation

[t-lark]

Describe the feature you want 描述你的功能需求

A clear documentation guide on how to update the theme

• Feature 1 功能需求 1 I want this feature to solve the problem of when someone needs to update the theme there are clear instructions on how to do so. Also any sort of bootstrap script to automate this would be great. I did not find any documentation on how to safely update this theme on the official docs site.

Updating the theme should also preserve data/configs (if possible) to encourage folks to update and not make it a bad experience

thanks!

[t-lark]

After updating hugo binaries the theme errors out and i tired overriding the theme with a global config and it doesn't work. I am hoping I don't have to manually go update every piece of code that calls a deprecated class/feature of hugo

% hugo serve -D
Watching for changes in /Users/tlarkin/repos/blog/tlark-full-site/{archetypes,content,layouts,static,themes}
Watching for config changes in /Users/tlarkin/repos/blog/tlark-full-site/config.toml, /Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/config.toml
Start building sites … 
hugo v0.140.2-aae02ca612a02e085c08366a9c9279f4abb39d94+extended darwin/arm64 BuildDate=2024-12-30T15:01:53Z VendorInfo=gohugoio

WARN  Current environment is "development". The "comment system", "CDN" and "fingerprint" will be disabled.
当前运行环境是 "development". "评论系统", "CDN" 和 "fingerprint" 不会启用.
ERROR render of "/404" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: 404.html:24:16: executing "404.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/automation" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/apple" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/cis-3" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
Built in 103 ms
Error: error building site: render: failed to render pages: render of "/categories" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/terms.html:24:16: executing "taxonomy/terms.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}

[dillonzq]

After updating hugo binaries the theme errors out and i tired overriding the theme with a global config and it doesn't work. I am hoping I don't have to manually go update every piece of code that calls a deprecated class/feature of hugo

% hugo serve -D
Watching for changes in /Users/tlarkin/repos/blog/tlark-full-site/{archetypes,content,layouts,static,themes}
Watching for config changes in /Users/tlarkin/repos/blog/tlark-full-site/config.toml, /Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/config.toml
Start building sites … 
hugo v0.140.2-aae02ca612a02e085c08366a9c9279f4abb39d94+extended darwin/arm64 BuildDate=2024-12-30T15:01:53Z VendorInfo=gohugoio

WARN  Current environment is "development". The "comment system", "CDN" and "fingerprint" will be disabled.
当前运行环境是 "development". "评论系统", "CDN" 和 "fingerprint" 不会启用.
ERROR render of "/404" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: 404.html:24:16: executing "404.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/automation" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/apple" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
ERROR render of "/categories/cis-3" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/list.html:24:16: executing "taxonomy/list.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}
Built in 103 ms
Error: error building site: render: failed to render pages: render of "/categories" failed: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/_default/baseof.html:24:16": execute of template failed: template: taxonomy/terms.html:24:16: executing "taxonomy/terms.html" at <partial "header.html" .>: error calling partial: "/Users/tlarkin/repos/blog/tlark-full-site/themes/LoveIt/layouts/partials/header.html:42:23": execute of template failed: template: partials/header.html:42:23: executing "partials/header.html" at <hugo>: can't evaluate field IsMultiLingual in type interface {}

Maybe you didn't upgrade Loveit theme to v0.3.0? How did you install this theme?

[t-lark]

I was able to just file copy it in the end and now it does work, but the file copy did overwrite some config files. Not a huge deal, but when web searching to update the theme I did not find any real great docs on how to do so. I was concerned that a straight file copy + replace could break things. I did get it working over the weekend though

[dillonzq]

I was able to just file copy it in the end and now it does work, but the file copy did overwrite some config files. Not a huge deal, but when web searching to update the theme I did not find any real great docs on how to do so. I was concerned that a straight file copy + replace could break things. I did get it working over the weekend though

Thank you for your feedback. I will add it to the document.