2022-04-02 13:30:16 +00:00
<!DOCTYPE html>
2023-02-08 21:24:18 +00:00
< html lang = "pir" dir = "rtl" >
2022-04-02 13:30:16 +00:00
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "height=device-height, width=device-width, initial-scale=1.0, minimum-scale=1.0" >
2023-06-03 09:12:46 +00:00
< meta name = "generator" content = "Hugo 0.112.7" >
2023-05-29 11:49:37 +00:00
< meta name = "generator" content = "Relearn 5.15.2+tip" >
2022-04-02 13:30:16 +00:00
< meta name = "description" content = "Documentation for Hugo Relearn Theme" >
< meta name = "author" content = "Sören Weber" >
2023-05-19 16:47:33 +00:00
< title > planks orrrganizat' n :: Cap' n Hugo Relearrrn Theme< / title >
2023-01-25 11:42:06 +00:00
< link href = "https://McShelby.github.io/hugo-theme-relearn/cont/pages/index.html" rel = "alternate" hreflang = "x-default" >
< link href = "https://McShelby.github.io/hugo-theme-relearn/cont/pages/index.html" rel = "alternate" hreflang = "en" >
< link href = "https://McShelby.github.io/hugo-theme-relearn/pir/cont/pages/index.html" rel = "alternate" hreflang = "pir" >
2023-05-19 16:47:33 +00:00
< link href = "https://McShelby.github.io/hugo-theme-relearn/pir/cont/pages/index.html" rel = "canonical" type = "text/html" title = "planks orrrganizat'n :: Cap'n Hugo Relearrrn Theme" >
< link href = "../../../pir/cont/pages/index.xml" rel = "alternate" type = "application/rss+xml" title = "planks orrrganizat'n :: Cap'n Hugo Relearrrn Theme" >
2023-06-05 16:33:00 +00:00
< link href = "../../../images/logo.svg?1685982774" rel = "icon" type = "image/svg+xml" >
2022-07-15 13:20:02 +00:00
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how - to - use -->
2023-06-05 16:33:00 +00:00
< link href = "../../../css/fontawesome-all.min.css?1685982776" rel = "stylesheet" media = "print" onload = "this.media='all';this.onload=null;" > < noscript > < link href = "../../../css/fontawesome-all.min.css?1685982776" rel = "stylesheet" > < / noscript >
< link href = "../../../css/nucleus.css?1685982776" rel = "stylesheet" >
< link href = "../../../css/auto-complete.css?1685982776" rel = "stylesheet" media = "print" onload = "this.media='all';this.onload=null;" > < noscript > < link href = "../../../css/auto-complete.css?1685982776" rel = "stylesheet" > < / noscript >
< link href = "../../../css/perfect-scrollbar.min.css?1685982776" rel = "stylesheet" >
< link href = "../../../css/fonts.css?1685982776" rel = "stylesheet" media = "print" onload = "this.media='all';this.onload=null;" > < noscript > < link href = "../../../css/fonts.css?1685982776" rel = "stylesheet" > < / noscript >
< link href = "../../../css/theme.css?1685982776" rel = "stylesheet" >
< link href = "../../../css/theme-auto.css?1685982776" rel = "stylesheet" id = "variant-style" >
< link href = "../../../css/variant.css?1685982776" rel = "stylesheet" >
< link href = "../../../css/print.css?1685982776" rel = "stylesheet" media = "print" >
< link href = "../../../css/format-print.css?1685982776" rel = "stylesheet" >
< link href = "../../../css/ie.css?1685982776" rel = "stylesheet" >
< script src = "../../../js/url.js?1685982776" > < / script >
< script src = "../../../js/variant.js?1685982776" > < / script >
2022-04-02 13:30:16 +00:00
< script >
// hack to let hugo tell us how to get to the root when using relativeURLs, it needs to be called *url= for it to do its magic:
// https://github.com/gohugoio/hugo/blob/145b3fcce35fbac25c7033c91c1b7ae6d1179da8/transform/urlreplacers/absurlreplacer.go#L72
2022-11-05 23:35:48 +00:00
window.index_js_url="../../../pir/index.search.js";
var root_url="../../../";
2022-04-02 13:30:16 +00:00
var baseUri=root_url.replace(/\/$/, '');
// translations
window.T_Copy_to_clipboard = 'Copy t\u0027 clipboard';
window.T_Copied_to_clipboard = 'Copied t\u0027 clipboard!';
window.T_Copy_link_to_clipboard = 'Copy link t\u0027 clipboard';
window.T_Link_copied_to_clipboard = 'Copied link t\u0027 clipboard!';
2022-11-17 21:13:11 +00:00
window.T_No_results_found = 'No rrresults found fer \u0022{0}\u0022';
window.T_N_results_found = '{1} rrresults found fer \u0022{0}\u0022';
2022-04-02 13:30:16 +00:00
// some further base stuff
var baseUriFull='https:\/\/McShelby.github.io\/hugo-theme-relearn/';
2023-02-25 21:51:39 +00:00
window.variants & & variants.init( [ 'auto', 'relearn-bright', 'relearn-light', 'relearn-dark', 'learn', 'neon', 'blue', 'green', 'red' ] );
2022-04-02 13:30:16 +00:00
< / script >
2022-12-02 15:05:54 +00:00
< style >
#body img.bg-white {
background-color: white;
}
< / style >
2022-04-02 13:30:16 +00:00
< / head >
2022-11-15 06:35:08 +00:00
< body class = "mobile-support print disableInlineCopyToClipboard" data-url = "../../../pir/cont/pages/index.html" >
2022-04-02 13:30:16 +00:00
< div id = "body" class = "default-animation" >
< div id = "sidebar-overlay" > < / div >
< div id = "toc-overlay" > < / div >
2023-02-08 23:54:12 +00:00
< nav id = "topbar" class = "highlightable" >
2022-04-02 13:30:16 +00:00
< div >
< div id = "breadcrumbs" >
< span id = "sidebar-toggle-span" >
2023-02-04 15:02:34 +00:00
< a href = "#" id = "sidebar-toggle" class = "topbar-link" title = 'Menu (CTRL+ALT+n)' > < i class = "fas fa-bars fa-fw" > < / i > < / a >
2022-04-02 13:30:16 +00:00
< / span >
< ol class = "links" itemscope itemtype = "http://schema.org/BreadcrumbList" >
2023-05-18 20:52:30 +00:00
< li itemscope itemtype = "https://schema.org/ListItem" itemprop = "itemListElement" > < a itemprop = "item" href = "../../../pir/index.html" > < span itemprop = "name" > Cap' n Hugo Relearrrn Theme< / span > < / a > < meta itemprop = "position" content = "1" > > < / li >
< li itemscope itemtype = "https://schema.org/ListItem" itemprop = "itemListElement" > < a itemprop = "item" href = "../../../pir/cont/index.html" > < span itemprop = "name" > Rambl' n< / span > < / a > < meta itemprop = "position" content = "2" > > < / li >
2023-05-19 16:47:33 +00:00
< li itemscope itemtype = "https://schema.org/ListItem" itemprop = "itemListElement" > < span itemprop = "name" > planks orrrganizat' n< / span > < meta itemprop = "position" content = "3" > < / li >
2022-04-02 13:30:16 +00:00
< / ol >
< / div >
< / div >
< / nav >
2022-07-05 22:16:52 +00:00
< main id = "body-inner" class = "highlightable default" tabindex = "-1" >
2022-04-02 13:30:16 +00:00
< div class = "flex-block-wrapper" >
2022-11-07 19:58:08 +00:00
< article class = "default" >
2023-05-19 18:46:07 +00:00
< header class = "headline" >
< / header >
2023-05-19 16:47:33 +00:00
< h1 id = "planks-orrrganizatn" > planks orrrganizat' n< / h1 >
2022-04-02 13:30:16 +00:00
2022-07-05 22:16:52 +00:00
2022-04-02 13:30:16 +00:00
< p > In < strong > Cap'n Hugo< / strong > , planks be th' core o' yer ship. Once it be configured, planks be definitely th' added value t' yer documentat'n ship.< / p >
< h2 id = "folders" > Folders< / h2 >
2022-12-23 11:24:54 +00:00
< p > Org'nize yer ship like < a href = "https://gohugo.io/content/organization/" target = "_blank" > any other Cap'n Hugo project< / a > . Typically, ye will have a < em > rrrambl'n< / em > folder wit' all yer planks.< / p >
2022-04-02 13:30:16 +00:00
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-plaintext" data-lang = "plaintext" > < span class = "line" > < span class = "cl" > rrrambl'n
< / span > < / span > < span class = "line" > < span class = "cl" > ├── level-one
< / span > < / span > < span class = "line" > < span class = "cl" > │ ├── level-two
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ ├── level-three
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ ├── level-four
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ │ ├── _index.md < -- /level-one/level-two/level-three/level-four
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ │ ├── page-4-a.md < -- /level-one/level-two/level-three/level-four/page-4-a
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ │ ├── page-4-b.md < -- /level-one/level-two/level-three/level-four/page-4-b
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ │ └── page-4-c.md < -- /level-one/level-two/level-three/level-four/page-4-c
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ ├── _index.md < -- /level-one/level-two/level-three
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ ├── page-3-a.md < -- /level-one/level-two/level-three/page-3-a
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ ├── page-3-b.md < -- /level-one/level-two/level-three/page-3-b
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ │ └── page-3-c.md < -- /level-one/level-two/level-three/page-3-c
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ ├── _index.md < -- /level-one/level-two
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ ├── page-2-a.md < -- /level-one/level-two/page-2-a
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ ├── page-2-b.md < -- /level-one/level-two/page-2-b
< / span > < / span > < span class = "line" > < span class = "cl" > │ │ └── page-2-c.md < -- /level-one/level-two/page-2-c
< / span > < / span > < span class = "line" > < span class = "cl" > │ ├── _index.md < -- /level-one
< / span > < / span > < span class = "line" > < span class = "cl" > │ ├── page-1-a.md < -- /level-one/page-1-a
< / span > < / span > < span class = "line" > < span class = "cl" > │ ├── page-1-b.md < -- /level-one/page-1-b
< / span > < / span > < span class = "line" > < span class = "cl" > │ └── page-1-c.md < -- /level-one/page-1-c
< / span > < / span > < span class = "line" > < span class = "cl" > ├── _index.md < -- /
< / span > < / span > < span class = "line" > < span class = "cl" > └── page-top.md < -- /page-top
2023-06-03 22:20:43 +00:00
< / span > < / span > < / code > < / pre > < / div >
< div class = "box notices cstyle note" >
2022-12-01 00:38:08 +00:00
< div class = "box-label" > < i class = "fa-fw fas fa-exclamation-circle" > < / i > Avast< / div >
< div class = "box-content" >
2023-06-04 22:25:27 +00:00
2022-04-02 13:30:16 +00:00
< p > < code > _index.md< / code > be required 'n each folder, it’ < / p >
2023-06-03 09:12:46 +00:00
< / div >
2022-04-02 13:30:16 +00:00
< / div >
< h2 id = "create-your-project" > Create yer project< / h2 >
2022-12-23 11:24:54 +00:00
< 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 t' train by follow'n < a href = "https://gohugo.io/overview/quickstart/" target = "_blank" > great documentat'n fer beginners< / a > .< / p >
2022-04-02 13:30:16 +00:00
< p > Cap'n Hugo provides a < code > new< / code > command t' create a new website.< / p >
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-shell" data-lang = "shell" > < span class = "line" > < span class = "cl" > hugo new ship < new_project>
2022-12-16 17:42:17 +00:00
< / span > < / span > < / code > < / pre > < / div > < p > Th' Relearrrn theme provides < a href = "../../../cont/archetypes/" > archetypes< / a > t' help ye create this kind o' planks.< / p >
2022-07-05 22:16:52 +00:00
< h2 id = "frontmatter-configuration" > Frontmatter Configurat'n< / h2 >
2022-12-23 11:24:54 +00:00
< p > Each Cap'n Hugo plank has t' define a < a href = "https://gohugo.io/content/front-matter/" target = "_blank" > frontmatter< / a > 'n < em > toml< / em > , < em > yaml< / em > or < em > json< / em > . This ship will use < em > toml< / em > 'n all cases.< / p >
2022-07-05 22:16:52 +00:00
< p > Th' Relearrrn theme uses th' follow'n parameters on top o' Cap'n Hugo ones:< / p >
2022-04-02 13:30:16 +00:00
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-toml" data-lang = "toml" > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # T'ble o' contents (toc) be enabled by default. Set this parameter t' true t' dis'ble it.< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Avast: Toc be always disabled fer chapter planks< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > disableToc< / span > < span class = "p" > =< / span > < span class = "kc" > false< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # If set, this will be used fer th' page' s menu entry (instead o' th' `title` attribute)< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > menuTitle< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # If set, this will explicitly override common rules fer th' expand state o' a page' s menu entry< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > alwaysopen< / span > < span class = "p" > =< / span > < span class = "kc" > true< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # If set, this will explicitly override common rules fer th' sort'n order o' a page' s submenu entries< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > ordersectionsby< / span > < span class = "p" > =< / span > < span class = "s2" > " title" < / span >
2022-07-03 15:22:50 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Th' title o' th' plank head'n will be prefixed by this HTML rrrambl'n< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > headingPre< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Th' title o' th' plank head'n will be postfixed by this HTML rrrambl'n< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > headingPost< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
2022-04-02 13:30:16 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Th' title o' th' plank 'n menu will be prefixed by this HTML rrrambl'n< / span >
2022-07-03 15:22:50 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > menuPre< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
2022-04-02 13:30:16 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Th' title o' th' plank 'n menu will be postfixed by this HTML rrrambl'n< / span >
2022-07-03 15:22:50 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > menuPost< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
2022-04-02 13:30:16 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Hide a menu entry by sett'n this t' true< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > hidden< / span > < span class = "p" > =< / span > < span class = "kc" > false< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Display name o' this plank modifier. If set, it will be displayed 'n th' footer.< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > LastModifierDisplayName< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "c" > # Email o' this plank modifier. If set wit' LastModifierDisplayName, it will be displayed 'n th' footer< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > LastModifierEmail< / span > < span class = "p" > =< / span > < span class = "s2" > " " < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < / code > < / pre > < / div > < h3 id = "add-icon-to-a-menu-entry" > Add ay'con t' a menu entry< / h3 >
2022-07-03 15:22:50 +00:00
< p > In th' plank frontmatter, add a < code > menuPre< / code > param t' insert any HTML code before th' menu label. Th' example below uses th' GitHub ay'con.< / p >
2022-04-02 13:30:16 +00:00
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-toml" data-lang = "toml" > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > title< / span > < span class = "p" > =< / span > < span class = "s2" > " GitHub repo" < / span >
2022-07-03 15:22:50 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > menuPre< / span > < span class = "p" > =< / span > < span class = "s2" > " < i class=' fab fa-github' > < /i> " < / span >
2022-04-02 13:30:16 +00:00
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
2022-11-05 23:35:48 +00:00
< / span > < / span > < / code > < / pre > < / div > < p >
2022-11-06 15:27:13 +00:00
2023-06-05 16:33:00 +00:00
< a href = "#image-4984c5e92023b82b4e11b68d77f26542" class = "lightbox-link" >
2023-02-14 19:29:35 +00:00
< img src = "../../../cont/pages/frontmatter-icon.png?classes=shadow&width=18.75rem" alt = "Title wit' icon" class = "shadow" style = "height: auto; width: 18.75rem;" loading = "lazy" >
2023-01-29 10:28:20 +00:00
< / a >
2023-06-05 16:33:00 +00:00
< a href = "javascript:history.back();" class = "lightbox" id = "image-4984c5e92023b82b4e11b68d77f26542" >
2023-02-14 19:29:35 +00:00
< img src = "../../../cont/pages/frontmatter-icon.png?classes=shadow&width=18.75rem" alt = "Title wit' icon" class = "lightbox-image" loading = "lazy" >
2022-11-06 15:27:13 +00:00
< / a > < / p >
2022-04-02 13:30:16 +00:00
< h3 id = "ordering-sibling-menupage-entries" > Order'n sibl'n menu/page entries< / h3 >
2022-12-23 11:24:54 +00:00
< p > Cap'n Hugo provides a < a href = "https://gohugo.io/content/ordering/" target = "_blank" > flex'ble way< / a > t' handle order fer yer planks.< / p >
2022-04-02 13:30:16 +00:00
< p > Th' simplest way be t' set < code > weight< / code > parameter t' a number.< / p >
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-toml" data-lang = "toml" > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > title< / span > < span class = "p" > =< / span > < span class = "s2" > " My page" < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > weight< / span > < span class = "p" > =< / span > < span class = "mi" > 5< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < / code > < / pre > < / div > < h3 id = "using-a-custom-title-for-menu-entries" > Us'n a custom title fer menu entries< / h3 >
< p > By default, th' Relearrrn theme will use a page’ s < code > title< / code > attribute fer th' menu item (or < code > linkTitle< / code > if defined).< / p >
< p > But a page’ s title has t' be descriptive on its own while th' menu be a hierarchy.
We’ ve added th' < code > menuTitle< / code > parameter fer that purpose:< / p >
< p > For example (for a plank named < code > content/install/linux.md< / code > ):< / p >
< div class = "highlight" > < pre tabindex = "0" class = "chroma" > < code class = "language-toml" data-lang = "toml" > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > title< / span > < span class = "p" > =< / span > < span class = "s2" > " Install on Linux" < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "nx" > menuTitle< / span > < span class = "p" > =< / span > < span class = "s2" > " Linux" < / span >
< / span > < / span > < span class = "line" > < span class = "cl" > < span class = "err" > +++< / span >
< / span > < / span > < / code > < / pre > < / div > < h3 id = "override-expand-state-rules-for-menu-entries" > Override expand state rules fer menu entries< / h3 >
< p > Ye can change how th' theme expands menu entries on th' side o' th' rrrambl'n wit' th' < code > alwaysopen< / code > sett'n on a per plank basis. If < code > alwaysopen=false< / code > fer any given entry, its children will not be shown 'n th' menu as long as it be not necessary fer th' sake o' navigat'n.< / p >
< p > Th' theme generates th' menu based on th' follow'n rules:< / p >
< ul >
< li > all parent entries o' th' active plank includ'n their sibl'ns be shown regardless o' any sett'ns< / li >
< li > immediate children entries o' th' active plank be shown regardless o' any sett'ns< / li >
< li > if not overridden, all other first level entries behave like they would have been given < code > alwaysopen=false< / code > < / li >
< li > if not overridden, all other entries o' levels besides th' first behave like they would have been given < code > alwaysopen=true< / code > < / li >
2022-10-31 14:06:51 +00:00
< li > all vis'ble entries show their immediate children entries if < code > alwaysopen=true< / code > ; this proceeds recursively< / li >
2022-04-02 13:30:16 +00:00
< li > all remain'n entries be not shown< / li >
< / ul >
2023-01-24 22:59:44 +00:00
< p > Ye can see this feature 'n act'n on th' example plank fer < a href = "../../../shortcodes/children/" > children shortcode< / a > an' its children planks.< / p >
2022-04-02 13:30:16 +00:00
< footer class = "footline" >
2023-05-26 06:40:21 +00:00
2022-04-02 13:30:16 +00:00
< / footer >
< / article >
2023-05-17 22:13:41 +00:00
2022-04-02 13:30:16 +00:00
< / div >
< / main >
< / div >
2023-06-05 16:33:00 +00:00
< script src = "../../../js/clipboard.min.js?1685982776" defer > < / script >
< script src = "../../../js/perfect-scrollbar.min.js?1685982776" defer > < / script >
< script src = "../../../js/theme.js?1685982776" defer > < / script >
2022-04-02 13:30:16 +00:00
< / body >
< / html >
