Skip to content

Commit

Permalink
Merge 0e05ab7 into 1ce0637
Browse files Browse the repository at this point in the history
  • Loading branch information
@mbiesiad
mbiesiad committed Jun 13, 2020
2 parents 1ce0637 + 0e05ab7 commit e3696b7
Show file tree
Hide file tree
Showing 4 changed files with 77 additions and 75 deletions.
44 changes: 23 additions & 21 deletions docs/README.md
View file
@@ -1,37 +1,38 @@
# gulp documentation
# Dokumentacja gulp

* [Getting Started](getting-started/) - Get started with gulp
* [API documentation](api/) - The programming interface, defined
* [CLI documentation](CLI.md) - Learn how to call tasks and use compilers
* [Writing a Plugin](writing-a-plugin/) - The essentials of writing a gulp plugin
* [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 한국어 참조 문서
* [Pierwsze kroki](getting-started/) - Pierwsze kroki z gulp
* [Dokumentacja API](api/) - Interfejs programowania, zdefiniowany
* [Dokumentacja CLI](CLI.md) - Dowiedz się, jak wywoływać taski i korzystać z kompilatorów
* [Pisanie wtyczki](writing-a-plugin/) - Podstawy pisania wtyczki gulp
* [Czemu używać Pump?](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](https://github.com/mbiesiad/gulp/tree/pl_PL/docs) - gulp Dokumentacja


## FAQ

See the [FAQ](FAQ.md) for the answers to commonly asked questions.
Zobacz [FAQ](FAQ.md) aby uzyskać odpowiedzi na najczęściej zadawane pytania.


## Recipes
## Przepisy

The community has written [recipes](recipes#recipes) for common gulp use-cases.
Społeczność napisała [przepisy kulinarne](recipes#recipes) dla typowych przypadków użycia gulp.


## Still got questions?
## Nadal masz pytania?

Post on [StackOverflow with a #gulp tag](https://stackoverflow.com/questions/tagged/gulp) or come chat with us in [#gulpjs](https://webchat.freenode.net/?channels=gulpjs) on [Freenode](https://freenode.net/).
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/).

## Videos
* [Intro to Gulp 4](https://youtu.be/N42LQ2dLoA8) presented by @addyosmani and @gauntface
## Wideo
* [Wstęp do Gulp 4](https://youtu.be/N42LQ2dLoA8) prezentowany przez @addyosmani oraz @gauntface

## Books
## 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)


## Articles
## 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)
Expand All @@ -46,19 +47,20 @@ Post on [StackOverflow with a #gulp tag](https://stackoverflow.com/questions/tag
* [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/)

## Examples
## Przykłady

- [Web Starter Kit gulpfile](https://github.com/google/web-starter-kit/blob/master/gulpfile.babel.js)


## License
## Licencja

All the documentation is covered by the CC0 license *(do whatever you want with it - public domain)*.
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/)

To the extent possible under law, [Fractal](http://wearefractal.com) has waived all copyright and related or neighboring rights to this work.
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]: https://github.com/mbiesiad/gulp/tree/pl_PL/docs
46 changes: 23 additions & 23 deletions docs/api/concepts.md
View file
Expand Up @@ -5,58 +5,58 @@ hide_title: true
sidebar_label: Concepts
-->

# Concepts
# Pojęcia

The following concepts are prerequisites to understanding the API docs. They will be referenced throughout, refer back to this page for detailed explanations.
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.

If you're new here, begin with the [Getting Started Guide][quick-start-docs].
Jeśli jesteś tu nowy, zacznij od [Poradnik wprowadzający][quick-start-docs].

## Vinyl

Vinyl is a metadata object that describes a file. The main properties of a Vinyl instance are `path` and `contents` - core aspects of a file on your file system. Vinyl objects can be used to describe files from many sources - on a local file system or any remote storage option.
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.

## Vinyl adapters
## Adaptery Vinyl

While Vinyl provides a way to describe a file, a way to access these files is needed. Each file source is accessed using a Vinyl adapter.
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.

An adapter exposes:
* A method with the signature `src(globs, [options])` and returns a stream that produces Vinyl objects.
* A method with the signature `dest(folder, [options])` and returns a stream that consumes Vinyl objects.
* Any extra methods specific to their input/output medium - such as the `symlink` method `vinyl-fs` provides. They should always return streams that produce and/or consume Vinyl objects.
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.

## Tasks
## Zadania

Each gulp task is an asynchronous JavaScript function that either accepts an error-first callback or returns a stream, promise, event emitter, child process, or observable. Due to some platform limitations, synchronous tasks aren't supported.
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 potomny lub observable. Z powodu pewnych ograniczeń platformy zadania synchroniczne nie są obsługiwane.

For a more detailed explanation, see [Creating Tasks][creating-tasks-doc].
Aby uzyskać bardziej szczegółowe wyjaśnienie, patrz [Tworzenie zadań][creating-tasks-doc].

## Globs

A glob is a string of literal and/or wildcard characters, like `*`, `**`, or `!`, used to match filepaths. Globbing is the act of locating files on a file system using one or more 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.

If you don't have experience with globs, see [Explaining Globs][explaining-globs-docs].
Jeśli nie masz doświadczenia z globami, zobacz [Wyjaśnianie Globs][explaining-globs-docs].

## Glob base

A glob base - sometimes called glob parent - is the path segment before any special characters in a glob string. As such, the glob base of `/src/js/**.js` is `/src/js/`. All paths that match the glob are guaranteed to share the glob base - that path segment can't be variable.
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.

Vinyl instances generated by `src()` are constructed with the glob base set as their `base` property. When written to the file system with `dest()`, the `base` will be removed from the output path to preserve directory structures.
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.

For more in depth information, see the [glob-parent][glob-parent-external] repository.
Aby uzyskać więcej szczegółowych informacji, zobacz [glob-parent][glob-parent-external] repository.

## File system stats

File metadata is provided as an instance of Node's [`fs.Stats`][fs-stats-external]. It is available as the `stat` property on your Vinyl instances and used internally to determine if a Vinyl object represents a directory or symbolic link. When written to the file system, permissions and time values are synchronized from the Vinyl object's `stat` property.
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

File system modes determine what permissions exist for a file. Most files and directories on your file system will have a fairly permissive mode, allowing gulp to read/write/update files on your behalf. By default, gulp will create files with the same permissions as the running process, but you can configure the modes through options in `src()`, `dest()`, etc. If you're experiencing permission (EPERM) issues, check the modes on your files.
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.

## Modules
## Moduły

Gulp is made up of many small modules that are pulled together to work cohesively. By utilizing [semver][semver-external] within the small modules, we can release bug fixes and features without publishing new versions of gulp. Often, when you don't see progress on the main repository, work is being done in one of these modules.
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.

If you're having trouble, ensure your current modules are updated using the `npm update` command. If the problem persists, open an issue on the individual project repository.
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
Expand Down
34 changes: 17 additions & 17 deletions docs/getting-started/1-quick-start.md
View file
Expand Up @@ -5,11 +5,11 @@ hide_title: true
sidebar_label: Quick Start
-->

# Quick Start
# Szybki start

If you've previously installed gulp globally, run `npm rm --global gulp` before following these instructions. For more information, read this [Sip][sip-article].
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].

## Check for node, npm, and npx
## Sprawdź dla node, npm, oraz npx
```sh
node --version
```
Expand All @@ -25,44 +25,44 @@ npx --version

If they are not installed, follow the instructions [here][node-install].

## Install the gulp command line utility
## Zainstaluj narzędzie wiersza poleceń gulp
```sh
npm install --global gulp-cli
```


## Create a project directory and navigate into it
## Utwórz katalog projektu i przejdź do niego
```sh
npx mkdirp my-project
```
```sh
cd my-project
```

## Create a package.json file in your project directory
## Utwórz plik package.json w katalogu projektu
```sh
npm init
```

This will guide you through giving your project a name, version, description, etc.
To poprowadzi cię przez nadanie projektowi nazwy, wersji, opisu itp.

## Install the gulp package in your devDependencies
## Zainstaluj pakiet gulp w swoich devDependencies
```sh
npm install --save-dev gulp
```

## Verify your gulp versions
## Sprawdź swoje wersje gulp

```sh
gulp --version
```

Ensure the output matches the screenshot below or you might need to restart the steps in this guide.
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]

## Create a gulpfile
Using your text editor, create a file named gulpfile.js in your project root with these contents:
## 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
Expand All @@ -72,15 +72,15 @@ function defaultTask(cb) {
exports.default = defaultTask
```

## Test it
Run the gulp command in your project directory:
## Przetestuj to
Uruchom polecenie gulp w katalogu projektu:
```sh
gulp
```
To run multiple tasks, you can use `gulp <task> <othertask>`.
Aby uruchomić wiele zadań, możesz użyć `gulp <task> <othertask>`.

## Result
The default task will run and do nothing.
## 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
Expand Down
28 changes: 14 additions & 14 deletions docs/getting-started/2-javascript-and-gulpfiles.md
View file
Expand Up @@ -5,32 +5,32 @@ hide_title: true
sidebar_label: JavaScript and Gulpfiles
-->

# JavaScript and Gulpfiles
# JavaScript oraz Gulpfiles

Gulp allows you to use existing JavaScript knowledge to write gulpfiles or to use your experience with gulpfiles to write plain JavaScript. Although a few utilities are provided to simplify working with the filesystem and command line, everything else you write is pure JavaScript.
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 explained
## Gulpfile wytłumaczony

A gulpfile is a file in your project directory titled `gulpfile.js` (or capitalized as `Gulpfile.js`, like Makefile), that automatically loads when you run the `gulp` command. Within this file, you'll often see gulp APIs, like `src()`, `dest()`, `series()`, or `parallel()` but any vanilla JavaScript or Node modules can be used. Any exported functions will be registered into gulp's task system.
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 waniliowego modułu JavaScript lub Node. Wszelkie wyeksportowane funkcje zostaną zarejestrowane w systemie zadań gulp.

## Transpilation
## Transpilacja

You can write a gulpfile using a language that requires transpilation, like TypeScript or Babel, by changing the extension on your `gulpfile.js` to indicate the language and install the matching transpiler module.
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.

* For TypeScript, rename to `gulpfile.ts` and install the [ts-node][ts-node-module] module.
* For Babel, rename to `gulpfile.babel.js` and install the [@babel/register][babel-register-module] module.
* 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].

__Most new versions of node support most features that TypeScript or Babel provide, except the `import`/`export` syntax. When only that syntax is desired, rename to `gulpfile.esm.js` and install the [esm][esm-module] 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].__

For a more advanced dive into this topic and the full list of supported extensions, see our [gulpfile transpilation][gulpfile-transpilation-advanced] documentation.
Aby uzyskać bardziej zaawansowane informacje na ten temat i pełną listę obsługiwanych rozszerzeń, zobacz naszą dokumentację [gulpfile transpilation][gulpfile-transpilation-advanced].

## Splitting a gulpfile
## Dzielenie pliku gulpfile

Many users start by adding all logic to a gulpfile. If it ever grows too big, it can be refactored into separate files.
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.

Each task can be split into its own file, then imported into your gulpfile for composition. Not only does this keep things organized, but it allows you to test each task independently or vary composition based on conditions.
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.

Node's module resolution allows you to replace your `gulpfile.js` file with a directory named `gulpfile.js` that contains an `index.js` file which is treated as a `gulpfile.js`. This directory could then contain your individual modules for tasks. If you are using a transpiler, name the folder and file accordingly.
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
Expand Down

0 comments on commit e3696b7

Please sign in to comment.