Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 28 additions & 22 deletions src/content/docs/pl/basics/project-structure.mdx
Original file line number Diff line number Diff line change
@@ -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';
Expand All @@ -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)
Expand All @@ -27,43 +27,61 @@ 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
</FileTree>

### `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/)
- [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/)
- [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`
Expand All @@ -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ą.
Expand All @@ -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.

Expand Down