<h2><ahref="/hugo-theme-relearn/pir/configuration/customization/taxonomy/index.html">Taxonomies</a></h2><p>How t' display custom taxonomies on yer planks</p>
<p>Ye can call other partials from <code>themes/hugo-relearn-themes/</code> besides those 'n <code>themes/hugo-relearn-themes/layouts/partials/_relearn</code>. However, us'n partials not mentioned as customiz'ble below might make future updates more challeng'n.</p>
<p>Th' Relearrrn theme allows ye t' cust'mize various parts o' th' theme by overrid'n partials. This makes th' theme highly configur'ble.</p>
<p>A bloody rule t' follow: Th' less code a partial contains, th' easier it will be t' update th' theme 'n th' future.</p>
<p>Here’s a list o' partials ye can safely override:</p>
<ul>
<li>
<p><code>layouts/partials/content.html</code>: Th' main rrrambl'n o' a plank. Override this t' display additonal plank metadata.</p>
</li>
<li>
<p><code>layouts/partials/content-header.html</code>: Th' header above th' title. By default, it shows tags, but ye can change this.</p>
</li>
<li>
<p><code>layouts/partials/content-footer.html</code>: Th' footer below th' rrrambl'n. By default, it shows author info, modificat'n dates, an' categories. Ye can cust'mize this.</p>
</li>
<li>
<p><code>layouts/partials/custom-header.html</code>: For add'n custom CSS. Remember t' include th' <code>style</code> HTML tag.</p>
</li>
<li>
<p><code>layouts/partials/custom-footer.html</code>: For add'n custom JavaScript. Remember t' include th' <code>script</code> HTML tag.</p>
</li>
<li>
<p><code>layouts/partials/favicon.html</code>: Th' favicon. Ye should definitely cust'mize this.</p>
</li>
<li>
<p><code>layouts/partials/head'n.html</code>: th' page’s title head'ns</p>
</li>
<li>
<p><code>layouts/partials/heading-pre.html</code>: Add rrrambl'n before th' page’s title head'ns. Remember t' consider th' <code>headingPre</code> front matter.</p>
</li>
<li>
<p><code>layouts/partials/heading-post.html</code>: Add rrrambl'n after th' page’s title head'ns. Remember t' consider th' <code>headingPost</code> front matter.</p>
</li>
<li>
<p><code>layouts/partials/logo.html</code>: Th' logo 'n th' top left corner. Ye should cust'mize this.</p>
</li>
<li>
<p><code>layouts/partials/menu-pre.html</code>: Add rrrambl'n before menu items. Remember t' consider th' <code>menuPre</code> front matter.</p>
</li>
<li>
<p><code>layouts/partials/menu-post.html</code>: Add rrrambl'n after menu items. Remember t' consider th' <code>menuPost</code> front matter.</p>
</li>
<li>
<p><code>layouts/partials/menu-footer.html</code>: Th' footer o' th' left menu.</p>
</li>
</ul>
<p>Ye can override other partials from <code>themes/hugo-relearn-themes/</code>, but be careful as this might make future updates more difficult.</p>
<p>A common quest'n be how t' add extra CSS styles or JavaScript t' yer ship. This depends on what ye need.</p>
<h2id="adding-javascript-or-stylesheets-to-all-pages">Add'n JavaScript or Stylesheets t' All Planks</h2>
<p>T' add JavaScript files or CSS stylesheets t' every plank, ye can include them 'n <code>layouts/partials/custom-header.html</code> or <code>layouts/partials/custom-footer.html</code>.</p>
<p>However, this can make yer ship larger than necessary if these files be only needed on a few planks. Th' next section explains how t' add dependencies only when needed.</p>
<p>Some shorrrtcodes need extra JavaScript an' CSS files. Th' theme only loads these when th' shortcode be used. Ye can use this fer yer own shorrrtcodes too.</p>
<p>For example, t' create a shortcode called <code>myshortcode</code> that needs th' <code>jquery</code> library:</p>
<li>Th' <code>name</code> 'n <code>hugo.toml</code> must match th' <code>Store</code> key used 'n th' shortcode file, prefixed wit' a <code>has</code>.</li>
<li>Th' key o' <code>relearn.dependencies</code> must match th' loader file name.</li>
</ul>
<p>See th' <code>math</code>, <code>mermaid</code>, an' <code>openapi</code> shorrrtcodes fer examples.</p>
<p>Give a unique name fer th' <code>locat'n</code> parameter when ye call it, so ye can distinguish yer loaders behavior depend'n on th' locat'n it was called from.</p>
<p>This plank shows ye, how t' configure custom <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#image-effects">image effects</a> on top o' exist'n ones.</p>
<p>This sett'n can also <ahref="/hugo-theme-relearn/pir/authoring/imageeffects/index.html">be overridden by yer front matter</a>.</p>
<p>If ye don’t configure anyth'n 'n yer <code>hugo.toml</code>, th' image effects default t'</p>
<p><spanclass="badge cstyle cyan badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-gears"></i></span><spanclass="badge-content">Opt'n</span></span> Ye can change these sett'ns 'n yer <code>hugo.toml</code> an' add arbitrary custom effects as boolean values (like <code>bg-white</code> 'n th' below snippet).</p>
<p>Th' theme comes wit' a reasonably configured topbar. Ye can learn how t' <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/topbar/index.html">configure th' defaults 'n this section</a>.</p>
<p><ahref="#R-image-1dac6d0e9db9f677a788008578a72411"class="lightbox-link"><imgalt="topbar on mobile devices"class="bg-white border lazy lightbox noshadow figure-image"loading="lazy"src="/hugo-theme-relearn/configuration/customization/topbar/topbar-closed.png"style=" height: auto; width: auto;"></a>
<ahref="javascript:history.back();"class="lightbox-back"id="R-image-1dac6d0e9db9f677a788008578a72411"><imgalt="topbar on mobile devices"class="bg-white border lazy lightbox noshadow lightbox-image"loading="lazy"src="/hugo-theme-relearn/configuration/customization/topbar/topbar-closed.png"></a></p>
<p>Nevertheless, yer requirements may differ from this configurat'n. Luckily, th' theme has ye covered as th' topbar, its buttons, an' th' functionality behind these buttons be fully configur'ble by ye.</p>
<li><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/start.html"rel="external"target="_self"><strong>start</strong></a>: shown between menu an' breadcrumb</li>
<li><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html"rel="external"target="_self"><strong>end</strong></a>: shown on th' opposite breadcrumb side 'n comparison t' th' <em>start</em> area</li>
<li><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/more.html"rel="external"target="_self"><strong>more</strong></a>: shown when press'n th' <spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-ellipsis-v"></i></span></span><em>more</em> button 'n th' topbar</li>
</ul>
<p>While ye cannot add additional areas 'n th' topbar, ye be free t' configure additional buttons that behave like th' <em>more</em> button, provid'n further user-defined areas.</p>
<h2id="buttons">Buttons</h2>
<p>Th' theme ships wit' th' follow'n predefined buttons (from left t' right 'n th' screenshot):</p>
<ul>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-bars"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html"rel="external"target="_self"><strong>sidebar</strong></a>: opens th' sidebar flyout if 'n mobile layout</li>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-list-alt"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html"rel="external"target="_self"><strong>toc</strong></a>: <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/topbar/index.html#table-of-contents">opens th' t'ble o' contents 'n an overlay</a></li>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-pen"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html"rel="external"target="_self"><strong>edit</strong></a>: browses t' th' edit'ble plank if th' <code>editURL</code><ahref="/hugo-theme-relearn/pir/authoring/frontmatter/topbar/index.html#edit-button">parameter be set</a></li>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-print"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html"rel="external"target="_self"><strong>print</strong></a>: browses t' th' chapter’s print'ble plank if <ahref="/hugo-theme-relearn/pir/configuration/sitemanagement/outputformats/index.html#print-support">print support</a> was activated</li>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-chevron-left"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html"rel="external"target="_self"><strong>prev</strong></a>: browses t' th' <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/topbar/index.html#arrow-navigation">previous plank</a> if there be one</li>
<li><spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-chevron-right"></i></span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html"rel="external"target="_self"><strong>next</strong></a>: browses t' th' [next page]authoring/frontmatter/topbar(#arrow-navigation) if there be one</li>
<p>Not all buttons be displayed at every given time. This be configur'ble (see below if interested).</p>
<h2id="redefining-areas">Redefin'n Areas</h2>
<p>Each predefined area an' button comes 'n its own file. By that, it be easy fer ye t' overwrite an area file 'n yer installat'n, reus'n only th' buttons ye like.</p>
<p>E.g., ye can redefine th' predefined <em>end</em> area by add'n th' file <ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html"rel="external"target="_self"><code>layouts/partials/topbar/area/end.html</code></a> 'n yer installat'n (not 'n th' theme itself) t' remove all but th' <em>more</em> button.</p>
<p>Th' below example sets an explicit value fer th' <code>onempty</code> parameter, overrid'n th' specific default value fer this button (these defaults vary depend'n on th' button). Th' parameter causes th' <em>more</em> button t' always be displayed instead o' hid'n once its rrrambl'n be empty.</p>
<h2id="defining-own-buttons">Defin'n Own Buttons</h2>
<h3id="button-types">Button Types</h3>
<p>Th' theme distinguishes between two types o' buttons:</p>
<ul>
<li><ahref="/hugo-theme-relearn/pir/configuration/customization/topbar/index.html#button"><strong>button</strong></a>: a click'ble button that either browses t' another ship, triggers a user-defined script or opens an overlay contain'n user-defined rrrambl'n</li>
<li><ahref="/hugo-theme-relearn/pir/configuration/customization/topbar/index.html#area-button"><strong>area-button</strong></a>: th' template fer th' <spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-ellipsis-v"></i></span></span><em>more</em> button, t' define yer own area overlay buttons</li>
<p>Depend'n on th' screen width, ye can configure how th' button should behave. Screen width be divided into three classes:</p>
<ul>
<li><strong>s</strong>: (controlled by th' <code>onwidths</code> parameter) mobile layout whar' th' menu sidebar be hidden</li>
<li><strong>m</strong>: (controlled by th' <code>onwidthm</code> parameter) desktop layout wit' vis'ble sidebar while th' rrrambl'n area width still resizes</li>
<li><strong>l</strong>: (controlled by th' <code>onwidthl</code> parameter) desktop layout wit' vis'ble sidebar once th' rrrambl'n area reached its maximum width</li>
</ul>
<p>For each width class, ye can configure one o' th' follow'n act'ns:</p>
<ul>
<li><code>show</code>: th' button be displayed 'n its given area</li>
<li><code>hide</code>: th' button be removed</li>
<li><code>area-XXX</code>: th' button be moved from its given area into th' area <code>XXX</code>; fer example, this be used t' move buttons t' th' <em>more</em> area overlay 'n th' mobile layout</li>
<p>While hid'n a button depend'n on th' screen size can be configured wit' th' above-described <em>hide</em> act'n, ye may want t' hide th' button on certain other condit'ns as well.</p>
<p>For example, th' <em>print</em> button 'n its default configurat'n should only be displayed if print support was configured. This be done 'n yer button template by check'n th' condit'ns first before display'n th' button (see <ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html"rel="external"target="_self"><code>layouts/partials/topbar/button/print.html</code></a>).</p>
<p>Another preferred condit'n fer hid'n a button be if th' displayed overlay be empty. This be th' case fer th' <em>toc</em> (see <ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html"rel="external"target="_self"><code>layouts/partials/topbar/button/toc.html</code></a>) as well as th' <em>more</em> button (see <ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html"rel="external"target="_self"><code>layouts/partials/topbar/button/more.html</code></a>) an' controlled by th' parameter <code>onempty</code>.</p>
<p>This parameter can have one o' th' follow'n values:</p>
<ul>
<li><code>dis'ble</code>: th' button be displayed 'n a disabled state if th' overlay be empty</li>
<li><code>hide</code>: th' button be removed if th' overlay be empty</li>
</ul>
<p>If ye want t' dis'ble a button contain'n <em>no overlay</em>, this can be achieved by an empty <code>href</code> parameter. An example can be seen 'n th' <em>prev</em> button (see <code>layouts/partials/topbar/button/prev.html</code>) whar' th' URL fer th' previous ship may be empty.</p>
<h2id="reference">Reference</h2>
<h3id="button">Button</h3>
<p>Contains th' basic button functionality an' be used as a base implementat'n fer all other buttons (<ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/button.html"rel="external"target="_self"><code>layouts/partials/topbar/func/button.html</code></a>).</p>
<p>Call this from yer own button templates if ye want t' implement a button without an overlay like th' <em>print</em> button (<ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html"rel="external"target="_self"><code>layouts/partials/topbar/button/print.html</code></a>) or wit' an overlay contain'n arbitrary rrrambl'n like th' <em>toc</em> button (<ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html"rel="external"target="_self"><code>layouts/partials/topbar/button/toc.html</code></a>).</p>
<p>For display'n an area 'n th' button’s overlay, see <ahref="/hugo-theme-relearn/pir/configuration/customization/topbar/index.html#area-button">Area-Button</a>.</p>
<td>Either th' destinat'n URL fer th' button or JavaScript code t' be executed on click.<br><br>- If start'n wit' <code>javascript:</code> all follow'n text will be executed 'n yer browser<br>- Every other str'n will be interpreted as URL<br>- If empty, th' button will be displayed 'n a disabled state regardless o' its <strong>rrrambl'n</strong></td>
<td>Defines what t' do wit' th' button if th' rrrambl'n parameter was set but ends up empty:<br><br>- <code>dis'ble</code>: Th' button be displayed 'n a disabled state.<br>- <code>hide</code>: Th' button be removed.</td>
<td>Th' act'n that should be executed if th' ship be displayed 'n th' given width:<br><br>- <code>show</code>: Th' button be displayed 'n its given area<br>- <code>hide</code>: Th' button be removed.<br>- <code>area-XXX</code>: Th' button be moved from its given area into th' area <code>XXX</code>.</td>
<p>Contains th' basic functionality t' display area overlay buttons (<ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/area-button.html"rel="external"target="_self"><code>layouts/partials/topbar/func/area-button.html</code></a>).</p>
<p>Call this from yer own button templates if ye want t' implement a button wit' an area overlay like th' <em>more</em> button (<ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html"rel="external"target="_self"><code>layouts/partials/topbar/button/more.html</code></a>).</p>
<td>Defines what t' do wit' th' button if th' rrrambl'n overlay be empty:<br><br>- <code>dis'ble</code>: Th' button be displayed 'n a disabled state.<br>- <code>hide</code>: Th' button be removed.</td>
<td>Th' act'n that should be executed if th' ship be displayed 'n th' given width:<br><br>- <code>show</code>: Th' button be displayed 'n its given area<br>- <code>hide</code>: Th' button be removed.<br>- <code>area-XXX</code>: Th' button be moved from its given area into th' area <code>XXX</code>.</td>
<td>Th' act'n that should be executed if th' ship be displayed 'n th' given width:<br><br>- <code>show</code>: Th' button be displayed 'n its given area<br>- <code>hide</code>: Th' button be removed.<br>- <code>area-XXX</code>: Th' button be moved from its given area into th' area <code>XXX</code>.</td>
<p>Th' predefined buttons by th' theme that open an overlay (the <em>more</em> an' <em>toc</em> button 'n <ahref="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button"rel="external"target="_self"><code>layouts/partials/topbar/button</code></a>).</p>
<p>Call these from yer own redefined area templates if ye want t' use default button behavior utiliz'n overlay functionality.</p>
<p>Th' <em><varying></em> parameter values be different fer each button an' configured fer standard behavior as seen on this plank.</p>
<td>Defines what t' do wit' th' button if th' rrrambl'n overlay be empty:<br><br>- <code>dis'ble</code>: Th' button be displayed 'n a disabled state.<br>- <code>hide</code>: Th' button be removed.</td>
<td>Th' act'n that should be executed if th' ship be displayed 'n th' given width:<br><br>- <code>show</code>: Th' button be displayed 'n its given area<br>- <code>hide</code>: Th' button be removed.<br>- <code>area-XXX</code>: Th' button be moved from its given area into th' area <code>XXX</code>.</td>
<p>A plank be displayed by exactly one plank design. Th' Relearrrn theme offers th' plank designs <code>home</code>, <code>chapter</code>, an' <code>default</code>.</p>
<p>A plank design usually consists o'</p>
<ul>
<li><ahref="https://gohugo.io/content-management/archetypes/"rel="external"target="_self">an archetype file</a>: a template fer creat'n new Marrrkdown files wit' this design</li>
<li><ahref="https://gohugo.io/templates/types/#content-view"rel="external"target="_self">rrrambl'n view files</a>: represented by <ahref="https://gohugo.io/content-management/front-matter/#type"rel="external"target="_self">Hugo’s reserved <code>type</code> front matter</a> an' backed by match'n partials</li>
<li>CSS styles</li>
</ul>
<p>If no <code>type</code> be set 'n yer front matter, th' plank be treated as if <code>type='default'</code> was set.</p>
<p>Don’t use th' <code>type</code> opt'n 'n yer modificat'ns fer other functionality!</p>
</div>
</div>
<p>All shipped designs use th' theme’s framework from <code>themes/hugo-theme-learn/layouts/_default/baseof.html</code>, contain'n o' th' same topbar an' sidebar but can change how rrrambl'n appears 'n th' center o' th' plank.</p>
<h2id="using-a-page-design">Us'n a Plank Design</h2>
<p>Regardless o' shipped or custom plank design, ye be <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/designs/index.html">us'n them</a> 'n th' same way.</p>
<h2id="creating-a-page-designs">Creat'n a Plank Designs</h2>
<p>T' make a custom plank design:</p>
<ol>
<li>
<p>Choose a name (for example, <code>mydesign</code>)</p>
</li>
<li>
<p>Create a rrrambl'n view file at <code>layouts/mydesign/views/article.html</code></p>
<p>Th' above example uses <code>layouts/mydesign/views/article.html</code> but ye have some others</p>
<ul>
<li><code>layouts/mydesign/baseof.html</code>: Completely redefine th' whole HTML structure, none o' th' other listed partials will be used</li>
<li><code>layouts/mydesign/views/menu.html</code>: Defines th' sidebar menu layout</li>
<li><code>layouts/mydesign/views/body.html</code>: Determines what t' contain 'n th' rrrambl'n area (for example a single plank, a list o' planks, a tree o' sub pages)</li>
<li><code>layouts/mydesign/views/article.html</code>: Controls how one page’s rrrambl'n an' title be displayed</li>
<p>In addit'n t' th' <ahref="/hugo-theme-relearn/pir/configuration/sitemanagement/outputformats/index.html">output formats com'n wit' th' theme</a>, ye can create yer own <ahref="https://gohugo.io/templates/output-formats/"rel="external"target="_self">output formats</a>.</p>
<h2id="starting-from-scratch">Start'n from Scratch</h2>
<p>If ye want t' add a new output format called <code>myformat</code> that outputs HTML an' ye want t' build everyth'n yourself without us'n th' theme’s components:</p>
<ol>
<li>Create a file <code>layouts/_default/baseof.myformat.html</code></li>
<li>Implement all th' necessary code 'n this file</li>
<p>This plank explains how t' show custom taxonomies on yer planks.</p>
<p>For more details, check th' official docs on <ahref="https://gohugo.io/content-management/taxonomies/#configure-taxonomies"rel="external"target="_self">sett'n up custom taxonomies</a> an' <ahref="https://gohugo.io/content-management/taxonomies/#assign-terms-to-content"rel="external"target="_self">us'n them 'n yer rrrambl'n</a>.</p>
<h2id="default-behavior">Default Behavior</h2>
<p>Th' Relearrrn theme automatically shows Hugo’s <ahref="https://gohugo.io/content-management/taxonomies/#default-taxonomies"rel="external"target="_self">default taxonomies</a><em>tags</em> an' <em>categories</em> out o' th' box.</p>
<ul>
<li>Tags appear at th' top o' th' plank 'n alphabetical order 'n form o' baggage tags.</li>
<li>Categories appear at th' bottom o' th' plank 'n alphabetical order as a list prefixed wit' an ay'con.</li>
</ul>
<p>Each item links t' a plank show'n all articles wit' that term.</p>
<h2id="setting-up-custom-taxonomies">Sett'n Up Custom Taxonomies</h2>
<p>T' add custom taxonomies, update yer <code>hugo.toml</code> file. Ye also have t' add th' default taxonomies if ye want t' use them.</p>
<td>Additional CSS classes set on th' outermost generated HTML element.<br><br>If set t' <code>tags</code> ye will get th' visuals fer display'n th' <em>tags</em> taxonomy, otherwise it will be a simple list o' links as fer th' <em>categories</em> taxonomy.</td>
<td>Th' style scheme used if <strong>class</strong> be <code>tags</code>.<br><br>- by severity: <code>caut'n</code>, <code>important</code>, <code>info</code>, <code>note</code>, <code>tip</code>, <code>warning</code><br>- by brand color: <code>primary</code>, <code>secondary</code>, <code>accent</code><br>- by color: <code>blue</code>, <code>cyan</code>, <code>green</code>, <code>grey</code>, <code>magenta</code>, <code>orange</code>, <code>red</code><br>- by special color: <code>default</code>, <code>transparent</code>, <code>code</code></td>
<td>Th' <ahref="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value"rel="external"target="_self">CSS color value</a> t' be used if <strong>class</strong> be <code>tags</code>. If not set, th' chosen color depends on th' <strong>style</strong>. Any given value will overwrite th' default.<br><br>- fer severity styles: a nice match'n color fer th' severity<br>- fer all other styles: th' correspond'n color</td>
<td>An optional <ahref="/hugo-theme-relearn/pir/shortcodes/icon/index.html#finding-an-icon">Font Awesome ay'con name</a> set t' th' left o' th' list.</td>
