<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="_blank">great documentat'n fer beginners</a>.</p>
<p>Cap'n Hugo provides a <code>new</code> command t' create a new website:</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>
<p>Ye can <ahref="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip"rel="external"target="_blank">download th' theme as .zip</a> file an' extract it into them <code>themes/hugo-theme-relearn</code> directory.</p>
<p>If ye install th' theme from yer git repository or GitHub, ye have several opt'ns.</p>
<p>If ye use th' <code>head</code> o' th' <code>main</code> branch, ye be us'n th' development version. Usually it be fully functional but can break from time t' time. We try t' fix newly introduced bugs 'n this version as soon as poss'ble.</p>
<p>Additionally ye can checkout one o' th' tagged versions. These tagged versions correspond t' an official <ahref="https://github.com/McShelby/hugo-theme-relearn/releases"rel="external"target="_blank">releases from th' GitHub repository</a>.</p>
<p>Besides th' usual version tags (eg <code>1.2.3</code>) there be also tags fer th' main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) an' th' latest (just <code>x</code>) released version mak'n it easier fer ye t' pin th' theme t' a certain version.</p>
<p>When build'n th' website, ye can set a theme by us'n <code>--theme</code> opt'n. However, we suggest ye modify th' configurat'n file <code>hugo.toml</code> an' set th' theme as th' default.</p>
<h2id="create-your-home-page">Create yer Home Plank</h2>
<p>If ye don’t create a home plank, yet, th' theme will generate a placeholder text wit' instruct'ns how t' proceed.</p>
<p>Start yer journey by fill'n th' home plank wit' rrrambl'n</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>By open'n th' given file, ye should see th' property <code>archetype=home</code> on top, mean'n this plank be a home plank. Th' Relearrrn theme provides <ahref="/hugo-theme-relearn/pir/cont/archetypes/index.html">some archetypes</a> t' create those skeleton files fer yer website.</p>
<p>Obviously ye better should change th' page’s rrrambl'n.</p>
<h2id="create-your-first-chapter-page">Create yer First Chapter Plank</h2>
<p>Chapters be planks that contain other child planks. It has a special layout style an' usually just contains th' <em>title</em> an' a <em>brief abstract</em> o' th' section.</p>
</span></span><spanclass="line"><spanclass="cl">Discover what this Cap'n Hugo theme be all about an' th' core concepts behind it.</span></span></code></pre></div><p>renders as</p>
<p>Begin by creat'n 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>By open'n th' given file, ye should see th' property <code>archetype=chapter</code> on top, mean'n this plank be a <em>chapter</em>.</p>
<p>Th' <code>weight</code> number will be used t' generate th' subtitle o' th' chapter plank, set th' number t' a consecutive value start'n at 1 fer each new chapter level.</p>
<h2id="create-your-first-content-pages">Create yer First Rrrambl'n Planks</h2>
<divclass="highlight wrap-code"><pretabindex="0"class="chroma"><codeclass="language-shell"data-lang="shell"><spanclass="line"><spanclass="cl">hugo new basics/first-content.md
</span></span><spanclass="line"><spanclass="cl">hugo new basics/second-content/_index.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>
<li>Ye have a left-side <strong>Basics</strong> menu, contain'n two submenus wit' names equal t' th' <code>title</code> properties 'n th' previously created files.</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> folder will be generated, contain'n all rrrambl'n an' assets fer yer website. It can now be deployed on any web server.</p>
<p>Now it’s time t' deploy yer plank by simply upload'n yer project t' some webserver or by us'n one o' <ahref="https://gohugo.io/hosting-and-deployment/"rel="external"target="_blank">Hugo’s many deployment opt'ns</a>.</p>