[{"data":1,"prerenderedAt":26},["ShallowReactive",2],{"clay-page:\u002F3.x\u002Fde\u002Fversions-and-languages\u002Fversions":3},{"html":4,"toc":5,"description":22,"hero":23,"list":24,"socialImage":25},"\u003Ch1 id=\"versionen\">Versionen\u003C\u002Fh1>\n\u003Cp>Wenn ein Release ändert, wie dein Projekt funktioniert, brauchen Nutzer älterer Releases weiterhin die alte Dokumentation. Clay hält ältere Versionen der Dokumentation neben der aktuellen online, jede mit eigener Navigation, Suche und eigenen URLs.\u003C\u002Fp>\n\u003Ch2 id=\"so-funktionieren-versionen\">\u003Ca class=\"heading-anchor\" href=\"#so-funktionieren-versionen\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#so-funktionieren-versionen\">#\u003C\u002Fa>So funktionieren Versionen\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ccode>docs\u002F\u003C\u002Fcode> ist immer die \u003Cstrong>neueste\u003C\u002Fstrong> Version. Sie liegt an der Wurzel der Seite: \u003Ccode>\u002Fguides\u002Fsetup\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Jeder Ordner in \u003Ccode>docs-archive\u002F\u003C\u002Fcode> ist eine \u003Cstrong>ältere\u003C\u002Fstrong> Version, eine Kopie von \u003Ccode>docs\u002F\u003C\u002Fcode>, gespeichert, als diese Version aktuell war. \u003Ccode>docs-archive\u002F1.x\u002F\u003C\u002Fcode> liegt unter \u003Ccode>\u002F1.x\u003C\u002Fcode>: \u003Ccode>\u002F1.x\u002Fguides\u002Fsetup\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\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>mein-projekt\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>├── clay.yaml\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>├── docs\u002F                 # neueste, unter \u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>└── docs-archive\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>    ├── 2.x\u002F              # unter \u002F2.x\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>    │   ├── index.md\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>    │   └── guides\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan>    └── 1.x\u002F              # unter \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\u003Cp>Die meisten Projekte brauchen nie Versionen: Ohne \u003Ccode>docs-archive\u002F\u003C\u002Fcode> zeigt Clay gar keinen Versionsumschalter.\u003C\u002Fp>\n\u003Ch2 id=\"eine-version-speichern\">\u003Ca class=\"heading-anchor\" href=\"#eine-version-speichern\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#eine-version-speichern\">#\u003C\u002Fa>Eine Version speichern\u003C\u002Fh2>\n\u003Cp>Speichere den aktuellen Stand direkt bevor ein Release die Dokumentation ändert:\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\"> version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> 2.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\u003Cp>Das kopiert \u003Ccode>docs\u002F\u003C\u002Fcode> nach \u003Ccode>docs-archive\u002F2.x\u002F\u003C\u002Fcode>. In \u003Ccode>clay edit\u003C\u002Fcode> tut \u003Ckbd>V\u003C\u002Fkbd> dasselbe und wechselt den Editor zur neuen Version. Danach passt du \u003Ccode>docs\u002F\u003C\u002Fcode> an das neue Release an und gibst ihm in der \u003Ccode>clay.yaml\u003C\u002Fcode> eine Bezeichnung:\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\">version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"3.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\u003Cp>Ohne \u003Ccode>version\u003C\u002Fcode> nennt der Umschalter die neueste Dokumentation „Latest“.\u003C\u002Fp>\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>Tipp\u003C\u002Fp>\n\u003Cp>Ein typischer Ablauf: \u003Ccode>npx clay version 2.x\u003C\u002Fcode>, committen, \u003Ccode>version: \"3.x\"\u003C\u002Fcode> setzen, die Dokumentation anpassen, veröffentlichen. Die alte Dokumentation ist ab dem ersten Build unter \u003Ccode>\u002F2.x\u003C\u002Fcode> online.\u003C\u002Fp>\n\u003C\u002Fdiv>\n\u003Cp>Versionsnamen werden Teil von URLs. Sie dürfen deshalb Buchstaben, Ziffern, \u003Ccode>.\u003C\u002Fcode>, \u003Ccode>-\u003C\u002Fcode> und \u003Ccode>_\u003C\u002Fcode> enthalten. \u003Ccode>docs\u003C\u002Fcode>, \u003Ccode>api\u003C\u002Fcode>, \u003Ccode>_clay\u003C\u002Fcode> und \u003Ccode>_nuxt\u003C\u002Fcode> sind reserviert.\u003C\u002Fp>\n\u003Ch2 id=\"der-versionsumschalter\">\u003Ca class=\"heading-anchor\" href=\"#der-versionsumschalter\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#der-versionsumschalter\">#\u003C\u002Fa>Der Versionsumschalter\u003C\u002Fh2>\n\u003Cp>Sobald es einen Ordner in \u003Ccode>docs-archive\u002F\u003C\u002Fcode> gibt, zeigt die Navigationsleiste einen Versionsumschalter, neueste zuerst. Beim Wechseln bleibt die Seite, die du liest, wenn die andere Version sie hat; sonst öffnet sich die Startseite dieser Version. Auch die \u003Ca href=\"\u002Fclay-example-repo\u002F3.x\u002Fde\u002Fversions-and-languages\u002Ftranslations\" data-route=\"\u002F3.x\u002Fde\u002Fversions-and-languages\u002Ftranslations\">Sprache\u003C\u002Fa> bleibt erhalten.\u003C\u002Fp>\n\u003Cp>Seiten älterer Versionen zeigen ein Banner, das sagt, zu welcher Version sie gehören, und auf dieselbe Seite in der neuesten Version verlinkt.\u003C\u002Fp>\n\u003Ch2 id=\"was-jede-version-für-sich-hat\">\u003Ca class=\"heading-anchor\" href=\"#was-jede-version-für-sich-hat\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#was-jede-version-für-sich-hat\">#\u003C\u002Fa>Was jede Version für sich hat\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>\u003C\u002Fth>\n\u003Cth>Pro Version\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Seiten, Bilder und Dateien\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>docs-archive\u002F<name>\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Startseite, Namen, Icons und Reihenfolge der Ordner\u003C\u002Ftd>\n\u003Ctd>Die \u003Ccode>index.md\u003C\u002Fcode>-Dateien der Version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Suchindex\u003C\u002Ftd>\n\u003Ctd>Ergebnisse bleiben in der Version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Bearbeiten-Links\u003C\u002Ftd>\n\u003Ctd>Führen nach \u003Ccode>docs-archive\u002F<name>\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Übersetzungen\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>*.de.md\u003C\u002Fcode>-Dateien im Ordner der Version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>Die \u003Ccode>clay.yaml\u003C\u002Fcode> teilen sich alle Versionen: Sie haben denselben Titel und dieselbe Navigationsleiste.\u003C\u002Fp>\n\u003Ch2 id=\"ältere-versionen-bearbeiten\">\u003Ca class=\"heading-anchor\" href=\"#ältere-versionen-bearbeiten\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#ältere-versionen-bearbeiten\">#\u003C\u002Fa>Ältere Versionen bearbeiten\u003C\u002Fh2>\n\u003Cp>Ältere Versionen sind ganz normale Dateien: Einen Tippfehler in \u003Ccode>docs-archive\u002F1.x\u002F\u003C\u002Fcode> behebst du wie überall sonst, oder du wechselst \u003Ccode>clay edit\u003C\u002Fcode> mit \u003Ckbd>v\u003C\u002Fkbd> zur Version. Links in einer älteren Version bleiben in dieser Version, solange sie relativ sind: \u003Ccode>[Einrichtung](setup.md)\u003C\u002Fcode> verlinkt auf \u003Ccode>\u002F1.x\u002Fsetup\u003C\u002Fcode>. Links, die mit \u003Ccode>\u002F\u003C\u002Fcode> beginnen, führen zur neuesten Version.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\n\u003Cp class=\"markdown-alert-title text-base-content\">\u003Ci class=\"fa-solid fa-sticky-note mr-2\">\u003C\u002Fi>Hinweis\u003C\u002Fp>\n\u003Cp>Jede gespeicherte Version fügt dem Build ihre Seiten hinzu. Behalte die Versionen, die deine Nutzer tatsächlich einsetzen, und lösche die Ordner von Versionen, die niemand mehr nutzt.\u003C\u002Fp>\n\u003C\u002Fdiv>\n",[6,10,13,16,19],{"id":7,"text":8,"level":9},"so-funktionieren-versionen","So funktionieren Versionen",2,{"id":11,"text":12,"level":9},"eine-version-speichern","Eine Version speichern",{"id":14,"text":15,"level":9},"der-versionsumschalter","Der Versionsumschalter",{"id":17,"text":18,"level":9},"was-jede-version-für-sich-hat","Was jede Version für sich hat",{"id":20,"text":21,"level":9},"ältere-versionen-bearbeiten","Ältere Versionen bearbeiten","Die Dokumentation älterer Releases online halten, mit einem Versionsumschalter und einem Banner, das zur neuesten Dokumentation führt.",null,false,"\u002F_clay\u002Fsocial\u002F3.x\u002Fde\u002Fversions-and-languages\u002Fversions.png",1792666371208]