mirror of
https://github.com/nunocoracao/blowfish.git
synced 2025-06-06 05:31:52 +02:00
900 lines
47 KiB
HTML
900 lines
47 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<html
|
|
lang="en"
|
|
dir="ltr"
|
|
class="scroll-smooth"
|
|
data-default-appearance="dark"
|
|
data-auto-appearance="false"
|
|
><head>
|
|
<meta charset="utf-8" />
|
|
|
|
<meta http-equiv="content-language" content="en" />
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
|
|
|
|
<title>Upgrading from Congo 1.x · Blowfish</title>
|
|
<meta name="title" content="Upgrading from Congo 1.x · Blowfish" />
|
|
|
|
<meta name="description" content="Product | Nuno Coração" />
|
|
|
|
|
|
|
|
<link rel="canonical" href="https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link
|
|
type="text/css"
|
|
rel="stylesheet"
|
|
href="/blowfish/css/main.bundle.min.3f7a3d89b943c3dacb033ff4448c83a5b58692eb75f99e903ee759443c690298da06dc2cc7adc967ae51bb50103acfa1b65f99a428ef2ff09176f2519b277273.css"
|
|
integrity="sha512-P3o9iblDw9rLAz/0RIyDpbWGkut1+Z6QPudZRDxpApjaBtwsx63JZ65Ru1AQOs+htl+ZpCjvL/CRdvJRmydycw=="
|
|
/>
|
|
|
|
|
|
<script type="text/javascript" src="/blowfish/js/main.min.cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e.js" integrity="sha512-z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg=="></script>
|
|
|
|
|
|
<script type="text/javascript" src="/blowfish/js/appearance.min.4a00b8b8a9118d31826a03a2a9cca83390fcd3eddd9e03868fffcf4dc1e2dc15649e9266091f1225a24e1bcf6558ff4807f77663bcfaaa8f3050d73c1bd5bf0b.js" integrity="sha512-SgC4uKkRjTGCagOiqcyoM5D80+3dngOGj//PTcHi3BVknpJmCR8SJaJOG89lWP9IB/d2Y7z6qo8wUNc8G9W/Cw=="></script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script defer type="text/javascript" id="script-bundle" src="/blowfish/js/main.bundle.min.9ae0a991bb442898e9bc60cf318b4de3ff878325ff3821625a5564b32b2f66aec0e7f7d0e00ca3ac7df59d9f01c18c88b6bdd213184f86ac9ce06d7bdffbadf8.js" integrity="sha512-muCpkbtEKJjpvGDPMYtN4/+HgyX/OCFiWlVksysvZq7A5/fQ4AyjrH31nZ8BwYyItr3SExhPhqyc4G173/ut+A==" data-copy="Copy" data-copied="Copied"></script>
|
|
|
|
<script src="/js/zoom.min.js"></script>
|
|
|
|
|
|
<link rel="apple-touch-icon" sizes="180x180" href="/blowfish/apple-touch-icon.png" />
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/blowfish/favicon-32x32.png" />
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/blowfish/favicon-16x16.png" />
|
|
<link rel="manifest" href="/blowfish/site.webmanifest" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<meta property="og:title" content="Upgrading from Congo 1.x" />
|
|
<meta property="og:description" content="Discover what's new in Congo version 2.0." />
|
|
<meta property="og:type" content="article" />
|
|
<meta property="og:url" content="https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/" /><meta property="article:section" content="docs" />
|
|
<meta property="article:published_time" content="2022-01-20T00:00:00+00:00" />
|
|
<meta property="article:modified_time" content="2022-01-20T00:00:00+00:00" /><meta property="og:site_name" content="Blowfish" />
|
|
|
|
|
|
<meta name="twitter:card" content="summary"/>
|
|
<meta name="twitter:title" content="Upgrading from Congo 1.x"/>
|
|
<meta name="twitter:description" content="Discover what's new in Congo version 2.0."/>
|
|
|
|
|
|
<script type="application/ld+json">
|
|
[{
|
|
"@context": "https://schema.org",
|
|
"@type": "Article",
|
|
"articleSection": "Documentation",
|
|
"name": "Upgrading from Congo 1.x",
|
|
"headline": "Upgrading from Congo 1.x",
|
|
"description": "Discover what\u0027s new in Congo version 2.0.",
|
|
"abstract": "Although Congo 2.0 contains a large number of changes, the theme has been designed to minimise the effort required to upgrade to the latest release.\nThat said, there are some changes that require adjustments to existing sites that are built with Congo version 1.",
|
|
"inLanguage": "en",
|
|
"url" : "https:\/\/nunocoracao.github.io\/blowfish\/docs\/version-2\/upgrade\/",
|
|
"author" : {
|
|
"@type": "Person",
|
|
"name": "Blowfish"
|
|
},
|
|
"copyrightYear": "2022",
|
|
"dateCreated": "2022-01-20T00:00:00\u002b00:00",
|
|
"datePublished": "2022-01-20T00:00:00\u002b00:00",
|
|
|
|
"dateModified": "2022-01-20T00:00:00\u002b00:00",
|
|
|
|
"keywords": ["new","docs"],
|
|
|
|
"mainEntityOfPage": "true",
|
|
"wordCount": "1382"
|
|
}]
|
|
</script>
|
|
|
|
|
|
|
|
<meta name="author" content="Blowfish" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
|
|
<script>
|
|
var doNotTrack = false;
|
|
if (!doNotTrack) {
|
|
window.dataLayer = window.dataLayer || [];
|
|
function gtag(){dataLayer.push(arguments);}
|
|
gtag('js', new Date());
|
|
gtag('config', 'G-XXXXXX', { 'anonymize_ip': false });
|
|
}
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="https://rsms.me/inter/inter.css">
|
|
</head>
|
|
<body
|
|
class="flex flex-col h-screen px-6 m-auto text-lg leading-7 max-w-7xl bg-neutral text-neutral-900 dark:bg-neutral-800 dark:text-neutral sm:px-14 md:px-24 lg:px-32"
|
|
>
|
|
<div id="the-top" class="absolute flex self-center">
|
|
<a
|
|
class="px-3 py-1 text-sm -translate-y-8 rounded-b-lg bg-primary-200 focus:translate-y-0 dark:bg-neutral-600"
|
|
href="#main-content"
|
|
><span class="font-bold text-primary-600 ltr:pr-2 rtl:pl-2 dark:text-primary-400"
|
|
>↓</span
|
|
>Skip to main content</a
|
|
>
|
|
</div>
|
|
|
|
|
|
<div style="padding-left:0;padding-right:0"
|
|
class="flex items-center justify-between px-4 py-6 sm:px-6 md:justify-start space-x-3">
|
|
|
|
|
|
<div>
|
|
<a href="/blowfish/" class="flex">
|
|
<span class="sr-only">Blowfish</span>
|
|
|
|
<img src="/blowfish/img/blowfish_logo_transparent.png" width="1000" height="1000"
|
|
class="max-h-[5rem] max-w-[5rem] object-scale-down object-left nozoom" alt="Blowfish" />
|
|
|
|
</a>
|
|
</div>
|
|
|
|
<div class="flex flex-1 items-center justify-between">
|
|
<nav class="flex space-x-3">
|
|
|
|
<a href="/" class="text-base font-medium text-gray-500 hover:text-gray-900">Blowfish</a>
|
|
|
|
</nav>
|
|
<div class="hidden md:flex items-center space-x-5 md:ml-12">
|
|
|
|
|
|
|
|
<a href="https://github.com/nunocoracao/blowfish" class="text-base font-medium text-gray-500 hover:text-gray-900" title="">GitHub</a>
|
|
|
|
|
|
|
|
<span></span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
<div class="flex md:hidden items-center space-x-5 md:ml-12">
|
|
|
|
<span></span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<div class="-my-2 -mr-2 md:hidden">
|
|
|
|
<label id="menu-button" for="menu-controller" class="block">
|
|
<input type="checkbox" id="menu-controller" class="hidden" />
|
|
<div class="cursor-pointer hover:text-primary-600 dark:hover:text-primary-400">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path fill="currentColor" d="M0 96C0 78.33 14.33 64 32 64H416C433.7 64 448 78.33 448 96C448 113.7 433.7 128 416 128H32C14.33 128 0 113.7 0 96zM0 256C0 238.3 14.33 224 32 224H416C433.7 224 448 238.3 448 256C448 273.7 433.7 288 416 288H32C14.33 288 0 273.7 0 256zM416 448H32C14.33 448 0 433.7 0 416C0 398.3 14.33 384 32 384H416C433.7 384 448 398.3 448 416C448 433.7 433.7 448 416 448z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
<div id="menu-wrapper" style="padding-top:25px;"
|
|
class="fixed inset-0 z-30 invisible w-screen h-screen m-auto overflow-auto transition-opacity opacity-0 cursor-default bg-neutral-100/50 backdrop-blur-sm dark:bg-neutral-900/50">
|
|
<ul
|
|
class="flex movedown flex-col w-full px-6 py-6 mx-auto overflow-visible list-none ltr:text-right rtl:text-left max-w-7xl sm:px-14 md:px-24 lg:px-32 sm:py-10 sm:pt-10">
|
|
<li class="mb-1">
|
|
<span class="cursor-pointer hover:text-primary-600 dark:hover:text-primary-400">
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><path fill="currentColor" d="M310.6 361.4c12.5 12.5 12.5 32.75 0 45.25C304.4 412.9 296.2 416 288 416s-16.38-3.125-22.62-9.375L160 301.3L54.63 406.6C48.38 412.9 40.19 416 32 416S15.63 412.9 9.375 406.6c-12.5-12.5-12.5-32.75 0-45.25l105.4-105.4L9.375 150.6c-12.5-12.5-12.5-32.75 0-45.25s32.75-12.5 45.25 0L160 210.8l105.4-105.4c12.5-12.5 32.75-12.5 45.25 0s12.5 32.75 0 45.25l-105.4 105.4L310.6 361.4z"/></svg>
|
|
|
|
</span>
|
|
|
|
</span>
|
|
</li>
|
|
|
|
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="https://github.com/nunocoracao/blowfish" title="">GitHub</a>
|
|
</li>
|
|
|
|
|
|
|
|
</ul>
|
|
</div>
|
|
</label>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div id="mobile-menu"
|
|
class="fixed inset-0 z-30 invisible w-screen h-screen m-auto overflow-auto transition-opacity opacity-0 cursor-default bg-neutral-100/50 backdrop-blur-sm dark:bg-neutral-900/50">
|
|
<ul
|
|
class="flex movedown flex-col w-full px-6 py-6 mx-auto overflow-visible list-none ltr:text-right rtl:text-left max-w-7xl sm:px-14 md:px-24 lg:px-32 sm:py-10 sm:pt-10">
|
|
<li class="mb-1">
|
|
<span class="cursor-pointer hover:text-primary-600 dark:hover:text-primary-400">
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><path fill="currentColor" d="M310.6 361.4c12.5 12.5 12.5 32.75 0 45.25C304.4 412.9 296.2 416 288 416s-16.38-3.125-22.62-9.375L160 301.3L54.63 406.6C48.38 412.9 40.19 416 32 416S15.63 412.9 9.375 406.6c-12.5-12.5-12.5-32.75 0-45.25l105.4-105.4L9.375 150.6c-12.5-12.5-12.5-32.75 0-45.25s32.75-12.5 45.25 0L160 210.8l105.4-105.4c12.5-12.5 32.75-12.5 45.25 0s12.5 32.75 0 45.25l-105.4 105.4L310.6 361.4z"/></svg>
|
|
|
|
</span>
|
|
|
|
</span>
|
|
</li>
|
|
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="https://github.com/nunocoracao/blowfish" title="">GitHub</a>
|
|
</li>
|
|
|
|
|
|
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="relative flex flex-col grow">
|
|
<main id="main-content" class="grow">
|
|
|
|
<article>
|
|
<header class="max-w-prose">
|
|
|
|
<ol class="text-sm text-neutral-500 dark:text-neutral-400 print:hidden">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="inline hidden">
|
|
<a
|
|
class="hover:underline decoration-neutral-300 dark:underline-neutral-600"
|
|
href="/blowfish/"
|
|
>Blowfish</a
|
|
><span class="px-1 text-primary-500">/</span>
|
|
</li>
|
|
|
|
|
|
<li class="inline ">
|
|
<a
|
|
class="hover:underline decoration-neutral-300 dark:underline-neutral-600"
|
|
href="/blowfish/docs/"
|
|
>Documentation</a
|
|
><span class="px-1 text-primary-500">/</span>
|
|
</li>
|
|
|
|
|
|
<li class="inline ">
|
|
<a
|
|
class="hover:underline decoration-neutral-300 dark:underline-neutral-600"
|
|
href="/blowfish/docs/version-2/"
|
|
>What's New in 2.0 ✨</a
|
|
><span class="px-1 text-primary-500">/</span>
|
|
</li>
|
|
|
|
|
|
<li class="inline hidden">
|
|
<a
|
|
class="hover:underline decoration-neutral-300 dark:underline-neutral-600"
|
|
href="/blowfish/docs/version-2/upgrade/"
|
|
>Upgrading from Congo 1.x</a
|
|
><span class="px-1 text-primary-500">/</span>
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
|
|
|
|
<h1 class="mt-0 text-4xl font-extrabold text-neutral-900 dark:text-neutral">
|
|
Upgrading from Congo 1.x
|
|
</h1>
|
|
<div class="mt-8 mb-12 text-base text-neutral-500 dark:text-neutral-400 print:hidden">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="flex flex-row flex-wrap items-center">
|
|
|
|
|
|
<span>1382 words</span><span class="px-2 text-primary-500">·</span><span title="Reading time">7 mins</span><span class="px-2 text-primary-500">·</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="mb-[2px]">
|
|
<a
|
|
href="#/docs/version-2/upgrade/index.md"
|
|
class="text-lg hover:text-primary-500"
|
|
rel="noopener noreferrer"
|
|
target="_blank"
|
|
title="Edit content"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M490.3 40.4C512.2 62.27 512.2 97.73 490.3 119.6L460.3 149.7L362.3 51.72L392.4 21.66C414.3-.2135 449.7-.2135 471.6 21.66L490.3 40.4zM172.4 241.7L339.7 74.34L437.7 172.3L270.3 339.6C264.2 345.8 256.7 350.4 248.4 353.2L159.6 382.8C150.1 385.6 141.5 383.4 135 376.1C128.6 370.5 126.4 361 129.2 352.4L158.8 263.6C161.6 255.3 166.2 247.8 172.4 241.7V241.7zM192 63.1C209.7 63.1 224 78.33 224 95.1C224 113.7 209.7 127.1 192 127.1H96C78.33 127.1 64 142.3 64 159.1V416C64 433.7 78.33 448 96 448H352C369.7 448 384 433.7 384 416V319.1C384 302.3 398.3 287.1 416 287.1C433.7 287.1 448 302.3 448 319.1V416C448 469 405 512 352 512H96C42.98 512 0 469 0 416V159.1C0 106.1 42.98 63.1 96 63.1H192z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
</span>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
</header>
|
|
<section class="flex flex-col max-w-full mt-0 prose dark:prose-invert lg:flex-row">
|
|
|
|
<div class="order-first px-0 lg:order-last lg:max-w-xs ltr:lg:pl-8 rtl:lg:pr-8">
|
|
<div class="toc ltr:pl-5 rtl:pr-5 print:hidden lg:sticky lg:top-10">
|
|
<details open class="mt-0 overflow-hidden rounded-lg ltr:-ml-5 ltr:pl-5 rtl:-mr-5 rtl:pr-5">
|
|
<summary
|
|
class="block py-1 text-lg font-semibold cursor-pointer bg-neutral-100 text-neutral-800 ltr:-ml-5 ltr:pl-5 rtl:-mr-5 rtl:pr-5 dark:bg-neutral-700 dark:text-neutral-100 lg:hidden"
|
|
>
|
|
Table of Contents
|
|
</summary>
|
|
<div
|
|
class="py-2 border-dotted border-neutral-300 ltr:-ml-5 ltr:border-l ltr:pl-5 rtl:-mr-5 rtl:border-r rtl:pr-5 dark:border-neutral-600"
|
|
>
|
|
<nav id="TableOfContents">
|
|
<ul>
|
|
<li><a href="#step-1-upgrade-hugo">Step 1: Upgrade Hugo</a></li>
|
|
<li><a href="#step-2-upgrade-congo">Step 2: Upgrade Congo</a>
|
|
<ul>
|
|
<li><a href="#upgrade-using-hugo">Upgrade using Hugo</a></li>
|
|
<li><a href="#upgrade-using-git">Upgrade using git</a></li>
|
|
<li><a href="#upgrade-manually">Upgrade manually</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#step-3-theme-configuration">Step 3: Theme configuration</a>
|
|
<ul>
|
|
<li><a href="#languagestoml">Languages.toml</a></li>
|
|
<li><a href="#menustoml">Menus.toml</a></li>
|
|
<li><a href="#configtoml">Config.toml</a></li>
|
|
<li><a href="#markuptoml">Markup.toml</a></li>
|
|
<li><a href="#paramstoml">Params.toml</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#step-4-move-assets">Step 4: Move assets</a></li>
|
|
<li><a href="#step-5-check-content">Step 5: Check content</a></li>
|
|
<li><a href="#step-6-rebuild">Step 6: Rebuild</a></li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</details>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="min-w-0 min-h-0 max-w-prose">
|
|
<p>Although Congo 2.0 contains a large number of changes, the theme has been designed to minimise the effort required to upgrade to the latest release.</p>
|
|
<p>That said, there are some changes that require adjustments to existing sites that are built with Congo version 1.x. This guide will step you through the process and highlight things you need to consider.</p>
|
|
<h2 id="step-1-upgrade-hugo" class="relative group">Step 1: Upgrade Hugo <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-1-upgrade-hugo" aria-label="Anchor">#</a></span></h2>
|
|
<div class="flex px-4 py-3 rounded-md bg-primary-100 dark:bg-primary-900">
|
|
<span class="text-primary-400 ltr:pr-3 rtl:pl-3">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</span>
|
|
<span class="dark:text-neutral-300">Congo 2.0 requires a minimum of <strong>Hugo v0.87.0 or later</strong></span>
|
|
</div>
|
|
|
|
<p>Congo is built to take advantage of some of the latest Hugo features. You should regularly keep your Hugo installation up to date to avoid any issues.</p>
|
|
<p>You can check your current version using the command <code>hugo version</code>. Visit the <a href="https://gohugo.io/getting-started/installing/">Hugo docs</a> for information on obtaining a newer release for your platform.</p>
|
|
<h2 id="step-2-upgrade-congo" class="relative group">Step 2: Upgrade Congo <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-2-upgrade-congo" aria-label="Anchor">#</a></span></h2>
|
|
<p>The process for upgrading Congo will depend on how you include the theme in your project. Instructions for each method can be found below.</p>
|
|
<ul>
|
|
<li><a href="#upgrade-using-hugo">Upgrade using Hugo</a></li>
|
|
<li><a href="#upgrade-using-git">Upgrade using git</a></li>
|
|
<li><a href="#upgrade-manually">Upgrade manually</a></li>
|
|
</ul>
|
|
<h3 id="upgrade-using-hugo" class="relative group">Upgrade using Hugo <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#upgrade-using-hugo" aria-label="Anchor">#</a></span></h3>
|
|
<p>To upgrade a go module to a new major release, the <code>modules.toml</code> and <code>go.mod</code> files need to be updated. In each file, update the path to the theme from <code>github.com/jpanther/congo</code> to <code>github.com/jpanther/congo/v2</code>.</p>
|
|
<p>Then change into your project directory and execute the following command:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo mod get -u
|
|
</span></span></code></pre></div><p>Note that in some circumstances there may be issues with this step due to the way that Hugo locally caches modules. If the command above doesn’t work, try using <code>hugo mod clean</code> to clear out the local cache and re-download any modules.</p>
|
|
<p>Once the theme has been upgraded, continue to the <a href="#step-3-theme-configuration">next section</a>.</p>
|
|
<h3 id="upgrade-using-git" class="relative group">Upgrade using git <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#upgrade-using-git" aria-label="Anchor">#</a></span></h3>
|
|
<p>Git submodules can be upgraded using the <code>git</code> command. Simply execute the following command and the latest version of the theme will be downloaded into your local repository:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">git submodule update --remote --merge
|
|
</span></span></code></pre></div><p>Once the submodule has been upgraded, continue to the <a href="#step-3-theme-configuration">next section</a>.</p>
|
|
<h3 id="upgrade-manually" class="relative group">Upgrade manually <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#upgrade-manually" aria-label="Anchor">#</a></span></h3>
|
|
<p>Updating Congo manually requires you to download the latest copy of the theme and replace the old version in your project.</p>
|
|
<div class="flex px-4 py-3 rounded-md bg-primary-100 dark:bg-primary-900">
|
|
<span class="text-primary-400 ltr:pr-3 rtl:pl-3">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</span>
|
|
<span class="dark:text-neutral-300">Note that any local customisations you have made to the theme files will be lost during this process.</span>
|
|
</div>
|
|
|
|
<ol>
|
|
<li>
|
|
<p>Download the latest release of the theme source code.</p>
|
|
<a
|
|
class="!rounded-md bg-primary-600 px-4 py-2 !text-neutral !no-underline hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
|
|
href="https://github.com/jpanther/congo/releases/latest"
|
|
target="_blank"
|
|
role="button"
|
|
>
|
|
Download from Github
|
|
</a>
|
|
|
|
</li>
|
|
<li>
|
|
<p>Extract the archive, rename the folder to <code>congo</code> and move it to the <code>themes/</code> directory inside your Hugo project’s root folder. You will need to overwrite the existing directory to replace all the theme files.</p>
|
|
</li>
|
|
<li>
|
|
<p>Continue to the <a href="#step-3-theme-configuration">next section</a>.</p>
|
|
</li>
|
|
</ol>
|
|
<h2 id="step-3-theme-configuration" class="relative group">Step 3: Theme configuration <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-3-theme-configuration" aria-label="Anchor">#</a></span></h2>
|
|
<p>Congo 2.0 introduces a number of new theme configuration parameters. Although the theme will adapt to existing version 1 configurations, in order to take advantage of some of the newer theme features, you will need to adjust your existing configuration.</p>
|
|
<p>The simplest way to do this is to take a copy of the theme’s default configuration and compare it to your existing files. The process is outlined in greater detail below.</p>
|
|
<h3 id="languagestoml" class="relative group">Languages.toml <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#languagestoml" aria-label="Anchor">#</a></span></h3>
|
|
<p>In order to provide multilingual support, language-specific theme parameters have been moved to a new config file <code>languages.[lang-code].toml</code>. The theme comes with a template <code>languages.en.toml</code> file which can be used as a guide.</p>
|
|
<div class="flex px-4 py-3 rounded-md bg-primary-100 dark:bg-primary-900">
|
|
<span class="text-primary-400 ltr:pr-3 rtl:pl-3">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</span>
|
|
<span class="dark:text-neutral-300">This step is optional if you do not need multilingual support, although completing it now will make future theme upgrades easier.</span>
|
|
</div>
|
|
|
|
<p>The languages config file follows this structure:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="c"># config/_default/languagues.en.toml</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="nx">languageCode</span> <span class="p">=</span> <span class="s2">"en"</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">languageName</span> <span class="p">=</span> <span class="s2">"English"</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">displayName</span> <span class="p">=</span> <span class="s2">"EN"</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">htmlCode</span> <span class="p">=</span> <span class="s2">"en"</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">weight</span> <span class="p">=</span> <span class="mi">1</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">rtl</span> <span class="p">=</span> <span class="kc">false</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="c"># Language-specific parameters go here</span>
|
|
</span></span></code></pre></div><p>Using your preferred language, simply create this new file in <code>config/_default/</code> and then move the language-specific parameters from any existing config files over to this new file. The table below outlines the parameters that need to be moved.</p>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Parameter</th>
|
|
<th>Old location</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>title</code></td>
|
|
<td><code>config.toml</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>description</code></td>
|
|
<td><code>params.toml</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>copyright</code></td>
|
|
<td><code>config.toml</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>dateFormat</code></td>
|
|
<td><code>params.toml</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>[author]</code></td>
|
|
<td><code>config.toml</code></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>Once the values have been moved to the new location, these parameters should be deleted from their original locations.</p>
|
|
<h3 id="menustoml" class="relative group">Menus.toml <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#menustoml" aria-label="Anchor">#</a></span></h3>
|
|
<p>As the theme is now aware of languages, the <code>menus.toml</code> file should also be renamed to include a language code. Rename the existing <code>menus.toml</code> to <code>menus.[lang-code].toml</code>, where the language code matches the code used in the <code>languages.toml</code> file in the previous section.</p>
|
|
<h3 id="configtoml" class="relative group">Config.toml <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#configtoml" aria-label="Anchor">#</a></span></h3>
|
|
<p>The <code>config.toml</code> file now only contains base Hugo configuration values. Other than removing the language-specific strings above, there are only two changes to consider.</p>
|
|
<p>If you’re using a language other than English, provide a <code>defaultContentLanguage</code> value that matches the language code in the config file you created for your language. Secondly, to take advange of the new site search in Congo 2.0, an <code>[outputs]</code> block needs to be provided.</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="c"># config/_default/config.toml</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="nx">defaultContentLanguage</span> <span class="p">=</span> <span class="s2">"en"</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="nx">enableRobotsTXT</span> <span class="p">=</span> <span class="kc">true</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">paginate</span> <span class="p">=</span> <span class="mi">10</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">summaryLength</span> <span class="p">=</span> <span class="mi">0</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="p">[</span><span class="nx">outputs</span><span class="p">]</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nx">home</span> <span class="p">=</span> <span class="p">[</span><span class="s2">"HTML"</span><span class="p">,</span> <span class="s2">"RSS"</span><span class="p">,</span> <span class="s2">"JSON"</span><span class="p">]</span>
|
|
</span></span></code></pre></div><h3 id="markuptoml" class="relative group">Markup.toml <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#markuptoml" aria-label="Anchor">#</a></span></h3>
|
|
<p>Congo 2.0 adds support for tables of contents on article pages. Although Hugo ships with default settings for generating contents listings, you can adjust this behaviour by adding a new <code>[tableOfContents]</code> block to your <code>markup.toml</code> file.</p>
|
|
<p>The recommended settings are as follows, which includes any headings in the Markdown content at levels 2, 3 and 4:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="c"># config/_default/markup.toml</span>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="p">[</span><span class="nx">tableOfContents</span><span class="p">]</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nx">startLevel</span> <span class="p">=</span> <span class="mi">2</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nx">endLevel</span> <span class="p">=</span> <span class="mi">4</span>
|
|
</span></span></code></pre></div><h3 id="paramstoml" class="relative group">Params.toml <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#paramstoml" aria-label="Anchor">#</a></span></h3>
|
|
<p>A number of new theme parameters have been introduced in Congo 2.0. Some minor changes are requried to existing configurations. Remember, the theme will always revert to a sensible default if a parameter is not provided.</p>
|
|
<p>The way that dark mode works in Congo has been changed to allow greater flexibility around configuration. The old <code>darkMode</code> and <code>darkToggle</code> parameters have been <strong>removed and replaced</strong> by three new parameters. These new options operate independently of each other, making it possible to force the appearance while still allowing the user to override.</p>
|
|
<!-- prettier-ignore-start -->
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>New parameter</th>
|
|
<th>Type</th>
|
|
<th>Default</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>defaultAppearance</code></td>
|
|
<td>String</td>
|
|
<td><code>"light"</code></td>
|
|
<td>Default theme appearance; either <code>light</code> or <code>dark</code>.<br>⚠️ <em>Setting this to <code>light</code> replicates the old <code>darkMode = false</code> setting, while <code>dark</code> replicates <code>darkMode = true</code>.</em></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>autoSwitchAppearance</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>true</code></td>
|
|
<td>Whether the theme appearance automatically switches based upon the operating system preference. Set to <code>false</code> to force the site to always use the <code>defaultAppearance</code>. <br>⚠️ <em>Setting this to <code>true</code> replicates the old <code>darkMode = "auto"</code> setting.</em></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>showAppearanceSwitcher</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>false</code></td>
|
|
<td>Whether the theme appearance switcher is dispalyed in the site footer. <br>⚠️ <em>This parameter replaces <code>darkToggle</code>.</em></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<!-- prettier-ignore-end -->
|
|
<p>The following table outlines some other key <strong>new parameters</strong> that control new features in version 2:</p>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>New parameter</th>
|
|
<th>Type</th>
|
|
<th>Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>enableSearch</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>false</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>showScrollToTop</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>true</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>article.showTaxonomies</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>false</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>article.showTableOfContents</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>false</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>list.showTableOfContents</code></td>
|
|
<td>Boolean</td>
|
|
<td><code>false</code></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>For the full list of supported parameters, refer to the <a href="https://nunocoracao.github.io/blowfish/docs/configuration/">Configuration</a> docs.</p>
|
|
<h2 id="step-4-move-assets" class="relative group">Step 4: Move assets <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-4-move-assets" aria-label="Anchor">#</a></span></h2>
|
|
<p>All site assets, with the exception of favicons, now use Hugo Pipes to build an optimised version of your project. In order for the theme to locate your files, any previously static theme assets need to be moved to the Hugo assets folder. Primarily this is the author image and site logo:</p>
|
|
<p><code>static/me.jpg</code> <strong>→</strong> <code>assets/me.jpg</code><br>
|
|
<code>static/logo.jpg</code> <strong>→</strong> <code>assets/logo.jpg</code></p>
|
|
<p>If you have provided an author image or site logo, simply move these assets from <code>static/</code> to <code>assets/</code>. If you use the same directory structure the theme will know where to find these files automatically. If you would like to provide a new path, update the <code>logo</code> and <code>author.image</code> config values accordingly.</p>
|
|
<p>Note that this step does not apply to any assets in your project that are actually static. For example, a PDF file that you link directly to from within an article is a static asset. These files should remain in the <code>static/</code> directory to ensure they are copied to the output folder when Hugo builds the site.</p>
|
|
<h2 id="step-5-check-content" class="relative group">Step 5: Check content <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-5-check-content" aria-label="Anchor">#</a></span></h2>
|
|
<p>The behavior of the <code>figure</code> shortcode is different in version 2. If you are using <code>figure</code> in your content and have advanced use cases, you may need to adjust the parameters you are providing.</p>
|
|
<p>Consult the <a href="https://nunocoracao.github.io/blowfish/docs/shortcodes/#figure">shortcode docs</a> to learn more about supported parameters.</p>
|
|
<h2 id="step-6-rebuild" class="relative group">Step 6: Rebuild <span class="absolute top-0 w-6 transition-opacity opacity-0 ltr:-left-6 rtl:-right-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#step-6-rebuild" aria-label="Anchor">#</a></span></h2>
|
|
<p>Now that all the configuration changes are complete, it’s time to rebuild the site. Run <code>hugo</code>, or your build command, and check that everything works as expected.</p>
|
|
<p>If you come across any errors, check the configuration is correct and refer to the <a href="https://nunocoracao.github.io/blowfish/docs/">full documentation</a> for further guidance. Remember, the example config files bundled with the theme contain all the default parameters and are a great starting point.</p>
|
|
<p>🙋♀️ If you still need help, feel free to ask your question on <a href="https://github.com/jpanther/congo/discussions">GitHub Discussions</a>.</p>
|
|
|
|
</div>
|
|
</section>
|
|
<footer class="pt-8 max-w-prose print:hidden">
|
|
|
|
|
|
|
|
|
|
<section class="flex flex-row flex-wrap justify-center pt-4 text-xl">
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="https://www.linkedin.com/shareArticle?mini=true&url=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&title=Upgrading%20from%20Congo%201.x"
|
|
title="Share on LinkedIn"
|
|
aria-label="Share on LinkedIn"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path fill="currentColor" d="M416 32H31.9C14.3 32 0 46.5 0 64.3v383.4C0 465.5 14.3 480 31.9 480H416c17.6 0 32-14.5 32-32.3V64.3c0-17.8-14.4-32.3-32-32.3zM135.4 416H69V202.2h66.5V416zm-33.2-243c-21.3 0-38.5-17.3-38.5-38.5S80.9 96 102.2 96c21.2 0 38.5 17.3 38.5 38.5 0 21.3-17.2 38.5-38.5 38.5zm282.1 243h-66.4V312c0-24.8-.5-56.7-34.5-56.7-34.6 0-39.9 27-39.9 54.9V416h-66.4V202.2h63.7v29.2h.9c8.9-16.8 30.6-34.5 62.9-34.5 67.2 0 79.7 44.3 79.7 101.9V416z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="https://twitter.com/intent/tweet/?url=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&text=Upgrading%20from%20Congo%201.x"
|
|
title="Tweet on Twitter"
|
|
aria-label="Tweet on Twitter"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="https://pinterest.com/pin/create/bookmarklet/?url=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&description=Upgrading%20from%20Congo%201.x"
|
|
title="Pin on Pinterest"
|
|
aria-label="Pin on Pinterest"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path fill="currentColor" d="M496 256c0 137-111 248-248 248-25.6 0-50.2-3.9-73.4-11.1 10.1-16.5 25.2-43.5 30.8-65 3-11.6 15.4-59 15.4-59 8.1 15.4 31.7 28.5 56.8 28.5 74.8 0 128.7-68.8 128.7-154.3 0-81.9-66.9-143.2-152.9-143.2-107 0-163.9 71.8-163.9 150.1 0 36.4 19.4 81.7 50.3 96.1 4.7 2.2 7.2 1.2 8.3-3.3.8-3.4 5-20.3 6.9-28.1.6-2.5.3-4.7-1.7-7.1-10.1-12.5-18.3-35.3-18.3-56.6 0-54.7 41.4-107.6 112-107.6 60.9 0 103.6 41.5 103.6 100.9 0 67.1-33.9 113.6-78 113.6-24.3 0-42.6-20.1-36.7-44.8 7-29.5 20.5-61.3 20.5-82.6 0-19-10.2-34.9-31.4-34.9-24.9 0-44.9 25.7-44.9 60.2 0 22 7.4 36.8 7.4 36.8s-24.5 103.8-29 123.2c-5 21.4-3 51.6-.9 71.2C65.4 450.9 0 361.1 0 256 0 119 111 8 248 8s248 111 248 248z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="https://reddit.com/submit/?url=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&resubmit=true&title=Upgrading%20from%20Congo%201.x"
|
|
title="Submit to Reddit"
|
|
aria-label="Submit to Reddit"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M201.5 305.5c-13.8 0-24.9-11.1-24.9-24.6 0-13.8 11.1-24.9 24.9-24.9 13.6 0 24.6 11.1 24.6 24.9 0 13.6-11.1 24.6-24.6 24.6zM504 256c0 137-111 248-248 248S8 393 8 256 119 8 256 8s248 111 248 248zm-132.3-41.2c-9.4 0-17.7 3.9-23.8 10-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3 55.4 12.5c0 13.6 11.1 24.6 24.6 24.6 13.8 0 24.9-11.3 24.9-24.9s-11.1-24.9-24.9-24.9c-9.7 0-18 5.8-22.1 13.8l-61.2-13.6c-3-.8-6.1 1.4-6.9 4.4l-19.1 86.4c-33.2 1.4-63.1 11.3-85.5 26.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9 0-46.3 46.9-14.4 62.8-1.1 5-1.7 10.2-1.7 15.5 0 52.6 59.2 95.2 132 95.2 73.1 0 132.3-42.6 132.3-95.2 0-5.3-.6-10.8-1.9-15.8 31.3-16 19.8-62.5-14.9-62.5zM302.8 331c-18.2 18.2-76.1 17.9-93.6 0-2.2-2.2-6.1-2.2-8.3 0-2.5 2.5-2.5 6.4 0 8.6 22.8 22.8 87.3 22.8 110.2 0 2.5-2.2 2.5-6.1 0-8.6-2.2-2.2-6.1-2.2-8.3 0zm7.7-75c-13.6 0-24.6 11.1-24.6 24.9 0 13.6 11.1 24.6 24.6 24.6 13.8 0 24.9-11.1 24.9-24.6 0-13.8-11-24.9-24.9-24.9z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="https://www.facebook.com/sharer/sharer.php?u=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&quote=Upgrading%20from%20Congo%201.x"
|
|
title="Share on Facebook"
|
|
aria-label="Share on Facebook"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M504 256C504 119 393 8 256 8S8 119 8 256c0 123.78 90.69 226.38 209.25 245V327.69h-63V256h63v-54.64c0-62.15 37-96.48 93.67-96.48 27.14 0 55.52 4.84 55.52 4.84v61h-31.28c-30.8 0-40.41 19.12-40.41 38.73V256h68.78l-11 71.69h-57.78V501C413.31 482.38 504 379.78 504 256z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
|
|
<a
|
|
class="m-1 inline-block min-w-[2.4rem] rounded bg-neutral-300 p-1 text-center text-neutral-700 hover:bg-primary-500 hover:text-neutral dark:bg-neutral-700 dark:text-neutral-300 dark:hover:bg-primary-400 dark:hover:text-neutral-800"
|
|
href="mailto:?body=https://nunocoracao.github.io/blowfish/docs/version-2/upgrade/&subject=Upgrading%20from%20Congo%201.x"
|
|
title="Send via email"
|
|
aria-label="Send via email"
|
|
>
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M207.8 20.73c-93.45 18.32-168.7 93.66-187 187.1c-27.64 140.9 68.65 266.2 199.1 285.1c19.01 2.888 36.17-12.26 36.17-31.49l.0001-.6631c0-15.74-11.44-28.88-26.84-31.24c-84.35-12.98-149.2-86.13-149.2-174.2c0-102.9 88.61-185.5 193.4-175.4c91.54 8.869 158.6 91.25 158.6 183.2l0 16.16c0 22.09-17.94 40.05-40 40.05s-40.01-17.96-40.01-40.05v-120.1c0-8.847-7.161-16.02-16.01-16.02l-31.98 .0036c-7.299 0-13.2 4.992-15.12 11.68c-24.85-12.15-54.24-16.38-86.06-5.106c-38.75 13.73-68.12 48.91-73.72 89.64c-9.483 69.01 43.81 128 110.9 128c26.44 0 50.43-9.544 69.59-24.88c24 31.3 65.23 48.69 109.4 37.49C465.2 369.3 496 324.1 495.1 277.2V256.3C495.1 107.1 361.2-9.332 207.8 20.73zM239.1 304.3c-26.47 0-48-21.56-48-48.05s21.53-48.05 48-48.05s48 21.56 48 48.05S266.5 304.3 239.1 304.3z"/></svg>
|
|
|
|
</span>
|
|
|
|
</a
|
|
>
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</footer>
|
|
</article>
|
|
|
|
|
|
<div
|
|
class="pointer-events-none absolute top-[100vh] bottom-0 w-12 ltr:right-0 rtl:left-0"
|
|
>
|
|
<a
|
|
href="#the-top"
|
|
class="pointer-events-auto sticky top-[calc(100vh-5.5rem)] flex h-12 w-12 items-center justify-center rounded-full bg-neutral/50 text-xl text-neutral-700 backdrop-blur hover:text-primary-600 dark:bg-neutral-800/50 dark:text-neutral dark:hover:text-primary-400"
|
|
aria-label="Scroll to top"
|
|
title="Scroll to top"
|
|
>
|
|
↑
|
|
</a>
|
|
</div>
|
|
|
|
</main><footer class="py-10 print:hidden">
|
|
|
|
|
|
<nav class="pb-4 text-base font-medium text-neutral-500 dark:text-neutral-400">
|
|
<ul class="flex flex-col list-none sm:flex-row">
|
|
|
|
<li
|
|
class="mb-1 ltr:text-right rtl:text-left sm:mb-0 ltr:sm:mr-7 ltr:sm:last:mr-0 rtl:sm:ml-7 rtl:sm:last:ml-0"
|
|
>
|
|
<a
|
|
class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/blowfish/tags/"
|
|
title="Tags"
|
|
>Tags</a
|
|
>
|
|
</li>
|
|
|
|
<li
|
|
class="mb-1 ltr:text-right rtl:text-left sm:mb-0 ltr:sm:mr-7 ltr:sm:last:mr-0 rtl:sm:ml-7 rtl:sm:last:ml-0"
|
|
>
|
|
<a
|
|
class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/blowfish/categories/"
|
|
title="Categories"
|
|
>Categories</a
|
|
>
|
|
</li>
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
<div class="flex items-center justify-between">
|
|
|
|
|
|
|
|
<p class="text-sm text-neutral-500 dark:text-neutral-400">
|
|
©
|
|
2022
|
|
Blowfish
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p class="text-xs text-neutral-500 dark:text-neutral-400">
|
|
|
|
|
|
Powered by <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500"
|
|
href="https://gohugo.io/" target="_blank" rel="noopener noreferrer">Hugo</a> & <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500" href="https://github.com/nunocoracao/blowfish" target="_blank" rel="noopener noreferrer">Blowfish</a>
|
|
</p>
|
|
|
|
|
|
</div>
|
|
<script>
|
|
mediumZoom(document.querySelectorAll("img:not(.nozoom)"), {
|
|
margin: 24,
|
|
background: 'rgba(0,0,0,0.5)',
|
|
scrollOffset: 0,
|
|
})
|
|
</script>
|
|
|
|
|
|
</footer>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|