Telepítési leírás átstruktúrálása

sze-info · May 8, 2024 · 0d13935 · 0d13935
1 parent 744b330
commit 0d13935
Show file tree

Hide file tree

Showing 12 changed files with 69 additions and 99 deletions.
diff --git a/docs/README.md b/docs/README.md
@@ -15,6 +15,14 @@
 
 A tárgy összeállítása során olyan nemzetközileg is elismert egyetemek tananyagát vettük alapul, mint az MIT, ETH Zürich, TU München, Univerisity of Virginia vagy a Stanford University. A megfelelő licenc betarása mellett bizonyos tanangyag részeket át is vettünk, másokat inspirációként használtunk, [erről részletesen itt](https://github.com/sze-info/arj#acknowledgement) lehet olvasni. 2023-ban a tantárgy az ROS 2 Humble verzióját használja, ez a disztribúció 2027 májusáig támogatott.
 
+A tantárgy teljesítése például következő autóipari / autonóm járműves cégeknél előnyt jelenthet (ABC sorrendben):
+
+- [AiMotive Kft.](https://aimotive.com/) **(Budapest)**
+- [AVL Hungary Kft.](https://www.avl.com/en-hu/locations/avl-hungary-kft) **(Budapest, Érd, Kecskemét)**
+- [Bosch: Robert Bosch Kft.](https://www.bosch.hu/karrier/) **(Budapest, Győr, Zalaegerszeg)**
+- [Continental Autonomous Mobility Hungary Kft.](https://www.continental.com/hu-hu/vallalat/continental-vallalatok-magyarorszagon/am-hungary/) **(Budapest, Győr, Debrecen)**
+- [Járműipari Kutatóközpont, SZE](https://jkk-web.sze.hu/szakmai-kompetenciak/autonom-kozlekedesi-rendszerek-kozpont/) **(Győr)**
+
 
 {: .highlight }
 A tárgyban bemutatott ismeretekre alapozva diplomamunka, szakdolgozat, projektmunka, TDK dolgozat is készíthető, illetve van lehetőség a kötelező szakmai gyakorlat teljesítésére is.

diff --git a/docs/_images/gitworkflow01.gif b/docs/_images/gitworkflow01.gif
diff --git a/docs/bevezetes/linux.md b/docs/bevezetes/linux.md
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: Linux
+title: Linux, git
 parent: Bevezetés
 ---
 
@@ -154,6 +154,12 @@ A megszokott `ctrl`+`v`, `ctrl`+`c` helyett itt a `ctrl`+`shift`+`v`, `ctrl`+`sh
 >
 > A legtöbb művelet VS code-dal elvégezhető terminál nélkül is. [Erről bővebben itt lehet olvasni](https://sze-info.github.io/arj/bevezetes/vscode.html).
 
+
+<center><img src="https://raw.githubusercontent.com/sze-info/arj/main/docs/_images/gitworkflow01.gif" width="100%" /></center>
+
+*Forrás*: [link](https://www.linkedin.com/posts/chaima-haj-taher-1093881ba_git-softwaredevelopment-workflow-activity-7177685446787751936-atW_)
+
+
 ## Szöveges fájlok
 - `wget`: webes tartalmak letöltése terminalból
 - `cat`: fájl tartalmának kiíratása

diff --git a/docs/bevezetes/vscode.md b/docs/bevezetes/vscode.md
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: VS code IDE
+title: VS code, git
 parent: Bevezetés
 ---
 

diff --git a/docs/onallo/ros2git.md b/docs/onallo/ros2git.md
@@ -36,6 +36,10 @@ parent: Önálló feladatok
 - `git checkout -- .`: Minden nem staged (unstaged) változás elvetése lokálisan. VS code-ban kb ez a "discard all changes" parancs. (Újabb git verziókban a `git restore .` is hasonló módon működik.)
 - `git merge <branch_name>`: a jelenlegi branch-be mergeli a branch-t
 
+<center><img src="https://raw.githubusercontent.com/sze-info/arj/main/docs/_images/gitworkflow01.gif" width="100%" /></center>
+
+*Forrás*: [link](https://www.linkedin.com/posts/chaima-haj-taher-1093881ba_git-softwaredevelopment-workflow-activity-7177685446787751936-atW_)
+
 ## Terminológia
 
 - **Local repository**: a helyi munka repo, pl lokálisan a `~/ros2_ws/src/my_repo` 

diff --git a/docs/telepites/README.md b/docs/telepites/README.md
@@ -8,11 +8,17 @@ permalink: /telepites/
 
 # Telepítés
 
+{: .note-title }
+> ROS 2
+>
+> ROS 1 verziókat csak történelmi okokból tárgyalunk, a jelenlegi fejlesztésekhez a ROS 2-t ajánljuk.
+
 `ROS 1` alapvetően Linux rendszereken támogatott, bár voltak próbálkozások más operációs rendszerekre is. Ezzel szemben az `ROS 2` már támogatja a natív Windows, Mac OS vagy egyéb Real-Time operációs rendszen történő futtatást. Tehát alapvetően négy lehetőség adott:
-1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu)
-2. WSL2, könnyűsúlyú Linux virtuális gép Windowsra
-3. Virtuális gép Windowsra
-4. Windows build
+
+1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu) ✅ [leírás](https://sze-info.github.io/arj/telepites/ubuntu.html)
+2. Windows WSL2, könnyűsúlyú Linux virtuális gép ✅ [leírás](https://sze-info.github.io/arj/telepites/win10.html)
+3. Virtuális gép Windowsra 🟠
+4. Windows build 🟠
 
 Ebből a 4 lehetőségből az első kettőt ajánljuk, de telmészetesen a többi sem tiltott. A dual boot betekintést nyújt a Linux világba, ami egy mérnöknél hasznos tudást jelent manapság. Telepítésnél körültekintően kell eljárni, hiszen egy rossz beállítás adatvesztést okoz, így a biztonsági mentés is ajánlott. A WSL (Windows Subsystem for Linux) egy könnyűsúlyú kompatibilitási réteg Linux-alapú elemek futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Ahogy a következő ábrán is látszik, a Linux kernel ugyanolyan egyszerűen érheti el a hardverelemeket (CPU, memória, GPU), mint a Windows kernel. Ehhez képest a virtuális gép (3. lehetőség) egy jóval lassabb , több absztrakciós réteget használó megoldás, annak ajánlott, akinek vagy nagyon modern, gyors gépe van, vagy már eleve telepített ilyen rendszereket. A natív Windows build (4. lehetőség) elvileg adott, de mivel a dokumenátió túlnyomó része Linuxra érhető el, így nagyon sok extra munkát fog jelenteni.
 
@@ -42,7 +48,7 @@ Az első három opció szemléltetése:
 
 
 {: .warning }
-> Az ROS melodic python 2.7-et támogat.
+> Az ROS 1 melodic python 2.7-et támogat, ez nem ajánlott.
 
 # Ubuntu és Python
 

diff --git a/docs/telepites/ros_humble.md b/docs/telepites/ros_humble.md
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: ROS2 humble
+title: ROS 2 humble
 parent: Telepítés
 ---
 
@@ -19,13 +19,19 @@ parent: Telepítés
 
 
 
-# ROS2 humble
+# ROS 2 humble
 
-Alapvetően négy lehetőség adott `ROS 2 Humble` telepítésére:
-1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu 22.04)
-2. WSL2, könnyűsúlyú Linux virtuális gép Windowsra
-3. Virtuális gép Windowsra
-4. Windows build
+{: .note-title }
+> Egyszerű telepítés
+>
+> A telepítés lépésről-lépésre is végrehajtható, de készítettünk egy [egyszerű shell script alapú telepítést](#otthoni--géptermi-telepítés) is.
+
+Ahogy abevezetőben írtuk, alapvetően négy lehetőség adott `ROS 2 Humble` telepítésére:
+
+1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu) ✅ [leírás](https://sze-info.github.io/arj/telepites/ubuntu.html)
+2. Windows WSL2, könnyűsúlyú Linux virtuális gép ✅ [leírás](https://sze-info.github.io/arj/telepites/win10.html)
+3. Virtuális gép Windowsra 🟠
+4. Windows build 🟠
 
 Ebből a 4 lehetőségből az első kettőt ajánljuk, de telmészetesen a többi sem tiltott. A dual boot betekintést nyújt a Linux világba, ami egy mérnöknél hasznos tudást jelent manapság. Telepítésnél körültekintően kell eljárni, hiszen egy rossz beállítás adatvesztést okoz, így a biztonsági mentés is ajánlott. A WSL (Windows Subsystem for Linux) egy könnyűsúlyú kompatibilitási réteg Linux-alapú elemek futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Ahogy a következő ábrán is látszik, a Linux kernel ugyanolyan egyszerűen érheti el a hardverelemeket (CPU, memória, GPU stb), mint a Windows kernel. Ehhez képest a virtuális gép (3. lehetőség) egy jóval lassabb, több absztrakciós réteget használó megoldás, annak ajánlott, akinek vagy nagyon modern, gyors gépe van, vagy már eleve telepített ilyen rendszereket. A natív Windows build (4. lehetőség) elvileg adott, de mivel a dokumenátió túlnyomó része Linuxra érhető el, így nagyon sok extra munkát fog jelenteni.
 
@@ -150,7 +156,7 @@ Részletek: [docs.ros.org/en/humble/Tutorials/Beginner-Client-Libraries/Colcon-T
 
 # Otthoni / géptermi telepítés
 
-Gépteremben a [következő `install_humble.sh`](https://github.com/sze-info/arj/blob/main/docs/telepites/install_humble.sh) fájlt futtatuk minden gépen.
+Gépteremben a [következő `install_humble.sh`](https://github.com/sze-info/arj/blob/main/docs/telepites/install_humble.sh) fájlt (shell scriptet) futtatuk minden gépen.
 
 ``` bash
 wget https://raw.githubusercontent.com/sze-info/arj/main/docs/telepites/install_humble.sh

diff --git a/docs/telepites/ros_melodic.md b/docs/telepites/ros_melodic.md
diff --git a/docs/telepites/ros_noetic.md b/docs/telepites/ros_noetic.md
diff --git a/docs/telepites/ubuntu.md b/docs/telepites/ubuntu.md
@@ -0,0 +1,9 @@
+---
+layout: default
+title: Ubuntu dual boot
+parent: Telepítés
+---
+
+# Ubuntu dual boot
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/GXxTxBPKecQ?si=XDETin5TdhI0Uml3" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
diff --git a/docs/telepites/win10.md b/docs/telepites/win10.md
@@ -1,28 +1,37 @@
 ---
 layout: default
-title: Windows 10 WSL2
+title: Windows WSL2
 parent: Telepítés
 ---
 
-# Windows 10 WSL2
+# Windows WSL2
 
 A **Windows Subsystem for Linux** egy kompatibilitási réteg Linux-alapú elemek natív futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Akkor érdemes választani a WSL használatát, ha nem szeretnétek natív Ubuntu-t (pl 18.04 / 22.04) telepíteni a számítógépeitekre.
 
+A WSL telepítését bemutató Windows 11-es videó (Windows 10 lejjebb, de nagyrészt ugyanez):
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/DIYktkx3XLM?si=-cjaTd6PbhuFkXfY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+A videó lépései szövegesen:
+
 - Rendszergazdaként futtatva nyissatok egy PowerShell ablakot.
 - Másoljátok be az alábbi parancsot. Ezzel engedélyezitek a WSL használatát.
-```
+``` bash
 Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
 ```
-- Indítsátok újra a számítógépet az ```Y``` betű beírásával.
+- Indítsátok újra a számítógépet az ```Y``` betű beírásával. *(opcionális)*
 - Nyissátok meg a Microsoft Store-t, és keressetek rá a Windows Subsystem for Linux Preview-ra. Telepítsétek.
-- Szintén a Microsoft Store-ban keressetek rá az Ubuntu 22.04-re, és telepítsétek.
+- Szintén a Microsoft Store-ban keressetek rá az Ubuntu 22.04-re, és telepítsétek, **vagy** PowerShell (Admin):
+``` bash
+wsl --install -d Ubuntu-22.04
+```
 - A könnyebb kezelhetőség érdekében érdemes telepíteni a Windows Terminal programot is. Szintén a Microsoft Store-ban keressetek rá a Windows Terminal-ra, és telepítsétek.
 - Indítsátok el a Windows Terminal programot, és a Ctrl+, (Control és vessző) billentyűkombinációval nyissátok meg a beállításokat. A Default Profile beállítási sor legördülő listájából válasszátok az Ubuntu 22.04-et. 
 - Indítsátok újra a Windows Terminal-t. Az első induláskor adjatok meg tetszőleges felhasználónevet és jelszót. 
 - A megoldás kidolgozásához a VS Code szerkesztőt javasoljuk. Telepítsétek innen: [code.visualstudio.com/download](https://code.visualstudio.com/download)
 - Végül telepítsétek a VS Code Remote Development kiegészítőjét, hogy WSL használatával is elérhető legyen: [marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack)
 
-A WSL telepítését bemutató videó [itt](https://youtu.be/S1U-f5pzO7s) érhető el: 
+A WSL telepítését bemutató Windows 10-es videó [itt](https://youtu.be/S1U-f5pzO7s) érhető el: 
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/S1U-f5pzO7s?rel=0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 

diff --git a/docs/telepites/win11.md b/docs/telepites/win11.md