[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"clay-page:\u002F3.x\u002Fde\u002Fguides\u002Fupgrading-to-clay-3":3},{"html":4,"toc":5,"description":25,"hero":26,"list":27,"socialImage":28},"\u003Ch1 id=\"umstieg-auf-clay-3\">Umstieg auf Clay 3\u003C\u002Fh1>\n\u003Cp>Clay 3 verlagert drei Dinge in die Dokumentation selbst: Ordnernamen, die Startseite und ältere Versionen. Alles andere, deine Seiten, Links, Übersetzungen und der Rest der \u003Ccode>clay.yaml\u003C\u002Fcode>, bleibt, wie es ist. Bis du sie verschoben hast, meldet \u003Ccode>clay build\u003C\u002Fcode> mit einer Warnung, was noch übrig ist, und \u003Ccode>--strict\u003C\u002Fcode> scheitert.\u003C\u002Fp>\n\u003Ch2 id=\"1-clay-aktualisieren\">\u003Ca class=\"heading-anchor\" href=\"#1-clay-aktualisieren\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#1-clay-aktualisieren\">#\u003C\u002Fa>1. Clay aktualisieren\u003C\u002Fh2>\n\u003Cdiv class=\"code-block is-terminal has-bar\">\u003Cdiv class=\"code-terminal\" aria-hidden=\"true\">\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003C\u002Fdiv>\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 command\">\u003Cspan style=\"--shiki-light:#695221;--shiki-dark:#DCDCAA\">npm\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> install\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\"> --save-dev\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> clay-doc@3\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Ch2 id=\"2-ordnernamen-dir-metayaml--indexmd\">\u003Ca class=\"heading-anchor\" href=\"#2-ordnernamen-dir-metayaml--indexmd\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#2-ordnernamen-dir-metayaml--indexmd\">#\u003C\u002Fa>2. Ordnernamen: dir-meta.yaml → index.md\u003C\u002Fh2>\n\u003Cp>Jeder Eintrag der \u003Ccode>dir-meta.yaml\u003C\u002Fcode> wird zum Front Matter einer \u003Ccode>index.md\u003C\u002Fcode> in diesem Ordner. Aus \u003Ccode>name\u003C\u002Fcode> wird \u003Ccode>title\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cp>\u003Ccode>dir-meta.yaml\u003C\u002Fcode> (Clay 2):\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>\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">path\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"guides\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  name\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"Guides\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  icon\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"fa-solid fa-book-open\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  order\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#076240;--shiki-dark:#B5CEA8\">3\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>\u003Ccode>docs\u002Fguides\u002Findex.md\u003C\u002Fcode> (Clay 3):\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\">Guides\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-book-open\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\">3\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">---\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>Namen pro Sprache (\u003Ccode>name: {en: Guides, de: Anleitungen}\u003C\u002Fcode>) kommen in Übersetzungen der \u003Ccode>index.md\u003C\u002Fcode>: eine \u003Ccode>index.de.md\u003C\u002Fcode> mit \u003Ccode>title: Anleitungen\u003C\u002Fcode>. Danach löschst du die \u003Ccode>dir-meta.yaml\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Eine \u003Ccode>index.md\u003C\u002Fcode> nur mit Front Matter benennt bloß ihren Ordner. Schreib Text darunter, und sie wird zur Seite des Ordners; siehe \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Forganizing\u002Findex-pages\" data-route=\"\u002F3.x\u002Fde\u002Forganizing\u002Findex-pages\">Indexseiten\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"3-die-startseite-index-in-der-clayyaml--docsindexmd\">\u003Ca class=\"heading-anchor\" href=\"#3-die-startseite-index-in-der-clayyaml--docsindexmd\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#3-die-startseite-index-in-der-clayyaml--docsindexmd\">#\u003C\u002Fa>3. Die Startseite: index in der clay.yaml → docs\u002Findex.md\u003C\u002Fh2>\n\u003Cp>Der Abschnitt \u003Ccode>index\u003C\u002Fcode> der \u003Ccode>clay.yaml\u003C\u002Fcode> wird zu \u003Ccode>docs\u002Findex.md\u003C\u002Fcode>. Für ein ähnliches Aussehen, eine große Kopfzeile und darunter die Seiten der obersten Ebene, setzt du \u003Ccode>hero\u003C\u002Fcode> und \u003Ccode>list\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cp>\u003Ccode>clay.yaml\u003C\u002Fcode> (Clay 2):\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:#800000;--shiki-dark:#569CD6\">index\u003C\u002Fspan>\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:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"Willkommen bei Mein Projekt\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  description\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"Alles, was du wissen musst.\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  icon\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"fa-solid fa-rocket\"\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>\u003Ccode>docs\u002Findex.md\u003C\u002Fcode> (Clay 3):\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\">Willkommen bei Mein Projekt\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\">Alles, was du wissen musst.\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-rocket\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">hero\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\">true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">list\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000FF;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\">true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">---\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>Werte pro Sprache kommen in \u003Ccode>docs\u002Findex.de.md\u003C\u002Fcode> und so weiter. Danach entfernst du \u003Ccode>index\u003C\u002Fcode> aus der \u003Ccode>clay.yaml\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2 id=\"4-ältere-versionen-versions--docs-archive\">\u003Ca class=\"heading-anchor\" href=\"#4-ältere-versionen-versions--docs-archive\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#4-ältere-versionen-versions--docs-archive\">#\u003C\u002Fa>4. Ältere Versionen: versions\u002F → docs-archive\u002F\u003C\u002Fh2>\n\u003Cp>Ältere Versionen rücken eine Ebene nach oben: Aus \u003Ccode>versions\u002F1.x\u002Fdocs\u002F\u003C\u002Fcode> wird \u003Ccode>docs-archive\u002F1.x\u002F\u003C\u002Fcode>. Ihre \u003Ccode>dir-meta.yaml\u003C\u002Fcode> wird wie in Schritt 2 zu \u003Ccode>index.md\u003C\u002Fcode>-Dateien.\u003C\u002Fp>\n\u003Cdiv class=\"code-block is-terminal has-bar\">\u003Cdiv class=\"code-terminal\" aria-hidden=\"true\">\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003C\u002Fdiv>\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 command\">\u003Cspan style=\"--shiki-light:#695221;--shiki-dark:#DCDCAA\">mkdir\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> docs-archive\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line command\">\u003Cspan style=\"--shiki-light:#695221;--shiki-dark:#DCDCAA\">git\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> mv\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> versions\u002F1.x\u002Fdocs\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> docs-archive\u002F1.x\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Ch2 id=\"5-prüfen\">\u003Ca class=\"heading-anchor\" href=\"#5-prüfen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#5-prüfen\">#\u003C\u002Fa>5. Prüfen\u003C\u002Fh2>\n\u003Cdiv class=\"code-block is-terminal has-bar\">\u003Cdiv class=\"code-terminal\" aria-hidden=\"true\">\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003C\u002Fdiv>\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 command\">\u003Cspan style=\"--shiki-light:#695221;--shiki-dark:#DCDCAA\">npx\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> clay\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> build\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\"> --strict\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Code kopieren\" aria-label=\"Code kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>Läuft der Build durch, ist der Umstieg geschafft. Links auf \u003Ccode>index.md\u003C\u002Fcode>-Dateien und auf Ordner führen zu den Seiten der Ordner; bestehende Links funktionieren also weiter.\u003C\u002Fp>\n\u003Ch2 id=\"was-sonst-neu-ist\">\u003Ca class=\"heading-anchor\" href=\"#was-sonst-neu-ist\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#was-sonst-neu-ist\">#\u003C\u002Fa>Was sonst neu ist\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>In der Seitenleiste öffnet der Titel eines Ordners seine Seite; der Pfeil blendet seine Seiten ein und aus.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Forganizing\u002Fclay-edit\" data-route=\"\u002F3.x\u002Fde\u002Forganizing\u002Fclay-edit\">clay edit\u003C\u002Fa> legt Seiten und Ordner an, benennt sie um, verschiebt und löscht sie, bearbeitet das ganze Front Matter und arbeitet in jeder Version und Sprache.\u003C\u002Fli>\n\u003Cli>Abschnittsüberschriften zeigen einen \u003Ccode>#\u003C\u002Fcode>-Link zum Kopieren.\u003C\u002Fli>\n\u003C\u002Ful>\n",[6,10,13,16,19,22],{"id":7,"text":8,"level":9},"1-clay-aktualisieren","1. Clay aktualisieren",2,{"id":11,"text":12,"level":9},"2-ordnernamen-dir-metayaml--indexmd","2. Ordnernamen: dir-meta.yaml → index.md",{"id":14,"text":15,"level":9},"3-die-startseite-index-in-der-clayyaml--docsindexmd","3. Die Startseite: index in der clay.yaml → docs\u002Findex.md",{"id":17,"text":18,"level":9},"4-ältere-versionen-versions--docs-archive","4. Ältere Versionen: versions\u002F → docs-archive\u002F",{"id":20,"text":21,"level":9},"5-prüfen","5. Prüfen",{"id":23,"text":24,"level":9},"was-sonst-neu-ist","Was sonst neu ist","Bring eine Clay-2-Seite auf Clay 3 - index.md-Dateien statt dir-meta.yaml, die Startseite in docs\u002Findex.md und ältere Versionen in docs-archive\u002F.",null,false,"\u002F_clay\u002Fsocial\u002F3.x\u002Fde\u002Fguides\u002Fupgrading-to-clay-3.png",1792666371254]