Skip to content

Commit f522d1e

Browse files
erbierconlyhans-devyanthomasdev
authored
i18n(pl): update project-structure.mdx (#12800)
Co-authored-by: OnlyHans Dev <[email protected]> Co-authored-by: Yan <[email protected]>
1 parent 93b60ca commit f522d1e

File tree

1 file changed

+28
-22
lines changed

1 file changed

+28
-22
lines changed

src/content/docs/pl/basics/project-structure.mdx

Lines changed: 28 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Struktura projektu
3-
description: Naucz się, jak zorganizować projekt z Astro.
3+
description: Wstęp do podstawowej struktury projektów Astro.
44
i18nReady: true
55
---
66
import { FileTree } from '@astrojs/starlight/components';
@@ -13,7 +13,7 @@ Poniżej przedstawimy Ci w jaki sposób projekt Astro jest zorganizowany oraz ja
1313

1414
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:
1515

16-
- `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, itp.)
16+
- `src/*` - Kod źródłowy Twojego projektu. (komponenty, strony, style, obrazy, itp.)
1717
- `public/*` - Twoje nieprzetworzone, pozaprogramowe zasoby. (fonty, ikony, itp.)
1818
- `package.json` - Manifest projektu.
1919
- `astro.config.mjs` - Plik konfiguracyjny Astro. (zalecany)
@@ -27,43 +27,61 @@ Standardowy folder projektu Astro może wyglądać tak:
2727
- public/
2828
- robots.txt
2929
- favicon.svg
30-
- social-image.png
30+
- my-cv.pdf
3131
- src/
32+
- blog/
33+
- post1.md
34+
- post2.md
35+
- post3.md
3236
- components/
3337
- Header.astro
3438
- Button.jsx
39+
- images/
40+
- image1.jpg
41+
- image2.jpg
42+
- image3.jpg
3543
- layouts/
3644
- PostLayout.astro
3745
- pages/
3846
- posts/
39-
- post1.md
40-
- post2.md
41-
- post3.md
42-
- index.astro
47+
- [post].astro
48+
- about.astro
49+
- **index.astro**
50+
- rss.xml.js
4351
- styles/
4452
- global.css
53+
- content.config.ts
4554
- astro.config.mjs
4655
- package.json
4756
- tsconfig.json
4857
</FileTree>
4958

5059
### `src/`
5160

52-
Folder `src/` to miejsce, gdzie żyje większość kodu źródłowego Twojego projektu. Zawiera on:
61+
Folder `src/` to miejsce, gdzie znajduje się większość kodu źródłowego Twojego projektu. Zawiera on:
5362

5463
- [Strony](/pl/basics/astro-pages/)
5564
- [Layouty](/pl/basics/layouts/)
5665
- [Komponenty Astro](/pl/basics/astro-components/)
5766
- [Komponenty frameworków UI (React, itp.)](/pl/guides/framework-components/)
5867
- [Style (CSS, Sass)](/pl/guides/styling/)
5968
- [Pliki Markdown](/pl/guides/markdown-content/)
69+
- [Obrazy, które mają zostać zoptymalizowane i procesowane przez Astro](/pl/guides/images/)
6070

6171
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.
6272

6373
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.
6474

6575
:::tip
66-
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.
76+
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.
77+
:::
78+
79+
### `src/pages`
80+
81+
Ś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.
82+
83+
:::caution
84+
`src/pages` to **wymagany** podfolder Twojego projektu Astro. Bez tego Twoja strona nie będzie miała żadnych stron czy ścieżek!
6785
:::
6886

6987
### `src/components`
@@ -72,24 +90,12 @@ Podczas gdy ten przewodnik opisuje niektóre popularne zasady użyte przez społ
7290

7391
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ń!
7492

75-
### `src/content`
76-
77-
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ć.
78-
7993
### `src/layouts`
8094

8195
[Layouty](/pl/basics/layouts/) to komponenty Astro, które definiują strukturę UI współdzieloną przez jedną lub więcej [stron](/pl/basics/astro-pages/).
8296

8397
Tak jak `src/components`, ten folder to znana, ale niewymagana konwencja.
8498

85-
### `src/pages`
86-
87-
[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.
88-
89-
:::caution
90-
`src/pages` to **wymagany** podfolder Twojego projektu Astro. Bez tego Twoja strona nie będzie miała żadnych stron czy ścieżek!
91-
:::
92-
9399
### `src/styles`
94100

95101
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/
98104

99105
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.
100106

101-
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`.
107+
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`.
102108

103109
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.
104110

0 commit comments

Comments
 (0)