[{"data":1,"prerenderedAt":20},["ShallowReactive",2],{"clay-page:\u002F4.x\u002Fconfiguration\u002Ffront-matter":3},{"html":4,"toc":5,"description":16,"hero":17,"list":18,"socialImage":19},"\u003Ch1 id=\"front-matter\">Front Matter\u003C\u002Fh1>\n\u003Cp>Front matter is the block of settings at the top of a Markdown file, between two \u003Ccode>---\u003C\u002Fcode> lines. Pages use it for their title and position, folders in their \u003Ccode>index.md\u003C\u002Fcode> for their name, icon, position and layout.\u003C\u002Fp>\n\u003Cdiv class=\"code-block\">\u003Cpre class=\"shiki shiki-themes light-plus dark-plus\" style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4;--shiki-light-bg:#FFFFFF;--shiki-dark-bg:#1E1E1E\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">---\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">title\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">Setup\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">icon\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">fa-solid fa-wrench\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">description\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">How to install and configure the project in five steps.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">order\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#076240;--shiki-dark:#B5CEA8\">2\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">---\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-light-font-weight:bold;--shiki-dark:#569CD6;--shiki-dark-font-weight:bold\"># Setting up the project\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy code\" aria-label=\"Copy code\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Ch2 id=\"fields\">\u003Ca class=\"heading-anchor\" href=\"#fields\" aria-label=\"Link to this section\" data-route=\"#fields\">#\u003C\u002Fa>Fields\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Default\u003C\u002Fth>\n\u003Cth>For\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>text\u003C\u002Ftd>\n\u003Ctd>first \u003Ccode># heading\u003C\u002Fcode>, then the file or folder name\u003C\u002Ftd>\n\u003Ctd>all\u003C\u002Ftd>\n\u003Ctd>Title in the sidebar, breadcrumbs, search and browser tab\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>icon\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>text\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>fa-solid fa-file\u003C\u002Fcode>, folders \u003Ccode>fa-solid fa-folder\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>all\u003C\u002Ftd>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Ffeatures\u002Fthemes-and-icons\" data-route=\"\u002F4.x\u002Ffeatures\u002Fthemes-and-icons\">Font Awesome\u003C\u002Fa> icon\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>description\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>text\u003C\u002Ftd>\n\u003Ctd>first paragraph\u003C\u002Ftd>\n\u003Ctd>all\u003C\u002Ftd>\n\u003Ctd>Summary for search engines and link previews, see \u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Ffeatures\u002Fseo\" data-route=\"\u002F4.x\u002Ffeatures\u002Fseo\">SEO\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>order\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>number\u003C\u002Ftd>\n\u003Ctd>none\u003C\u002Ftd>\n\u003Ctd>all\u003C\u002Ftd>\n\u003Ctd>Position among the entries next to it, see \u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Forganizing\u002Fnavigation\" data-route=\"\u002F4.x\u002Forganizing\u002Fnavigation\">navigation\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>list\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>true\u003C\u002Fcode> \u002F \u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>index.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>List of links to the folder’s pages below the text\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>hero\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>true\u003C\u002Fcode> \u002F \u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>index.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>title\u003C\u002Fcode>, \u003Ccode>icon\u003C\u002Fcode> and \u003Ccode>description\u003C\u002Fcode> as a large centered header\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>redirects\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>list\u003C\u002Ftd>\n\u003Ctd>none\u003C\u002Ftd>\n\u003Ctd>all\u003C\u002Ftd>\n\u003Ctd>Old addresses that lead to the page, see \u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Forganizing\u002Fredirects\" data-route=\"\u002F4.x\u002Forganizing\u002Fredirects\">redirects\u003C\u002Fa>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"rules\">\u003Ca class=\"heading-anchor\" href=\"#rules\" aria-label=\"Link to this section\" data-route=\"#rules\">#\u003C\u002Fa>Rules\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Front matter only counts when \u003Ccode>---\u003C\u002Fcode> is the very first line of the file; a horizontal rule further down is never mistaken for it.\u003C\u002Fli>\n\u003Cli>Values may be quoted: \u003Ccode>title: \"Setup: the long way\"\u003C\u002Fcode>. Quote values that contain \u003Ccode>: \u003C\u002Fcode> or start with a special character.\u003C\u002Fli>\n\u003Cli>Fields Clay does not know are left alone, so other tools can keep their fields, like \u003Ccode>tags\u003C\u002Fcode> or \u003Ccode>author\u003C\u002Fcode>, in the same block.\u003C\u002Fli>\n\u003Cli>In a translation, \u003Ccode>title\u003C\u002Fcode>, \u003Ccode>icon\u003C\u002Fcode> and \u003Ccode>description\u003C\u002Fcode> are the translation’s own; \u003Ccode>order\u003C\u002Fcode> always comes from the original.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"where-each-files-front-matter-applies\">\u003Ca class=\"heading-anchor\" href=\"#where-each-files-front-matter-applies\" aria-label=\"Link to this section\" data-route=\"#where-each-files-front-matter-applies\">#\u003C\u002Fa>Where each file’s front matter applies\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>File\u003C\u002Fth>\n\u003Cth>Describes\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fsetup.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The page \u003Ccode>\u002Fsetup\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fguides\u002Findex.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The folder \u003Ccode>guides\u003C\u002Fcode>: its name, icon and order, and its page \u003Ccode>\u002Fguides\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Findex.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The start page \u003Ccode>\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fsetup.de.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The German page \u003Ccode>\u002Fde\u002Fsetup\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\n\u003Cp class=\"markdown-alert-title text-primary\">\u003Ci class=\"fa-solid fa-lightbulb mr-2\">\u003C\u002Fi>Tip\u003C\u002Fp>\n\u003Cp>\u003Ccode>clay edit\u003C\u002Fcode> edits all of these fields for every page and folder, in every version and language. See \u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Forganizing\u002Fclay-edit\" data-route=\"\u002F4.x\u002Forganizing\u002Fclay-edit\">clay edit\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\n",[6,10,13],{"id":7,"text":8,"level":9},"fields","Fields",2,{"id":11,"text":12,"level":9},"rules","Rules",{"id":14,"text":15,"level":9},"where-each-files-front-matter-applies","Where each file’s front matter applies","Reference of every front matter field of pages, folders (index.md) and the start page, with defaults and examples.",null,false,"\u002F_clay\u002Fsocial\u002F4.x\u002Fconfiguration\u002Ffront-matter.png",1792666369543]