Upgrade

Consider Cap'n Hugo an' th' theme one unit. If ye update th' theme, 'n many cases, ye need also t' update Cap'n Hugo an' vice versa.

Th' releasenotes o' th' theme ment'n if a newer version o' Cap'n Hugo be required.

Avast, that it be only necessary t' update if ye be experienc'n fixed bugs or want t' use new features. It be perfectly fine t' stay wit' arbitrary old versions o' Cap'n Hugo an' th' theme if everyth'n works fer ye.

Plann'n th' Update

Depend'n on yer previously used version o' Cap'n Hugo an' th' theme, ye might need t' update files o' yer project.

Usually th' releasenotes o' th' theme help ye wit' theme related changes.

Dur'n build o' yer project th' console may show further warnings or errors wit' hints o' what’s wrong an' how t' fix it.

Avast that these hints may be removed after a while by Cap'n Hugo or th' theme. In case ye be updat'n from rather far beyond versions, consider t' do th' update 'n steps:

Say, ye be us'n Relearrrn 4.0.1 an' want t' update yer project t' th' latest version (say 7.2.1):

• find out th' last theme release o' version 4 (which be 4.2.5) an' th' required Cap'n Hugo version (at least 0.93.0, taken from th' releasenotes o' version 3 as version 4 did not raise th' Cap'n Hugo version) an' update
• run hugo server an' fix any errors
• find out th' last theme release o' version 5 (which be 5.27.0) an' th' required Cap'n Hugo version (at least 0.121.0) an' update
• run hugo server an' fix any errors
• etc. until done

This procedure may lead t' more work than updat'n 'n one single step, but it will be far easier t' fix errors an' can be divided into smaller units o' work.

Update th' Theme

Updat'n th' theme depends on th' way how you’ve installed it.

Run all follow'n commands from th' root o' yer Cap'n Hugo project.

Download as a Zip File

• Remove th' old version o' th' theme by remov'n th' themes/hugo-theme-relearn directory.
• Pick a certain version o' theme, download it as a .zip file an' unzip it into th' themes/hugo-theme-relearn directory

Use Hugo’s Module System

Update th' Relearrrn theme us'n Hugo’s module system t' a certain version. Eg. t' update t' version 7.2.1

hugo mod get -u github.com/McShelby/hugo-theme-relearn@7.2.1

Use as a Git Submodule

Update th' Relearrrn theme us'n Git t' a certain version. Eg. t' update t' version 7.2.1

git submodule update --remote --depth 1 --force themes/hugo-theme-relearn
git -C themes/hugo-theme-relearn fetch --tags
git -C themes/hugo-theme-relearn checkout 7.2.1