fix: examples -> cookbook

Tresjs · Mar 7, 2024 · f13b8fe · f13b8fe
1 parent 0d09ec3
commit f13b8fe
Show file tree

Hide file tree

Showing 10 changed files with 84 additions and 15 deletions.
diff --git a/docs/.vitepress/config/pl.ts b/docs/.vitepress/config/pl.ts
@@ -60,20 +60,20 @@ export const plConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
         ],
       },
       {
-        text: "Przykłady",
+        text: "Książka kucharska 🍳🧑‍🍳",
         collapsed: true,
         items: [
-          { text: "Sterowanie orbitą", link: "/pl/examples/orbit-controls" },
+          { text: "Sterowanie orbitą", link: "/pl/cookbook/orbit-controls" },
           {
             text: "Podstawowe animacje",
-            link: "/pl/examples/basic-animations",
+            link: "/pl/cookbook/basic-animations",
           },
-          { text: "Grupy", link: "/pl/examples/groups" },
-          { text: "Ładowanie tekstur", link: "/pl/examples/load-textures" },
-          { text: "Ładowanie modelu", link: "/pl/examples/load-models" },
-          { text: "Ładowanie tekstu", link: "/pl/examples/text-3d" },
-          { text: "Światła i cienie", link: "/pl/examples/lights-shadows" },
-          { text: "Shadery", link: "/pl/examples/shaders" },
+          { text: "Grupy", link: "/pl/cookbook/groups" },
+          { text: "Ładowanie tekstur", link: "/pl/cookbook/load-textures" },
+          { text: "Ładowanie modelu", link: "/pl/cookbook/load-models" },
+          { text: "Ładowanie tekstu", link: "/pl/cookbook/text-3d" },
+          { text: "Światła i cienie", link: "/pl/cookbook/lights-shadows" },
+          { text: "Shadery", link: "/pl/cookbook/shaders" },
         ],
       },
       {

diff --git a/docs/pl/examples/basic-animations.md → docs/pl/cookbook/basic-animations.md b/docs/pl/examples/basic-animations.md → docs/pl/cookbook/basic-animations.md
@@ -1,3 +1,11 @@
+---
+title: Podstawowe animacje
+description: Jak używać kompozycji useRenderLoop do animowania swoich obiektów.
+author: alvarosabu
+thumbnail: /recipes/animations.png
+difficulty: 0
+---
+
 # Podstawowe animacje
 
 Ten przewodnik pomoże ci rozpocząć pracę z podstawowymi animacjami w TresJS.

diff --git a/docs/pl/examples/groups.md → docs/pl/cookbook/groups.md b/docs/pl/examples/groups.md → docs/pl/cookbook/groups.md
@@ -1,3 +1,11 @@
+---
+title: Grupa
+description: Naucz się, jak grupować wiele obiektów na scenie.
+author: alvarosabu
+thumbnail: /recipes/groups.png
+difficulty: 0
+---
+
 # Grupa
 
 `<TresGroup>` to instancja klasy [THREE.Group](https://threejs.org/docs/#api/en/objects/Group), która jest prawie taka sama jak [THREE.Object3D](https://threejs.org/docs/#api/en/objects/Object3D), ale pozwala na **grupowanie wielu obiektów w scenie**, aby mogły być manipulowane jako jednostka (przesuwanie, obracanie itp.).

diff --git a/docs/pl/cookbook/index.md b/docs/pl/cookbook/index.md
@@ -0,0 +1,5 @@
+# Książka kucharska 🍳🧑‍🍳
+
+Odkryj przewodniki po recepturach, które pomogą Ci rozpocząć korzystanie z podstaw Tres. Każda receptura została zaprojektowana, aby pomóc Ci zrozumieć główne koncepcje Tres i jak je wykorzystać w Twoich projektach.
+
+<Cookbook />
diff --git a/docs/pl/examples/lights-shadows.md → docs/pl/cookbook/lights-shadows.md b/docs/pl/examples/lights-shadows.md → docs/pl/cookbook/lights-shadows.md
@@ -1,4 +1,12 @@
-# Światło i Cienie
+---
+title: Światła i Cienie
+description: Naucz się, jak dodawać światła i cienie do swojej sceny.
+author: alvarosabu
+thumbnail: /recipes/lights-and-shadows.png
+difficulty: 0
+---
+
+# Światła i Cienie
 
 Ten przewodnik pomoże Ci rozpocząć pracę z prostym oświetleniem i cieniami w TresJS.
 
@@ -10,7 +18,7 @@ Zbudujemy prostą scenę z trzema meshami i płaszczyzną, ale tylko dwa z nich
 
 Konfiguracja sceny (opcjonalne)
 Importujemy wszystkie moduły, których potrzebujemy, dla większej wygody możemy użyć orbit-controls z pakietu cientos,
-[zobacz tutaj, aby dowiedzieć się jak](/examples/orbit-controls).
+[zobacz tutaj, aby dowiedzieć się jak](/cookbook/orbit-controls).
 
 Umieśćmy cztery obiekty w naszej scenie, jeden z nich będzie płaszczyzną, która odbierze cienie, dwa z nich będą rzutować cienie, a ostatni nie będzie rzutował żadnych cieni w ogóle.
 
@@ -119,7 +127,7 @@ Podobnie jak w poprzednim kroku, ustawiamy siatkę, którą chcemy, aby rzuciła
 </template>
 ```
 
-eraz mamy wszystkie niezbędne kroki, aby dodać cienie do naszej sceny, a jeśli zastosujemy to, co się nauczyliśmy w [podstawowych animacjach](/examples/basic-animations), i dodamy ruch do naszego sześcianu, zauważysz, że cień również animuje się 🤩
+eraz mamy wszystkie niezbędne kroki, aby dodać cienie do naszej sceny, a jeśli zastosujemy to, co się nauczyliśmy w [podstawowych animacjach](/cookbook/basic-animations), i dodamy ruch do naszego sześcianu, zauważysz, że cień również animuje się 🤩
 
 ```vue
 <script setup>

diff --git a/docs/pl/examples/load-models.md → docs/pl/cookbook/load-models.md b/docs/pl/examples/load-models.md → docs/pl/cookbook/load-models.md
@@ -1,3 +1,11 @@
+---
+title: Wczytywanie Modeli
+description: Wczytaj modele 3D do swoich scen w Tres.
+author: alvarosabu
+thumbnail: /recipes/gltf-model.png
+difficulty: 1
+---
+
 # Wczytywanie Modeli
 
 > Wszystkie modele używane w tej instrukcji pochodzą od [Alvaro Saburido](https://sketchfab.com/3d-models/aku-aku-7dfcb6edf10b4098bbb965c56fd3055c).

diff --git a/docs/pl/examples/load-textures.md → docs/pl/cookbook/load-textures.md b/docs/pl/examples/load-textures.md → docs/pl/cookbook/load-textures.md
@@ -1,3 +1,11 @@
+---
+title: Ładowanie tekstur
+description: Dodaj mapy tekstur do swoich obiektów w TresJS.
+author: alvarosabu
+thumbnail: /recipes/load-textures.png
+difficulty: 1
+---
+
 # Ładowanie tekstur
 
 > Wszystkie tekstury używane w tym przykładzie pochodzą z [ambientcg](https://ambientcg.com/).

diff --git a/docs/pl/examples/orbit-controls.md → docs/pl/cookbook/orbit-controls.md b/docs/pl/examples/orbit-controls.md → docs/pl/cookbook/orbit-controls.md
@@ -1,3 +1,11 @@
+---
+title: OrbitControls
+description: Jak korzystać z OrbitControls do interakcji ze sceną.
+author: alvarosabu
+thumbnail: /recipes/orbit-controls.png
+difficulty: 1
+---
+
 # OrbitControls
 
 <SandboxDemo url="https://play.tresjs.org/#eNqVVU1z2zYQ/Ss78nR0KEVSlp1JWaejWk7TdmInY+kW5gCRMAkbBDAAKFnj0X/PAhAlyvlydBJ23z7svl0snwYLTc3fSsWrlg6ywYUpNFMWDLWtAk5E9SYfWJMP/soFa5TUFp7gkhhWzGtSyvU1URHMb99dziSXeq5IQSO4kQspKLoUExVs4U7LBoa21pQO/+zxuKtnRKyI2YOmFm33JimkPsZ+0EtmZ1JYLbmJYEEf7eTq6zBGhZXGRSZJiIFiFwTLDWAUFSVmlYtcoMNYqDi8gadcABScEu3ryGB48vr06nJ2Poycx/haTQZWt9RbCFc1yeCOcBMMAYI1LzaKZs8lcgjZWtViCZ1O2XPdHMgehMuOdUT3Fsu6SEKHsB94sLRRnFiKJ4CLnp6r0ZKJEntXcd87wJ/3f6TaKFpYtqIz0lBNIFPSMMukQPSnswgmEfzxOR9A0oUdSX8wz1skEibcHfh9U7ojHDOnEYwjSJH5ALAYgL4ZZ8UD3AzhSpOq77/DS9FfW6tMliSarOOK2bpdtoZq11fsdlzIJnGVYfuJwbk1SUOYSFysSf5hmsxkSW9p1XKi43sjBdbWXbHPfafONTX1jdQN4deoqmaE7+tFRBIK7ARIningGa6YdupKQfh7VtX2KxFOIzhz8mbMpY+uDTrG8SmaCmLsKAzSQWZH+k6z8l/KFdU7O6ay7zUaLpLeIODR2A13f2vbcJybpSw3YcQboismMkhxkgAUKd1b6I41dQlnME7T37xhzUpb78/bXJzgKAain2ABlqR4qLRsRTkqwpM6SVN3D9LgDPsEB9EgvO9RQ5RvDW4gT5/vHLh4snChs/WXg3McJqMoBcaXlLOVjgW1iVBN0odPJ/F5nCYlMzZxZkTnA//ijojD+vgV7hCB9K/69Dvz8S12TcmDIuIlue+x07M4jcc75s4YN8zF9Lndcn0Jr8NNkfH8Neb7OzVNXwb8BuDLerG+Pfh0nHqBcenQx7g5VneHw8nWtPwF4hDwI2oEjkrasBeQdlBX/Fn8KuFs2ad0jDiaW5xJa3C13LHq2UTinlGMU/1Budd8PJmEc7n+39v2nwgfU9Pi4Rv2e/MYUv6Iw0L1CuU+tBLfKLXB/XZ+gyun52xk2fJdc77jvKVG8tblGGCX+AYx7R7OZ/uff2D4/Bfmrfsqmq6oo0Qtfs289VO3BfezFgyfvXAe79sx+4FKh8om8WQv+PYLbBTQQA==" />

diff --git a/docs/pl/examples/shaders.md → docs/pl/cookbook/shaders.md b/docs/pl/examples/shaders.md → docs/pl/cookbook/shaders.md
@@ -1,3 +1,11 @@
+---
+title: Shadery
+description: Shadery otwierają świat nieograniczonych możliwości.
+author: alvarosabu
+thumbnail: /recipes/shaders.png
+difficulty: 2
+---
+
 # Shadery
 
 To przewodnik pomoże Ci rozpocząć pracę ze shaderami w TresJS.
@@ -13,7 +21,7 @@ _Wymagana jest podstawowa wiedza na temat działania shaderów_
 ## Konfiguracja sceny (opcjonalnie)
 
 Importujemy wszystkie moduły, których potrzebujemy, dla wygody możemy użyć orbit-controls z cientos,
-[zobacz tutaj, aby dowiedzieć się jak](/examples/orbit-controls).
+[zobacz tutaj, aby dowiedzieć się jak](/cookbook/orbit-controls).
 
 Teraz umieśćmy naszą kamerę w pozycji `[11,11,11]`.
 
@@ -107,7 +115,7 @@ void main() {
 
 ## Animowanie bloba
 
-Podobnie jak w przypadku przykładu [Podstawowe animacje](/examples/basic-animations), zaczynamy od odwołania się do naszego bloba, używając [Template Ref](https://vuejs.org/guide/essentials/template-refs.html)
+Podobnie jak w przypadku przykładu [Podstawowe animacje](/cookbook/basic-animations), zaczynamy od odwołania się do naszego bloba, używając [Template Ref](https://vuejs.org/guide/essentials/template-refs.html)
 
 ```vue
 <script setup lang="ts">

diff --git a/docs/pl/examples/text-3d.md → docs/pl/cookbook/text-3d.md b/docs/pl/examples/text-3d.md → docs/pl/cookbook/text-3d.md
@@ -1,4 +1,12 @@
-# Texto3D
+---
+title: Text 3D
+description: Dodaj tekst 3D z łatwością.
+author: alvarosabu
+thumbnail: /recipes/text-3d.png
+difficulty: 1
+---
+
+# Tekst 3D
 
 [TextGeometry](https://threejs.org/docs/index.html?q=text#examples/en/geometries/TextGeometry) to jedna z metod, dzięki której możemy dodać tekst w 3D do naszej sceny.