Herzlich willkommen! Dieses Repository enthält alle Assets, die zur Erstellung der Kubernetes-Website und Dokumentation erforderlich sind. Wir freuen uns sehr, dass Sie dazu beitragen wollen!
Sie können auf die Schaltfläche Fork im oberen rechten Bereich des Bildschirms klicken, um eine Kopie dieses Repositorys in Ihrem GitHub-Konto zu erstellen. Diese Kopie wird als Fork bezeichnet. Nehmen Sie die gewünschten Änderungen an Ihrem Fork vor. Wenn Sie bereit sind, diese Änderungen an uns zu senden, gehen Sie zu Ihrem Fork und erstellen Sie eine neue Pull-Anforderung, um uns darüber zu informieren.
Sobald Ihre Pull-Anfrage erstellt wurde, übernimmt ein Rezensent von Kubernetes die Verantwortung für klares, umsetzbares Feedback. Als Eigentümer des Pull-Request liegt es in Ihrer Verantwortung Ihren Pull-Reqest enstsprechend des Feedbacks, dass Sie vom Kubernetes-Reviewer erhalten haben abzuändern. Beachten Sie auch, dass Sie am Ende mehr als einen Rezensenten von Kubernetes erhalten, der Ihnen Feedback gibt, oder dass Sie Rückmeldungen von einem Rezensenten von Kubernetes erhalten, der sich von demjenigen unterscheidet, der ursprünglich für das Feedback zugewiesen wurde. In einigen Fällen kann es vorkommen, dass einer Ihrer Prüfer bei Bedarf eine technische Überprüfung von einem [Kubernetes Techn-Reviewer] (https://github.com/kubernetes/website/wiki/tech-reviewers) anfordert. Reviewer geben ihr Bestes, um zeitnah Feedback zu geben, die Antwortzeiten können jedoch je nach den Umständen variieren.
Weitere Informationen zum Beitrag zur Kubernetes-Dokumentation finden Sie unter:
- Mitwirkung beginnen
- Ihre Dokumentationsänderungen bereitstellen
- Seitenvorlagen verwenden
- Dokumentationsstil-Handbuch
- Übersetzung der Kubernetes-Dokumentation
Lesen Sie die Übersetzung von README.md
und detailliertere Anleitungen für koreanische Mitwirkende auf der Seite [Koreanischen README] (README-ko.md).
Sie können die Betreuer der koreanischen Lokalisierung erreichen unter:
- June Yi (GitHub - @gochist)
- Slack Kanal
Um die Kubernetes-Website lokal laufen zu lassen, empfiehlt es sich, ein spezielles Docker Image auszuführen, das den statischen Site-Generator Hugo enthält.
Unter Windows benötigen Sie einige weitere Tools, die Sie mit Chocolatey installieren können.
choco install make
Wenn Sie die Website lieber lokal ohne Docker ausführen möchten, finden Sie weitere Informationen unter Website lokal mit Hugo ausführen.
Wenn Sie Docker installiert haben, erstellen Sie das Docker-Image kubernetes-hugo
lokal:
make docker-image
Nachdem das Image erstellt wurde, können Sie die Site lokal ausführen:
make docker-serve
Öffnen Sie Ihren Browser unter http://localhost:1313, um die Site anzuzeigen. Wenn Sie Änderungen an den Quelldateien vornehmen, aktualisiert Hugo die Site und erzwingt eine Browseraktualisierung.
Hugo-Installationsanweisungen finden Sie in der offiziellen Hugo-Dokumentation. Stellen Sie sicher, dass Sie die Hugo-Version installieren, die in der Umgebungsvariablen HUGO_VERSION
in der Datei netlify.toml
angegeben ist.
So führen Sie die Site lokal aus, wenn Sie Hugo installiert haben:
make serve
Dadurch wird der lokale Hugo-Server an Port 1313 gestartet. Öffnen Sie Ihren Browser unter http://localhost:1313, um die Site anzuzeigen. Wenn Sie Änderungen an den Quelldateien vornehmen, aktualisiert Hugo die Site und erzwingt eine Browseraktualisierung.
Erfahren Sie auf der Community-Seite wie Sie mit der Kubernetes-Community interagieren können.
Sie können die Betreuer dieses Projekts unter folgender Adresse erreichen:
Die Teilnahme an der Kubernetes-Community unterliegt dem [Kubernetes-Verhaltenskodex] (code-of-conduct.md).
Kubernetes lebt vom Community Engagement und wir freuen uns sehr über Ihre Beiträge zu unserer Website und unserer Dokumentation!