From fe9dee65f31dd0540116dad8a4e9b976a0014d4c Mon Sep 17 00:00:00 2001 From: Blaine Bublitz Date: Sun, 7 Apr 2024 21:13:56 -0700 Subject: [PATCH] chore: Remove locale docs (#2787) --- docs/locale/pl_PL/README.md | 66 -------------- docs/locale/pl_PL/api/concepts.md | 77 ----------------- .../pl_PL/getting-started/1-quick-start.md | 85 ------------------- .../2-javascript-and-gulpfiles.md | 31 ------- 4 files changed, 259 deletions(-) delete mode 100644 docs/locale/pl_PL/README.md delete mode 100644 docs/locale/pl_PL/api/concepts.md delete mode 100644 docs/locale/pl_PL/getting-started/1-quick-start.md delete mode 100644 docs/locale/pl_PL/getting-started/2-javascript-and-gulpfiles.md diff --git a/docs/locale/pl_PL/README.md b/docs/locale/pl_PL/README.md deleted file mode 100644 index ced801441..000000000 --- a/docs/locale/pl_PL/README.md +++ /dev/null @@ -1,66 +0,0 @@ -# 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 deleted file mode 100644 index d23325bc9..000000000 --- a/docs/locale/pl_PL/api/concepts.md +++ /dev/null @@ -1,77 +0,0 @@ -# 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 deleted file mode 100644 index 3d1b54df8..000000000 --- a/docs/locale/pl_PL/getting-started/1-quick-start.md +++ /dev/null @@ -1,85 +0,0 @@ -# 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 `. - -## 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 deleted file mode 100644 index 989ea9175..000000000 --- a/docs/locale/pl_PL/getting-started/2-javascript-and-gulpfiles.md +++ /dev/null @@ -1,31 +0,0 @@ -# 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