@intlayer/docs 7.0.7 → 7.0.8

package/docs/pl/readme.md

@@ -0,0 +1,261 @@
+<p align="center">
+  <a href="https://intlayer.org">
+    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.png" width="60%" alt="Logo Intlayer" />
+  </a>
+</p>
+
+<h1 align="center">
+  <strong> Intlayer: otwarte, elastyczne narzędzie i18n z tłumaczeniami wspieranymi przez AI oraz CMS.</strong>
+</h1>
+
+<br />
+
+<p align="center">
+  <a href="https://intlayer.org/doc/concept/content">Dokumentacja</a> •
+  <a href="https://intlayer.org/doc/environment/nextjs">Next.js</a> •
+  <a href="https://intlayer.org/doc/environment/vite-and-react">React + Vite</a> •
+  <a href="https://intlayer.org/doc/concept/cms">CMS</a> •
+  <a href="https://discord.gg/7uxamYVeCk">Discord</a>
+</p>
+<p align="center" style="margin-top:15px;">
+  <a href="https://www.npmjs.com/package/intlayer" target="_blank"><img src="https://img.shields.io/npm/v/intlayer?style=for-the-badge&labelColor=FFFFFF&color=000000&logoColor=FFFFFF" alt="wersja npm" height="24"/>
+  </a>
+    <a href="https://github.com/aymericzip/intlayer/stargazers" target="_blank"><img src="https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logo=github&logoColor=FFD700" alt="Gwiazdy GitHub" height="24"/>
+  </a>
+  <a href="https://www.npmjs.org/package/intlayer" target="_blank"><img src="https://img.shields.io/npm/dm/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="miesięczne pobrania" height="24"/>
+  </a>
+  <a href="https://github.com/aymericzip/intlayer/blob/main/LICENSE"><img src="https://img.shields.io/github/license/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="licencja"/>
+  </a>
+  <a href="https://github.com/aymericzip/intlayer/commits/main"><img src="https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000" alt="ostatni commit"/>
+  </a>
+</p>
+
+![Obejrzyj wideo](https://github.com/aymericzip/intlayer/blob/main/docs/assets/demo_video.gif)
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## Czym jest Intlayer?
+
+Większość bibliotek i18n jest albo zbyt skomplikowana, zbyt sztywna, albo nie została stworzona z myślą o nowoczesnych frameworkach.
+
+Intlayer to **nowoczesne rozwiązanie i18n** dla aplikacji webowych i mobilnych.  
+Jest niezależny od frameworka, **wspierany przez AI** i zawiera darmowy **CMS oraz edytor wizualny**.
+
+Dzięki **plikom z treścią dla każdego języka**, **autouzupełnianiu w TypeScript**, **słownikom możliwym do tree-shakingu** oraz **integracji CI/CD**, Intlayer sprawia, że internacjonalizacja jest **szybsza, czystsza i inteligentniejsza**.
+
+## Kluczowe zalety Intlayer:
+
+| Funkcja                                                                                                                                             | Opis                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Funkcja" width="700">                          | **Wsparcie dla wielu frameworków**<br><br>Intlayer jest kompatybilny ze wszystkimi głównymi frameworkami i bibliotekami, w tym Next.js, React, Vite, Vue.js, Nuxt, Preact, Express i wieloma innymi.                                                                                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true" alt="Funkcja" width="700">       | **Zarządzanie treścią oparte na JavaScript**<br><br>Wykorzystaj elastyczność JavaScript do efektywnego definiowania i zarządzania swoją treścią. <br><br> - [Deklaracja treści](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Funkcja" width="700"> | **Plik deklaracji treści dla każdego języka**<br><br>Przyspiesz swój rozwój, deklarując treść raz, przed automatycznym generowaniem.<br><br> - [Plik deklaracji treści dla każdego języka](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Funkcja" width="700">                      | **Środowisko z bezpiecznym typowaniem**<br><br>Wykorzystaj TypeScript, aby zapewnić, że definicje treści i kod są wolne od błędów, a także skorzystaj z autouzupełniania w IDE.<br><br> - [Konfiguracja TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Funkcja" width="700">                         | **Uproszczona konfiguracja**<br><br>Rozpocznij pracę szybko przy minimalnej konfiguracji. Łatwo dostosuj ustawienia dotyczące internacjonalizacji, routingu, AI, budowania oraz obsługi treści. <br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Funkcja" width="700">                   | **Uproszczone pobieranie treści**<br><br>Nie musisz wywoływać funkcji `t` dla każdej części treści. Pobierz całą swoją zawartość bezpośrednio za pomocą jednego hooka.<br><br> - [Integracja z React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Funkcja" width="700">                    | **Spójna implementacja komponentów serwerowych**<br><br>Idealnie dopasowana do komponentów serwerowych Next.js, używaj tej samej implementacji zarówno dla komponentów klienta, jak i serwera, bez potrzeby przekazywania funkcji `t` przez każdy komponent serwerowy. <br><br> - [Komponenty serwerowe](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Funkcja" width="700">                           | **Zorganizowana baza kodu**<br><br>Utrzymuj swoją bazę kodu w lepszym porządku: 1 komponent = 1 słownik w tym samym folderze. Tłumaczenia blisko odpowiednich komponentów, co zwiększa łatwość utrzymania i przejrzystość. <br><br> - [Jak działa Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Funkcja" width="700">                         | **Ulepszone routowanie**<br><br>Pełne wsparcie routingu aplikacji, płynnie dostosowujące się do złożonych struktur aplikacji, dla Next.js, React, Vite, Vue.js itp.<br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Funkcja" width="700">                            | **Wsparcie Markdown**<br><br>Importuj i interpretuj pliki lokalizacyjne oraz zdalne pliki Markdown dla wielojęzycznych treści, takich jak polityki prywatności, dokumentacja itp. Interpretuj i udostępniaj metadane Markdown w swoim kodzie.<br><br> - [Pliki treści](https://intlayer.org/doc/concept/content/file)                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Funkcja" width="700">                       | **Bezpłatny Edytor Wizualny i CMS**<br><br>Dostępny jest bezpłatny edytor wizualny i CMS dla twórców treści, eliminując potrzebę korzystania z platformy lokalizacyjnej. Utrzymuj synchronizację treści za pomocą Git lub zewnętrznie zarządzaj nią całkowicie lub częściowo za pomocą CMS.<br><br> - [Edytor Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Funkcja" width="700">                              | **Treść możliwa do tree-shakingu**<br><br>Treść możliwa do tree-shakingu, zmniejszająca rozmiar finalnego bundla. Ładuje treść na poziomie komponentu, wykluczając nieużywaną zawartość z bundla. Obsługuje lazy loading, aby zwiększyć efektywność ładowania aplikacji. <br><br> - [Optymalizacja budowania aplikacji](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Funkcja" width="700">                    | **Renderowanie statyczne**<br><br>Nie blokuje renderowania statycznego. <br><br> - [Integracja z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Funkcja" width="700">                      | **Tłumaczenie wspomagane AI**<br><br>Przekształć swoją stronę internetową na 231 języków za pomocą jednego kliknięcia, korzystając z zaawansowanych narzędzi tłumaczeniowych Intlayer opartych na AI, używając własnego dostawcy AI / klucza API. <br><br> - [Integracja CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [Automatyczne wypełnianie](https://intlayer.org/doc/concept/auto-fill) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Funkcja" width="700">                                 | **Integracja serwera MCP**<br><br>Udostępnia serwer MCP (Model Context Protocol) do automatyzacji IDE, umożliwiając płynne zarządzanie treścią i przepływy pracy i18n bezpośrednio w Twoim środowisku programistycznym. <br><br> - [Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **Rozszerzenie VSCode**<br><br>Intlayer dostarcza rozszerzenie do VSCode, które pomaga zarządzać Twoimi treściami i tłumaczeniami, budować słowniki, tłumaczyć zawartość i nie tylko. <br><br> - [Rozszerzenie VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperacyjność**<br><br>Umożliwia interoperacyjność z react-i18next, next-i18next, next-intl oraz react-intl. <br><br> - [Intlayer i react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer i next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer i next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                                                                 |
+
+---
+
+## 📦 Instalacja
+
+Rozpocznij swoją przygodę z Intlayer już dziś i doświadcz płynniejszego, bardziej zaawansowanego podejścia do internacjonalizacji.
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+```bash
+npm install intlayer react-intlayer
+```
+
+⚡ Szybki start (Next.js)
+
+```ts
+// intlayer.config.ts
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```tsx
+// app/page.tsx
+import { useIntlayer } from "react-intlayer";
+
+const Component = () => {
+  const { title } = useIntlayer("home");
+
+  return <h1>{title}</h1>;
+};
+```
+
+<a href="https://intlayer.org/doc/environment/nextjs"> Pobierz pełny przewodnik → </a>
+
+## 🎥 Tutorial na żywo na YouTube
+
+[![Jak internacjonalizować swoją aplikację za pomocą Intlayer](https://i.ytimg.com/vi/e_PPG7PTqGU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDtyJ4uYotEjl12nZ_gZKZ_kjEgOQ)](https://youtu.be/e_PPG7PTqGU?si=GyU_KpVhr61razRw)
+
+<a href="https://intlayer.org/doc/concept/content">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## Spis treści
+
+Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowiedzieć się, jak zintegrować go ze swoimi projektami.
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">📘 Zacznij</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/why">Dlaczego Intlayer?</a></li>
+  <li><a href="https://intlayer.org/doc">Wprowadzenie</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">⚙️ Koncepcja</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/concept/how-works-intlayer">Jak działa Intlayer</a></li>
+  <li><a href="https://intlayer.org/doc/concept/configuration">Konfiguracja</a></li>
+  <li><a href="https://intlayer.org/doc/concept/ai">Dostawca AI</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cli">Intlayer CLI</a></li>
+  <li><a href="https://intlayer.org/doc/concept/editor">Edytor Intlayer</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cms">CMS Intlayer</a></li>
+  <li><a href="https://intlayer.org/doc/concept/content">Słownik</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file">Plik deklaracji treści na lokalizację</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/translation">Tłumaczenie</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/enumeration">Enumeracja</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/condition">Warunek</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/nesting">Zagnieżdżanie</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/markdown">Markdown</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/function-fetching">Pobieranie funkcji</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/insertion">Wstawianie</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/file">Plik</a></li>
+    </ul>
+  </li>
+</ul>
+</details>
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">🌐 Środowisko</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/environment/nextjs">Intlayer z Next.js 15</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/14">Next.js 14 (App Router)</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router">Next.js Page Router</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/create-react-app">React CRA</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react">Vite + React</a>
+     <ul>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7">React-router-v7</a></li>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/tanstack-start">Tanstack start</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/react-native-and-expo">React Native</a></li>
+  <li><a href="https://intlayer.org/doc/environment/lynx-and-react">Lynx + React</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-svelte">Vite + Svelte</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-preact">Vite + Preact</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-vue">Vite + Vue</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt">Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-solid">Vite + Solid</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular">Angular</a></li>
+  <li><a href="https://intlayer.org/doc/environment/express">Express</a></li>
+  <li><a href="https://intlayer.org/doc/environment/nest">NestJS</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">📰 Blog</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/what_is_internationalization.md">Czym jest i18n</a></li>
+  <li><a href="https://intlayer.org/blog/SEO-and-i18n">i18n i SEO</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-i18next">Intlayer i i18next</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-react-i18next">Intlayer i react-intl</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-intl">Intlayer i next-intl</a></li>
+</ul>
+</details>
+
+## 🌐 Readme w innych językach
+
+[English](https://github.com/aymericzip/intlayer/blob/main/readme.md) •
+[简体中文](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/readme.md) •
+[Русский](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/readme.md) •
+[日本語](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/readme.md) •
+[Français](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/readme.md) •
+[한국어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/readme.md) •
+[Español](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/readme.md) •
+[Deutsch](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/readme.md) •
+[العربية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/readme.md) •
+[Italiano](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/readme.md) •
+[English (UK)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/readme.md) •
+[Português](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/readme.md) •
+[हिन्दी](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/readme.md)
+[Türkçe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/readme.md)
+
+## 🤝 Społeczność
+
+Intlayer jest tworzony z myślą o społeczności i dla niej, dlatego bardzo cenimy Twoje uwagi!
+
+- Masz sugestię? [Otwórz zgłoszenie](https://github.com/aymericzip/intlayer/issues)
+- Znalazłeś błąd lub masz propozycję ulepszenia? [Prześlij PR](https://github.com/aymericzip/intlayer/pulls)
+- Potrzebujesz pomocy lub chcesz się połączyć? [Dołącz do naszego Discorda](https://discord.gg/7uxamYVeCk)
+
+Możesz także śledzić nas na:
+
+  <div>
+    <br/>
+    <p align="center">
+      <a href="https://discord.gg/528mBV4N" target="blank"><img align="center"
+         src="https://img.shields.io/badge/discord-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white"
+         alt="Intlayer Discord" height="30"/></a>
+      <a href="https://www.linkedin.com/company/intlayerorg" target="blank"><img align="center"
+         src="https://img.shields.io/badge/linkedin-%231DA1F2.svg?style=for-the-badge&logo=linkedin&logoColor=white"
+         alt="Intlayer LinkedIn" height="30"/></a>
+      <a href="https://www.facebook.com/intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/facebook-4267B2.svg?style=for-the-badge&logo=facebook&logoColor=white"
+         alt="Intlayer Facebook" height="30"/></a>
+      <a href="https://www.instagram.com/intlayer/" target="blank"><img align="center"
+         src="https://img.shields.io/badge/instagram-%23E4405F.svg?style=for-the-badge&logo=Instagram&logoColor=white"
+         alt="Intlayer Instagram" height="30"/></a>
+      <a href="https://x.com/Intlayer183096" target="blank"><img align="center"
+         src="https://img.shields.io/badge/x-1DA1F2.svg?style=for-the-badge&logo=x&logoColor=white"
+         alt="Intlayer X" height="30"/></a>
+      <a href="https://www.youtube.com/@intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/youtube-FF0000.svg?style=for-the-badge&logo=youtube&logoColor=white"
+         alt="Intlayer YouTube" height="30"/></a>
+      <a href="https://www.tiktok.com/@intlayer" target="blank"><img align="center"
+         src="https://img.shields.io/badge/tiktok-000000.svg?style=for-the-badge&logo=tiktok&logoColor=white"
+         alt="Intlayer TikTok" height="30"/></a>
+      <br>
+    </p>
+</div>
+
+### Wkład w projekt
+
+Aby uzyskać bardziej szczegółowe wytyczne dotyczące wkładu w ten projekt, prosimy o zapoznanie się z plikiem [`CONTRIBUTING.md`](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). Zawiera on istotne informacje na temat naszego procesu rozwoju, konwencji komunikatów commitów oraz procedur wydawniczych. Twoje wkłady są dla nas cenne i doceniamy Twoje starania w ulepszaniu tego projektu!
+
+### Dziękujemy za wsparcie
+
+Jeśli podoba Ci się Intlayer, daj nam ⭐ na GitHub. To pomaga innym odkryć projekt!
+
+[![Star History Chart](https://api.star-history.com/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.com/#aymericzip/intlayer&Date)

package/docs/pl/releases/v6.md

@@ -0,0 +1,305 @@
+---
+createdAt: 2025-09-22
+updatedAt: 2025-09-23
+title: Nowy Intlayer v6 - Co nowego?
+description: Odkryj, co nowego w Intlayer v6. Znaczące ulepszenia wydajności, doświadczenia deweloperskiego oraz nowe funkcje usprawniające proces internacjonalizacji.
+keywords:
+  - Intlayer
+  - Lokalizacja
+  - Development
+  - Wydajność
+  - Doświadczenie dewelopera
+  - Funkcje
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - releases
+  - v6
+---
+
+# Nowy Intlayer v6 - Co nowego?
+
+Witamy w Intlayer v6! Ta wersja skupia się na wydajności, doświadczeniu deweloperskim oraz niezawodności. Poniżej znajdują się najważniejsze zmiany wraz z notatkami migracyjnymi i przykładami do kopiowania.
+
+## Najważniejsze zmiany
+
+- Nowa komenda: `npx intlayer content test` do wykrywania brakujących tłumaczeń
+- Nowa globalna opcja `autoFill` do automatycznego generowania brakujących tłumaczeń
+- Komenda fill domyślnie pomija istniejące tłumaczenia: `npx intlayer fill`
+- Rozszerzenie VS Code: nowy pasek aktywności Intlayer (Wyszukiwanie i Słowniki), akcje na pasku narzędzi/kontekstowe, automatyczne ujawnianie, komendy Fill/Test
+- Budowanie 10× szybciej dzięki równoległemu przetwarzaniu promise
+- Zdalne buforowanie słowników, aby uniknąć ponownego pobierania przy starcie aplikacji
+- Ulepszone logowanie: ustaw `log.mode: 'verbose'` aby analizować zachowanie
+- Silniejsza walidacja zapobiegająca awariom aplikacji z powodu problemów ze słownikami
+- Aktualizacje na żywo z CMS przy użyciu `build.importMode = 'live'` i `pnpm intlayer live`
+- Poprawki: integracja Vue.js, adapter Lynx, Edytor Wizualny na Windows
+
+---
+
+## Nowość: Testowanie brakujących tłumaczeń
+
+Szybko przeprowadź audyt projektu, aby znaleźć brakujące klucze/lokalizacje.
+
+```bash
+npx intlayer content test
+```
+
+Output:
+
+```bash
+pnpm intlayer content test
+Brakujące tłumaczenia:
+ - blog-data       - japoński (ja), koreański (ko), chiński (zh), niemiecki (de), włoski (it) - src/components/BlogPage/blogData.content.ts
+ - demo-page       - francuski (fr), włoski (it)                                         - src/components/DemoPage/demo.content.ts
+ - locale-switcher - włoski (it), portugalski (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.ts
+Języki: angielski (en), rosyjski (ru), japoński (ja), francuski (fr), koreański (ko), chiński (zh), hiszpański (es), niemiecki (de), arabski (ar), włoski (it), brytyjski angielski (en-GB), portugalski (pt), hindi (hi)
+Wymagane języki: angielski (en)
+Brakujące języki: japoński (ja), koreański (ko), chiński (zh), niemiecki (de), włoski (it), francuski (fr), portugalski (pt)
+Brakujące wymagane języki: -
+Łączna liczba brakujących języków: 7
+Łączna liczba brakujących wymaganych języków: 0
+```
+
+Zobacz więcej opcji w dokumentacji CLI: [Referencja CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_cli.md) → "Testuj brakujące tłumaczenia". A także przewodnik [Testowanie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/testing.md).
+
+---
+
+## Nowość: Globalne autoFill do uzupełniania brakujących tłumaczeń
+
+Możesz teraz globalnie włączyć auto-fill, aby każde słowniki z brakującymi tłumaczeniami były automatycznie uzupełniane.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  content: {
+    // Automatyczne generowanie brakujących tłumaczeń dla wszystkich słowników
+    autoFill: "./{{fileName}}Filled.content.ts",
+    //
+    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // autoFill: true, // automatyczne generowanie brakujących tłumaczeń dla wszystkich słowników, np. używając "./{{fileName}}.content.json"
+    //
+    // autoFill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Automatycznie uzupełnij brakujące tłumaczenia za pomocą polecenia `npx intlayer fill`.
+
+Możesz nadal dostosowywać ustawienia dla poszczególnych słowników, używając pola `autoFill` w plikach zawartości. Intlayer najpierw uwzględni konfigurację dla konkretnego słownika, a następnie przejdzie do konfiguracji globalnej. Pełną dokumentację znajdziesz w [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/autoFill.md) oraz [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
+
+---
+
+## Polecenie fill: bezpieczniejsze domyślne ustawienia
+
+Polecenie fill domyślnie uzupełnia tylko brakujące tłumaczenia i pomija istniejącą zawartość.
+
+```bash
+npx intlayer fill
+```
+
+```bash
+Affected dictionary keys for processing: access-key-creation-form-schema, doc-search-metadata, doc-search-page
+  - [access-key-creation-form-schema]      Słownik nie ma ścieżki do pliku. Pomijanie.
+  - [access-key-creation-form-schema]      Przetwarzanie deklaracji zawartości: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
+  - [access-key-creation-form-schema]      Brak lokalizacji do uzupełnienia - pomijanie słownika
+  - [doc-search-metadata]                  Słownik nie ma ścieżki do pliku. Pomijanie.
+  - [doc-search-metadata]                  Przetwarzanie deklaracji zawartości: src/app/[locale]/(docs)/doc/search/metadata.content.ts
+  - [doc-search-metadata]                  Brak lokalizacji do uzupełnienia - pomijanie słownika
+  - [doc-search-page]                      Słownik nie ma ścieżki do pliku. Pomijanie.
+  - [doc-search-page]                      Przetwarzanie deklaracji zawartości: src/app/[locale]/(docs)/doc/search/page.content.ts
+  - [doc-search-page]                     [Rosyjski (ru)]                   Przygotowywanie tłumaczenia słownika z angielskiego (en) na rosyjski (ru)
+[intlayer]  Zastosowano formatowanie Prettier do src/app/[locale]/(docs)/doc/search/page.content.ts
+  - [doc-search-page]                      Deklaracja zawartości zapisana w src/app/[locale]/(docs)/doc/search/page.content.ts
+```
+
+Przykłady CI są dostępne w [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/CI_CD.md).
+
+---
+
+## Zaktualizowane rozszerzenie VS Code
+
+Rozszerzenie teraz zawiera dedykowaną kartę Intlayer w pasku aktywności oraz kilka usprawnień w przepływie pracy:
+
+- Pasek aktywności Intlayer z dwoma widokami:
+  - Widok wyszukiwania do przeszukiwania słownika/treści na żywo
+  - Drzewo słowników wyświetlające środowiska, słowniki oraz pliki współtworzące
+- Pasek narzędzi w widoku Słowników: Build, Pull, Push, Fill, Refresh, Test, Create Dictionary File
+- Menu kontekstowe: Pull/Push na słownikach; Fill na plikach
+- Auto‑reveal: aktualny plik edytora jest podświetlany w drzewie Słowników, gdy ma to zastosowanie
+- Nowe polecenia dostępne z Palety Poleceń: Fill Dictionaries oraz Test Dictionaries
+
+Szczegóły znajdują się w dokumentacji [Oficjalne rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md).
+
+---
+
+Zaktualizowano serwer MCP, aby obsługiwał nowe funkcje.
+
+- Automatyczne wypełnianie
+- Testowanie brakujących tłumaczeń
+- Aktualizacje na żywo
+- Logowanie
+- Walidacja
+- Notatki migracyjne
+- Dokumentacja
+
+> Serwer MCP pomaga w automatyzacji projektów korzystających z Intlayer. Testuje brakujące tłumaczenia dla automatycznie generowanego kodu. Pomaga zrozumieć Twoją konfigurację oraz osadzić dokumentację Intlayer w Twoim IDE.
+
+---
+
+## Wydajność: 10× szybciej
+
+- Równoległe rozwiązywanie lokalnych i zdalnych słowników
+- Zdalne słowniki są buforowane, aby uniknąć ponownego pobierania przy uruchomieniu aplikacji
+
+```bash
+npx intlayer build
+```
+
+Wynik:
+
+```bash
+[intlayer]  Przygotowywanie Intlayer (v6.0.1)
+[intlayer]  Słowniki:
+[intlayer]  ✓ Zawartość lokalna: 163/163
+[intlayer]  ✓ Zawartość zdalna: 100/100
+[intlayer]   - access-key-creation-form             [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - access-key-form                      [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - ai-ab-testing-section                                 [distant: ✔ imported]
+[intlayer]   - application-not-running-view         [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - available-techno-section             [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - blog-data                            [local: ✔ built]
+[intlayer]   - blog-metadata                        [local: ✔ built]
+[intlayer]   - blog-nav-list                        [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - blog-page                                             [distant: ✔ fetched]
+[intlayer]   - blog-search-page                     [local: ✔ built] [distant: ✔ imported]
+...
+[intlayer]  Zawartość załadowana  (Łącznie: 8401ms - Lokalnie: 4050ms - Zdalnie: 4222ms)
+```
+
+---
+
+## Ulepszenia logowania
+
+System logowania został ulepszony, aby dostarczać bardziej szczegółowe informacje o tym, co dzieje się podczas transformacji w trakcie budowania i działania aplikacji.
+
+> Włącz szczegółowe logi, aby lepiej zrozumieć, co dzieje się podczas transformacji w trakcie budowania i działania aplikacji.
+
+```ts fileName="intlayer.config.ts"
+export default {
+  log: {
+    mode: "verbose", // opcje: "default" | "verbose" | "disabled"
+  },
+};
+```
+
+Zobacz [Konfiguracja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md) dla wszystkich opcji logowania.
+
+---
+
+## Silniejsza walidacja
+
+Przetwarzanie słowników teraz wykonuje bardziej solidną walidację. Gdy przetwarzanie słownika się nie powiedzie, Intlayer unika przerwania działania aplikacji i wyświetla błędy, które można naprawić.
+
+---
+
+## Aktualizacje na żywo z CMS (bezpieczne dla produkcji)
+
+Serwuj na żywo aktualizacje treści (np. aktualizacje redakcyjne) w środowisku produkcyjnym bez konieczności przebudowy aplikacji.
+
+1. Włącz tryb importu na żywo:
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  build: {
+    importMode: "live", // "static" | "dynamic" | "live"
+  },
+  editor: {
+    liveSync: true, // włącz synchronizację na żywo po stronie serwera
+  },
+};
+
+export default config;
+```
+
+2. Uruchom aplikację i proces na żywo równolegle:
+
+```bash
+npx intlayer live --with 'vite preview'
+```
+
+Uwagi:
+
+- Tylko słowniki oznaczone do użycia trybu na żywo będą pobierane na żywo. Pozostałe są zoptymalizowane pod kątem wydajności.
+- W przypadku braku dostępności API na żywo następuje powrót do importu dynamicznego.
+
+Zobacz [CMS i Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md) oraz [Konfiguracja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md) dla pełnych wskazówek.
+
+## Równoległy proces do obserwacji plików na turbopack
+
+Podczas korzystania z Turbopack w Next.js 14 i nowszych jako serwera deweloperskiego z poleceniem `next dev --turbopack`, zmiany w słownikach nie będą domyślnie automatycznie wykrywane.
+
+To ograniczenie występuje, ponieważ Turbopack nie może uruchamiać wtyczek webpack równolegle, aby monitorować zmiany w plikach zawartości.
+
+Aby to obejść, zrezygnowaliśmy z polecenia `intlayer watch`, używając opcji `--with`, aby uruchomić jednocześnie serwer deweloperski i obserwatora budowy Intlayer.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
+## Notatki migracyjne
+
+- Usunięto: `dictionaryOutput` (wcześniej `i18next` lub `next-intl`). W przyszłych wersjach pojawi się ponownie jako modułowe adaptery. Usuń to pole z konfiguracji.
+- Powiązane usunięcie: `i18nextResourcesDir` (zobacz changelog w `doc/configuration`).
+- Zalecane jest użycie nowej globalnej opcji `content.autoFill` do masowego generowania brakujących tłumaczeń.
+- Użyj `npx intlayer content test`, aby blokować PR-y z powodu brakujących tłumaczeń.
+- Dla szczegółowej diagnostyki ustaw `log.mode = 'verbose'`.
+- W konfiguracji Vite używaj `intlayer` zamiast `intlayerPlugin` oraz `intlayerMiddleware` zamiast `intlayerMiddlewarePlugin`.
+
+---
+
+## Poprawki
+
+- Stabilność integracji z Vue.js
+- Ulepszenia adaptera Lynx
+- Edytor wizualny na Windows
+
+---
+
+## Notatki migracyjne z wersji v6 do v7
+
+Sprawdź [notatki migracyjne z v6 do v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/releases/v7.md) aby uzyskać więcej informacji.
+
+---
+
+## Przydatne linki
+
+- [Referencja CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_cli.md)
+- [Auto‑uzupełnianie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/autoFill.md)
+- [Konfiguracja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md)
+- [Referencja pliku zawartości](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md)
+- [Oficjalne rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)
+- [CMS i synchronizacja na żywo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)