[{"data":1,"prerenderedAt":39},["ShallowReactive",2],{"clay-page:\u002F3.x\u002Fde\u002Fguides\u002Fmigrating-from-clay-1":3},{"html":4,"toc":5,"description":35,"hero":36,"list":37,"socialImage":38},"\u003Ch1 id=\"umstieg-von-clay-1\">Umstieg von Clay 1\u003C\u002Fh1>\n\u003Cp>Clay 1 bestand aus zwei Teilen: dem Clay-Frontend und Clay Oven, einem eigenen Go-Werkzeug, das die Dokumentation aufbereitet hat. Clay 2 ist ein einziges npm-Paket, \u003Ccode>clay-doc\u003C\u002Fcode>, das beides erledigt. Deine Dokumentation und die \u003Ccode>clay.yaml\u003C\u002Fcode> funktionieren weiter; was sich ändert, ist das Bauen. Diese Seite beschreibt den Schritt zu Clay 2; mach danach mit dem \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fguides\u002Fupgrading-to-clay-3\" data-route=\"\u002F3.x\u002Fde\u002Fguides\u002Fupgrading-to-clay-3\">Umstieg auf Clay 3\u003C\u002Fa> weiter.\u003C\u002Fp>\n\u003Ch2 id=\"was-bleibt\">\u003Ca class=\"heading-anchor\" href=\"#was-bleibt\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#was-bleibt\">#\u003C\u002Fa>Was bleibt\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Der Ordner \u003Ccode>docs\u002F\u003C\u002Fcode>, die Markdown-Dateien und ihr Front Matter.\u003C\u002Fli>\n\u003Cli>\u003Ccode>clay.yaml\u003C\u002Fcode> und \u003Ccode>dir-meta.yaml\u003C\u002Fcode> mit all ihren Einstellungen (Clay 3 verlagert die \u003Ccode>dir-meta.yaml\u003C\u002Fcode> dann in \u003Ccode>index.md\u003C\u002Fcode>-Dateien).\u003C\u002Fli>\n\u003Cli>Die Umgebungsvariablen \u003Ccode>CLAY_TITLE\u003C\u002Fcode>, \u003Ccode>CLAY_BASE_URL\u003C\u002Fcode>, \u003Ccode>CLAY_SITE_URL\u003C\u002Fcode> und \u003Ccode>CLAY_FONTAWESOME_KIT\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Die URLs deiner Seiten.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"was-sich-ändert\">\u003Ca class=\"heading-anchor\" href=\"#was-sich-ändert\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#was-sich-ändert\">#\u003C\u002Fa>Was sich ändert\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Clay 1\u003C\u002Fth>\n\u003Cth>Clay 2\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Clay Oven herunterladen, \u003Ccode>.\u002Fclay-oven\u003C\u002Fcode> ausführen\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>npm install --save-dev clay-doc\u003C\u002Fcode>, \u003Ccode>npx clay build\u003C\u002Fcode> ausführen\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ausgabe in \u003Ccode>output\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Ausgabe in \u003Ccode>publish\u002Fpublic\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run-oven.sh\u003C\u002Fcode> in der CI\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>npm ci\u003C\u002Fcode> und \u003Ccode>npx clay build --strict\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Optionen \u003Ccode>-c\u003C\u002Fcode>, \u003Ccode>-d\u003C\u002Fcode>, \u003Ccode>-o\u003C\u002Fcode>, \u003Ccode>-fm\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>--root\u003C\u002Fcode> und \u003Ccode>--out\u003C\u002Fcode>; die Dateinamen sind fest\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>-nc\u003C\u002Fcode>, \u003Ccode>-ci\u003C\u002Fcode>, um Rückfragen zu überspringen\u003C\u002Ftd>\n\u003Ctd>Es gibt keine Rückfragen mehr\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>langs\u003C\u002Fcode> in der \u003Ccode>clay.yaml\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Nicht mehr nötig: Die Sprachen der Codeblöcke werden erkannt\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Keine Live-Vorschau\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>npx clay dev\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"schritt-für-schritt\">\u003Ca class=\"heading-anchor\" href=\"#schritt-für-schritt\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#schritt-für-schritt\">#\u003C\u002Fa>Schritt für Schritt\u003C\u002Fh2>\n\u003Ch3 id=\"1-clay-installieren\">\u003Ca class=\"heading-anchor\" href=\"#1-clay-installieren\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#1-clay-installieren\">#\u003C\u002Fa>1. Clay installieren\u003C\u002Fh3>\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\"> init\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\"> -y\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#006400;--shiki-dark:#6A9955\">                       # nur, wenn es noch keine package.json gibt\u003C\u002Fspan>\u003C\u002Fspan>\n\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\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\u003Ch3 id=\"2-die-clayyaml-aufräumen\">\u003Ca class=\"heading-anchor\" href=\"#2-die-clayyaml-aufräumen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#2-die-clayyaml-aufräumen\">#\u003C\u002Fa>2. Die clay.yaml aufräumen\u003C\u002Fh3>\n\u003Cp>Entferne \u003Ccode>langs\u003C\u002Fcode>, falls vorhanden. Clay 2 warnt davor, funktioniert aber trotzdem.\u003C\u002Fp>\n\u003Ch3 id=\"3-die-gitignore-anpassen\">\u003Ca class=\"heading-anchor\" href=\"#3-die-gitignore-anpassen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#3-die-gitignore-anpassen\">#\u003C\u002Fa>3. Die .gitignore anpassen\u003C\u002Fh3>\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>node_modules\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>publish\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>output\u002F\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\u003Ch3 id=\"4-bauen-und-prüfen\">\u003Ca class=\"heading-anchor\" href=\"#4-bauen-und-prüfen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#4-bauen-und-prüfen\">#\u003C\u002Fa>4. Bauen und prüfen\u003C\u002Fh3>\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>Clay 2 prüft Links und Einstellungen gründlicher als Clay Oven. Behebe, was es meldet; siehe \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fcli\u002Fbuild-checks\" data-route=\"\u002F3.x\u002Fde\u002Fcli\u002Fbuild-checks\">Build-Prüfungen\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"5-die-ci-anpassen\">\u003Ca class=\"heading-anchor\" href=\"#5-die-ci-anpassen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#5-die-ci-anpassen\">#\u003C\u002Fa>5. Die CI anpassen\u003C\u002Fh3>\n\u003Cp>Ersetze den Schritt mit Clay Oven in deinem Workflow:\u003C\u002Fp>\n\u003Cdiv class=\"code-block\">\u003Cpre class=\"shiki shiki-themes light-plus dark-plus has-diff\" 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\">name\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">Build docs\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff remove\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  run\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fclay-doc\u002Fclay-oven\u002Frefs\u002Fheads\u002Fmain\u002Frun-oven.sh | sh\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">- \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">uses\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">actions\u002Fsetup-node@v7\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">  with\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">    node-version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">lts\u002F*\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">    cache\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">npm\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">- \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">run\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">npm ci\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line diff add\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">- \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">run\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">npx clay build --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>und lade \u003Ccode>publish\u002Fpublic\u003C\u002Fcode> statt \u003Ccode>output\u003C\u002Fcode> hoch. Unter \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fdeployment\u002Fgithub-pages\" data-route=\"\u002F3.x\u002Fde\u002Fdeployment\u002Fgithub-pages\">GitHub Pages\u003C\u002Fa> findest du einen vollständigen Workflow.\u003C\u002Fp>\n\u003Ch2 id=\"neu-in-clay-2\">\u003Ca class=\"heading-anchor\" href=\"#neu-in-clay-2\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#neu-in-clay-2\">#\u003C\u002Fa>Neu in Clay 2\u003C\u002Fh2>\n\u003Cp>Nach dem Umstieg steht dir ohne weiteren Aufwand zur Verfügung:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>eine Live-Vorschau mit \u003Ccode>clay dev\u003C\u002Fcode>,\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fcli\u002Fbuild-checks\" data-route=\"\u002F3.x\u002Fde\u002Fcli\u002Fbuild-checks\">Build-Prüfungen\u003C\u002Fa> für Links und Einstellungen,\u003C\u002Fli>\n\u003Cli>eine \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Ffeatures\u002Fsearch\" data-route=\"\u002F3.x\u002Fde\u002Ffeatures\u002Fsearch\">Suche\u003C\u002Fa> mit Tippfehlertoleranz und \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Ffeatures\u002Fseo\" data-route=\"\u002F3.x\u002Fde\u002Ffeatures\u002Fseo\">SEO\u003C\u002Fa> mit Sitemap,\u003C\u002Fli>\n\u003Cli>\u003Ccode>description\u003C\u002Fcode> und \u003Ccode>order\u003C\u002Fcode> im Front Matter,\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>, \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fversions-and-languages\u002Fversions\" data-route=\"\u002F3.x\u002Fde\u002Fversions-and-languages\u002Fversions\">Versionen\u003C\u002Fa> und \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fversions-and-languages\u002Ftranslations\" data-route=\"\u002F3.x\u002Fde\u002Fversions-and-languages\u002Ftranslations\">Übersetzungen\u003C\u002Fa>.\u003C\u002Fli>\n\u003C\u002Ful>\n",[6,10,13,16,20,23,26,29,32],{"id":7,"text":8,"level":9},"was-bleibt","Was bleibt",2,{"id":11,"text":12,"level":9},"was-sich-ändert","Was sich ändert",{"id":14,"text":15,"level":9},"schritt-für-schritt","Schritt für Schritt",{"id":17,"text":18,"level":19},"1-clay-installieren","1. Clay installieren",3,{"id":21,"text":22,"level":19},"2-die-clayyaml-aufräumen","2. Die clay.yaml aufräumen",{"id":24,"text":25,"level":19},"3-die-gitignore-anpassen","3. Die .gitignore anpassen",{"id":27,"text":28,"level":19},"4-bauen-und-prüfen","4. Bauen und prüfen",{"id":30,"text":31,"level":19},"5-die-ci-anpassen","5. Die CI anpassen",{"id":33,"text":34,"level":9},"neu-in-clay-2","Neu in Clay 2","Bring eine Clay-1-Seite, die mit Clay Oven gebaut wurde, Schritt für Schritt auf Clay 2.",null,false,"\u002F_clay\u002Fsocial\u002F3.x\u002Fde\u002Fguides\u002Fmigrating-from-clay-1.png",1792666371262]