hugo-theme-relearn/pir/basics/installation/index.html

220 lines
30 KiB
HTML
Raw Normal View History

<!doctype html><html lang=pir class="js csstransforms3d">
<head>
<meta charset=utf-8>
<meta name=viewport content="width=device-width,initial-scale=1">
<meta name=generator content="Hugo 0.88.1">
<link rel=alternate type=application/rss+xml href=../../../pir/basics/installation/index.xml title="Documentat'n fer Cap'n Hugo Relearrrn Theme">
<meta name=description content="Documentation for Hugo Relearn Theme">
<meta name=author content="Sören Weber">
<link rel="shortcut icon" href=../../../images/logo.svg?1635068105>
<title>Installat'n :: Documentat'n fer Cap'n Hugo Relearrrn Theme</title>
<link href=../../../css/nucleus.css?1635068105 rel=stylesheet>
<link href=../../../css/fontawesome-all.min.css?1635068105 rel=stylesheet>
<link href=../../../css/featherlight.min.css?1635068105 rel=stylesheet>
<link href=../../../css/perfect-scrollbar.min.css?1635068105 rel=stylesheet>
<link href=../../../css/auto-complete.css?1635068105 rel=stylesheet>
<link href=../../../css/theme.css?1635068105 rel=stylesheet>
<link href=../../../css/theme-relearn.css?1635068105 rel=stylesheet>
<link href=../../../css/variant.css?1635068105 rel=stylesheet>
<link href=../../../css/print.css?1635068105 rel=stylesheet media=print>
<script src=../../../js/jquery.min.js?1635068105></script>
<style>:root #header+#content>#left>#rlblock_left{display:none!important}</style>
</head>
<body data-url=../../../pir/basics/installation/>
<nav id=sidebar class=showVisitedLinks>
<div id=header-wrapper>
<div id=header>
<a id=logo href=../../../pir/ style="color:#3d414d;font-family:novacento sans wide,helvetica,tahoma,geneva,arial,sans-serif;font-size:30px;font-weight:700;margin-top:-2px"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64.044 64.044" style="height:65px;margin-bottom:-20px;margin-top:-20px;width:65px"><path d="M46.103 136.34c-.642-.394-1.222-2.242-1.98-2.358-.76-.117-1.353.506-1.618 1.519-.266 1.012-.446 4.188.173 5.538.213.435.482.787 1.03.845.547.057.967-.504 1.45-1.027.482-.523.437-.9 1.142-.612.705.289 1.051.4 1.586 1.229.535.828 1.085 4.043.868 5.598-.241 1.458-.531 2.8-.59 4.088.26.075.517.148.772.217 2.68.724 5.373 1.037 7.873.02.001-.028.01-.105.008-.11-.048-.165-.18-.41-.36-.698-.18-.29-.414-.645-.586-1.114a3.212 3.212.0 01-.125-1.735c.056-.21.153-.342.249-.475 1.237-1.193 2.932-1.373 4.244-1.384.557-.004 1.389.016 2.198.255s1.706.724 2.068 1.843c.187.578.114 1.17-.043 1.623-.153.438-.369.783-.545 1.091-.178.31-.329.6-.401.821-.007.02-.003.071-.005.094 2.256 1.008 4.716.91 7.189.398.55-.114 1.11-.247 1.673-.377.344-1.085.678-2.145.852-3.208.124-.752.158-2.311-.078-3.538-.118-.613-.306-1.15-.52-1.489-.221-.349-.413-.501-.747-.538-.243-.027-.51.013-.796.098-.67.223-1.33.606-1.966.76l-.008.002-.109.032c-.556.152-1.233.158-1.797-.36-.556-.51-.89-1.367-1.117-2.596-.283-1.528-.075-3.279.89-4.518l.071-.09h.07c.65-.71 1.485-.802 2.16-.599.706.213 1.333.629 1.772.84.736.354 1.185.319 1.475.171.291-.148.5-.439.668-.955.332-1.017.301-2.819.022-4.106-.148-.684-.13-1.292-.13-1.883-1.558-.463-3.067-.982-4.574-1.208-1.128-.169-2.263-.173-3.298.164-.13.046-.256.095-.38.15-.373.164-.633.342-.805.52-.077.098-.081.105-.087.21-.004.068.031.289.13.571.1.282.256.634.467 1.03.279.524.448 1.063.431 1.618a2.12 2.12.0 01-.499 1.309 1.757 1.757.0 01-.62.51h-.002c-.515.291-1.107.404-1.723.464-.86.083-1.787.026-2.598-.097-.806-.123-1.47-.28-1.948-.555-.444-.256-.79-.547-1.037-.925a2.273 2.273.0 01-.356-1.301c.029-.837.403-1.437.625-1.897.111-.23.191-.433.236-.583.045-.15.044-.25.046-.24-.005-.029-.127-.355-1.015-.741-1.138-.495-2.322-.673-3.533-.668h-.015a9.711 9.711.0 00-.521.016h-.002c-1.163.057-2.35.308-3.541.569.383 1.531.79 2.753.818 4.502-.096 1.297.158 2.114-1.03 2.935-.85.588-1.508.729-2.15.335" style="fill:#3d414d;fill-opacity:1;stroke:none;stroke-width:1.03763;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" transform="translate(-40.698 -95.175)"/><path d="M61.472 101.34v.002c-.3-.003-.603.01-.894.04-.544.055-1.39.165-1.778.306-1.238.364.13 2.344.41 2.913.28.569.285 2.03.14 2.134-.144.103-.375.261-.934.345-.56.084.03-.037-1.589.086-1.62.122-5.506.29-8.265.248-.022.26-.036.521-.097.808-.309 1.442-.63 3.163-.494 4.074.071.473.168.65.414.8.23.14.737.235 1.62-.004.834-.227 1.3-.442 1.887-.456.595-.016 1.555.472 1.965.717.411.245-.03-.008.002.0s.128.05.176.102c.049.053-.276-.523.104.199.379.721.72 3.256.002 4.68-.46.913-1.01 1.49-1.64 1.711-.63.22-1.229.067-1.734-.135-.881-.353-1.584-.7-2.205-.647-1.199 1.94-1.186 4.17-.6 6.602.097.397.212.814.327 1.23 2.68-.556 5.542-1.016 8.337.132 1.064.437 1.73 1.015 1.902 1.857.169.831-.193 1.508-.438 1.986-.122.238-.23.46-.307.642-.07.164-.096.28-.104.324.069.429.309.723.686.945.385.227.89.355 1.35.423.723.104 1.567.152 2.287.086.693-.064 1.032-.338 1.241-.544a2.447 2.447.0 00.303-.437.175.175.0 00.013-.035c-.004-.066-.037-.246-.195-.527-.46-.816-.87-1.595-.817-2.51.028-.476.218-.938.529-1.288.304-.343.698-.586 1.186-.79 1.442-.606 2.96-.609 4.372-.409 1.525.216 2.963.679 4.378 1.083.226-2.09.784-3.9.592-5.77-.058-.565-.287-1.333-.598-1.827-.32-.508-.59-.717-1.036-.642-.648.11-1.472.935-2.707 1.078-.791.092-1.494-.267-1.95-.86-.45-.583-.678-1.335-.78-2.101-.202-1.525.031-3.229.89-4.27.615-.747 1.45-.887 2.15-.74.687.145 1.307.492 1.857.745v-.002c.546.252 1.033.388 1.281.344a.547.547.0 00.353-.188c.113-.124.242-.35.384-.75.604-1.712.206-3.68-.303-5.654-.667.145-1.336.293-2.018.413-1.341.236-2.73.392-4.136.273-.656-.055-1.695-.085-2.58-.476-.442-.195-.903-.514-1.157-1.093-.259-.591-.205-1.313.08-2.014.223-.64 1.082-2.178.692-2.585-.391-.407-1.651-.56-2.554-.571z" style="fill:#3d414
Relearn
</a>
</div>
<div class=searchbox>
<label for=search-by><i class="fas fa-search"></i></label>
<input data-search-input id=search-by type=search placeholder=Search...>
<span data-search-clear><i class="fas fa-times"></i></span>
</div>
<script src=../../../js/lunr.min.js?1635068105></script>
<script src=../../../js/auto-complete.js?1635068105></script>
<script>var index_url="../../../pir/index.json",root_url="../../../",baseUri=root_url.replace(/\/$/,'')</script>
<script src=../../../js/search.js?1635068105></script>
</div>
<div class=highlightable>
<ul class=topics>
<li data-nav-id=/pir/basics/ title=Basics class="dd-item parent"><a href=../../../pir/basics/><b>1.</b> Basics<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/basics/requirements/ title=Requirrrements class="dd-item alwaysopen"><a href=../../../pir/basics/requirements/>Requirrrements<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/basics/installation/ title="Installat'n" class="dd-item active parent alwaysopen"><a href=../../../pir/basics/installation/>Installat'n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/basics/migration/ title="Migrrrat'n" class="dd-item alwaysopen"><a href=../../../pir/basics/migration/>Migrrrat'n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/basics/configuration/ title="Configurrrat'n" class="dd-item alwaysopen"><a href=../../../pir/basics/configuration/>Configurrrat'n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/basics/customization/ title="Customizat'n" class="dd-item alwaysopen"><a href=../../../pir/basics/customization/>Customizat'n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/basics/history/ title=Historrry class="dd-item alwaysopen"><a href=../../../pir/basics/history/>Historrry<i class="fas fa-check read-icon"></i></a><ul></ul></li></ul></li>
<li data-nav-id=/pir/cont/ title="Rambl'n" class=dd-item><a href=../../../pir/cont/><b>2.</b> Rambl'n<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/cont/pages/ title="Planks orrrganizat'n" class="dd-item alwaysopen"><a href=../../../pir/cont/pages/>Planks orrrganizat'n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/cont/archetypes/ title=Arrrchetypes class=dd-item><a href=../../../pir/cont/archetypes/>Arrrchetypes<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/cont/markdown/ title="Marrrkdown rules" class=dd-item><a href=../../../pir/cont/markdown/>Marrrkdown rules<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/cont/syntaxhighlight/ title="Code highlight'n" class=dd-item><a href=../../../pir/cont/syntaxhighlight/>Code highlight'n<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/cont/menushortcuts/ title="Menu extrrra shorrrtcuts" class=dd-item><a href=../../../pir/cont/menushortcuts/>Menu extrrra shorrrtcuts<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/cont/icons/ title="Ay'cons an' logos" class=dd-item><a href=../../../pir/cont/icons/>Ay'cons an' logos<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/cont/i18n/ title="Multilingual an' i18n" class="dd-item alwaysopen"><a href=../../../pir/cont/i18n/>Multilingual an' i18n<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/cont/tags/ title=Tags class=dd-item><a href=../../../pir/cont/tags/>Tags<i class="fas fa-check read-icon"></i></a></li></ul></li>
<li data-nav-id=/pir/shortcodes/ title=Shorrrtcodes class=dd-item><a href=../../../pir/shortcodes/><b>3.</b> Shorrrtcodes<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/attachments/ title=Attachments class=dd-item><a href=../../../pir/shortcodes/attachments/>Attachments<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/button/ title=Button class=dd-item><a href=../../../pir/shortcodes/button/>Button<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/children/ title=Children class=dd-item><a href=../../../pir/shortcodes/children/>Children<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/children/test/ title="Plank X" class=dd-item><a href=../../../pir/shortcodes/children/test/>Plank X<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/children/children-1/ title="Plank 1" class=dd-item><a href=../../../pir/shortcodes/children/children-1/>Plank 1<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/children/children-1/children-1-1/ title="Plank 1-1" class=dd-item><a href=../../../pir/shortcodes/children/children-1/children-1-1/>Plank 1-1<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/children/children-1/children-1-1/children-1-1-2/ title="Plank 1-1-2" class="dd-item alwaysopen"><a href=../../../pir/shortcodes/children/children-1/children-1-1/children-1-1-2/>Plank 1-1-2<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-1/ title="Plank 1-1-2-1" class="dd-item alwaysopen"><a href=../../../pir/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-1/>Plank 1-1-2-1<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-2/ title="Plank 1-1-2-2" class="dd-item alwaysopen"><a href=../../../pir/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-2/>Plank 1-1-2-2<i class="fas fa-check read-icon"></i></a><ul></ul></li></ul></li>
<li data-nav-id=/pir/shortcodes/children/children-1/children-1-1/children-1-1-3/ title="Plank 1-1-3" class="dd-item alwaysopen"><a href=../../../pir/shortcodes/children/children-1/children-1-1/children-1-1-3/>Plank 1-1-3<i class="fas fa-check read-icon"></i></a><ul></ul></li></ul></li></ul></li>
<li data-nav-id=/pir/shortcodes/children/children-2/ title="Plank 2" class=dd-item><a href=../../../pir/shortcodes/children/children-2/>Plank 2<i class="fas fa-check read-icon"></i></a><ul></ul></li>
<li data-nav-id=/pir/shortcodes/children/children-3/ title="Plank 3" class=dd-item><a href=../../../pir/shortcodes/children/children-3/>Plank 3<i class="fas fa-check read-icon"></i></a><ul>
<li data-nav-id=/pir/shortcodes/children/children-3/test3/ title="Plank 3-1" class=dd-item><a href=../../../pir/shortcodes/children/children-3/test3/>Plank 3-1<i class="fas fa-check read-icon"></i></a></li></ul></li></ul></li>
<li data-nav-id=/pir/shortcodes/expand/ title=Expand class=dd-item><a href=../../../pir/shortcodes/expand/>Expand<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/include/ title=Include class=dd-item><a href=../../../pir/shortcodes/include/>Include<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/mermaid/ title=Merrrmaid class=dd-item><a href=../../../pir/shortcodes/mermaid/>Merrrmaid<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/notice/ title=Notice class=dd-item><a href=../../../pir/shortcodes/notice/>Notice<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/siteparam/ title="Ship param" class=dd-item><a href=../../../pir/shortcodes/siteparam/>Ship param<i class="fas fa-check read-icon"></i></a></li>
<li data-nav-id=/pir/shortcodes/tabs/ title="Tabbed views" class=dd-item><a href=../../../pir/shortcodes/tabs/>Tabbed views<i class="fas fa-check read-icon"></i></a></li></ul></li>
</ul>
<div id=shortcuts>
<div class=nav-title>More</div>
<ul>
<li><a class=padding href=../../../pir/tags/><i class="fas fa-fw fa-tags"></i> Arrr! Tags</a></li>
<li><a class=padding href=https://github.com/McShelby/hugo-theme-relearn><i class="fab fa-fw fa-github"></i> GitHub repo</a></li>
<li><a class=padding href=../../../pir/showcase/><i class="fas fa-fw fa-camera"></i> Showcases</a></li>
<li><a class=padding href=https://gohugo.io/><i class="fas fa-fw fa-bookmark"></i> Cap'n Hugo Documentat'n</a></li>
<li><a class=padding href=../../../pir/credits/><i class="fas fa-fw fa-bullhorn"></i> Crrredits</a></li>
</ul>
</div>
<div id=prefooter>
<hr>
<ul>
<li>
<a class=padding>
<i class="fas fa-language fa-fw"></i>
<div class=select-style>
<select id=select-language onchange="location=baseUri+this.value"><option id=pir value=/pir/basics/installation/ selected>Arrr! Pirrrates</option><option id=en value=/basics/installation/>English</option></select><svg id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="255" height="255" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255"><g><g id="arrow-drop-down"><polygon points="0,63.75 127.5,191.25 255,63.75"/></g></g></svg>
</div>
</a>
</li>
<li><a class=padding href=# data-clear-history-toggle><i class="fas fa-history fa-fw"></i> Clear History</a></li>
</ul>
</div>
<div id=footer>
<a class=github-button href=https://github.com/McShelby/hugo-theme-relearn/archive/main.zip data-icon=octicon-cloud-download aria-label="Download McShelby/hugo-theme-relearn on GitHub">Download</a>
<a class=github-button href=https://github.com/McShelby/hugo-theme-relearn data-icon=octicon-star data-show-count=true aria-label="Star McShelby/hugo-theme-relearn on GitHub">Star</a>
<a class=github-button href=https://github.com/McShelby/hugo-theme-relearn/fork data-icon=octicon-repo-forked data-show-count=true aria-label="Fork McShelby/hugo-theme-relearn on GitHub">Fork</a>
<p>Built with <a href=https://github.com/McShelby/hugo-theme-relearn><i class="fas fa-heart"></i></a> by <a href=https://gohugo.io/>Hugo</a></p>
<script async defer src=https://buttons.github.io/buttons.js></script>
</div>
</div>
</nav>
<div id=body>
<div id=overlay></div>
<div class="padding highlightable">
<div id=top-bar>
<div id=top-github-link>
<a class=github-link title="Edit this page" href=https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/basics/installation/_index.pir.md target=blank>
<i class="fas fa-code-branch"></i>
<span id=top-github-link-text>Edit this page</span>
</a>
</div>
<div id=breadcrumbs>
<span id=sidebar-toggle-span>
<a href=# id=sidebar-toggle data-sidebar-toggle>
<i class="fas fa-bars"></i>
</a>
</span>
<span id=toc-menu><i class="fas fa-list-alt"></i></span>
<ol class=links itemscope itemtype=http://schema.org/BreadcrumbList>
<meta itemprop=itemListOrder content="Descending">
<li itemscope itemtype=https://schema.org/ListItem itemprop=itemListElement><meta itemprop=position content="3"><a itemprop=item href=../../../pir/><span itemprop=name>Relearrrn Theme fer Cap'n Hugo</span></a> > </li>
<li itemscope itemtype=https://schema.org/ListItem itemprop=itemListElement><meta itemprop=position content="2"><a itemprop=item href=../../../pir/basics/><span itemprop=name>Basics</span></a> > </li>
<li itemscope itemtype=https://schema.org/ListItem itemprop=itemListElement><meta itemprop=position content="1"><a itemprop=item href=../../../pir/basics/installation/ aria-disabled=true><span itemprop=name>Installat'n</span></a></li>
</ol>
</div>
<div class=progress>
<div class=wrapper>
<nav id=TableOfContents></nav>
</div>
</div>
</div>
<div id=head-tags>
</div>
<main id=body-inner>
<h1>Installat'n</h1>
<p>Th' follow'n steps be here t' help ye initialize yer new website. If ye don&rsquo;t know Cap'n Hugo at all, we strongly suggest ye learn more about it by follow'n this <a href=https://gohugo.io/overview/quickstart/>great documentat'n fer beginners</a>.</p>
<h2 id=create-your-project>Create yer project</h2>
<p>Cap'n Hugo provides a <code>new</code> command t' create a new website.</p>
<pre tabindex=0><code>hugo new ship &lt;new_project&gt;
</code></pre><h2 id=install-the-theme>Install th' theme</h2>
<p>Install th' Relearrrn theme by follow'n <a href=https://gohugo.io/getting-started/quick-start/#step-3-add-a-theme>this documentat'n</a></p>
<p>This theme&rsquo;s repository be: <a href=https://github.com/McShelby/hugo-theme-relearn.git>https://github.com/McShelby/hugo-theme-relearn.git</a></p>
<p>Alternatively, ye can <a href=https://github.com/McShelby/hugo-theme-relearn/archive/main.zip>download th' theme as .zip</a> file an' extract it 'n th' <code>themes</code> directory</p>
<h2 id=basic-configuration>Basic configurat'n</h2>
<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>config.toml</code>) an' set th' theme as th' default. Ye can also add th' <code>[outputs]</code> section t' en'ble th' search functionality.</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-toml data-lang=toml><span style=color:#78787e># Change th' default theme t' be use when build'n th' ship wit' Cap'n Hugo</span>
theme = <span style=color:#5af78e>&#34;hugo-theme-relearn&#34;</span>
<span style=color:#78787e># For search functionality</span>
[outputs]
home = [ <span style=color:#5af78e>&#34;HTML&#34;</span>, <span style=color:#5af78e>&#34;RSS&#34;</span>, <span style=color:#5af78e>&#34;JSON&#34;</span>]
</code></pre></div><h2 id=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 a <em>chapter name</em>, th' <em>title</em> an' a <em>brief abstract</em> o' th' section.</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-markdown data-lang=markdown><span style=font-weight:700>### Chapter 1
</span><span style=font-weight:700></span>
<span style=font-weight:700># Basics
</span><span style=font-weight:700></span>
Discover what this Cap'n Hugo theme be all about an' th' core concepts behind it.
</code></pre></div><p>renders as</p>
<p><img src="../../../basics/installation/images/chapter.png?classes=shadow&width=60pc" alt="A Chapter"></p>
<p>Th' Relearrrn theme provides archetypes t' create skeletons fer yer website. Begin by creat'n yer first chapter plank wit' th' follow'n command</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell>hugo new --kind chapter basics/_index.md
</code></pre></div><p>By open'n th' given file, ye should see th' property <code>chapter=true</code> on top, mean'n this plank be a <em>chapter</em>.</p>
<p>By default all chapters an' planks be created as a draft. If ye want t' render these planks, remove th' property <code>draft: true</code> from th' metadata.</p>
<h2 id=create-your-first-content-pages>Create yer first rambl'n planks</h2>
<p>Then, create rambl'n planks inside th' previously created chapter. Here be two ways t' create rambl'n 'n th' chapter:</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell>hugo new basics/first-content.md
hugo new basics/second-content/_index.md
</code></pre></div><p>Feel free t' edit those files by add'n some sample rambl'n an' replac'n th' <code>title</code> value 'n th' beginn'n o' th' files.</p>
<h2 id=launching-the-website-locally>Launch'n th' website locally</h2>
<p>Launch by us'n th' follow'n command:</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell>hugo serve
</code></pre></div><p>Go t' <code>http://localhost:1313</code></p>
<p>Ye should notice three th'ns:</p>
<ol>
<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>
<li>Th' home plank explains how t' cust'mize it by follow'n th' instruct'ns.</li>
<li>When ye run <code>hugo serve</code>, when th' contents o' th' files change, th' plank automatically refreshes wit' th' changes. Neat!</li>
</ol>
<h2 id=build-the-website>Build th' website</h2>
<p>When yer ship be ready t' deploy, run th' follow'n command:</p>
<div class=highlight><pre tabindex=0 style=color:#e2e4e5;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-shell data-lang=shell>hugo
</code></pre></div><p>A <code>public</code> folder will be generated, contain'n all static rambl'n an' assets fer yer website. It can now be deployed on any web server.</p>
<div class="notices note">
<div class=label>Avast</div><p>This website can be automatically published an' hosted wit' <a href=https://www.netlify.com/>Netlify</a> (Read more about <a href=https://www.netlify.com/blog/2015/07/30/hosting-hugo-on-netlifyinsanely-fast-deploys/>Automated HUGO deployments wit' Netlify</a>). Alternatively, ye can use <a href=https://gohugo.io/hosting-and-deployment/hosting-on-github/>GitHub planks</a></p>
</div>
<footer class=footline>
</footer>
</main>
</div>
<div id=navigation>
<a class="nav nav-prev" href=../../../pir/basics/requirements/ title=Requirrrements><i class="fa fa-chevron-left"></i></a>
<a class="nav nav-next" href=../../../pir/basics/migration/ title="Migrrrat'n"><i class="fa fa-chevron-right"></i></a>
</div>
</div>
<div style=left:-1000px;overflow:scroll;position:absolute;top:-1000px;border:none;box-sizing:content-box;height:200px;margin:0;padding:0;width:200px>
<div style=border:none;box-sizing:content-box;height:200px;margin:0;padding:0;width:200px></div>
</div>
<script src=../../../js/clipboard.min.js?1635068105></script>
<script src=../../../js/perfect-scrollbar.min.js?1635068105></script>
<script src=../../../js/perfect-scrollbar.jquery.min.js?1635068105></script>
<script src=../../../js/jquery.svg.pan.zoom.js?1635068105></script>
<script src=../../../js/featherlight.min.js?1635068105></script>
<script src=../../../js/modernizr.custom-3.6.0.js?1635068105></script>
<script src=../../../js/mermaid.min.js?1635068105></script>
<script>typeof mermaid!='undefined'&&mermaid.mermaidAPI.initialize(Object.assign({securityLevel:"antiscript"},JSON.parse('{ "startOnLoad": true }'),{startOnLoad:!1}))</script>
<script src=../../../js/relearn.js?1635068105></script>
</body>
</html>