[{"data":1,"prerenderedAt":20},["ShallowReactive",2],{"clay-page:\u002F4.x\u002Fde\u002Fguides\u002Ftroubleshooting":3},{"html":4,"toc":5,"description":16,"hero":17,"list":18,"socialImage":19},"\u003Ch1 id=\"problemlösung\">Problemlösung\u003C\u002Fh1>\n\u003Cp>Öffne das Problem, das du hast.\u003C\u002Fp>\n\u003Ch2 id=\"die-veröffentlichte-seite\">\u003Ca class=\"heading-anchor\" href=\"#die-veröffentlichte-seite\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#die-veröffentlichte-seite\">#\u003C\u002Fa>Die veröffentlichte Seite\u003C\u002Fh2>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Die Seite hat keine Styles, oder Links führen zu 404\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Die Seite liegt unter einem Pfad, aber Clay hat sie für die Wurzel gebaut. Setz \u003Ccode>baseURL\u003C\u002Fcode> auf diesen Pfad, mit Schrägstrichen auf beiden Seiten:\u003C\u002Fp>\n\u003Cdiv class=\"code-block has-title\">\u003Cdiv class=\"code-title\">\u003Ci class=\"fa-regular fa-file-lines\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan>clay.yaml\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\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">baseURL\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"\u002Fmein-projekt\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\u003Cp>Prüf es mit \u003Ccode>npx clay preview\u003C\u002Fcode>: Es liefert die Seite unter ihrer \u003Ccode>baseURL\u003C\u002Fcode> aus, wie der Hoster.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Bilder werden nicht angezeigt\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Verweise auf Bilder relativ zur Seite, etwa \u003Ccode>img\u002Fscreen.png\u003C\u002Fcode> oder \u003Ccode>..\u002Fimg\u002Fscreen.png\u003C\u002Fcode>. Pfade, die mit \u003Ccode>\u002F\u003C\u002Fcode> beginnen, zeigen auf die Wurzel der Domain, nicht auf deine Dokumentation, und brechen unter einer \u003Ccode>baseURL\u003C\u002Fcode>. \u003Ccode>npx clay build\u003C\u002Fcode> meldet Bilder, die es nicht gibt.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">„Zuletzt aktualisiert“ fehlt\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Clay liest die Daten aus Git. Entweder liegt die Dokumentation in keinem Git-Repository, oder die CI hat nur den letzten Commit ausgecheckt.\u003C\u002Fp>\n\u003Cdiv class=\"clay-tabs\" data-tabs=\"\">\u003Cdiv role=\"tablist\" class=\"tabs tabs-border not-prose\">\u003Cbutton type=\"button\" role=\"tab\" id=\"clay-tabs-1-0\" class=\"tab tab-active\" aria-controls=\"clay-tabs-1-0-panel\" aria-selected=\"true\" tabindex=\"0\">GitHub Actions\u003C\u002Fbutton>\u003Cbutton type=\"button\" role=\"tab\" id=\"clay-tabs-1-1\" class=\"tab\" aria-controls=\"clay-tabs-1-1-panel\" aria-selected=\"false\" tabindex=\"-1\">GitLab CI\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv role=\"tabpanel\" id=\"clay-tabs-1-0-panel\" class=\"clay-tab-panel\" aria-labelledby=\"clay-tabs-1-0\" data-label=\"GitHub Actions\">\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\">uses\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#CE9178\">actions\u002Fcheckout@v7\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\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\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">    fetch-depth\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#076240;--shiki-dark:#B5CEA8\">0\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\u003C\u002Fdiv>\u003Cdiv role=\"tabpanel\" id=\"clay-tabs-1-1-panel\" class=\"clay-tab-panel\" aria-labelledby=\"clay-tabs-1-1\" data-label=\"GitLab CI\" hidden=\"\">\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\">variables\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\">  GIT_DEPTH\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#076240;--shiki-dark:#B5CEA8\">0\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\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Icons fehlen oder erscheinen als Kästchen\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cul>\n\u003Cli>Prüf die Klassen des Icons auf \u003Ca href=\"https:\u002F\u002Ffontawesome.com\u002Ficons\" target=\"_blank\" rel=\"noopener noreferrer\">\u003Ci class=\"fa-solid fa-arrow-up-right-from-square clay-external-icon\" aria-hidden=\"true\">\u003C\u002Fi>fontawesome.com\u003C\u002Fa>: Stil und Name sind nötig, \u003Ccode>fa-solid fa-rocket\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Pro-Icons funktionieren nur mit einem \u003Ca href=\"\u002Fclay-example-repo\u002F4.x\u002Fde\u002Ffeatures\u002Fthemes-and-icons#font-awesome-kits\" data-route=\"\u002F4.x\u002Fde\u002Ffeatures\u002Fthemes-and-icons#font-awesome-kits\">Kit\u003C\u002Fa>, das sie enthält.\u003C\u002Fli>\n\u003Cli>Mit einem Kit: Trag die Domain deiner Seite bei den erlaubten Domains des Kits in deinem Font-Awesome-Konto ein.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">index.html direkt geöffnet sieht kaputt aus\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Die Seite braucht einen Webserver: Von der Festplatte geöffnet (\u003Ccode>file:\u002F\u002F…\u003C\u002Fcode>) kann der Browser Styles, Skripte und Suche nicht laden. Nutze \u003Ccode>npx clay preview\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Ch2 id=\"bauen-und-vorschau\">\u003Ca class=\"heading-anchor\" href=\"#bauen-und-vorschau\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#bauen-und-vorschau\">#\u003C\u002Fa>Bauen und Vorschau\u003C\u002Fh2>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Der Build scheitert an einer Seite\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Clay zeigt, welche Seite gescheitert ist und warum. Häufige Ursachen:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Ein Link in HTML\u003C\u002Fstrong> zeigt auf eine Seite, die es nicht gibt. Die Linkprüfung sieht nur Markdown-Links; korrigiere den HTML-Link.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Das Front Matter\u003C\u002Fstrong> ist nicht geschlossen: Die zweite \u003Ccode>---\u003C\u002Fcode>-Zeile fehlt.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Mit \u003Ccode>npx clay build --verbose\u003C\u002Fcode> siehst du die vollständige Ausgabe.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">„clay dev“ läuft für dieses Projekt\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Ein Build und der Entwicklungsserver können nicht gleichzeitig im selben Projekt laufen. Beende \u003Ccode>clay dev\u003C\u002Fcode> (\u003Ckbd>Strg\u003C\u002Fkbd> + \u003Ckbd>C\u003C\u002Fkbd> in seinem Terminal) und baue dann erneut.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Änderungen erscheinen nicht in clay dev\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>\u003Ccode>clay dev\u003C\u002Fcode> lädt den Browser neu, wenn sich eine Seite, ein Bild oder die \u003Ccode>clay.yaml\u003C\u002Fcode> ändert. Passiert nichts, prüf, ob du die Dateien des Projekts bearbeitest, in dem \u003Ccode>clay dev\u003C\u002Fcode> gestartet wurde, und schau in seiner Ausgabe nach Fehlern.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Der Port ist belegt\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Ein anderes Programm nutzt Port 3000 (oder 4173 für \u003Ccode>clay preview\u003C\u002Fcode>). Wähle einen anderen:\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\">npx\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> clay\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> dev\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#0000FF;--shiki-dark:#569CD6\"> --port\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#076240;--shiki-dark:#B5CEA8\"> 3001\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\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Cdetails class=\"clay-details collapse\">\u003Csummary class=\"collapse-title\">\u003Cspan class=\"clay-details-icon\" aria-hidden=\"true\">\u003Ci class=\"fa-solid fa-chevron-right\">\u003C\u002Fi>\u003C\u002Fspan>\u003Cspan class=\"clay-details-title\">Node.js ist zu alt\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Clay braucht Node.js 20.19 oder neuer. Prüf es mit \u003Ccode>node --version\u003C\u002Fcode> und aktualisiere Node.js von \u003Ca href=\"https:\u002F\u002Fnodejs.org\" target=\"_blank\" rel=\"noopener noreferrer\">\u003Ci class=\"fa-solid fa-arrow-up-right-from-square clay-external-icon\" aria-hidden=\"true\">\u003C\u002Fi>nodejs.org\u003C\u002Fa> oder mit deiner Versionsverwaltung.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\n\u003Ch2 id=\"immer-noch-nicht-weiter\">\u003Ca class=\"heading-anchor\" href=\"#immer-noch-nicht-weiter\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#immer-noch-nicht-weiter\">#\u003C\u002Fa>Immer noch nicht weiter?\u003C\u002Fh2>\n\u003Cp>Ein Coding-Agent findet die Ursache oft; beschreib das Problem an der markierten Stelle:\u003C\u002Fp>\n\u003Cdiv class=\"clay-prompt-aura aura not-prose\">\u003Cdiv class=\"clay-prompt code-block\">\u003Cdiv class=\"clay-prompt-title\">\u003Ci class=\"fa-solid fa-wand-magic-sparkles\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan>Vorgeschlagener Prompt\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"clay-prompt-text\">Meine Clay-Seite hat ein Problem: <beschreib es>. Lies\nhttps:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002Fde\u002Fguides\u002Ftroubleshooting.md und\nhttps:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fbuild-checks.md, führe\n`npx clay build --strict` aus, finde die Ursache und behebe sie.\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Prompt kopieren\" aria-label=\"Prompt kopieren\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Sonst öffne ein Issue im \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fclay-doc\u002Fclay\u002Fissues\" target=\"_blank\" rel=\"noopener noreferrer\">\u003Ci class=\"fa-solid fa-arrow-up-right-from-square clay-external-icon\" aria-hidden=\"true\">\u003C\u002Fi>Clay-Repository\u003C\u002Fa> mit dem Befehl, den du ausgeführt hast, und seiner Ausgabe.\u003C\u002Fp>\n",[6,10,13],{"id":7,"text":8,"level":9},"die-veröffentlichte-seite","Die veröffentlichte Seite",2,{"id":11,"text":12,"level":9},"bauen-und-vorschau","Bauen und Vorschau",{"id":14,"text":15,"level":9},"immer-noch-nicht-weiter","Immer noch nicht weiter?","Lösungen für die häufigsten Probleme mit Clay-Seiten, von fehlenden Styles bis zu fehlenden Daten.",null,false,"\u002F_clay\u002Fsocial\u002F4.x\u002Fde\u002Fguides\u002Ftroubleshooting.png",1792666372876]