Witamy!
W tym repozytorium znajdziesz wszystko, czego potrzebujesz do zbudowania strony internetowej Kubernetesa wraz z dokumentacją. Bardzo nam miło, że chcesz wziąć udział w jej współtworzeniu!
Możesz kliknąć w przycisk Fork w prawym górnym rogu ekranu, aby stworzyć kopię tego repozytorium na swoim koncie GitHub. Taki rodzaj kopii (odgałęzienia) nazywa się fork. Zmieniaj w nim, co chcesz, a kiedy będziesz już gotowy/a przesłać te zmiany do nas, przejdź do swojej kopii i stwórz nowy pull request, abyśmy zostali o tym poinformowani.
Po stworzeniu pull request, jeden z recenzentów projektu Kubernetes podejmie się przekazania jasnych wskazówek pozwalających podjąć następne działania. Na Tobie, jako właścicielu pull requesta, spoczywa odpowiedzialność za wprowadzenie poprawek zgodnie z uwagami recenzenta. Może też się zdarzyć, że swoje uwagi zgłosi więcej niż jeden recenzent, lub że recenzję będzie robił ktoś inny, niż ten, kto został przydzielony na początku. W niektórych przypadkach, jeśli zajdzie taka potrzeba, recenzent może poprosić dodatkowo o recenzję jednego z recenzentów technicznych. Recenzenci zrobią wszystko, aby odpowiedzieć sprawnie, ale konkretny czas odpowiedzi zależy od wielu czynników.
Więcej informacji na temat współpracy przy tworzeniu dokumentacji znajdziesz na stronach:
- Jak rozpocząć współpracę
- Podgląd wprowadzanych zmian w dokumentacji
- Szablony stron
- Styl pisania dokumentacji
- Lokalizacja dokumentacji Kubernetes
Zalecaną metodą uruchomienia serwisu internetowego Kubernetesa lokalnie jest użycie specjalnego obrazu Dockera, który zawiera generator stron statycznych Hugo.
Użytkownicy Windows będą potrzebowali dodatkowych narzędzi, które mogą zainstalować przy pomocy Chocolatey.
choco install make
Jeśli wolisz uruchomić serwis lokalnie bez Dockera, przeczytaj jak uruchomić serwis lokalnie przy pomocy Hugo poniżej.
Jeśli zainstalowałeś i uruchomiłeś już Dockera, zbuduj obraz kubernetes-hugo
lokalnie:
make docker-image
Po zbudowaniu obrazu, możesz uruchomić serwis lokalnie:
make docker-serve
Aby obejrzeć zawartość serwisu otwórz w przeglądarce adres http://localhost:1313. Po każdej zmianie plików źródłowych, Hugo automatycznie aktualizuje stronę i odświeża jej widok w przeglądarce.
Zajrzyj do oficjalnej dokumentacji Hugo po instrukcję instalacji. Upewnij się, że instalujesz rozszerzoną wersję Hugo, określoną przez zmienną środowiskową HUGO_VERSION
w pliku netlify.toml
.
Aby uruchomić serwis lokalnie po instalacji Hugo, napisz:
make serve
Zostanie uruchomiony lokalny serwer Hugo na porcie 1313. Otwórz w przeglądarce adres http://localhost:1313, aby obejrzeć zawartość serwisu. Po każdej zmianie plików źródłowych, Hugo automatycznie aktualizuje stronę i odświeża jej widok w przeglądarce.
Zajrzyj na stronę społeczności, aby dowiedzieć się, jak możesz zaangażować się w jej działania.
Możesz kontaktować się z gospodarzami projektu za pomocą:
Udział w działaniach społeczności Kubernetes jest regulowany przez Kodeks postępowania.
Kubernetes rozkwita dzięki zaangażowaniu społeczności — doceniamy twój wkład w tworzenie naszego serwisu i dokumentacji!