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.

Semver

Recent releases o' th' theme follow th' semver standard.

Theme Repo Organizat'n

Th' main branch o' th' source code repo contains all versions wit' th' development version at th' HEAD. This means, pull'n from th' main branch may give ye a beta version.

As this be not suitable fer product'n, th' repository contains stable tags fer each released version 'n th' form o' 7.2.1.

In addit'n, th' repository contains float'n tags fer

• th' latest bugfix release o' a minor version 'n th' form o' 7.2.x
• th' latest feature release o' a major version 'n th' form o' 7.x
• th' latest stable release o' th' theme 'n th' form o' x

Choose a tag that best fits yer needs.

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

Use a Downloaded Archive

Download th' archive o' a certain version o' th' theme from GitHub an' extract it into th' themes/hugo-theme-relearn directory.

Eg. t' upgrade t' version 7.2.1

Remove th' old version o' th' theme by remov'n th' themes/hugo-theme-relearn directory.

mkdir "themes/hugo-theme-relearn"
curl -L https://github.com/McShelby/hugo-theme-relearn/archive/refs/tags/7.2.1.tar.gz | tar -xz --strip-components=1 -C "themes/hugo-theme-relearn"

This doesn’t work 'n Windows PowerShell 5.1. Use cmd or PowerShell 7 instead.

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 -C themes/hugo-theme-relearn fetch --depth 1 -f origin tag 7.2.1
git -C themes/hugo-theme-relearn checkout 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