<scripttype=application/ld+json>{"@context":"https://schema.org","@type":"BlogPosting","articleSection":"Documentation","name":"Installation","headline":"Installation","description":"How to install the Congo theme.","inLanguage":"en-AU","author":{"@type":"Person","name":"Congo"},"creator":{"@type":"Person","name":"Congo"},"copyrightHolder":"Congo","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","url":"https:\/\/jpanther.github.io\/Congo\/docs\/installation\/","wordCount":"318","keywords":["installation","docs"]}</script>
<p>Simply follow the standard Hugo <ahref=https://gohugo.io/getting-started/quick-start/>Quick Start</a> procedure to get up and running quickly.</p>
<p>Detailed instructions can be found below.</p>
<h2id=install-hugo>Install Hugo <aclass=heading-anchorhref=#install-hugoaria-label=Anchor>#</a></h2>
<p>You can find specific instructions for your platform in the official <ahref=https://gohugo.io/getting-started/installing.>Hugo docs</a>.</p>
<p>Make sure you are using <strong>Hugo version 0.86.1</strong> or later as the theme takes advantage of some of the latest Hugo features.</p>
<h2id=create-a-new-site>Create a new site <aclass=heading-anchorhref=#create-a-new-sitearia-label=Anchor>#</a></h2>
<p>Run the command <code>hugo new site mywebsite</code> to create a new Hugo site in a folder named <code>mywebsite</code>.</p>
<h2id=download-the-congo-theme>Download the Congo theme <aclass=heading-anchorhref=#download-the-congo-themearia-label=Anchor>#</a></h2>
<p>There are a couple of ways to install the Congo theme into your Hugo website. The git method is the easiest to keep the theme up-to-date, but you can also download and install manually if you don’t have git available.</p>
<h3id=install-using-git>Install using git <aclass=heading-anchorhref=#install-using-gitaria-label=Anchor>#</a></h3>
<p>Change into the directory for your Hugo website, initialise a new repository and add Congo as a submodule.</p>
<spanclass="no-prose dark:text-gray-300"><strong>Note:</strong> You need to substitute <code>mywebsite</code> for the correct folder name you used in Step 2.</span>
<p>Extract the archive, rename the folder to <code>congo</code> and move it to the <code>themes/</code> directory inside your your <code>mywebsite</code> folder.</p>
<spanclass="no-prose dark:text-gray-300"><strong>Note:</strong> You need to substitute <code>mywebsite</code> for the correct folder name you used in Step 2.</span>
</div>
<h2id=set-up-your-configuration-files>Set up your configuration files <aclass=heading-anchorhref=#set-up-your-configuration-filesaria-label=Anchor>#</a></h2>
<p>In the root folder of your website, delete the <code>config.toml</code> file that was generated by Hugo. Copy the entire <code>config</code> folder from <code>themes/congo/config/</code> into the root of your website. This will ensure you have all the correct theme settings and will enable you to easily customise the theme.</p>
<p>You’re now all set up to use Congo. From here you can add some content and start the Hugo server.</p>
<p>Refer to the Hugo docs for more information or read the next section to learn more about configuring the theme.</p>
