<liitemscopeitemtype="https://schema.org/ListItem"itemprop="itemListElement"><aitemprop="item"href="../../../pir/index.html"><spanitemprop="name">Cap'n Hugo Relearrrn Theme</span></a><metaitemprop="position"content="1">></li>
<p>On top o' <ahref="https://gohugo.io/overview/configuration/"target="_blank">Cap'n Hugo global configurat'n</a>, th' Relearrrn theme lets ye define th' follow'n parameters 'n yer <code>config.toml</code> (here, values be default).</p>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># This controls whether submenus will be expanded (true), or collapsed (false) 'n th'</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># menu; if no sett'n be given, th' first menu level be set t' false, all others t' true;</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># this can be overridden 'n th' planks frontmatter</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Prefix URL t' edit current plank. Will display an "Edit" button on top right hand corner o' every plank.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Useful t' give opportunity t' people t' create merge request fer yer doc.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># See th' config.toml file from this documentat'n ship t' have an example.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Disables hidden planks from show'n up 'n th' sitemap an' on Google (et all), otherwise they may be indexed by search engines</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Disables hidden planks from show'n up on th' tags plank although th' tag term will be displayed even if all planks be hidden</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Javascript an' CSS cache be automatically busted when new version o' ship be generated.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Set this t' true t' dis'ble this behavior (some proxies don't handle well this optimization)</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Set this t' true if ye want t' dis'ble generat'n fer generator version meta tags o' hugo an' th' theme;</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># don't forget t' also set Hugo's disableHugoGeneratorInject=true, otherwise it will generate a meta tag into yer home plank</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># A title fer shortcuts 'n menu be set by default. Set this t' true t' dis'ble it.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' false, a Home button will appear below th' search bar on th' menu.</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># It be redirect'n t' th' land'n plank o' th' current language if specified. (Default be "/")</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' false, board th' MathJax module on every plank regardless if a MathJax shortcode be present</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' false, board th' Merrrmaid module on every plank regardless if a Merrrmaid shortcode or Merrrmaid codefence be present</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' false, board th' OpenAPI module on every plank regardless if a OpenAPI shortcode be present</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Order sections 'n menu by "weight" or "title". Default t' "weight";</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># this can be overridden 'n th' planks frontmatter</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># Change default color scheme wit' a variant one. Eg. can be "auto", "red", "blue", "green" or an array like [ "blue", "green" ].</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' true, th' menu 'n th' sidebar will be displayed 'n a collaps'ble tree view. Although th' functionality works wit' old browsers (IE11), th' display o' th' expander ay'cons be limited t' modern browsers</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># If set t' true, no index.html will be appended t' prettyURLs; this will cause planks not</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># t' be serv'ble from th' file system</span>
</span></span><spanclass="line"><spanclass="cl"><spanclass="c"># For external links ye can define how they be opened 'n yer browser; this sett'n will only be applied t' th' rrrambl'n area but not th' shortcut menu</span>
<p>If yer ship be served from a subfolder, eg. <code>https://example.com/mysite/</code>, ye have t' set th' follow'n lines t' yer <code>config.toml</code></p>
</span></span></code></pre></div><p>Without <code>canonifyURLs=true</code> URLs 'n sublemental planks (like <code>sitemap.xml</code>, <code>rss.xml</code>) will be generated falsly while yer HTML files will still work. See <ahref="https://github.com/gohugoio/hugo/issues/5226"target="_blank">https://github.com/gohugoio/hugo/issues/5226</a>.</p>
<h2id="serving-your-page-from-the-filesystem">Serv'n yer plank from th' filesystem</h2>
<p>If ye want yer plank served from th' filesystem by us'n URLs start'n wit' <code>file://</code> you’ll need th' follow'n configurat'n 'n yer <code>config.toml</code>:</p>
</span></span></code></pre></div><p>Th' theme will append an additional <code>index.html</code> t' all branch bundle links by default t' make th' plank be serv'ble from th' file system. If ye don’t care about th' file system an' only serve yer plank via a webserver ye can also generate th' links without this change by add'n this t' yer <code>config.toml</code></p>
<p>If ye want t' use th' search feature from th' file system us'n an older installat'n o' th' theme make sure t' change yer outputformat fer th' homepage from th' now deprecated <code>JSON</code> t' <code>SEARCH</code><ahref="#activate-search">as seen below</a>.</p>
</span></span></code></pre></div><p>This will generate a search index file at th' root o' yer public folder ready t' be consumed by th' Lunr search library. Avast that th' <code>SEARCH</code> outputformat was named <code>JSON</code> 'n previous releases but was implemented differently. Although <code>JSON</code> still works, it be now deprecated.</p>
<p>Ye can add a dedicated search plank fer yer plank by add'n th' <code>SEARCHPAGE</code> outputformat t' yer home plank by add'n th' follow'n lines 'n yer <code>config.toml</code> file.</p>
</span></span></code></pre></div><p>Ye can access this plank by either click'n on th' magnifier glass or by typ'n some search term an' press'n <code>ENTER</code> inside o' th' menu’s search box .</p>
<p>Ye can activate print support t' add th' capability t' print whole chapters or even th' complete ship. Just add th' <code>PRINT</code> output format t' yer home, section an' plank 'n yer <code>config.toml</code> as seen below:</p>
</span></span></code></pre></div><p>This will add a little printer ay'con 'n th' top bar. It will switch th' plank t' print preview when clicked. Ye can then send this plank t' th' printer by us'n yer browser’s usual print functionality.</p>
<p>Th' result'n URL will not be <ahref="https://gohugo.io/templates/output-formats/#configure-output-formats"target="_blank">configured ugly</a> 'n terms o' <ahref="https://gohugo.io/content-management/urls/#ugly-urls"target="_blank">Hugo’s URL handl'n</a> even if you’ve set <code>uglyURLs=true</code> 'n yer <code>config.toml</code>. This be due t' th' fact that fer one mime type only one suffix can be configured.</p>
<p>Nevertheless, if you’re unhappy wit' th' result'n URLs ye can manually redefine <code>outputFormats.PRINT</code> 'n yer own <code>config.toml</code> t' yer lik'n.</p>
<p>Th' MathJax configurat'n parameters can also be set on a specific plank. In this case, th' global parameter would be overwritten by th' local one. See <ahref="../../../shortcodes/math/">Math</a> fer additional documentat'n.</p>
<p>MathJax be globally disabled. By default it won’t be boarded by any plank.</p>
<p>On plank “Physics” ye coded some JavaScript fer a dynamic formulae. Ye can set th' MathJax parameters locally t' board mathJax on this plank.</p>
<p>Ye also can dis'ble MathJax fer specific planks while globally enabled.</p>
<p>Th' Merrrmaid configurat'n parameters can also be set on a specific plank. In this case, th' global parameter would be overwritten by th' local one. See <ahref="../../../shortcodes/mermaid/">Merrrmaid</a> fer additional documentat'n.</p>
<p>Merrrmaid be globally disabled. By default it won’t be boarded by any plank.</p>
<p>On plank “Architecture” ye coded some JavaScript t' dynamically generate a class diagram. Ye can set th' Merrrmaid parameters locally t' board mermaid on this plank.</p>
<imgsrc="../../../basics/configuration/home_button_defaults.png?classes=shadow&width=18.75rem"alt="Default Home Button"class="lightbox-image"loading="lazy">
