Upgrade

Consider Cap'n Hugo an' th' theme one unit. If ye upgrade th' theme, 'n many cases, ye need also t' upgrade 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' upgrade 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' Upgrade

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

Th' releasenotes announce theme related modificat'ns an' help ye identify'n spots 'n yer files that require changes.

Also watch th' console dur'n build o' yer project, as it 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' upgrade 'n steps:

Say, ye be us'n Relearrrn 4.0.1 an' want t' upgrade 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' upgrade
• 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' upgrade
• 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' make adapt'ns an' can be divided into smaller units o' work.

Upgrade 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.

Download th' .zip archive o' a certain version o' th' theme an' unzip it into th' themes/hugo-theme-relearn directory

Eg. t' upgrade t' version 7.2.1 download from https://github.com/McShelby/hugo-theme-relearn/releases/tag/7.2.1

Use Hugo’s Module System

Upgrade th' Relearrrn theme us'n Hugo’s module system t' a certain version.

Eg. t' upgrade t' version 7.2.1

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

Use as a Git Submodule

Upgrade th' Relearrrn theme us'n Git t' a certain version.

Eg. t' upgrade t' version 7.2.1

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