2021-10-16 23:18:04 +00:00
<!doctype html> < html lang = en class = "js csstransforms3d" >
< head >
< meta charset = utf-8 >
< meta name = viewport content = "width=device-width,initial-scale=1" >
2022-02-06 01:00:15 +00:00
< meta name = generator content = "Hugo 0.92.1" >
2022-02-06 12:52:29 +00:00
< meta name = generator content = "Relearn 2.9.4" >
2021-10-16 23:18:04 +00:00
< meta name = description content = "Documentation for Hugo Relearn Theme" >
< meta name = author content = "Sören Weber" >
< title > Pages organization :: Documentation for Hugo Relearn Theme< / title >
2022-02-06 12:52:29 +00:00
< link rel = alternate type = application/rss+xml href = /hugo-theme-relearn/cont/pages/index.xml title = "Documentation for Hugo Relearn Theme" >
2022-02-06 13:10:37 +00:00
< link rel = icon href = /hugo-theme-relearn/images/logo.svg?1644153034 type = image/svg+xml >
< link href = /hugo-theme-relearn/css/nucleus.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/fontawesome-all.min.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/featherlight.min.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/perfect-scrollbar.min.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/auto-complete.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/theme.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/theme-relearn.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/variant.css?1644153034 rel = stylesheet >
< link href = /hugo-theme-relearn/css/print.css?1644153034 rel = stylesheet media = print >
2021-10-16 23:18:04 +00:00
< style > : root # header + # content > # left > # rlblock_left { display : none !important } < / style >
2022-02-06 13:10:37 +00:00
< script src = /hugo-theme-relearn/js/jquery.min.js?1644153034 > < / script >
2021-10-16 23:18:04 +00:00
< / head >
2022-02-06 01:14:27 +00:00
< body data-url = /hugo-theme-relearn/cont/pages/ >
< script > var index _url = "/hugo-theme-relearn/index.json" , root _url = "/" , baseUri = root _url . replace ( /\/$/ , '' ) < / script >
2021-10-16 23:18:04 +00:00
< nav id = sidebar class = showVisitedLinks >
< div id = header-wrapper >
< div id = header >
2022-02-06 01:14:27 +00:00
< a id = logo href = /hugo-theme-relearn/ style = "color:#3d414d;font-family:work sans,helvetica,tahoma,geneva,arial,sans-serif;font-size:30px;font-weight:300;margin-top:-2px;text-transform:uppercase" > < 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- . 57
2021-10-16 23:18:04 +00:00
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 >
2022-02-06 13:10:37 +00:00
< script src = /hugo-theme-relearn/js/lunr.min.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/auto-complete.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/search.js?1644153034 > < / script >
2021-10-16 23:18:04 +00:00
< / div >
< div class = highlightable >
< ul class = topics >
2022-02-06 01:14:27 +00:00
< li data-nav-id = /hugo-theme-relearn/basics/ title = Basics class = dd-item > < a href = /hugo-theme-relearn/basics/ > < b > 1.< / b > Basics< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/basics/migration/ title = "What's new" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/migration/ > What's new< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/basics/requirements/ title = Requirements class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/requirements/ > Requirements< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/basics/installation/ title = Installation class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/installation/ > Installation< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/basics/configuration/ title = Configuration class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/configuration/ > Configuration< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/basics/customization/ title = Customization class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/customization/ > Customization< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/basics/history/ title = History class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/basics/history/ > History< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/ title = Content class = "dd-item parent" > < a href = /hugo-theme-relearn/cont/ > < b > 2.< / b > Content< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/cont/pages/ title = "Pages organization" class = "dd-item active parent alwaysopen" > < a href = /hugo-theme-relearn/cont/pages/ > Pages organization< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/archetypes/ title = Archetypes class = dd-item > < a href = /hugo-theme-relearn/cont/archetypes/ > Archetypes< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/markdown/ title = "Markdown syntax" class = dd-item > < a href = /hugo-theme-relearn/cont/markdown/ > Markdown syntax< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/syntaxhighlight/ title = "Code highlighting" class = dd-item > < a href = /hugo-theme-relearn/cont/syntaxhighlight/ > Code highlighting< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/menushortcuts/ title = "Menu extra shortcuts" class = dd-item > < a href = /hugo-theme-relearn/cont/menushortcuts/ > Menu extra shortcuts< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/icons/ title = "Icons and logos" class = dd-item > < a href = /hugo-theme-relearn/cont/icons/ > Icons and logos< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/i18n/ title = "Multilingual and i18n" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/cont/i18n/ > Multilingual and i18n< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/cont/tags/ title = Tags class = dd-item > < a href = /hugo-theme-relearn/cont/tags/ > Tags< i class = "fas fa-check read-icon" > < / i > < / a > < / li > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/ title = Shortcodes class = dd-item > < a href = /hugo-theme-relearn/shortcodes/ > < b > 3.< / b > Shortcodes< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/attachments/ title = Attachments class = dd-item > < a href = /hugo-theme-relearn/shortcodes/attachments/ > Attachments< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/button/ title = Button class = dd-item > < a href = /hugo-theme-relearn/shortcodes/button/ > Button< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/ title = Children class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/ > Children< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/test/ title = "page X" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/test/ > page X< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/ title = "page 1" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/children-1/ > page 1< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/ title = "page 1-1" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/ > page 1-1< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/ title = "page 1-1-2" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/ > page 1-1-2< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-1/ title = "page 1-1-2-1" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-1/ > page 1-1-2-1< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-2/ title = "page 1-1-2-2" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-2/children-1-1-2-2/ > page 1-1-2-2< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-3/ title = "page 1-1-3" class = "dd-item alwaysopen" > < a href = /hugo-theme-relearn/shortcodes/children/children-1/children-1-1/children-1-1-3/ > page 1-1-3< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li > < / ul > < / li > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-2/ title = "page 2" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/children-2/ > page 2< i class = "fas fa-check read-icon" > < / i > < / a > < ul > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-3/ title = "page 3" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/children-3/ > page 3< i class = "fas fa-check read-icon" > < / i > < / a > < ul >
< li data-nav-id = /hugo-theme-relearn/shortcodes/children/children-3/test3/ title = "page 3-1" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/children/children-3/test3/ > page 3-1< i class = "fas fa-check read-icon" > < / i > < / a > < / li > < / ul > < / li > < / ul > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/expand/ title = Expand class = dd-item > < a href = /hugo-theme-relearn/shortcodes/expand/ > Expand< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/include/ title = Include class = dd-item > < a href = /hugo-theme-relearn/shortcodes/include/ > Include< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/mermaid/ title = Mermaid class = dd-item > < a href = /hugo-theme-relearn/shortcodes/mermaid/ > Mermaid< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/notice/ title = Notice class = dd-item > < a href = /hugo-theme-relearn/shortcodes/notice/ > Notice< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/siteparam/ title = "Site param" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/siteparam/ > Site param< i class = "fas fa-check read-icon" > < / i > < / a > < / li >
< li data-nav-id = /hugo-theme-relearn/shortcodes/tabs/ title = "Tabbed views" class = dd-item > < a href = /hugo-theme-relearn/shortcodes/tabs/ > Tabbed views< i class = "fas fa-check read-icon" > < / i > < / a > < / li > < / ul > < / li >
2021-10-16 23:18:04 +00:00
< / ul >
< div id = shortcuts >
< div class = nav-title > More< / div >
< ul >
< li > < a class = padding href = https://github.com/McShelby/hugo-theme-relearn > < i class = "fab fa-fw fa-github" > < / i > GitHub repo< / a > < / li >
2022-02-06 01:14:27 +00:00
< li > < a class = padding href = /hugo-theme-relearn/showcase/ > < i class = "fas fa-fw fa-camera" > < / i > Showcases< / a > < / li >
2021-10-16 23:18:04 +00:00
< li > < a class = padding href = https://gohugo.io/ > < i class = "fas fa-fw fa-bookmark" > < / i > Hugo Documentation< / a > < / li >
2022-02-06 01:14:27 +00:00
< li > < a class = padding href = /hugo-theme-relearn/credits/ > < i class = "fas fa-fw fa-bullhorn" > < / i > Credits< / a > < / li >
< li > < a class = padding href = /hugo-theme-relearn/tags/ > < i class = "fas fa-fw fa-tags" > < / i > Tags< / a > < / li >
2021-10-16 23:18:04 +00:00
< / ul >
< / div >
< div id = prefooter >
< hr >
< ul >
< li >
< a class = padding >
< i class = "fas fa-language fa-fw" > < / i >
< div class = select-style >
2022-02-06 01:00:15 +00:00
< select id = select-language onchange = "location=baseUri+this.value" > < option id = en value = /hugo-theme-relearn/cont/pages/ selected > English< / option > < option id = pir value = /hugo-theme-relearn/pir/cont/pages/ > Arrr! Pirrrates< / 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 >
2021-10-16 23:18:04 +00:00
< / 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/cont/pages/_index.en.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" >
2022-02-06 01:14:27 +00:00
< li itemscope itemtype = https://schema.org/ListItem itemprop = itemListElement > < meta itemprop = position content = "3" > < a itemprop = item href = /hugo-theme-relearn/ > < span itemprop = name > Relearn Theme for Hugo< / span > < / a > > < / li >
< li itemscope itemtype = https://schema.org/ListItem itemprop = itemListElement > < meta itemprop = position content = "2" > < a itemprop = item href = /hugo-theme-relearn/cont/ > < span itemprop = name > Content< / span > < / a > > < / li >
< li itemscope itemtype = https://schema.org/ListItem itemprop = itemListElement > < meta itemprop = position content = "1" > < a itemprop = item href = /hugo-theme-relearn/cont/pages/ aria-disabled = true > < span itemprop = name > Pages organization< / span > < / a > < / li >
2021-10-16 23:18:04 +00:00
< / ol >
< / div >
< div class = progress >
< div class = wrapper >
< nav id = TableOfContents >
< ul >
< li > < a href = #folders > Folders< / a > < / li >
< li > < a href = #types > Types< / a > < / li >
< li > < a href = #create-your-project > Create your project< / a > < / li >
< li > < a href = #front-matter-configuration > Front Matter configuration< / a >
< ul >
< li > < a href = #add-icon-to-a-menu-entry > Add icon to a menu entry< / a > < / li >
< li > < a href = #ordering-sibling-menupage-entries > Ordering sibling menu/page entries< / a > < / li >
< li > < a href = #using-a-custom-title-for-menu-entries > Using a custom title for menu entries< / a > < / li >
< li > < a href = #override-expand-state-rules-for-menu-entries > Override expand state rules for menu entries< / a > < / li >
< / ul >
< / li >
< li > < a href = #your-page > Your Page< / a > < / li >
< / ul >
< / nav >
< / div >
< / div >
< / div >
< div id = head-tags >
< / div >
< main id = body-inner >
< h1 > Pages organization< / h1 >
< p > In < strong > Hugo< / strong > , pages are the core of your site. Once it is configured, pages are definitely the added value to your documentation site.< / p >
< h2 id = folders > Folders< / h2 >
< p > Organize your site like < a href = https://gohugo.io/content/organization/ > any other Hugo project< / a > . Typically, you will have a < em > content< / em > folder with all your pages.< / 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-plaintext data-lang = plaintext > content
├── level-one
│ ├── level-two
│ │ ├── level-three
│ │ │ ├── level-four
│ │ │ │ ├── _index.md < -- /level-one/level-two/level-three/level-four
│ │ │ │ ├── page-4-a.md < -- /level-one/level-two/level-three/level-four/page-4-a
│ │ │ │ ├── page-4-b.md < -- /level-one/level-two/level-three/level-four/page-4-b
│ │ │ │ └── page-4-c.md < -- /level-one/level-two/level-three/level-four/page-4-c
│ │ │ ├── _index.md < -- /level-one/level-two/level-three
│ │ │ ├── page-3-a.md < -- /level-one/level-two/level-three/page-3-a
│ │ │ ├── page-3-b.md < -- /level-one/level-two/level-three/page-3-b
│ │ │ └── page-3-c.md < -- /level-one/level-two/level-three/page-3-c
│ │ ├── _index.md < -- /level-one/level-two
│ │ ├── page-2-a.md < -- /level-one/level-two/page-2-a
│ │ ├── page-2-b.md < -- /level-one/level-two/page-2-b
│ │ └── page-2-c.md < -- /level-one/level-two/page-2-c
│ ├── _index.md < -- /level-one
│ ├── page-1-a.md < -- /level-one/page-1-a
│ ├── page-1-b.md < -- /level-one/page-1-b
│ └── page-1-c.md < -- /level-one/page-1-c
├── _index.md < -- /
└── page-top.md < -- /page-top
< / code > < / pre > < / div >
< div class = "notices note" >
< div class = label > Note< / div > < p > < code > _index.md< / code > is required in each folder, it’ < / p >
< / div >
< h2 id = types > Types< / h2 >
< p > The Relearn theme defines two types of pages. < em > Default< / em > and < em > Chapter< / em > . Both can be used at any level of the documentation, the only difference being layout display.< / p >
< p > A < strong > Chapter< / strong > displays a page meant to be used as introduction for a set of child pages. Commonly, it contains a simple title and a catch line to define content that can be found under it.
You can define any HTML as prefix for the menu. In the example below, it’ s just a number but that could be an < a href = https://fortawesome.github.io/Font-Awesome/ > icon< / a > .< / p >
2022-02-06 01:00:15 +00:00
< p > < img src = "images/pages-chapter.png?width=50pc" alt = "Chapter page" > < / p >
2021-10-16 23:18:04 +00:00
< 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 > +++
chapter = true
pre = " < < span style = color:#ff6ac1 > b< / span > > 1. < /< span style = color:#ff6ac1 > b< / span > > "
title = " Basics"
weight = 5
+++
< 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 Hugo theme is all about and the core-concepts behind it.
< / code > < / pre > < / div > < p > To tell the Relearn theme to consider a page as a chapter, set < code > chapter=true< / code > in the Front Matter of the page.< / p >
< p > A < strong > Default< / strong > page is any other content page.< / p >
2022-02-06 01:00:15 +00:00
< p > < img src = "images/pages-default.png?width=50pc" alt = "Default page" > < / p >
2021-10-16 23:18:04 +00:00
< 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:#ff5c57 > +++< / span >
title = < span style = color:#5af78e > " Installation" < / span >
weight = < span style = color:#ff9f43 > 15< / span >
< span style = color:#ff5c57 > +++< / span >
< / code > < / pre > < / div > < p > The following steps are here to help you initialize your new website. If you don’ t know Hugo at all, we strongly suggest you to train by following this < a href = https://gohugo.io/overview/quickstart/ > great documentation for beginners< / a > .< / p >
< h2 id = create-your-project > Create your project< / h2 >
< p > Hugo provides a < code > new< / code > command to create a new website.< / 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 site < new_project>
2022-02-06 01:14:27 +00:00
< / code > < / pre > < / div > < p > The Relearn theme provides < a href = /hugo-theme-relearn/cont/archetypes/ > archetypes< / a > to help you create this kind of pages.< / p >
2021-10-16 23:18:04 +00:00
< h2 id = front-matter-configuration > Front Matter configuration< / h2 >
< p > Each Hugo page has to define a < a href = https://gohugo.io/content/front-matter/ > Front Matter< / a > in < em > toml< / em > , < em > yaml< / em > or < em > json< / em > . This site will use < em > toml< / em > in all cases.< / p >
< p > The Relearn theme uses the following parameters on top of Hugo ones :< / 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:#ff5c57 > +++< / span >
< span style = color:#78787e > # Table of contents (toc) is enabled by default. Set this parameter to true to disable it.< / span >
< span style = color:#78787e > # Note: Toc is always disabled for chapter pages< / span >
2021-11-03 20:43:23 +00:00
disableToc = < span style = color:#ff6ac1 > false< / span >
2021-10-16 23:18:04 +00:00
< span style = color:#78787e > # If set, this will be used for the page' s menu entry (instead of the `title` attribute)< / span >
menuTitle = < span style = color:#5af78e > " " < / span >
< span style = color:#78787e > # If set, this will explicitly override common rules for the expand state of a page' s menu entry< / span >
alwaysopen = < span style = color:#ff6ac1 > true< / span >
< span style = color:#78787e > # If set, this will explicitly override common rules for the sorting order of a page' s submenu entries< / span >
ordersectionsby = < span style = color:#5af78e > " title" < / span >
< span style = color:#78787e > # The title of the page in menu will be prefixed by this HTML content< / span >
pre = < span style = color:#5af78e > " " < / span >
< span style = color:#78787e > # The title of the page in menu will be postfixed by this HTML content< / span >
post = < span style = color:#5af78e > " " < / span >
< span style = color:#78787e > # Set the page as a chapter, changing the way it' s displayed< / span >
chapter = < span style = color:#ff6ac1 > false< / span >
< span style = color:#78787e > # Hide a menu entry by setting this to true< / span >
hidden = < span style = color:#ff6ac1 > false< / span >
< span style = color:#78787e > # Display name of this page modifier. If set, it will be displayed in the footer.< / span >
LastModifierDisplayName = < span style = color:#5af78e > " " < / span >
< span style = color:#78787e > # Email of this page modifier. If set with LastModifierDisplayName, it will be displayed in the footer< / span >
LastModifierEmail = < span style = color:#5af78e > " " < / span >
< span style = color:#ff5c57 > +++< / span >
< / code > < / pre > < / div > < h3 id = add-icon-to-a-menu-entry > Add icon to a menu entry< / h3 >
< p > In the page frontmatter, add a < code > pre< / code > param to insert any HTML code before the menu label. The example below uses the GitHub icon.< / 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:#ff5c57 > +++< / span >
title = < span style = color:#5af78e > " GitHub repo" < / span >
pre = < span style = color:#5af78e > " < i class=' fab fa-github' > < /i> " < / span >
< span style = color:#ff5c57 > +++< / span >
2022-02-06 01:00:15 +00:00
< / code > < / pre > < / div > < p > < img src = images/frontmatter-icon.png alt = "Title with icon" > < / p >
2021-10-16 23:18:04 +00:00
< h3 id = ordering-sibling-menupage-entries > Ordering sibling menu/page entries< / h3 >
< p > Hugo provides a < a href = https://gohugo.io/content/ordering/ > flexible way< / a > to handle order for your pages.< / p >
< p > The simplest way is to set < code > weight< / code > parameter to a number.< / 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:#ff5c57 > +++< / span >
title = < span style = color:#5af78e > " My page" < / span >
weight = < span style = color:#ff9f43 > 5< / span >
< span style = color:#ff5c57 > +++< / span >
< / code > < / pre > < / div > < h3 id = using-a-custom-title-for-menu-entries > Using a custom title for menu entries< / h3 >
< p > By default, the Relearn theme will use a page’ s < code > title< / code > attribute for the menu item (or < code > linkTitle< / code > if defined).< / p >
< p > But a page’ s title has to be descriptive on its own while the menu is a hierarchy.
We’ ve added the < code > menuTitle< / code > parameter for that purpose:< / p >
< p > For example (for a page named < code > content/install/linux.md< / code > ):< / 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:#ff5c57 > +++< / span >
title = < span style = color:#5af78e > " Install on Linux" < / span >
menuTitle = < span style = color:#5af78e > " Linux" < / span >
< span style = color:#ff5c57 > +++< / span >
< / code > < / pre > < / div > < h3 id = override-expand-state-rules-for-menu-entries > Override expand state rules for menu entries< / h3 >
< p > You can change how the theme expands menu entries on the side of the content with the < code > alwaysopen< / code > setting on a per page basis. If < code > alwaysopen=false< / code > for any given entry, its children will not be shown in the menu as long as it is not necessary for the sake of navigation.< / p >
< p > The theme generates the menu based on the following rules:< / p >
< ul >
< li > all parent entries of the active page including their siblings are shown regardless of any settings< / li >
< li > immediate children entries of the active page are shown regardless of any settings< / 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 of levels besides the first behave like they would have been given < code > alwaysopen=true< / code > < / li >
< li > all visible entries show their immediate children entries if < code > alwaysopen=true< / code > ; this proceeds recursivley< / li >
< li > all remaining entries are not shown< / li >
< / ul >
2022-02-06 01:14:27 +00:00
< p > You can see this feature in action on the example page for < a href = /hugo-theme-relearn/shortcodes/children/ > children shortcode< / a > and its children pages.< / p >
2021-10-16 23:18:04 +00:00
< h2 id = your-page > Your Page< / h2 >
< p > To configure your page, you basically have three choices:< / p >
< ol >
< li > Create an < code > _index.md< / code > document in < code > content< / code > folder and fill the file with < em > Markdown content< / em > < / li >
< li > Create an < code > index.html< / code > file in the < code > static< / code > folder and fill the file with < em > HTML content< / em > < / li >
< li > Configure your server to automatically redirect home page to one your documentation page< / li >
< / ol >
< footer class = footline >
< / footer >
< / main >
< / div >
< div id = navigation >
2022-02-06 01:14:27 +00:00
< a class = "nav nav-prev" href = /hugo-theme-relearn/cont/ title = Content > < i class = "fa fa-chevron-left" > < / i > < / a >
< a class = "nav nav-next" href = /hugo-theme-relearn/cont/archetypes/ title = Archetypes > < i class = "fa fa-chevron-right" > < / i > < / a >
2021-10-16 23:18:04 +00:00
< / 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 >
2022-02-06 13:10:37 +00:00
< script src = /hugo-theme-relearn/js/clipboard.min.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/perfect-scrollbar.min.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/perfect-scrollbar.jquery.min.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/jquery.svg.pan.zoom.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/featherlight.min.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/modernizr.custom-3.6.0.js?1644153034 > < / script >
< script src = /hugo-theme-relearn/js/mermaid.min.js?1644153034 > < / script >
2021-11-08 15:53:51 +00:00
< script > typeof mermaid != 'undefined' && typeof mermaid . mermaidAPI != 'undefined' && mermaid . mermaidAPI . initialize ( Object . assign ( { securityLevel : "antiscript" } , JSON . parse ( '{ "startOnLoad": true }' ) , { startOnLoad : ! 1 } ) ) < / script >
2022-02-06 13:10:37 +00:00
< script src = /hugo-theme-relearn/js/relearn.js?1644153034 > < / script >
2021-10-16 23:18:04 +00:00
< / body >
< / html >
