diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index f328de7229ec9..180981738aa91 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -197,3 +197,9 @@ aliases: - aisonaku - potapy4 - dianaabv + sig-docs-pl-owners: # Admins for Polish content + - mfilocha + - nvtkaszpir + sig-docs-pl-reviews: # PR reviews for Polish content + - mfilocha + - nvtkaszpir diff --git a/README-pl.md b/README-pl.md new file mode 100644 index 0000000000000..c05631df91fe8 --- /dev/null +++ b/README-pl.md @@ -0,0 +1,87 @@ +# Dokumentacja projektu Kubernetes + +[![Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website) +[![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest) + +Witamy! + +W tym repozytorium znajdziesz wszystko, czego potrzebujesz do zbudowania [strony internetowej Kubernetesa wraz z dokumentacją](https://kubernetes.io/). Bardzo nam miło, że chcesz wziąć udział w jej współtworzeniu! + +## Twój wkład w dokumentację + +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](https://github.com/kubernetes/website/wiki/Tech-reviewers). 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ę](https://kubernetes.io/docs/contribute/start/) +* [Podgląd wprowadzanych zmian w dokumentacji](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally) +* [Szablony stron](http://kubernetes.io/docs/contribute/style/page-templates/) +* [Styl pisania dokumentacji](http://kubernetes.io/docs/contribute/style/style-guide/) +* [Lokalizacja dokumentacji Kubernetes](https://kubernetes.io/docs/contribute/localization/) + +## Różne wersje językowe `README.md` +| | | +|---|---| +|[README po francusku](README-fr.md)|[README po koreańsku](README-ko.md)| +|[README po niemiecku](README-de.md)|[README po portugalsku](README-pt.md)| +|[README w hindi](README-hi.md)|[README po hiszpańsku](README-es.md)| +|[README po indonezyjsku](README-id.md)|[README po chińsku](README-zh.md)| +|[README po japońsku](README-ja.md)|[README po polsku](README-pl.md)| +||| + +## Jak uruchomić lokalną kopię strony przy pomocy Dockera? + +Zalecaną metodą uruchomienia serwisu internetowego Kubernetesa lokalnie jest użycie specjalnego obrazu [Dockera](https://docker.com), który zawiera generator stron statycznych [Hugo](https://gohugo.io). + +> Użytkownicy Windows będą potrzebowali dodatkowych narzędzi, które mogą zainstalować przy pomocy [Chocolatey](https://chocolatey.org). + +```bash +choco install make +``` + +> Jeśli wolisz uruchomić serwis lokalnie bez Dockera, przeczytaj [jak uruchomić serwis lokalnie przy pomocy Hugo](#jak-uruchomić-serwis-lokalnie-przy-pomocy-hugo) poniżej. + +Jeśli [zainstalowałeś i uruchomiłeś](https://www.docker.com/get-started) już Dockera, zbuduj obraz `kubernetes-hugo` lokalnie: + +```bash +make docker-image +``` + +Po zbudowaniu obrazu, możesz uruchomić serwis lokalnie: + +```bash +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. + +## Jak uruchomić lokalną kopię strony przy pomocy Hugo? + +Zajrzyj do [oficjalnej dokumentacji Hugo](https://gohugo.io/getting-started/installing/) po instrukcję instalacji. Upewnij się, że instalujesz rozszerzoną wersję Hugo, określoną przez zmienną środowiskową `HUGO_VERSION` w pliku [`netlify.toml`](netlify.toml#L9). + +Aby uruchomić serwis lokalnie po instalacji Hugo, napisz: + +```bash +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. + +## Społeczność, listy dyskusyjne, uczestnictwo i wsparcie + +Zajrzyj na stronę [społeczności](http://kubernetes.io/community/), aby dowiedzieć się, jak możesz zaangażować się w jej działania. + +Możesz kontaktować się z gospodarzami projektu za pomocą: + +* [Komunikatora Slack](https://kubernetes.slack.com/messages/sig-docs) +* [List dyskusyjnych](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) + +### Zasady postępowania + +Udział w działaniach społeczności Kubernetes jest regulowany przez [Kodeks postępowania](code-of-conduct.md). + +## Dziękujemy! + +Kubernetes rozkwita dzięki zaangażowaniu społeczności — doceniamy twój wkład w tworzenie naszego serwisu i dokumentacji! diff --git a/README.md b/README.md index f403f9e9dee65..6780cf8d19fe6 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ For more information about contributing to the Kubernetes documentation, see: |[Hindi README](README-hi.md)|[Spanish README](README-es.md)| |[Indonesian README](README-id.md)|[Chinese README](README-zh.md)| |[Japanese README](README-ja.md)|[Vietnamese README](README-vi.md)| -|[Russian README](README-ru.md)| +|[Russian README](README-ru.md)|[Polish README](README-pl.md)| ||| ## Running the website locally using Docker diff --git a/config.toml b/config.toml index ce4b124166711..ccb2da1d5daa5 100644 --- a/config.toml +++ b/config.toml @@ -286,3 +286,14 @@ time_format_blog = "02.01.2006" # A list of language codes to look for untranslated content, ordered from left to right. language_alternatives = ["en"] +[languages.pl] +title = "Kubernetes" +description = "Produkcyjny system zarządzania kontenerami" +languageName = "Polski" +weight = 13 +contentDir = "content/pl" + +[languages.pl.params] +time_format_blog = "01.02.2006" +# A list of language codes to look for untranslated content, ordered from left to right. +language_alternatives = ["en"] diff --git a/content/pl/OWNERS b/content/pl/OWNERS new file mode 100644 index 0000000000000..f51cfd63f3e19 --- /dev/null +++ b/content/pl/OWNERS @@ -0,0 +1,13 @@ +# See the OWNERS docs at https://go.k8s.io/owners + +# This is the directory for Polish source content. +# Teams and members are visible at https://github.com/orgs/kubernetes/teams. + +reviewers: +- sig-docs-pl-reviews + +approvers: +- sig-docs-pl-owners + +labels: +- language/pl