[{"data":1,"prerenderedAt":20},["ShallowReactive",2],{"clay-page:\u002Fde\u002Fpublishing":3},{"html":4,"toc":5,"description":16,"hero":17,"list":18,"socialImage":19},"\u003Ch1 id=\"veröffentlichen\">Veröffentlichen\u003C\u002Fh1>\n\u003Cp>Ein Clay-Build ist ein Ordner statischer Dateien: Es gibt keinen Server zu betreiben, und jeder Hoster, der Dateien ausliefert, kann eine Clay-Seite ausliefern.\u003C\u002Fp>\n\u003Cdiv class=\"clay-cards not-prose\">\u003Ca class=\"clay-card\" href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fcommands\" data-route=\"\u002Fde\u002Fpublishing\u002Fcommands\">\u003Ci class=\"clay-card-icon fa-solid fa-terminal\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"clay-card-title\">Befehle\u003C\u002Fspan>\u003Cspan class=\"clay-card-text\">Jeder clay-Befehl und jede Option, von der Live-Vorschau über Bauen, Prüfen und Suchen bis zum Bearbeiten und Speichern von Versionen.\u003C\u002Fspan>\u003C\u002Fa>\u003Ca class=\"clay-card\" href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fbuild-checks\" data-route=\"\u002Fde\u002Fpublishing\u002Fbuild-checks\">\u003Ci class=\"clay-card-icon fa-solid fa-list-check\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"clay-card-title\">Build-Prüfungen\u003C\u002Fspan>\u003Cspan class=\"clay-card-text\">Die Probleme, die clay build meldet, wie --strict daraus Fehler macht und was zu tun ist, wenn ein Build scheitert.\u003C\u002Fspan>\u003C\u002Fa>\u003Ca class=\"clay-card\" href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fgithub-pages\" data-route=\"\u002Fde\u002Fpublishing\u002Fgithub-pages\">\u003Ci class=\"clay-card-icon fa-brands fa-github\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"clay-card-title\">GitHub Pages\u003C\u002Fspan>\u003Cspan class=\"clay-card-text\">Eine Clay-Seite auf GitHub Pages veröffentlichen, mit einem Workflow, der die Dokumentation bei jedem Push prüft und veröffentlicht.\u003C\u002Fspan>\u003C\u002Fa>\u003Ca class=\"clay-card\" href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fother-hosts\" data-route=\"\u002Fde\u002Fpublishing\u002Fother-hosts\">\u003Ci class=\"clay-card-icon fa-solid fa-server\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"clay-card-title\">Andere Hoster\u003C\u002Fspan>\u003Cspan class=\"clay-card-text\">Eine Clay-Seite auf Netlify, Cloudflare Pages, GitLab Pages oder dem eigenen Webserver veröffentlichen.\u003C\u002Fspan>\u003C\u002Fa>\u003C\u002Fdiv>\n\u003Ch2 id=\"von-deiner-dokumentation-ins-web\">\u003Ca class=\"heading-anchor\" href=\"#von-deiner-dokumentation-ins-web\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#von-deiner-dokumentation-ins-web\">#\u003C\u002Fa>Von deiner Dokumentation ins Web\u003C\u002Fh2>\n\u003Cdiv class=\"clay-steps\">\u003Col>\n\u003Cli>\u003Cstrong>Schau beim Schreiben zu\u003C\u002Fstrong> mit \u003Ccode>npx clay dev\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Bau und prüfe\u003C\u002Fstrong> mit \u003Ccode>npx clay build --strict\u003C\u002Fcode>. Kaputte Links und Tippfehler in den Einstellungen stoppen den Build.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Sieh dir das Ergebnis an\u003C\u002Fstrong> mit \u003Ccode>npx clay preview\u003C\u002Fcode>, so wie ein Webhoster es ausliefert.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Veröffentliche \u003Ccode>publish\u002Fpublic\u003C\u002Fcode>\u003C\u002Fstrong>, am besten mit einem Workflow bei jedem Push, siehe \u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fgithub-pages\" data-route=\"\u002Fde\u002Fpublishing\u002Fgithub-pages\">GitHub Pages\u003C\u002Fa> oder \u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fother-hosts\" data-route=\"\u002Fde\u002Fpublishing\u002Fother-hosts\">andere Hoster\u003C\u002Fa>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"wo-hosten\">\u003Ca class=\"heading-anchor\" href=\"#wo-hosten\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#wo-hosten\">#\u003C\u002Fa>Wo hosten\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Hoster\u003C\u002Fth>\n\u003Cth>Kosten\u003C\u002Fth>\n\u003Cth>Eingerichtet mit\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fgithub-pages\" data-route=\"\u002Fde\u002Fpublishing\u002Fgithub-pages\">GitHub Pages\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Kostenlos für öffentliche Repositories\u003C\u002Ftd>\n\u003Ctd>Einer Workflow-Datei, siehe Anleitung\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fother-hosts#hosting-dienste\" data-route=\"\u002Fde\u002Fpublishing\u002Fother-hosts#hosting-dienste\">Netlify, Cloudflare Pages\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Kostenlose Tarife\u003C\u002Ftd>\n\u003Ctd>Den Build-Einstellungen des Hosters\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fother-hosts#hosting-dienste\" data-route=\"\u002Fde\u002Fpublishing\u002Fother-hosts#hosting-dienste\">GitLab Pages\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Kostenlos\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>.gitlab-ci.yml\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Fpublishing\u002Fother-hosts#dein-eigener-webserver\" data-route=\"\u002Fde\u002Fpublishing\u002Fother-hosts#dein-eigener-webserver\">Dein eigener Server\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Dein Server\u003C\u002Ftd>\n\u003Ctd>nginx, Caddy oder Docker\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"bevor-du-online-gehst\">\u003Ca class=\"heading-anchor\" href=\"#bevor-du-online-gehst\" aria-label=\"Link zu diesem Abschnitt\" data-route=\"#bevor-du-online-gehst\">#\u003C\u002Fa>Bevor du online gehst\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\">Liegt die Seite unter einem Pfad?\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Eine Seite unter \u003Ccode>https:\u002F\u002Fmeine-org.github.io\u002Fmein-projekt\u002F\u003C\u002Fcode> braucht \u003Ccode>baseURL: \"\u002Fmein-projekt\u002F\"\u003C\u002Fcode> in der \u003Ccode>clay.yaml\u003C\u002Fcode>, sonst brechen Styles und Links. Prüf es mit \u003Ccode>npx clay preview\u003C\u002Fcode>, das die Seite unter ihrer \u003Ccode>baseURL\u003C\u002Fcode> ausliefert.\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\">Willst du Links und Daten für Suchmaschinen?\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Setz \u003Ccode>siteURL\u003C\u002Fcode> auf den Ursprung der Seite, etwa \u003Ccode>https:\u002F\u002Fmeine-org.github.io\u003C\u002Fcode>: Seiten bekommen dann kanonische Links, und der Build schreibt eine Sitemap. Siehe \u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Ffeatures\u002Fseo\" data-route=\"\u002Fde\u002Ffeatures\u002Fseo\">SEO\u003C\u002Fa>.\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\">Holt die CI die ganze Historie?\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cdiv class=\"collapse-content\">\u003Cp>Clay nimmt das Änderungsdatum jeder Seite aus Git. Die meisten CI-Systeme klonen nur den letzten Commit; checke die ganze Historie aus, um die Daten zu bekommen, siehe \u003Ca href=\"\u002Fclay-example-repo\u002Fde\u002Ffeatures\u002Fpage-details\" data-route=\"\u002Fde\u002Ffeatures\u002Fpage-details\">Seitendetails\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdetails>\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>Führ \u003Ccode>npx clay build --strict\u003C\u002Fcode> vor dem Pushen lokal aus. Es dauert ein paar Sekunden und findet dieselben Probleme wie die CI.\u003C\u002Fp>\n\u003C\u002Fdiv>\n",[6,10,13],{"id":7,"text":8,"level":9},"von-deiner-dokumentation-ins-web","Von deiner Dokumentation ins Web",2,{"id":11,"text":12,"level":9},"wo-hosten","Wo hosten",{"id":14,"text":15,"level":9},"bevor-du-online-gehst","Bevor du online gehst","Die clay-Befehle, die Prüfungen jedes Builds und wie die Seite auf GitHub Pages oder bei einem anderen Hoster online geht.",null,false,"\u002F_clay\u002Fsocial\u002Fde\u002Fpublishing.png",1792666371423]