From 2adec361f22459439d3a0b95874efaffcfdc9a5d Mon Sep 17 00:00:00 2001 From: Kacper Date: Wed, 2 Oct 2024 13:41:18 +0200 Subject: [PATCH 1/3] i18n(pl): Create project-structure.mdx There are three sections left to translate --- .../docs/pl/basics/project-structure.mdx | 131 ++++++++++++++++++ 1 file changed, 131 insertions(+) create mode 100644 src/content/docs/pl/basics/project-structure.mdx diff --git a/src/content/docs/pl/basics/project-structure.mdx b/src/content/docs/pl/basics/project-structure.mdx new file mode 100644 index 0000000000000..5f45e0c2466b2 --- /dev/null +++ b/src/content/docs/pl/basics/project-structure.mdx @@ -0,0 +1,131 @@ +--- +title: Struktura projektu +description: Naucz się, jak zorganizować projekt z Astro. +i18nReady: true +--- +import { FileTree } from '@astrojs/starlight/components'; + +Twój nowy projekt Astro wygenerowany dzięki kreatorowi CLI `create astro` już zawiera kilka plików i folderów. Inne stworzysz już sam i dodasz je do istniejącej struktury plików Astro. + +Poniżej przedstawimy Ci w jaki sposób projekt Astro jest zorganizowany oraz jakie pliki znajdziesz w swoim nowym projekcie. + +## Foldery i Pliki + +Astro wykorzystuje opiniowany układ folderów dla Twojego projektu. Każdy główny folder projektu Astro powinien zawierać następujące foldery i pliki: + +- `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, itp.) +- `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (czcionki, ikonki, itp.) +- `package.json` - Manifest projektu. +- `astro.config.mjs` - Plik konfiguracyjny Astro. (zalecany) +- `tsconfig.json` - Plik konfiguracyjny TypeScript. (zalecany) + +### Przykładowe Drzewko Projektu + +Standardowy folder projektu Astro może wyglądać tak: + + +- public/ + - robots.txt + - favicon.svg + - social-image.png +- src/ + - components/ + - Header.astro + - Button.jsx + - layouts/ + - PostLayout.astro + - pages/ + - posts/ + - post1.md + - post2.md + - post3.md + - index.astro + - styles/ + - global.css +- astro.config.mjs +- package.json +- tsconfig.json + + +### `src/` + +Folder `src/` to miejsce, gdzie żyje większość kodu źródłowego Twojego projektu. Zawiera on: + +- [Strony](/pl/basics/astro-pages/) +- [Layouty](/pl/basics/layouts/) +- [Komponenty Astro](/pl/basics/astro-components/) +- [Komponenty frameworków UI (React, itp.)](/pl/guides/framework-components/) +- [Style (CSS, Sass)](/pl/guides/styling/) +- [Pliki Markdown](/pl/guides/markdown-content/) + +Astro przetwarza, optymalizuje i pakuje Twoje pliki z folderu `src/` aby stworzyć finalną stronę internetową, która wysyłana jest do przeglądarki. W przeciwieństwie do statycznego folderu `public/` zawartość `src/` jest budowana i obsługiwana przez Astro. + +Niektóre pliki (takie jak komponenty Astro) nie są nawet wysyłane w swojej postaci, tylko renderowane jako statyczny HTML. Inne pliki (jak CSS) są przesyłane do przeglądarki ale mogą być zoptymalizowane bądź spakowane z innymi plikami CSS dla lepszej wydajności. + +:::tip +Podczas gdy ten przewodnik opisuje niektóre popularne pomysły użyte przez społeczność Astro, to jedynymi folderami zarezerwowanymi przez samo Astro są `src/pages/` i `src/content/`. Masz wolną rękę aby zmieniać nazwy i reorganizować inne foldery w taki sposób, który jest dla Ciebie najlepszy. +::: + +### `src/components` + +**Komponenty** są jednostkami wielekrotnego użytko dla Twoich stron HTML. Mogą być one [komponentami Astro](/pl/basics/astro-components/), lub [komponentami frameworków UI](/pl/guides/framework-components/) jak React bądź Vue. Podstawą jest aby grupować i organizować wszystkie komponenty Twojego folderu w tym folderze. + +Ta wszechobecna konwencja projektów Astro nie jest jednak wymagana. Organizuj swoje projekty jakkolwiek sobie zamarzysz! + +### `src/content` + +Folder `src/content/` ma na celu przechowywanie [kolekcji zawartości](/pl/guides/content-collections/) i ich opcjonalne pliki konfiguracji. Żadne inne pliki nie mają prawa tu być. + +### `src/layouts` + +[Layouty](/pl/basics/layouts/) to komponenty Astro, które definiują structurę UI współdzieloną przez jedną lub więcej [stron](/pl/basics/astro-pages/). + +Tak jak `src/components`, ten folder to znana, ale niewymagana konwencja. + +### `src/pages` + +[Strony](/pl/basics/astro-pages/) są specjalnym rodzajem komponentu, dzięki którym stworzysz nowe podstrony swojej witryny. Strona może być komponentem Astro bądź plikiem Markdown, który reprezentuje jakąś część zawartości Twojego portalu. + +:::caution +`src/pages` to **wymagany** podfolder Twojego projektu Astro. Bez tego Twoja strona nie będzie miała żadnych stron czy ścieżek! +::: + +### `src/styles` + +Powszechnym zamysłem jest przechowywanie Twoich plików CSS bądź Sass w `src/styles`, ale nie jest on konieczny. Tak długo jak Twoje style będą się znajdować w czeluściach folderu `src/` i będą one odpowiednio zaimportowane, Astro sobie z nimi poradzi i je zoptymalizuje. + +### `public/` + +Folder `public/` jest dla plików i zasobów Twojego projekty, które nie muszą być przetworzone podczas procesu budowania Astro. Pliki z tego folderu będą skopiowane do folderu budowania w stanie nienaruszonym, a po tym Twoja strona zostanie stworzona. + +Takie zachowanie sprawia, że `public/` jest idealnym miejscem na podstawowe zasoby jak zdjęcia czy czcionki, lub dla specjalnych plików takich jak `robots.txt` i `manifest.webmanifest`. + +Możesz umieścić w `public/` pliki CSS i JavaScript, ale pamiętaj, że te pliki nie będą zoptymalizowane ani spakowane w Twoim finalnym projekcie. + +:::tip +Jako ogólna zasada, każdy plik CSS lub JavaScript napisany przez Ciebie, powinien się znajdować w folderze `src/`. +::: + +### `package.json` + +This is a file used by JavaScript package managers to manage your dependencies. It also defines the scripts that are commonly used to run Astro (ex: `npm start`, `npm run build`). + +There are [two kinds of dependencies](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) you can specify in a `package.json`: `dependencies` and `devDependencies`. In most cases, these work the same: Astro needs all dependencies at build time, and your package manager will install both. We recommend putting all of your dependencies in `dependencies` to start, and only use `devDependencies` if you find a specific need to do so. + +For help creating a new `package.json` file for your project, check out the [manual setup](/pl/install-and-setup/#manual-setup) instructions. + +### `astro.config.mjs` + +This file is generated in every starter template and includes configuration options for your Astro project. Here you can specify integrations to use, build options, server options, and more. + +Astro supports several file formats for its JavaScript configuration file: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` and `astro.config.ts`. We recommend using `.mjs` in most cases or `.ts` if you want to write TypeScript in your config file. + +TypeScript config file loading is handled using [`tsm`](https://github.com/lukeed/tsm) and will respect your project's `tsconfig` options. + +See the [Configuring Astro Guide](/pl/guides/configuring-astro/) for details on setting configurations. + +### `tsconfig.json` + +This file is generated in every starter template and includes TypeScript configuration options for your Astro project. Some features (like npm package imports) aren’t fully supported in the editor without a `tsconfig.json` file. + +See the [TypeScript Guide](/pl/guides/typescript/) for details on setting configurations. From 20294ca195a18d863a429ec1d2084f975c8183ed Mon Sep 17 00:00:00 2001 From: Kacper Date: Wed, 2 Oct 2024 15:02:58 +0200 Subject: [PATCH 2/3] i18n(pl): Fixed typos --- .../docs/pl/basics/project-structure.mdx | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/src/content/docs/pl/basics/project-structure.mdx b/src/content/docs/pl/basics/project-structure.mdx index 5f45e0c2466b2..c0d9d7e447009 100644 --- a/src/content/docs/pl/basics/project-structure.mdx +++ b/src/content/docs/pl/basics/project-structure.mdx @@ -14,7 +14,7 @@ Poniżej przedstawimy Ci w jaki sposób projekt Astro jest zorganizowany oraz ja Astro wykorzystuje opiniowany układ folderów dla Twojego projektu. Każdy główny folder projektu Astro powinien zawierać następujące foldery i pliki: - `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, itp.) -- `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (czcionki, ikonki, itp.) +- `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (fonty, ikony, itp.) - `package.json` - Manifest projektu. - `astro.config.mjs` - Plik konfiguracyjny Astro. (zalecany) - `tsconfig.json` - Plik konfiguracyjny TypeScript. (zalecany) @@ -68,7 +68,7 @@ Podczas gdy ten przewodnik opisuje niektóre popularne pomysły użyte przez spo ### `src/components` -**Komponenty** są jednostkami wielekrotnego użytko dla Twoich stron HTML. Mogą być one [komponentami Astro](/pl/basics/astro-components/), lub [komponentami frameworków UI](/pl/guides/framework-components/) jak React bądź Vue. Podstawą jest aby grupować i organizować wszystkie komponenty Twojego folderu w tym folderze. +**Komponenty** są jednostkami wielekrotnego użytku dla Twoich stron HTML. Mogą być one [komponentami Astro](/pl/basics/astro-components/), lub [komponentami frameworków UI](/pl/guides/framework-components/) jak React bądź Vue. Podstawą jest aby grupować i organizować wszystkie komponenty Twojego folderu w tym folderze. Ta wszechobecna konwencja projektów Astro nie jest jednak wymagana. Organizuj swoje projekty jakkolwiek sobie zamarzysz! @@ -78,7 +78,7 @@ Folder `src/content/` ma na celu przechowywanie [kolekcji zawartości](/pl/guide ### `src/layouts` -[Layouty](/pl/basics/layouts/) to komponenty Astro, które definiują structurę UI współdzieloną przez jedną lub więcej [stron](/pl/basics/astro-pages/). +[Layouty](/pl/basics/layouts/) to komponenty Astro, które definiują strukturę UI współdzieloną przez jedną lub więcej [stron](/pl/basics/astro-pages/). Tak jak `src/components`, ten folder to znana, ale niewymagana konwencja. @@ -96,36 +96,36 @@ Powszechnym zamysłem jest przechowywanie Twoich plików CSS bądź Sass w `src/ ### `public/` -Folder `public/` jest dla plików i zasobów Twojego projekty, które nie muszą być przetworzone podczas procesu budowania Astro. Pliki z tego folderu będą skopiowane do folderu budowania w stanie nienaruszonym, a po tym Twoja strona zostanie stworzona. +Folder `public/` jest dla plików i zasobów Twojego projektu, które nie muszą być przetworzone podczas procesu budowania Astro. Pliki z tego folderu będą skopiowane do folderu budowania w stanie nienaruszonym, a po tym Twoja strona zostanie stworzona. -Takie zachowanie sprawia, że `public/` jest idealnym miejscem na podstawowe zasoby jak zdjęcia czy czcionki, lub dla specjalnych plików takich jak `robots.txt` i `manifest.webmanifest`. +Takie zachowanie sprawia, że `public/` jest idealnym miejscem na podstawowe zasoby jak zdjęcia czy fonty, lub dla specjalnych plików takich jak `robots.txt` i `manifest.webmanifest`. Możesz umieścić w `public/` pliki CSS i JavaScript, ale pamiętaj, że te pliki nie będą zoptymalizowane ani spakowane w Twoim finalnym projekcie. :::tip -Jako ogólna zasada, każdy plik CSS lub JavaScript napisany przez Ciebie, powinien się znajdować w folderze `src/`. +Ogólnie przyjmując, każdy plik CSS lub JavaScript napisany przez Ciebie powinien się znajdować w folderze `src/`. ::: ### `package.json` -This is a file used by JavaScript package managers to manage your dependencies. It also defines the scripts that are commonly used to run Astro (ex: `npm start`, `npm run build`). +Ten plik jest używany przez paczkę mendedżerów pakietów to zarządzania Twoimi zależnościami. Definiuje również powszechnie użyte skrypty do uruchamiania Astro (np. `npm start`, `npm run build`). -There are [two kinds of dependencies](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) you can specify in a `package.json`: `dependencies` and `devDependencies`. In most cases, these work the same: Astro needs all dependencies at build time, and your package manager will install both. We recommend putting all of your dependencies in `dependencies` to start, and only use `devDependencies` if you find a specific need to do so. +Znajdują się tu [dwa typy zależności](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file), które możesz określić jako `package.json`: `dependencies` i `devDependencies`. W większości przypadków oba pracują tak samo: Astro potrzebuje wszelkie zależności podczas budowy, a Twój menedżer paczki je zainstaluje. Zalecamy przechowywanie wszystkich Twoich zależności w `dependencies` na początek, oraz używać jedynie `devDependencies` gdy najdzie taka specyficzna potrzeba. -For help creating a new `package.json` file for your project, check out the [manual setup](/pl/install-and-setup/#manual-setup) instructions. +Aby wesprzeć tworzenie nowego pliku `package.json` dla Twojego projektu, sprawdź instrukcję [ręcznej instalacji](/pl/install-and-setup/#instalacja-ręczna). ### `astro.config.mjs` -This file is generated in every starter template and includes configuration options for your Astro project. Here you can specify integrations to use, build options, server options, and more. +Ten plik jest wygenerowany w każdym startowym szablonie i zawiera opcje konfiguracji dla Twojego projektu Astro. Tutaj możesz określić opcje budowania, opcje serwera, jakich integracji użyć i wiele więcej. -Astro supports several file formats for its JavaScript configuration file: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` and `astro.config.ts`. We recommend using `.mjs` in most cases or `.ts` if you want to write TypeScript in your config file. +Astro wspiera kilka formatów dla pliku konfiguracyjnego JavaScriptu: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` i `astro.config.ts`. Polecamy korzystanie z `.mjs` w większości przypadków, oraz z `.ts` w razie pisania w TypeScript. -TypeScript config file loading is handled using [`tsm`](https://github.com/lukeed/tsm) and will respect your project's `tsconfig` options. +Ładowanie pliku konfiguracyjnego TypeScript jest obsługiwane przez [`tsm`](https://github.com/lukeed/tsm) i będzie zwracał szczególną uwagę na Twoje opcje `tsconfig`. -See the [Configuring Astro Guide](/pl/guides/configuring-astro/) for details on setting configurations. +Zerknij na [Przewodnik Konfiguracji Astro](/pl/guides/configuring-astro/) aby poznać szczegóły opcji konfiguracyjnych. ### `tsconfig.json` -This file is generated in every starter template and includes TypeScript configuration options for your Astro project. Some features (like npm package imports) aren’t fully supported in the editor without a `tsconfig.json` file. +Gdy tworzysz szablon startowy ten plik już tam na Ciebie czeka, zawierając w sobie opcje konfiguracji TypeScript dla Twojego projektu Astro. Pewne funkcje (jak importy paczki npm) nie są w pełni wspierane w edytorze bez pliku `tsconfig.json`. -See the [TypeScript Guide](/pl/guides/typescript/) for details on setting configurations. +Zobacz na [Poradnik TypeScript](/pl/guides/typescript/) dla szczegółów ustawienia konfiguracji. From 8787e2248bea44f48ec6377aa8c063373d212fbe Mon Sep 17 00:00:00 2001 From: Kacper Date: Thu, 3 Oct 2024 10:17:02 +0200 Subject: [PATCH 3/3] i18n(pl): FIxes provided by Rezix --- src/content/docs/pl/basics/project-structure.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/content/docs/pl/basics/project-structure.mdx b/src/content/docs/pl/basics/project-structure.mdx index c0d9d7e447009..19d70bfc027ce 100644 --- a/src/content/docs/pl/basics/project-structure.mdx +++ b/src/content/docs/pl/basics/project-structure.mdx @@ -11,7 +11,7 @@ Poniżej przedstawimy Ci w jaki sposób projekt Astro jest zorganizowany oraz ja ## Foldery i Pliki -Astro wykorzystuje opiniowany układ folderów dla Twojego projektu. Każdy główny folder projektu Astro powinien zawierać następujące foldery i pliki: +Astro wykorzystuje z góry narzuconą strukturę folderów dla Twojego projektu. Każdy główny folder projektu Astro powinien zawierać następujące foldery i pliki: - `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, itp.) - `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (fonty, ikony, itp.) @@ -63,14 +63,14 @@ Astro przetwarza, optymalizuje i pakuje Twoje pliki z folderu `src/` aby stworzy Niektóre pliki (takie jak komponenty Astro) nie są nawet wysyłane w swojej postaci, tylko renderowane jako statyczny HTML. Inne pliki (jak CSS) są przesyłane do przeglądarki ale mogą być zoptymalizowane bądź spakowane z innymi plikami CSS dla lepszej wydajności. :::tip -Podczas gdy ten przewodnik opisuje niektóre popularne pomysły użyte przez społeczność Astro, to jedynymi folderami zarezerwowanymi przez samo Astro są `src/pages/` i `src/content/`. Masz wolną rękę aby zmieniać nazwy i reorganizować inne foldery w taki sposób, który jest dla Ciebie najlepszy. +Podczas gdy ten przewodnik opisuje niektóre popularne zasady użyte przez społeczność Astro, to jedynymi folderami zarezerwowanymi przez samo Astro są `src/pages/` i `src/content/`. Masz wolną rękę aby zmieniać nazwy i zmieniać układ innych folderów w taki sposób, który jest dla Ciebie najlepszy. ::: ### `src/components` -**Komponenty** są jednostkami wielekrotnego użytku dla Twoich stron HTML. Mogą być one [komponentami Astro](/pl/basics/astro-components/), lub [komponentami frameworków UI](/pl/guides/framework-components/) jak React bądź Vue. Podstawą jest aby grupować i organizować wszystkie komponenty Twojego folderu w tym folderze. +**Komponenty** są jednostkami wielekrotnego użytku dla Twoich stron HTML. Mogą być one [komponentami Astro](/pl/basics/astro-components/), lub [komponentami frameworków UI](/pl/guides/framework-components/) jak React bądź Vue. Powszechne jest aby grupować i organizować wszystkie komponenty Twojego folderu w tym folderze. -Ta wszechobecna konwencja projektów Astro nie jest jednak wymagana. Organizuj swoje projekty jakkolwiek sobie zamarzysz! +To jest powszechnie przyjęta praktyka w projektach Astro, lecz nie jest ona wymagana. Możesz dowolnie organizować swoje komponenty według własnych życzeń! ### `src/content` @@ -92,7 +92,7 @@ Tak jak `src/components`, ten folder to znana, ale niewymagana konwencja. ### `src/styles` -Powszechnym zamysłem jest przechowywanie Twoich plików CSS bądź Sass w `src/styles`, ale nie jest on konieczny. Tak długo jak Twoje style będą się znajdować w czeluściach folderu `src/` i będą one odpowiednio zaimportowane, Astro sobie z nimi poradzi i je zoptymalizuje. +Powszechnym zamysłem jest przechowywanie Twoich plików CSS bądź Sass w `src/styles`, ale nie jest on konieczny. Tak długo, jak Twoje style znajdują się gdziekolwiek w katalogu src/ i są poprawnie importowane, Astro zajmie się ich obsługą i optymalizacją. ### `public/` @@ -126,6 +126,6 @@ Zerknij na [Przewodnik Konfiguracji Astro](/pl/guides/configuring-astro/) aby po ### `tsconfig.json` -Gdy tworzysz szablon startowy ten plik już tam na Ciebie czeka, zawierając w sobie opcje konfiguracji TypeScript dla Twojego projektu Astro. Pewne funkcje (jak importy paczki npm) nie są w pełni wspierane w edytorze bez pliku `tsconfig.json`. +Ten plik jest generowany w każdym szablonie startowym i zawiera on opcje konfiguracji TypeScript dla Twojego projektu Astro. Niektóre funkcje (takie jak importy pakietów npm) nie są w pełni obsługiwane w edytorze bez pliku `tsconfig.json`. -Zobacz na [Poradnik TypeScript](/pl/guides/typescript/) dla szczegółów ustawienia konfiguracji. +Szczegóły dotyczące ustawień konfiguracji znajdziesz w [Przewodniku TypeScript](/pl/guides/typescript/).