Docs: Begin adding Polish translations (#2456)

mbiesiad · web-flow · commit 9f12c2d25a50 · 2020-07-28T10:12:28.000-07:00
diff --git a/docs/README.md b/docs/README.md
@@ -7,6 +7,7 @@
 * [Why Use Pump?](why-use-pump/README.md) - Why to use the `pump` module instead of calling `.pipe` yourself
 * [Simplified Chinese documentation][SimplifiedChineseDocs] - gulp 简体中文文档
 * [Korean documentation][KoreanDocs] - gulp 한국어 참조 문서
+* [Polish documentation](/docs/locale/pl_PL/README.md) - gulp Dokumentacja
 
 
 ## FAQ
diff --git a/docs/locale/pl_PL/README.md b/docs/locale/pl_PL/README.md
@@ -0,0 +1,66 @@
+# Dokumentacja gulp
+
+* [Pierwsze kroki](getting-started/) - Pierwsze kroki z gulp
+* [Dokumentacja API](/docs/api/) - Interfejs programowania, zdefiniowany
+* [Dokumentacja CLI](/docs/CLI.md) - Dowiedz się, jak wywoływać taski i korzystać z kompilatorów
+* [Pisanie wtyczki](/docs/writing-a-plugin/) - Podstawy pisania wtyczki gulp
+* [Czemu używać Pump?](/docs/why-use-pump/README.md) - Dlaczego używać modułu `pump` zamiast wywoływać `.pipe` yourself
+* [Dokumentacja język chiński uproszczony][SimplifiedChineseDocs] - gulp 简体中文文档
+* [Dokumentacja język koreański][KoreanDocs] - gulp 한국어 참조 문서
+* [Dokumentacja język polski][PolishDocs] - gulp Dokumentacja
+
+
+## FAQ
+
+Zobacz [FAQ](/docs/FAQ.md) aby uzyskać odpowiedzi na najczęściej zadawane pytania.
+
+
+## Receptury
+
+Społeczność napisała [receptury](/docs/recipes#recipes) dla typowych przypadków użycia gulp.
+
+
+## Nadal masz pytania?
+
+Napisz post na [StackOverflow z tagiem #gulp](https://stackoverflow.com/questions/tagged/gulp) lub wpadnij z nami na czat [#gulpjs](https://webchat.freenode.net/?channels=gulpjs) na [Freenode](https://freenode.net/).
+
+## Wideo
+* [Wstęp do Gulp 4](https://youtu.be/N42LQ2dLoA8) prezentowany przez @addyosmani oraz @gauntface
+
+## Książki
+* [Developing a gulp Edge](http://shop.oreilly.com/product/9781939902146.do)
+* [Getting Started with Gulp – Second Edition](https://www.packtpub.com/application-development/getting-started-gulp-%E2%80%93-second-edition) - Travis Maynard, Packt (April 2017)
+
+
+## Artykuły
+* [Tagtree intro to gulp video](http://tagtree.io/gulp)
+* [Introduction to node.js streams](https://github.com/substack/stream-handbook)
+* [Video introduction to node.js streams](https://www.youtube.com/watch?v=QgEuZ52OZtU)
+* [Getting started with gulp (by @markgdyr)](https://markgoodyear.com/2014/01/getting-started-with-gulp/)
+* [A cheatsheet for gulp](https://github.com/osscafe/gulp-cheatsheet)
+* [Why you shouldn’t create a gulp plugin (or, how to stop worrying and learn to love existing node packages)](http://blog.overzealous.com/post/74121048393/why-you-shouldnt-create-a-gulp-plugin-or-how-to-stop)
+* [Inspiration (slides) about why gulp was made](http://slid.es/contra/gulp)
+* [Building With Gulp](http://www.smashingmagazine.com/2014/06/11/building-with-gulp/)
+* [Gulp - The Basics (screencast)](https://www.youtube.com/watch?v=dwSLFai8ovQ)
+* [Get started with gulp (video series)](https://www.youtube.com/playlist?list=PLRk95HPmOM6PN-G1xyKj9q6ap_dc9Yckm)
+* [Optimize your web code with gulp](http://www.linuxuser.co.uk/tutorials/optimise-your-web-code-with-gulp-js)
+* [Automate Your Tasks Easily with Gulp.js ](https://scotch.io/tutorials/automate-your-tasks-easily-with-gulp-js)
+* [How to upgrade to Gulp v4](https://www.liquidlight.co.uk/blog/article/how-do-i-update-to-gulp-4/)
+
+## Przykłady
+
+- [Web Starter Kit gulpfile](https://github.com/google/web-starter-kit/blob/master/gulpfile.babel.js)
+
+
+## Licencja
+
+Cała dokumentacja objęta jest licencją CC0 *(rób co chcesz - domena publiczna)*.
+
+[![CC0](https://i.creativecommons.org/p/zero/1.0/88x31.png)](https://creativecommons.org/publicdomain/zero/1.0/)
+
+W zakresie, w jakim jest to możliwe na mocy prawa, [Fractal](http://wearefractal.com) zrzekł się wszelkich praw autorskich i pokrewnych lub powiązanych do tego dzieła.
+
+[SpanishDocs]: https://github.com/bucaran/gulp-docs-es
+[SimplifiedChineseDocs]: https://github.com/lisposter/gulp-docs-zh-cn
+[KoreanDocs]: https://github.com/preco21/gulp-docs-ko
+[PolishDocs]: /docs/locale/pl_PL/README.md
diff --git a/docs/locale/pl_PL/api/concepts.md b/docs/locale/pl_PL/api/concepts.md
@@ -0,0 +1,77 @@
+# Pojęcia
+
+Poniższe pojęcia są niezbędne do zrozumienia dokumentacji API. Będą się do nich odwoływać w całości, wróć do tej strony, aby uzyskać szczegółowe wyjaśnienia.
+
+Jeśli jesteś tu nowy, zacznij od [Poradnik wprowadzający][quick-start-docs].
+
+## Vinyl
+
+Vinyl to obiekt metadanych opisujący plik. Główne właściwości instancji Vinyl to `path` i `contents` - podstawowe aspekty pliku w systemie plików. Obiekty Vinyl mogą być używane do opisywania plików z wielu źródeł - w lokalnym systemie plików lub dowolnej opcji zdalnego przechowywania.
+
+## Adaptery Vinyl
+
+Chociaż Vinyl zapewnia sposób na opisanie pliku, potrzebny jest sposób na dostęp do tych plików. Każde źródło pliku jest dostępne za pomocą adaptera Vinyl.
+
+Adapter udostępnia:
+* Metoda z podpisem `src (globs, [opcje])` i zwraca strumień, który produkuje obiekty Vinyl.
+* Metoda z podpisem `dest (folder, [opcje])` i zwraca strumień, który zużywa obiekty Vinyl.
+* Wszelkie dodatkowe metody specyficzne dla ich nośnika wejścia / wyjścia - takie jak metoda `symlink`, którą zapewnia `winyl-fs`. Powinny zawsze zwracać strumienie, które produkują i / lub zużywają obiekty Vinyl.
+
+## Zadania
+
+Każde zadanie gulp to asynchroniczna funkcja JavaScript, która albo przyjmuje wywołanie zwrotne z pierwszym błędem, albo zwraca strumień, obietnicę, emiter zdarzeń, proces podrzędny lub observable. Z powodu pewnych ograniczeń platformy zadania synchroniczne nie są obsługiwane.
+
+Aby uzyskać bardziej szczegółowe wyjaśnienie, patrz [Tworzenie zadań][creating-tasks-doc].
+
+## Globs
+
+Glob jest ciągiem literałów i / lub symboli wieloznacznych, takich jak `*`, `**` lub `!`, używanych do dopasowania ścieżek plików. Globbing to czynność polegająca na lokalizowaniu plików w systemie plików przy użyciu co najmniej jednego globu.
+
+Jeśli nie masz doświadczenia z globami, zobacz [Wyjaśnianie Globs][explaining-globs-docs].
+
+## Glob base
+
+Glob base - czasami nazywany globem parent - to segment ścieżki przed znakami specjalnymi w ciągu globu. Jako taka, globalną bazą `/src /js/**. Js` jest `/src/js/`. Wszystkie ścieżki pasujące do globu mają tę samą bazę globalną - ten segment ścieżki nie może być zmienny.
+
+Instancje Vinyl generowane przez `src ()` są konstruowane z ustawieniem glob base jako ich właściwości `base`. Po zapisaniu do systemu plików za pomocą `dest ()`, `base` zostanie usunięte ze ścieżki wyjściowej, aby zachować struktury katalogów.
+
+Aby uzyskać więcej szczegółowych informacji, zobacz [glob-parent][glob-parent-external] repository.
+
+## File system stats
+
+Metadane pliku są dostarczane jako instancja węzła [`fs.Stats`][fs-stats-external]. Jest dostępny jako właściwość `stat` w twoich instancjach Vinyl i używany wewnętrznie do ustalenia, czy obiekt Vinyl reprezentuje katalog lub dowiązanie symboliczne. Po zapisaniu w systemie plików uprawnienia i wartości czasu są synchronizowane z właściwością `stat` obiektu Vinyl.
+
+## File system modes
+
+Tryby systemu plików określają, jakie uprawnienia istnieją dla pliku. Większość plików i katalogów w twoim systemie plików będzie miała dość permisywny tryb, pozwalający gulpowi na odczyt / zapis / aktualizację plików w twoim imieniu. Domyślnie gulp tworzy pliki z tymi samymi uprawnieniami, co uruchomiony proces, ale możesz skonfigurować tryby za pomocą opcji w `src ()`, `dest ()` itp. Jeśli masz problemy z uprawnieniami (EPERM), sprawdź tryby plików.
+
+## Moduły
+
+Gulp składa się z wielu małych modułów połączonych ze sobą w celu zapewnienia spójnej pracy. Używając [semver][semver-external] w małych modułach, możemy wydać poprawki błędów i funkcje bez publikowania nowych wersji gulp. Często, gdy nie widać postępu w głównym repozytorium, praca jest wykonywana w jednym z tych modułów.
+
+Jeśli masz problemy, sprawdź, czy bieżące moduły zostały zaktualizowane za pomocą polecenia `npm update`. Jeśli problem będzie się powtarzał, otwórz problem w indywidualnym repozytorium projektu.
+
+* [undertaker][undertaker-external] - the task registration system
+* [vinyl][vinyl-external] - the virtual file objects
+* [vinyl-fs][vinyl-fs-external] - a vinyl adapter to your local file system
+* [glob-watcher][glob-watcher-external] - the file watcher
+* [bach][bach-external] - task orchestration using `series()` and `parallel()`
+* [last-run][last-run-external] - tracks the last run time of a task
+* [vinyl-sourcemap][vinyl-sourcemap-external] - built-in sourcemap support
+* [gulp-cli][gulp-cli-external] - the command line interface for interacting with gulp
+
+
+[quick-start-docs]: ../getting-started/1-quick-start.md
+[creating-tasks-doc]: ../getting-started/3-creating-tasks.md
+[explaining-globs-docs]: ../getting-started/6-explaining-globs.md
+[undertaker-external]: https://github.com/gulpjs/undertaker
+[vinyl-external]: https://github.com/gulpjs/vinyl
+[vinyl-fs-external]: https://github.com/gulpjs/vinyl-fs
+[glob-watcher-external]: https://github.com/gulpjs/glob-watcher
+[bach-external]: https://github.com/gulpjs/bach
+[last-run-external]: https://github.com/gulpjs/last-run
+[vinyl-sourcemap-external]: https://github.com/gulpjs/vinyl-sourcemap
+[gulp-cli-external]: https://github.com/gulpjs/gulp-cli
+[semver-external]: https://semver.org
+[fs-stats-external]: https://nodejs.org/api/fs.html#fs_class_fs_stats
+[glob-parent-external]: https://github.com/es128/glob-parent
diff --git a/docs/locale/pl_PL/getting-started/1-quick-start.md b/docs/locale/pl_PL/getting-started/1-quick-start.md
@@ -0,0 +1,85 @@
+# Szybki start
+
+Jeśli wcześniej instalowałeś gulp globalnie, uruchom `npm rm --global gulp` przed wykonaniem tych instrukcji. Aby uzyskać więcej informacji, przeczytaj to [Sip][sip-article].
+
+## Sprawdź dla node, npm, oraz npx
+```sh
+node --version
+```
+![Output: v8.11.1][img-node-version-command]
+```sh
+npm --version
+```
+![Output: 5.6.0][img-npm-version-command]
+```sh
+npx --version
+```
+![Output: 9.7.1][img-npx-version-command]
+
+If they are not installed, follow the instructions [here][node-install].
+
+## Zainstaluj narzędzie wiersza poleceń gulp
+```sh
+npm install --global gulp-cli
+```
+
+
+## Utwórz katalog projektu i przejdź do niego
+```sh
+npx mkdirp my-project
+```
+```sh
+cd my-project
+```
+
+## Utwórz plik package.json w katalogu projektu
+```sh
+npm init
+```
+
+To poprowadzi cię przez nadanie projektowi nazwy, wersji, opisu itp.
+
+## Zainstaluj pakiet gulp w swoich devDependencies
+```sh
+npm install --save-dev gulp
+```
+
+## Sprawdź swoje wersje gulp
+
+```sh
+gulp --version
+```
+
+Upewnij się, że dane wyjściowe odpowiadają zrzutowi ekranu poniżej, w przeciwnym razie może być konieczne ponowne uruchomienie kroków opisanych w tym przewodniku.
+
+![Output: CLI version 2.0.1 & Local version 4.0.0][img-gulp-version-command]
+
+## Stwórz gulpfile
+Za pomocą edytora tekstu utwórz plik o nazwie gulpfile.js w katalogu głównym projektu z następującymi treściami:
+```js
+function defaultTask(cb) {
+  // place code for your default task here
+  cb();
+}
+
+exports.default = defaultTask
+```
+
+## Przetestuj to
+Uruchom polecenie gulp w katalogu projektu:
+```sh
+gulp
+```
+Aby uruchomić wiele zadań, możesz użyć `gulp <task> <othertask>`.
+
+## Wynik
+Zadanie domyślne zostanie uruchomione i nic nie zrobi.
+![Output: Starting default & Finished default][img-gulp-command]
+
+[sip-article]: https://medium.com/gulpjs/gulp-sips-command-line-interface-e53411d4467
+[node-install]: https://nodejs.org/en/
+[img-node-version-command]: https://gulpjs.com/img/docs-node-version-command.png
+[img-npm-version-command]: https://gulpjs.com/img/docs-npm-version-command.png
+[img-npx-version-command]: https://gulpjs.com/img/docs-npx-version-command.png
+[img-gulp-version-command]: https://gulpjs.com/img/docs-gulp-version-command.png
+[img-gulp-command]: https://gulpjs.com/img/docs-gulp-command.png
diff --git a/docs/locale/pl_PL/getting-started/2-javascript-and-gulpfiles.md b/docs/locale/pl_PL/getting-started/2-javascript-and-gulpfiles.md
@@ -0,0 +1,31 @@
+# JavaScript oraz Gulpfiles
+
+Gulp umożliwia wykorzystanie istniejącej wiedzy o języku JavaScript do pisania plików gulpfiles lub wykorzystanie doświadczenia z plikami gulpfiles do pisania zwykłego kodu JavaScript. Chociaż dostępnych jest kilka narzędzi upraszczających pracę z systemem plików i wierszem poleceń, wszystko, co piszesz, to czysty JavaScript.
+
+## Gulpfile wytłumaczony
+
+Plik gulpfile to plik w katalogu projektu o nazwie `gulpfile.js` (lub pisany wielkimi literami jako `Gulpfile.js`, jak Makefile), który automatycznie ładuje się po uruchomieniu polecenia `gulp`. W tym pliku często zobaczysz interfejsy API gulp, takie jak `src ()`, `dest ()`, `series ()` lub `parallel ()`, ale można użyć dowolnego standardowego modułu JavaScript lub Node. Wszelkie wyeksportowane funkcje zostaną zarejestrowane w systemie zadań gulp.
+
+## Transpilacja
+
+Możesz napisać plik gulpfile przy użyciu języka wymagającego transpilacji, takiego jak TypeScript lub Babel, zmieniając rozszerzenie w swoim `gulpfile.js` aby wskazać język i zainstalować odpowiedni moduł transpilatora.
+
+* Dla TypeScript, zmień nazwę `gulpfile.ts` i zaintaluj moduł [ts-node][ts-node-module].
+* Dla Babel, zmień nazwę na `gulpfile.babel.js` i zainstaluj moduł [@babel/register][babel-register-module].
+
+__Większość nowych wersji node obsługuje większość funkcji udostępnianych przez TypeScript lub Babel, z wyjątkiem składni `import`/`export`. Jeśli pożądana jest tylko ta składnia, zmień nazwę na `gulpfile.esm.js` i zainstaluj moduł [esm][esm-module].__
+
+Aby uzyskać bardziej zaawansowane informacje na ten temat i pełną listę obsługiwanych rozszerzeń, zobacz naszą dokumentację [gulpfile transpilation][gulpfile-transpilation-advanced].
+
+##  Dzielenie pliku gulpfile
+
+Wielu użytkowników zaczyna od dodania całej logiki do pliku gulpfile. Jeśli kiedykolwiek stanie się zbyt duży, można go przekształcić w osobne pliki.
+
+Każde zadanie można podzielić na własny plik, a następnie zaimportować do pliku gulp w celu złożenia. Pozwala to nie tylko utrzymać porządek, ale umożliwia testowanie każdego zadania niezależnie lub różnicowanie składu w zależności od warunków.
+
+Moduł Node'a pozwala zastąpić twój plik `gulpfile.js` z katalogiem o nazwie `gulpfile.js` który zawiera plik `index.js` który jest traktowany jako `gulpfile.js`. Ten katalog może następnie zawierać poszczególne moduły zadań. Jeśli używasz transpilatora, odpowiednio nazwij folder i plik.
+
+[gulpfile-transpilation-advanced]: ../documentation-missing.md
+[ts-node-module]: https://www.npmjs.com/package/ts-node
+[babel-register-module]: https://www.npmjs.com/package/@babel/register
+[esm-module]: https://www.npmjs.com/package/esm
