diff --git a/src/content/docs/pl/basics/project-structure.mdx b/src/content/docs/pl/basics/project-structure.mdx index 072c3b498f49d..0d57724613783 100644 --- a/src/content/docs/pl/basics/project-structure.mdx +++ b/src/content/docs/pl/basics/project-structure.mdx @@ -1,6 +1,6 @@ --- title: Struktura projektu -description: Naucz się, jak zorganizować projekt z Astro. +description: Wstęp do podstawowej struktury projektów Astro. i18nReady: true --- import { FileTree } from '@astrojs/starlight/components'; @@ -13,7 +13,7 @@ Poniżej przedstawimy Ci w jaki sposób projekt Astro jest zorganizowany oraz ja 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.) +- `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, obrazy, itp.) - `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (fonty, ikony, itp.) - `package.json` - Manifest projektu. - `astro.config.mjs` - Plik konfiguracyjny Astro. (zalecany) @@ -27,21 +27,30 @@ Standardowy folder projektu Astro może wyglądać tak: - public/ - robots.txt - favicon.svg - - social-image.png + - my-cv.pdf - src/ + - blog/ + - post1.md + - post2.md + - post3.md - components/ - Header.astro - Button.jsx + - images/ + - image1.jpg + - image2.jpg + - image3.jpg - layouts/ - PostLayout.astro - pages/ - posts/ - - post1.md - - post2.md - - post3.md - - index.astro + - [post].astro + - about.astro + - **index.astro** + - rss.xml.js - styles/ - global.css + - content.config.ts - astro.config.mjs - package.json - tsconfig.json @@ -49,7 +58,7 @@ Standardowy folder projektu Astro może wyglądać tak: ### `src/` -Folder `src/` to miejsce, gdzie żyje większość kodu źródłowego Twojego projektu. Zawiera on: +Folder `src/` to miejsce, gdzie znajduje się większość kodu źródłowego Twojego projektu. Zawiera on: - [Strony](/pl/basics/astro-pages/) - [Layouty](/pl/basics/layouts/) @@ -57,13 +66,22 @@ Folder `src/` to miejsce, gdzie żyje większość kodu źródłowego Twojego pr - [Komponenty frameworków UI (React, itp.)](/pl/guides/framework-components/) - [Style (CSS, Sass)](/pl/guides/styling/) - [Pliki Markdown](/pl/guides/markdown-content/) +- [Obrazy, które mają zostać zoptymalizowane i procesowane przez Astro](/pl/guides/images/) 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 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. +Podczas gdy ten przewodnik opisuje niektóre popularne zasady użyte przez społeczność Astro, to jedynym folderem zarezerwowanym przez samo Astro jest `src/pages/`. 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/pages` + +Ścieżki do podstron powstają po dodaniu [pliku w obsługiwanym formacie](/pl/basics/astro-pages/#obsługiwane-typy-plików-stron) do tego katalogu. + +:::caution +`src/pages` to **wymagany** podfolder Twojego projektu Astro. Bez tego Twoja strona nie będzie miała żadnych stron czy ścieżek! ::: ### `src/components` @@ -72,24 +90,12 @@ Podczas gdy ten przewodnik opisuje niektóre popularne zasady użyte przez społ 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` - -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ą 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. -### `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 znajdują się gdziekolwiek w katalogu src/ i są poprawnie importowane, Astro zajmie się ich obsługą i optymalizacją. @@ -98,7 +104,7 @@ Powszechnym zamysłem jest przechowywanie Twoich plików CSS bądź Sass w `src/ 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 fonty, lub dla specjalnych plików takich jak `robots.txt` i `manifest.webmanifest`. +Takie zachowanie sprawia, że `public/` jest idealnym miejscem na podstawowe zasoby, które nie wymagają żadnego procesowania, takie 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.