'README.md' módosítása

README.md

@@ -1,10 +1,12 @@
-# APT tárhely készítése
+# APT tároló készítése
 
-Apt tárhely létrehozása apache2 szerveren amely felhasználónév jelszó párossal (ez elhagyható) érhető el https protokollon. Az alábbi leírás a www.brickorama.hu szerveren készült, így minden hivatkozásban az található. A felhasználónév és jelszó kezelését az apache2 végzi, itt nem kerül kifejtésre, a leírásban ezekhez a [felhasználónév] és [jelszó] jelzéseket használom. Minden parancsot a domainhez tartozó felhasználó nevében adok ki, amit másra nem használok, így elkerülve pl. a pgp kulcs felülírását.
+Linuxra készült programok kézenfekvő terjesztési módja a beépített csomagkezelő használata.
+
+Az alábbiakban az APT csomagkezelőhöz szükséges tároló létrehozása kerül ismertetésre apache2 szerveren, amely felhasználónév jelszó párossal (ez elhagyható) érhető el https protokollon. Az alábbi leírás a www.brickorama.hu szerveren készült, így minden hivatkozásban az található. A felhasználónév és jelszó kezelését az apache2 végzi, itt nem kerül kifejtésre, a leírásban ezekhez a [felhasználónév] és [jelszó] jelzések használatosak. Minden parancs a domainhez tartozó felhasználó (brickorama.hu) nevében került kiadásra, ami másra nincs használva, így elkerülhető pl. a pgp kulcs felülírása.
 
 ## A tároló aláírásához szükséges PGP kulcs létrehozása
 
-A kulcspár generálását a gpg --batch kapcsolójával érdemes megtenni, így a program nem interaktív és könnyebben megismételhető a folyamat. Ehhez kell egy sablonfájl, az alábbi egy soha le nem járó kulcsot készít.
+A kulcspár generálását a **gpg --batch** kapcsolójával érdemes megtenni, így a program nem interaktív és könnyebben megismételhető a folyamat. Ehhez kell egy sablonfájl, az alábbi paranccsal egy soha le nem járó kulcshoz szükséges sablon készíthető.
 ```
 echo "%echo Generating PGP key
 Key-Type: RSA
@@ -15,7 +17,7 @@ Expire-Date: 0
 %no-ask-passphrase
 %no-protection
 %commit
-" >  /tmp/brickorama.hu-pgp-key.batch
+" > /tmp/brickorama.hu-pgp-key.batch
 ```
 
 Kulcspár generálása.
@@ -28,18 +30,25 @@ A generált kulcs ellenőrzése.
 gpg --list-keys
 ```
 
-Ez a kulcs tartalmazza a privát és publikus kulcsot is, az apt tároló használatához a publikus kulcs szükséges (lásd később), így ki kell exportálni, célszerűen a www gyökerébe.
+Ez a kulcs tartalmazza a privát és publikus kulcsot is, az apt tároló használatához a publikus kulcs szükséges (lásd később), így ki kell exportálni, célszerűen a **www** gyökerébe.
 ```
  gpg --armor --export brickorama.hu > ~/www/pgp-key.public
 ```
 
 ## A tároló létrehozása
 
-A webkiszolgálón szükség van egy alkönyvtárra, ez lesz a tároló URL-e.
+Az apt **sources.list** fájlában az alábbi formátumban kell megadni egy tárolót.
+```
+deb url disztribúció [komponens1] [komponens2] [...]
+```
+Egyszerű tárolóhoz lehet használni a gyökérkönyvtárat disztribúció gyanánt (**/**), de érdemes eleve létrehozni legalább egy disztribúciót egy komponenssel, a későbbi könnyű bővíthetség céljából.
+
+Ehhez a webkiszolgálón szükség van egy alkönyvtárra, ez lesz a tároló **url**-e, ha szükséges az autentikáció, ehhez a könyvtárhoz kell beállítani.
 ```
 mkdir ~/www/apt-repo
 ```
 
+A disztribúció
 
 apt-ftparchive --arch armhf packages pool/rpi4/main/ > dists/rpi4/main/binary-armhf/Packages
 
@@ -58,7 +67,7 @@ wget -q -O - https://www.brickorama.hu/pgp-key.public | apt-key add -
 
 Ez után a források közé fel kell venni a tárolót.
 ```
-echo "deb https://www.brickorama.hu/apt-repo stable main" | tee /etc/apt/sources.list.d/brickorama.hu.list
+echo "deb https://www.brickorama.hu/apt-repo stable main" > /etc/apt/sources.list.d/brickorama.hu.list
 ```
 
 Amennyiben a tárhely jelszó védett, fel kell venni egy autentikációs fájlt az apt számára.
@@ -68,7 +77,7 @@ login [felhasználónév]
 password [jelszó]" > /etc/apt/auth.conf.d/brickorama.hu.conf
 ```
 
-A apt tárhely használatra kész.
+A apt tároló használatra kész!
 ```
 apt-get update
 ```