mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2025-01-19 11:20:24 +00:00
204 lines
15 KiB
HTML
204 lines
15 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="art-x-pir" dir="rtl" itemscope itemtype="http://schema.org/Article" data-r-output-format="print">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="height=device-height, width=device-width, initial-scale=1.0, minimum-scale=1.0">
|
|
<meta name="generator" content="Hugo 0.140.2">
|
|
<meta name="generator" content="Relearn 7.2.1+6747b8862e1ea7331662a6376ef02a48126816ae">
|
|
<meta name="description" content="How to upgrade your Relearn site">
|
|
<meta name="author" content="Sören Weber">
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
|
|
<meta name="twitter:title" content="Upgrade :: Cap'n Hugo Relearrrn Theme">
|
|
<meta name="twitter:description" content="How to upgrade your Relearn site">
|
|
<meta property="og:url" content="https://mcshelby.github.io/hugo-theme-relearn/pir/introduction/upgrade/index.html">
|
|
<meta property="og:site_name" content="Cap'n Hugo Relearrrn Theme">
|
|
<meta property="og:title" content="Upgrade :: Cap'n Hugo Relearrrn Theme">
|
|
<meta property="og:description" content="How to upgrade your Relearn site">
|
|
<meta property="og:locale" content="art_x_pir">
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
|
|
<meta itemprop="name" content="Upgrade :: Cap'n Hugo Relearrrn Theme">
|
|
<meta itemprop="description" content="How to upgrade your Relearn site">
|
|
<meta itemprop="wordCount" content="431">
|
|
<meta itemprop="image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
|
|
<meta itemprop="keywords" content="Tutorial">
|
|
<title>Upgrade :: Cap'n Hugo Relearrrn Theme</title>
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/upgrade/index.html" rel="alternate" hreflang="x-default">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/upgrade/index.html" rel="alternate" hreflang="en">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/introduction/upgrade/index.html" rel="alternate" hreflang="art-x-pir">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/introduction/upgrade/index.html" rel="canonical" type="text/html" title="Upgrade :: Cap'n Hugo Relearrrn Theme">
|
|
<link href="/hugo-theme-relearn/pir/introduction/upgrade/index.xml" rel="alternate" type="application/rss+xml" title="Upgrade :: Cap'n Hugo Relearrrn Theme">
|
|
<link href="/hugo-theme-relearn/images/logo.svg?1735758767" rel="icon" type="image/svg+xml">
|
|
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1735758767" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1735758767" rel="stylesheet"></noscript>
|
|
<link href="/hugo-theme-relearn/css/auto-complete.css?1735758767" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1735758767" rel="stylesheet"></noscript>
|
|
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1735758767" rel="stylesheet">
|
|
<link href="/hugo-theme-relearn/css/theme.min.css?1735758767" rel="stylesheet">
|
|
<link href="/hugo-theme-relearn/css/format-print.min.css?1735758767" rel="stylesheet" id="R-format-style">
|
|
<script>
|
|
window.relearn = window.relearn || {};
|
|
window.relearn.relBasePath='..\/..\/..';
|
|
window.relearn.relBaseUri='..\/..\/..\/..';
|
|
window.relearn.absBaseUri='https:\/\/mcshelby.github.io\/hugo-theme-relearn';
|
|
window.relearn.min = `.min`;
|
|
window.relearn.disableAnchorCopy=false;
|
|
window.relearn.disableAnchorScrolling=false;
|
|
// variant stuff
|
|
window.relearn.themevariants = [ 'relearn-auto', 'relearn-light', 'relearn-dark', 'relearn-bright', 'zen-auto', 'zen-light', 'zen-dark', 'retro-auto', 'neon', 'learn', 'blue', 'green', 'red' ];
|
|
window.relearn.customvariantname = "my-custom-variant";
|
|
window.relearn.changeVariant = function(variant) {
|
|
var oldVariant = document.documentElement.dataset.rThemeVariant;
|
|
window.localStorage.setItem(window.relearn.absBaseUri + "/variant", variant);
|
|
document.documentElement.dataset.rThemeVariant = variant;
|
|
if (oldVariant != variant) {
|
|
document.dispatchEvent( new CustomEvent('themeVariantLoaded', { detail: { variant, oldVariant } }) );
|
|
}
|
|
}
|
|
window.relearn.markVariant = function() {
|
|
var variant = window.localStorage.getItem(window.relearn.absBaseUri + "/variant");
|
|
var select = document.querySelector("#R-select-variant");
|
|
if (select) {
|
|
select.value = variant;
|
|
}
|
|
}
|
|
window.relearn.initVariant = function() {
|
|
var variant = window.localStorage.getItem(window.relearn.absBaseUri + "/variant") ?? "";
|
|
if( variant == window.relearn.customvariantname ){
|
|
}else if( !variant || !window.relearn.themevariants.includes(variant) ){
|
|
variant = window.relearn.themevariants[0];
|
|
window.localStorage.setItem(window.relearn.absBaseUri + "/variant", variant);
|
|
}
|
|
document.documentElement.dataset.rThemeVariant = variant;
|
|
}
|
|
window.relearn.initVariant();
|
|
window.relearn.markVariant();
|
|
// translations
|
|
window.T_Copy_to_clipboard = `Copy t' clipboard`;
|
|
window.T_Copied_to_clipboard = `Copied t' clipboard!`;
|
|
window.T_Copy_link_to_clipboard = `Copy link t' clipboard`;
|
|
window.T_Link_copied_to_clipboard = `Copied link t' clipboard!`;
|
|
window.T_Reset_view = `Rrreset view`;
|
|
window.T_View_reset = `View rrreset!`;
|
|
window.T_No_results_found = `No rrresults found fer "{0}"`;
|
|
window.T_N_results_found = `{1} rrresults found fer "{0}"`;
|
|
</script>
|
|
<script src="/hugo-theme-relearn/js/variant.js?1735758767"></script>
|
|
<style>
|
|
#R-body img.bg-white {
|
|
background-color: white;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body class="mobile-support print disableInlineCopyToClipboard" data-url="/hugo-theme-relearn/pir/introduction/upgrade/index.html">
|
|
<div id="R-body" class="default-animation">
|
|
<div id="R-body-overlay"></div>
|
|
<nav id="R-topbar">
|
|
<div class="topbar-wrapper">
|
|
<div class="topbar-sidebar-divider"></div>
|
|
<div class="topbar-area topbar-area-start" data-area="start">
|
|
<div class="topbar-button topbar-button-sidebar" data-content-empty="disable" data-width-s="show" data-width-m="hide" data-width-l="hide"><button class="topbar-control" onclick="toggleNav()" type="button" title="Menu (CTRL+ALT+n)"><i class="fa-fw fas fa-bars"></i></button>
|
|
</div>
|
|
<div class="topbar-button topbar-button-toc" data-content-empty="hide" data-width-s="show" data-width-m="show" data-width-l="show"><button class="topbar-control" onclick="toggleTopbarFlyout(this)" type="button" title="Table o' Contents (CTRL+ALT+t)"><i class="fa-fw fas fa-list-alt"></i></button>
|
|
<div class="topbar-content">
|
|
<div class="topbar-content-wrapper">
|
|
<nav class="TableOfContents">
|
|
<ul>
|
|
<li><a href="#planning-the-update">Plann'n th' Update</a></li>
|
|
<li><a href="#update-the-theme">Update th' Theme</a>
|
|
<ul>
|
|
<li><a href="#download-as-a-zip-file">Download as a Zip File</a></li>
|
|
<li><a href="#use-hugos-module-system">Use Hugo’s Module System</a></li>
|
|
<li><a href="#use-as-a-git-submodule">Use as a Git Submodule</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<ol class="topbar-breadcrumbs breadcrumbs highlightable" itemscope itemtype="http://schema.org/BreadcrumbList"><li
|
|
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><a itemprop="item" href="/hugo-theme-relearn/pir/introduction/index.html"><span itemprop="name">Introduction</span></a><meta itemprop="position" content="1"> > </li><li
|
|
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><span itemprop="name">Upgrade</span><meta itemprop="position" content="2"></li>
|
|
</ol>
|
|
<div class="topbar-area topbar-area-end" data-area="end">
|
|
<div class="topbar-button topbar-button-edit" data-content-empty="disable" data-width-s="area-more" data-width-m="show" data-width-l="show"><a class="topbar-control" href="https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/introduction/upgrade/_index.pir.md" target="_self" title="Edit (CTRL+ALT+w)"><i class="fa-fw fas fa-pen"></i></a>
|
|
</div>
|
|
<div class="topbar-button topbar-button-print" data-content-empty="disable" data-width-s="area-more" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/pir/introduction/upgrade/index.print.html" title="Prrrint whole chapterrr (CTRL+ALT+p)"><i class="fa-fw fas fa-print"></i></a>
|
|
</div>
|
|
<div class="topbar-button topbar-button-prev" data-content-empty="disable" data-width-s="show" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/pir/introduction/quickstart/index.html" title="Gettin' started (🡒)"><i class="fa-fw fas fa-chevron-left"></i></a>
|
|
</div>
|
|
<div class="topbar-button topbar-button-next" data-content-empty="disable" data-width-s="show" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/pir/introduction/tools/index.html" title="Tool Integration (🡐)"><i class="fa-fw fas fa-chevron-right"></i></a>
|
|
</div>
|
|
<div class="topbar-button topbar-button-more" data-content-empty="hide" data-width-s="show" data-width-m="show" data-width-l="show"><button class="topbar-control" onclick="toggleTopbarFlyout(this)" type="button" title="Morrre"><i class="fa-fw fas fa-ellipsis-v"></i></button>
|
|
<div class="topbar-content">
|
|
<div class="topbar-content-wrapper">
|
|
<div class="topbar-area topbar-area-more" data-area="more">
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
<div id="R-main-overlay"></div>
|
|
<main id="R-body-inner" class="highlightable introduction" tabindex="-1">
|
|
<div class="flex-block-wrapper">
|
|
<article class="default">
|
|
<header class="headline">
|
|
</header>
|
|
|
|
<h1 id="upgrade">Upgrade</h1>
|
|
|
|
<p>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.</p>
|
|
<p>Th' <a href="/hugo-theme-relearn/pir/introduction/releasenotes/index.html">releasenotes o' th' theme</a> ment'n if a newer version o' Cap'n Hugo be required.</p>
|
|
<p>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.</p>
|
|
<h2 id="planning-the-update">Plann'n th' Update</h2>
|
|
<p>Depend'n on yer previously used version o' Cap'n Hugo an' th' theme, ye might need t' update files o' yer project.</p>
|
|
<p>Usually th' <a href="/hugo-theme-relearn/pir/introduction/releasenotes/index.html">releasenotes o' th' theme</a> help ye wit' theme related changes.</p>
|
|
<p>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.</p>
|
|
<p>Avast that these <a href="https://gohugo.io/troubleshooting/deprecation" rel="external" target="_self">hints may be removed after a while</a> 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:</p>
|
|
<p>Say, ye be us'n Relearrrn 4.0.1 an' want t' update yer project t' th' latest version (say 7.2.1):</p>
|
|
<ul>
|
|
<li>find out th' <a href="/hugo-theme-relearn/pir/introduction/changelog/4/index.html">last theme release o' version 4</a> (which be 4.2.5) an' th' <a href="/hugo-theme-relearn/pir/introduction/releasenotes/4/index.html">required Cap'n Hugo version</a> (at least 0.93.0, <a href="/hugo-theme-relearn/pir/introduction/releasenotes/3/index.html">taken from th' releasenotes o' version 3</a> as version 4 did not raise th' Cap'n Hugo version) an' update</li>
|
|
<li>run <code>hugo server</code> an' fix any errors</li>
|
|
<li>find out th' <a href="/hugo-theme-relearn/pir/introduction/changelog/5/index.html">last theme release o' version 5</a> (which be 5.27.0) an' th' <a href="/hugo-theme-relearn/pir/introduction/releasenotes/5/index.html">required Cap'n Hugo version</a> (at least 0.121.0) an' update</li>
|
|
<li>run <code>hugo server</code> an' fix any errors</li>
|
|
<li>etc. until done</li>
|
|
</ul>
|
|
<p>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.</p>
|
|
<h2 id="update-the-theme">Update th' Theme</h2>
|
|
<p>Updat'n th' theme depends on th' way <a href="/hugo-theme-relearn/pir/introduction/quickstart/index.html#install-the-theme">how you’ve installed it</a>.</p>
|
|
<p>Run all follow'n commands from th' root o' yer Cap'n Hugo project.</p>
|
|
<h3 id="download-as-a-zip-file">Download as a Zip File</h3>
|
|
<ul>
|
|
<li>Remove th' old version o' th' theme by remov'n th' <code>themes/hugo-theme-relearn</code> directory.</li>
|
|
<li><a href="https://github.com/McShelby/hugo-theme-relearn/releases" rel="external" target="_self">Pick a certain version</a> o' theme, download it as a .zip file an' unzip it into th' <code>themes/hugo-theme-relearn</code> directory</li>
|
|
</ul>
|
|
<h3 id="use-hugos-module-system">Use Hugo’s Module System</h3>
|
|
<p>Update th' Relearrrn theme us'n <a href="https://gohugo.io/hugo-modules/use-modules/#update-one-module" rel="external" target="_self">Hugo’s module system</a> t' a certain version. Eg. t' update t' version 7.2.1</p>
|
|
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo mod get -u github.com/McShelby/hugo-theme-relearn@7.2.1</span></span></code></pre></div>
|
|
<h3 id="use-as-a-git-submodule">Use as a Git Submodule</h3>
|
|
<p>Update th' Relearrrn theme us'n <a href="https://git-scm.com/" rel="external" target="_self">Git</a> t' a certain version. Eg. t' update t' version 7.2.1</p>
|
|
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">git submodule update --remote --depth <span class="m">1</span> --force themes/hugo-theme-relearn
|
|
</span></span><span class="line"><span class="cl">git -C themes/hugo-theme-relearn fetch --tags
|
|
</span></span><span class="line"><span class="cl">git -C themes/hugo-theme-relearn checkout 7.2.1</span></span></code></pre></div>
|
|
|
|
|
|
<footer class="footline">
|
|
<div class="R-taxonomy taxonomy-categories cstyle" title="Categorrries" style="--VARIABLE-TAGS-BG-color: var(--INTERNAL-TAG-BG-color);">
|
|
<i class="fa-fw fas fa-layer-group"></i>
|
|
<ul>
|
|
<li><a class="term-link" href="/hugo-theme-relearn/pir/categories/tutorial/index.html">Tutorial</a></li>
|
|
</ul>
|
|
</div>
|
|
</footer>
|
|
</article>
|
|
</div>
|
|
</main>
|
|
</div>
|
|
<script src="/hugo-theme-relearn/js/clipboard.min.js?1735758767" defer></script>
|
|
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1735758767" defer></script>
|
|
<script src="/hugo-theme-relearn/js/theme.js?1735758767" defer></script>
|
|
</body>
|
|
</html>
|