Dit artikel legt uit hoe je het thema correct kunt upgraden.

Versies

Voordat je gaat upgraden, is het handig om te weten wat een versie is. Naast de relatief stabiele versies vermeld in Releases kun je ook een branch gebruiken zoals master, develop, of zelfs een bepaalde commit.

Dit artikel gebruikt de tijdelijke aanduiding [version] voor de versie; vervang deze door de versie waarnaar je wilt upgraden.

Upgraden

Kies de upgradestap op basis van de installatiemethode: Git Submodule en Hugo Module.

Ongeacht de installatiemethode moet je altijd afhankelijkheden ophalen en bijwerken via hugo mod npm pack en npm update.

Extra Afhankelijkheden

Als je extra afhankelijkheden wilt toevoegen, definieer deze dan in package.hugo.json in plaats van package.json. Dit komt omdat hugo mod npm pack altijd de package.json overschrijft, waarbij de package.hugo.json van het thema en die van je site worden samengevoegd.

Git Submodule

1$ cd themes/hugo-theme-bootstrap
2$ git fetch
3$ git checkout [version]
4$ cd ../../
5$ hugo mod npm pack
6$ npm update
7$ git add themes/hugo-theme-bootstrap package.hugo.json package.json package-lock.json
8$ git commit -m 'Bump theme to [version]'
  • git fetch haalt de nieuwste branch- en taginformatie op uit de thema-repository.
  • git checkout [version] schakelt over naar de versie [version].
  • hugo mod npm pack en npm update halen de nieuwste afhankelijkheden op uit het thema en werken deze bij.

Hugo Module

1$ hugo mod get github.com/razonyang/hugo-theme-bootstrap@[version]
2$ hugo mod tidy
3$ hugo mod npm pack
4$ npm update
5$ git add go.mod go.sum package.hugo.json package.json package-lock.json
6$ git commit -m 'Bump theme to [version]'
  • hugo mod tidy ruimt overbodige afhankelijkheden op.
  • hugo mod npm pack en npm update halen de nieuwste afhankelijkheden op uit het thema en werken deze bij.