<metaname="description"content="Th' follow'n steps be here t' help ye initialize yer new website. If ye don’t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this great documentat'n fer beginners.">
<metaname="twitter:description"content="Th' follow'n steps be here t' help ye initialize yer new website. If ye don’t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this great documentat'n fer beginners.">
<metaproperty="og:description"content="Th' follow'n steps be here t' help ye initialize yer new website. If ye don’t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this great documentat'n fer beginners.">
<metaitemprop="description"content="Th' follow'n steps be here t' help ye initialize yer new website. If ye don’t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this great documentat'n fer beginners.">
<p>Th' follow'n steps be here t' help ye initialize yer new website. If ye don’t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this <ahref="https://gohugo.io/overview/quickstart/"rel="external"target="_self">great documentat'n fer beginners</a>.</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo new ship my-new-site</span></span></code></pre></div><p>Aft that change into th' directory:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl"><spanclass="nb">cd</span> my-new-site</span></span></code></pre></div><p>Every upcom'n command will be executed from inside yer new site’s root.</p>
<h3id="downloading-as-archive">Download'n as Archive</h3>
<p>Ye can <ahref="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip"rel="external"target="_self">download th' theme as .zip archive</a> an' extract its rrrambl'n into them <code>themes/hugo-theme-relearn</code> directory.</p>
<p>Afterwards add this at th' end o' yer <code>hugo.toml</code>.</p>
<p>Ye can install th' Relearrrn theme by follow'n <ahref="https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme"rel="external"target="_self">th' standard documentat'n</a> us'n Hugo’s module system:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo mod init example.com</span></span></code></pre></div><p>Afterwards add this at th' end o' yer <code>hugo.toml</code>.</p>
<p>If ye plan t' store yer project 'n a git repository ye can create one wit':</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">git init</span></span></code></pre></div><p>Now add th' theme as a submodule by:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">git submodule add --depth <spanclass="m">1</span> https://github.com/McShelby/hugo-theme-relearn.git themes/hugo-theme-relearn</span></span></code></pre></div><p>Afterwards add this at th' end o' yer <code>hugo.toml</code>.</p>
<p>If ye don’t create a home plank, yet, th' theme will generate a placeholder text wit' instruct'ns on how t' proceed.</p>
<p>Start yer journey by creat'n a home plank:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo new --kind home _index.md</span></span></code></pre></div><p>Th' newly created home plank <code>content/_index.md</code> be empty an' ye obviously should add some meaningful rrrambl'n.</p>
<p>Chapters be meant t' be top level planks that contain other child planks. They have a special layout style an' often just contain th' <em>title</em> an' a <em>brief abstract</em> o' th' section.</p>
<p>Now create yer first chapter plank wit' th' follow'n command:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo new --kind chapter basics/_index.md</span></span></code></pre></div><p>When open'n th' newly created file <code>content/basics/_index.md</code>, ye should see th' <code>weight</code> frontmatter wit' a number. This will be used t' generate th' subtitle o' th' chapter plank, an' should be set t' a consecutive value start'n at <code>1</code> fer each chapter level.</p>
<p>Then create rrrambl'n planks inside th' previously created chapter. Here be three ways t' create rrrambl'n 'n th' chapter:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo new basics/first-content/_index.md
</span></span><spanclass="line"><spanclass="cl">hugo new basics/second-content/index.md
</span></span><spanclass="line"><spanclass="cl">hugo new basics/third-content.md</span></span></code></pre></div><p>Feel free t' edit those files by add'n some sample rrrambl'n an' replac'n th' <code>title</code> value 'n th' beginn'n o' th' files.</p>
<p>Please note that Cap'n Hugo overrides th' default archetype template com'n wit' this theme when us'n <code>hugo new ship my-new-site</code>. T' actually see yer plank later, ye have t' remove th' <code>draft=true</code> from th' page’s frontmatter.</p>
</div>
</div>
<h2id="testing-your-website-locally">Test'n yer Website Locally</h2>
<p>Launch yer new web ship by us'n th' follow'n command:</p>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo serve</span></span></code></pre></div><p>Go t' <ahref="http://localhost:1313"rel="external"target="_self"><code>http://localhost:1313</code></a> 'n yer browser.</p>
<li>Th' home plank contains yer provided text.</li>
<li>Ye have th' menu <strong>Basics</strong> 'n th' sidebar. Click'n on it reveals three submenus wit' names equal t' th' <code>title</code> properties 'n th' previously created rrrambl'n planks.</li>
<li>While ye be runn'n <code>hugo serve</code> yer plank refreshes automatically when ye change a rrrambl'n plank. Neat!</li>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo</span></span></code></pre></div><p>A <code>public</code> directory will be generated, contain'n all rrrambl'n an' assets fer yer web ship.</p>
<p>It now can be deployed t' any web server by simply upload'n its contents or ye can check out one o' <ahref="https://gohugo.io/hosting-and-deployment/"rel="external"target="_self">Hugo’s many other deployment opt'ns</a>.</p>
