mirror of
https://github.com/nunocoracao/blowfish.git
synced 2025-07-20 14:29:12 +02:00
1085 lines
56 KiB
HTML
1085 lines
56 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<html
|
|
lang="en"
|
|
dir="ltr"
|
|
class="scroll-smooth"
|
|
data-default-appearance="light"
|
|
data-auto-appearance="true"
|
|
><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>Installation · Blowfish</title>
|
|
<meta name="title" content="Installation · Blowfish" />
|
|
|
|
<meta name="description" content="Product | Nuno Coração" />
|
|
|
|
|
|
|
|
<link rel="canonical" href="https://github.com/nunocoracao/blowfish/docs/installation/" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link
|
|
type="text/css"
|
|
rel="stylesheet"
|
|
href="/nunocoracao/blowfish/css/main.bundle.min.3f7a3d89b943c3dacb033ff4448c83a5b58692eb75f99e903ee759443c690298da06dc2cc7adc967ae51bb50103acfa1b65f99a428ef2ff09176f2519b277273.css"
|
|
integrity="sha512-P3o9iblDw9rLAz/0RIyDpbWGkut1+Z6QPudZRDxpApjaBtwsx63JZ65Ru1AQOs+htl+ZpCjvL/CRdvJRmydycw=="
|
|
/>
|
|
|
|
|
|
<script type="text/javascript" src="/nunocoracao/blowfish/js/main.min.cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e.js" integrity="sha512-z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg=="></script>
|
|
|
|
|
|
<script type="text/javascript" src="/nunocoracao/blowfish/js/appearance.min.4a00b8b8a9118d31826a03a2a9cca83390fcd3eddd9e03868fffcf4dc1e2dc15649e9266091f1225a24e1bcf6558ff4807f77663bcfaaa8f3050d73c1bd5bf0b.js" integrity="sha512-SgC4uKkRjTGCagOiqcyoM5D80+3dngOGj//PTcHi3BVknpJmCR8SJaJOG89lWP9IB/d2Y7z6qo8wUNc8G9W/Cw=="></script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script defer type="text/javascript" id="script-bundle" src="/nunocoracao/blowfish/js/main.bundle.min.e6e48d63bad91cf9da5ad2ef829f0e1a4f79580fef3b734cbce6d93a5c2042e544ac067c02a4ae5d9f83b402ae77c7a04f8f3c347050a2d5bfb18c21fc7de756.js" integrity="sha512-5uSNY7rZHPnaWtLvgp8OGk95WA/vO3NMvObZOlwgQuVErAZ8AqSuXZ+DtAKud8egT488NHBQotW/sYwh/H3nVg==" data-copy="Copy" data-copied="Copied"></script>
|
|
|
|
<script src="/js/zoom.min.js"></script>
|
|
|
|
|
|
<link rel="apple-touch-icon" sizes="180x180" href="/nunocoracao/blowfish/apple-touch-icon.png" />
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/nunocoracao/blowfish/favicon-32x32.png" />
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/nunocoracao/blowfish/favicon-16x16.png" />
|
|
<link rel="manifest" href="/nunocoracao/blowfish/site.webmanifest" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<meta property="og:title" content="Installation" />
|
|
<meta property="og:description" content="How to install the Congo theme." />
|
|
<meta property="og:type" content="article" />
|
|
<meta property="og:url" content="https://github.com/nunocoracao/blowfish/docs/installation/" /><meta property="article:section" content="docs" />
|
|
<meta property="article:published_time" content="2020-08-16T00:00:00+00:00" />
|
|
<meta property="article:modified_time" content="2020-08-16T00:00:00+00:00" /><meta property="og:site_name" content="Blowfish" />
|
|
|
|
|
|
<meta name="twitter:card" content="summary"/>
|
|
<meta name="twitter:title" content="Installation"/>
|
|
<meta name="twitter:description" content="How to install the Congo theme."/>
|
|
|
|
|
|
<script type="application/ld+json">
|
|
[{
|
|
"@context": "https://schema.org",
|
|
"@type": "Article",
|
|
"articleSection": "Documentation",
|
|
"name": "Installation",
|
|
"headline": "Installation",
|
|
"description": "How to install the Congo theme.",
|
|
"abstract": "Simply follow the standard Hugo Quick Start procedure to get up and running quickly.\nDetailed installation instructions can be found below. Instructions for updating the theme are also available.\nInstallation # These instructions will get you up and running using Hugo and Congo from a completely blank state.",
|
|
"inLanguage": "en",
|
|
"url" : "https:\/\/github.com\/nunocoracao\/blowfish\/docs\/installation\/",
|
|
"author" : {
|
|
"@type": "Person",
|
|
"name": "Blowfish"
|
|
},
|
|
"copyrightYear": "2020",
|
|
"dateCreated": "2020-08-16T00:00:00\u002b00:00",
|
|
"datePublished": "2020-08-16T00:00:00\u002b00:00",
|
|
|
|
"dateModified": "2020-08-16T00:00:00\u002b00:00",
|
|
|
|
"keywords": ["installation","docs"],
|
|
|
|
"mainEntityOfPage": "true",
|
|
"wordCount": "976"
|
|
}]
|
|
</script>
|
|
|
|
|
|
|
|
<meta name="author" content="Blowfish" />
|
|
|
|
|
|
<link href="https://linkedin.com/in/nunocoracao" rel="me" />
|
|
|
|
<link href="https://twitter.com/nunocoracao" rel="me" />
|
|
|
|
<link href="https://medium.com/@nunocoracao" rel="me" />
|
|
|
|
<link href="https://github.com/nunocoracao" rel="me" />
|
|
|
|
<link href="http://goodreads.com/nunocoracao" rel="me" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<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="/nunocoracao/blowfish" class="flex">
|
|
<span class="sr-only">Blowfish</span>
|
|
|
|
<img src="/nunocoracao/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="/nunocoracao/blowfish/about/" class="text-base font-medium text-gray-500 hover:text-gray-900" title="About">About</a>
|
|
|
|
<a href="/nunocoracao/blowfish/posts/" class="text-base font-medium text-gray-500 hover:text-gray-900" title="Posts">Posts</a>
|
|
|
|
<a href="/nunocoracao/blowfish/resume/" class="text-base font-medium text-gray-500 hover:text-gray-900" title="Resume">Resume</a>
|
|
|
|
<a href="/nunocoracao/blowfish/music/" class="text-base font-medium text-gray-500 hover:text-gray-900" title="Music">Music</a>
|
|
|
|
<a href="/nunocoracao/blowfish/docs/" class="text-base font-medium text-gray-500 hover:text-gray-900" title="Documentation">Docs</a>
|
|
|
|
|
|
|
|
<span></span>
|
|
|
|
|
|
<button id="search-button" class="text-base hover:text-primary-600 dark:hover:text-primary-400"
|
|
title="">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M505 442.7L405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9 0 208 0S0 93.1 0 208s93.1 208 208 208c48.3 0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9 0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7 0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7 0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</button>
|
|
|
|
|
|
|
|
|
|
<div
|
|
class="ltr:mr-14 rtl:ml-14 cursor-pointer text-sm text-neutral-700 hover:text-primary-600 dark:text-neutral dark:hover:text-primary-400">
|
|
<button id="appearance-switcher" type="button">
|
|
<div class="flex items-center justify-center h-12 dark:hidden">
|
|
|
|
|
|
<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="M32 256c0-123.8 100.3-224 223.8-224c11.36 0 29.7 1.668 40.9 3.746c9.616 1.777 11.75 14.63 3.279 19.44C245 86.5 211.2 144.6 211.2 207.8c0 109.7 99.71 193 208.3 172.3c9.561-1.805 16.28 9.324 10.11 16.95C387.9 448.6 324.8 480 255.8 480C132.1 480 32 379.6 32 256z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
<div class="items-center justify-center hidden h-12 dark:flex">
|
|
|
|
|
|
<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="M256 159.1c-53.02 0-95.1 42.98-95.1 95.1S202.1 351.1 256 351.1s95.1-42.98 95.1-95.1S309 159.1 256 159.1zM509.3 347L446.1 255.1l63.15-91.01c6.332-9.125 1.104-21.74-9.826-23.72l-109-19.7l-19.7-109c-1.975-10.93-14.59-16.16-23.72-9.824L256 65.89L164.1 2.736c-9.125-6.332-21.74-1.107-23.72 9.824L121.6 121.6L12.56 141.3C1.633 143.2-3.596 155.9 2.736 164.1L65.89 256l-63.15 91.01c-6.332 9.125-1.105 21.74 9.824 23.72l109 19.7l19.7 109c1.975 10.93 14.59 16.16 23.72 9.824L256 446.1l91.01 63.15c9.127 6.334 21.75 1.107 23.72-9.822l19.7-109l109-19.7C510.4 368.8 515.6 356.1 509.3 347zM256 383.1c-70.69 0-127.1-57.31-127.1-127.1c0-70.69 57.31-127.1 127.1-127.1s127.1 57.3 127.1 127.1C383.1 326.7 326.7 383.1 256 383.1z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
</button>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
<div class="flex md:hidden items-center space-x-5 md:ml-12">
|
|
|
|
<span></span>
|
|
|
|
|
|
<button id="search-button-mobile" class="text-base hover:text-primary-600 dark:hover:text-primary-400"
|
|
title="">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M505 442.7L405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9 0 208 0S0 93.1 0 208s93.1 208 208 208c48.3 0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9 0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7 0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7 0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</button>
|
|
|
|
|
|
|
|
|
|
<button id="appearance-switcher-mobile" type="button" style="margin-right:5px">
|
|
<div class="flex items-center justify-center h-12 dark:hidden">
|
|
|
|
|
|
<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="M32 256c0-123.8 100.3-224 223.8-224c11.36 0 29.7 1.668 40.9 3.746c9.616 1.777 11.75 14.63 3.279 19.44C245 86.5 211.2 144.6 211.2 207.8c0 109.7 99.71 193 208.3 172.3c9.561-1.805 16.28 9.324 10.11 16.95C387.9 448.6 324.8 480 255.8 480C132.1 480 32 379.6 32 256z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
<div class="items-center justify-center hidden h-12 dark:flex">
|
|
|
|
|
|
<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="M256 159.1c-53.02 0-95.1 42.98-95.1 95.1S202.1 351.1 256 351.1s95.1-42.98 95.1-95.1S309 159.1 256 159.1zM509.3 347L446.1 255.1l63.15-91.01c6.332-9.125 1.104-21.74-9.826-23.72l-109-19.7l-19.7-109c-1.975-10.93-14.59-16.16-23.72-9.824L256 65.89L164.1 2.736c-9.125-6.332-21.74-1.107-23.72 9.824L121.6 121.6L12.56 141.3C1.633 143.2-3.596 155.9 2.736 164.1L65.89 256l-63.15 91.01c-6.332 9.125-1.105 21.74 9.824 23.72l109 19.7l19.7 109c1.975 10.93 14.59 16.16 23.72 9.824L256 446.1l91.01 63.15c9.127 6.334 21.75 1.107 23.72-9.822l19.7-109l109-19.7C510.4 368.8 515.6 356.1 509.3 347zM256 383.1c-70.69 0-127.1-57.31-127.1-127.1c0-70.69 57.31-127.1 127.1-127.1s127.1 57.3 127.1 127.1C383.1 326.7 326.7 383.1 256 383.1z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
</button>
|
|
|
|
|
|
</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="/nunocoracao/blowfish/about/" title="About">About</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/posts/" title="Posts">Posts</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/resume/" title="Resume">Resume</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/music/" title="Music">Music</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/docs/" title="Documentation">Docs</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="/nunocoracao/blowfish/about/" title="About">About</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/posts/" title="Posts">Posts</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/resume/" title="Resume">Resume</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/music/" title="Music">Music</a>
|
|
</li>
|
|
|
|
<li class="mb-1">
|
|
<a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2"
|
|
href="/nunocoracao/blowfish/docs/" title="Documentation">Docs</a>
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
<button id="search-button-mobile" class="text-base hover:text-primary-600 dark:hover:text-primary-400">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M505 442.7L405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9 0 208 0S0 93.1 0 208s93.1 208 208 208c48.3 0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9 0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7 0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7 0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</button>
|
|
</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="/nunocoracao/blowfish/"
|
|
>Welcome to Congo! :tada:</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="/nunocoracao/blowfish/docs/"
|
|
>Documentation</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="/nunocoracao/blowfish/docs/installation/"
|
|
>Installation</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">
|
|
Installation
|
|
</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>976 words</span><span class="px-2 text-primary-500">·</span><span title="Reading time">5 mins</span><span class="px-2 text-primary-500">·</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="mb-[2px]">
|
|
<a
|
|
href="https://github.com/nunocoracao/homepage/tree/main/content/docs/installation.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="#installation">Installation</a>
|
|
<ul>
|
|
<li><a href="#install-hugo">Install Hugo</a></li>
|
|
<li><a href="#create-a-new-site">Create a new site</a></li>
|
|
<li><a href="#download-the-congo-theme">Download the Congo theme</a>
|
|
<ul>
|
|
<li><a href="#install-using-hugo">Install using Hugo</a></li>
|
|
<li><a href="#install-using-git">Install using git</a></li>
|
|
<li><a href="#install-manually">Install manually</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#set-up-theme-configuration-files">Set up theme configuration files</a></li>
|
|
<li><a href="#next-steps">Next steps</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#installing-updates">Installing updates</a>
|
|
<ul>
|
|
<li><a href="#update-using-hugo">Update using Hugo</a></li>
|
|
<li><a href="#update-using-git">Update using git</a></li>
|
|
<li><a href="#update-manually">Update manually</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</details>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="min-w-0 min-h-0 max-w-prose">
|
|
<p>Simply follow the standard Hugo <a href="https://gohugo.io/getting-started/quick-start/">Quick Start</a> procedure to get up and running quickly.</p>
|
|
<p>Detailed installation instructions can be found below. Instructions for <a href="#installing-updates">updating the theme</a> are also available.</p>
|
|
<h2 id="installation" class="relative group">Installation <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="#installation" aria-label="Anchor">#</a></span></h2>
|
|
<p>These instructions will get you up and running using Hugo and Congo from a completely blank state. Most of the dependencies mentioned in this guide can be installed using the package manager of choice for your platform.</p>
|
|
<h3 id="install-hugo" class="relative group">Install 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="#install-hugo" aria-label="Anchor">#</a></span></h3>
|
|
<p>If you haven’t used Hugo before, you will need to <a href="https://gohugo.io/getting-started/installing">install it onto your local machine</a>. You can check if it’s already installed by running the command <code>hugo version</code>.</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">Make sure you are using <strong>Hugo version 0.87.0</strong> or later as the theme takes advantage of some of the latest Hugo features.</span>
|
|
</div>
|
|
|
|
<p>You can find detailed installation instructions for your platform in the <a href="https://gohugo.io/getting-started/installing">Hugo docs</a>.</p>
|
|
<h3 id="create-a-new-site" class="relative group">Create a new site <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="#create-a-new-site" aria-label="Anchor">#</a></span></h3>
|
|
<p>Run the command <code>hugo new site mywebsite</code> to create a new Hugo site in a directory named <code>mywebsite</code>.</p>
|
|
<p>Note that you can name the project directory whatever you choose, but the instructions below will assume it’s named <code>mywebsite</code>. If you use a different name, be sure to substitute it accordingly.</p>
|
|
<h3 id="download-the-congo-theme" class="relative group">Download the Congo theme <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="#download-the-congo-theme" aria-label="Anchor">#</a></span></h3>
|
|
<p>There several different ways to install the Congo theme into your Hugo website. From easiest to most difficult to install and maintain, they are:</p>
|
|
<ul>
|
|
<li><a href="#install-using-hugo">Hugo module</a> (recommended)</li>
|
|
<li><a href="#install-using-git">Git submodule</a></li>
|
|
<li><a href="#install-manually">Manual file copy</a></li>
|
|
</ul>
|
|
<p>If you’re unsure, choose the Hugo module method.</p>
|
|
<h4 id="install-using-hugo" class="relative group">Install 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="#install-using-hugo" aria-label="Anchor">#</a></span></h4>
|
|
<p>This method is the quickest and easiest for keeping the theme up-to-date. Hugo uses <strong>Go</strong> to initialise and manage modules so you need to ensure you have <code>go</code> installed before proceeding.</p>
|
|
<ol>
|
|
<li>
|
|
<p><a href="https://golang.org/dl/">Download</a> and install Go. You can check if it’s already installed by using the command <code>go version</code>.</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">Make sure you are using <strong>Go version 1.12</strong> or later as Hugo requires this for modules to work correctly.</span>
|
|
</div>
|
|
|
|
</li>
|
|
<li>
|
|
<p>From your Hugo project directory (that you created above), initialise modules for your website:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl"><span class="c1"># If you're managing your project on GitHub</span>
|
|
</span></span><span class="line"><span class="cl">hugo mod init github.com/<username>/<repo-name>
|
|
</span></span><span class="line"><span class="cl">
|
|
</span></span><span class="line"><span class="cl"><span class="c1"># If you're managing your project locally</span>
|
|
</span></span><span class="line"><span class="cl">hugo mod init my-project
|
|
</span></span></code></pre></div></li>
|
|
<li>
|
|
<p>Add the theme to your configuration by creating a new file <code>config/_default/module.toml</code> and adding the following:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="p">[[</span><span class="nx">imports</span><span class="p">]]</span>
|
|
</span></span><span class="line"><span class="cl"><span class="nx">path</span> <span class="p">=</span> <span class="s2">"github.com/jpanther/congo/v2"</span>
|
|
</span></span></code></pre></div></li>
|
|
<li>
|
|
<p>Start your server using <code>hugo server</code> and the theme will be downloaded automatically.</p>
|
|
</li>
|
|
<li>
|
|
<p>Continue to <a href="#set-up-theme-configuration-files">set up the theme configuration files</a>.</p>
|
|
</li>
|
|
</ol>
|
|
<h4 id="install-using-git" class="relative group">Install 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="#install-using-git" aria-label="Anchor">#</a></span></h4>
|
|
<p>For this method you’ll need to ensure you have <strong>Git</strong> installed on your local machine.</p>
|
|
<p>Change into the directory for your Hugo website (that you created above), initialise a new <code>git</code> repository and add Congo as a submodule.</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> mywebsite
|
|
</span></span><span class="line"><span class="cl">git init
|
|
</span></span><span class="line"><span class="cl">git submodule add -b stable https://github.com/jpanther/congo.git themes/congo
|
|
</span></span></code></pre></div><p>Then continue to <a href="#set-up-theme-configuration-files">set up the theme configuration files</a>.</p>
|
|
<h4 id="install-manually" class="relative group">Install 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="#install-manually" aria-label="Anchor">#</a></span></h4>
|
|
<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.</p>
|
|
</li>
|
|
<li>
|
|
<p>Continue to <a href="#set-up-theme-configuration-files">set up the theme configuration files</a>.</p>
|
|
</li>
|
|
</ol>
|
|
<h3 id="set-up-theme-configuration-files" class="relative group">Set up theme configuration files <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="#set-up-theme-configuration-files" aria-label="Anchor">#</a></span></h3>
|
|
<p>In the root folder of your website, delete the <code>config.toml</code> file that was generated by Hugo. Copy the <code>*.toml</code> config files from the theme into your <code>config/_default/</code> folder. This will ensure you have all the correct theme settings and will enable you to easily customise the theme to your needs.</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"><strong>Note:</strong> You should not overwrite the <code>module.toml</code> file if one already exists in your project!</span>
|
|
</div>
|
|
|
|
<p>Depending on how you installed the theme you will find the theme config files in different places:</p>
|
|
<ul>
|
|
<li><strong>Hugo Modules:</strong> In the Hugo cache directory, or <a href="https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/jpanther/congo/tree/stable/config/_default">download a copy</a> from GitHub</li>
|
|
<li><strong>Git submodule or Manual install:</strong> <code>themes/congo/config/_default</code></li>
|
|
</ul>
|
|
<p>Once you’ve copied the files, your config folder should look like this:</p>
|
|
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">config/_default/
|
|
</span></span><span class="line"><span class="cl">├─ config.toml
|
|
</span></span><span class="line"><span class="cl">├─ markup.toml
|
|
</span></span><span class="line"><span class="cl">├─ menus.toml
|
|
</span></span><span class="line"><span class="cl">├─ module.toml <span class="c1"># if you installed using Hugo Modules</span>
|
|
</span></span><span class="line"><span class="cl">└─ params.toml
|
|
</span></span></code></pre></div><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"><strong>Important:</strong> If you didn’t use Hugo Modules to install Congo, you must add the line <code>theme = "congo"</code> to the top of your <code>config.toml</code> file.</span>
|
|
</div>
|
|
|
|
<h3 id="next-steps" class="relative group">Next steps <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="#next-steps" aria-label="Anchor">#</a></span></h3>
|
|
<p>The basic Congo installation is now complete. Continue to the <a href="https://github.com/nunocoracao/blowfish/docs/getting-started/">Getting Started</a> section to learn more about configuring the theme.</p>
|
|
<hr>
|
|
<h2 id="installing-updates" class="relative group">Installing updates <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="#installing-updates" aria-label="Anchor">#</a></span></h2>
|
|
<p>From time to time there will be <a href="https://github.com/jpanther/congo/releases">new releases</a> posted that apply fixes and add new functionality to the theme. In order to take advantage of these changes, you will need to update the theme files on your website.</p>
|
|
<p>How you go about this will depend on the installation method you chose when the theme was originally installed. Instructions for each method can be found below.</p>
|
|
<ul>
|
|
<li><a href="#update-using-hugo">Hugo module</a></li>
|
|
<li><a href="#update-using-git">Git submodule</a></li>
|
|
<li><a href="#update-manually">Manual file copy</a></li>
|
|
</ul>
|
|
<h3 id="update-using-hugo" class="relative group">Update 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="#update-using-hugo" aria-label="Anchor">#</a></span></h3>
|
|
<p>Hugo makes updating modules super easy. Simply 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>Hugo will automatically update any modules that are required for your project. It does this by inspecting your <code>module.toml</code> and <code>go.mod</code> files. If you have any issues with the update, check to ensure these files are still configured correctly.</p>
|
|
<p>Then simply rebuild your site and check everything works as expected.</p>
|
|
<h3 id="update-using-git" class="relative group">Update 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="#update-using-git" aria-label="Anchor">#</a></span></h3>
|
|
<p>Git submodules can be updated 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 updated, rebuild your site and check everything works as expected.</p>
|
|
<h3 id="update-manually" class="relative group">Update 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="#update-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>Rebuild your site and check everything works as expected.</p>
|
|
</li>
|
|
</ol>
|
|
|
|
</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://github.com/nunocoracao/blowfish/docs/installation/&title=Installation"
|
|
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://github.com/nunocoracao/blowfish/docs/installation/&text=Installation"
|
|
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://github.com/nunocoracao/blowfish/docs/installation/&description=Installation"
|
|
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://github.com/nunocoracao/blowfish/docs/installation/&resubmit=true&title=Installation"
|
|
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://github.com/nunocoracao/blowfish/docs/installation/&quote=Installation"
|
|
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://github.com/nunocoracao/blowfish/docs/installation/&subject=Installation"
|
|
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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="pt-8">
|
|
<hr class="border-dotted border-neutral-300 dark:border-neutral-600" />
|
|
<div class="flex justify-between pt-3">
|
|
<span>
|
|
|
|
</span>
|
|
<span>
|
|
|
|
<a class="flex text-right group" href="/nunocoracao/blowfish/docs/getting-started/">
|
|
<span class="flex flex-col">
|
|
<span
|
|
class="mt-[0.1rem] leading-6 group-hover:underline group-hover:decoration-primary-500"
|
|
>Getting Started</span
|
|
>
|
|
<span class="mt-[0.1rem] text-xs text-neutral-500 dark:text-neutral-400">
|
|
|
|
</span>
|
|
</span>
|
|
<span
|
|
class="ml-3 text-neutral-700 group-hover:text-primary-600 ltr:inline rtl:hidden dark:text-neutral dark:group-hover:text-primary-400"
|
|
>→</span
|
|
>
|
|
<span
|
|
class="mr-3 text-neutral-700 group-hover:text-primary-600 ltr:hidden rtl:inline dark:text-neutral dark:group-hover:text-primary-400"
|
|
>←</span
|
|
>
|
|
</a>
|
|
|
|
</span>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</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="/nunocoracao/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="/nunocoracao/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
|
|
id="search-wrapper"
|
|
class="invisible fixed inset-0 z-50 flex h-screen w-screen cursor-default flex-col bg-neutral-500/50 p-4 backdrop-blur-sm dark:bg-neutral-900/50 sm:p-6 md:p-[10vh] lg:p-[12vh]"
|
|
data-url="https://github.com/nunocoracao/blowfish"
|
|
>
|
|
<div
|
|
id="search-modal"
|
|
class="flex flex-col w-full max-w-3xl min-h-0 mx-auto border rounded-md shadow-lg top-20 border-neutral-200 bg-neutral dark:border-neutral-700 dark:bg-neutral-800"
|
|
>
|
|
<header class="relative z-10 flex items-center justify-between flex-none px-2">
|
|
<form class="flex items-center flex-auto min-w-0">
|
|
<div class="flex items-center justify-center w-8 h-8 text-neutral-400">
|
|
|
|
|
|
<span class="relative inline-block align-text-bottom icon">
|
|
<svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M505 442.7L405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9 0 208 0S0 93.1 0 208s93.1 208 208 208c48.3 0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9 0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7 0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7 0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg>
|
|
|
|
</span>
|
|
|
|
|
|
</div>
|
|
<input
|
|
type="search"
|
|
id="search-query"
|
|
class="flex flex-auto h-12 mx-1 bg-transparent appearance-none focus:outline-dotted focus:outline-2 focus:outline-transparent"
|
|
placeholder="Search"
|
|
tabindex="0"
|
|
/>
|
|
</form>
|
|
<button
|
|
id="close-search-button"
|
|
class="flex items-center justify-center w-8 h-8 text-neutral-700 hover:text-primary-600 dark:text-neutral dark:hover:text-primary-400"
|
|
title="Close (Esc)"
|
|
>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
</button>
|
|
</header>
|
|
<section class="flex-auto px-2 overflow-auto">
|
|
<ul id="search-results">
|
|
|
|
</ul>
|
|
</section>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|