oprava README

This commit is contained in:
archos 2025-06-05 21:10:11 +02:00
parent a40767dbd5
commit 11b65fdba7

View File

@ -14,27 +14,36 @@ Tento projekt poskytuje skripty pro rychlou instalaci a konfiguraci základních
Pro stažení a instalaci projektu postupujte podle následujících kroků: Pro stažení a instalaci projektu postupujte podle následujících kroků:
1. Klonujte repozitář: 1. Klonujte repozitář:
```bash ```bash
git clone https://git.arch-linux.cz/Archos/Archlinux_I3.git git clone https://git.arch-linux.cz/Archos/Archlinux_I3.git
``` ```
2. Přejděte do adresáře repozitáře: 2. Přejděte do adresáře repozitáře:
```bash ```bash
cd Archlinux_I3 cd Archlinux_I3
``` ```
3. Nastavte skripty jako spustitelné pomocí následujících příkazů v kořenovém adresáři: 3. Nastavte skripty jako spustitelné pomocí následujících příkazů v kořenovém adresáři:
- Pro změnu oprávnění všech souborů s příponou `.sh` ve stávajícím adresáři: - Pro změnu oprávnění všech souborů s příponou `.sh` ve stávajícím adresáři:
```bash ```bash
chmod +x *.sh chmod +x *.sh
``` ```
4.
4.
- Pro změnu oprávnění všech souborů s příponou `.sh` ve stávajícím adresáři i v podadresářích: - Pro změnu oprávnění všech souborů s příponou `.sh` ve stávajícím adresáři i v podadresářích:
```bash ```bash
find . -type f -name "*.sh" -exec chmod +x {} \; find . -type f -name "*.sh" -exec chmod +x {} \;
``` ```
## Popis skriptů a jejich instalace ## Popis skriptů a jejich instalace
- **install_packages.sh** - Tento skript instaluje základní balíčky, které jsou potřebné pro systém a pro správné fungování správce oken i3. Seznam balíčků k instalaci je definován v - **install_packages.sh** - Tento skript instaluje základní balíčky, které jsou potřebné pro systém a pro správné fungování správce oken i3. Seznam balíčků k instalaci je definován v
souboru `packages-repository.txt`. souboru `packages-repository.txt`.
Spustí se příkazem: Spustí se příkazem:
@ -45,31 +54,34 @@ Pro stažení a instalaci projektu postupujte podle následujících kroků:
- **install_yay.sh / install_paru.sh** - **install_yay.sh / install_paru.sh**
- Tyto skripty jsou určeny pro instalaci balíčků z Arch User Repository (AUR). Každý skript nejprve ověří, zda je nainstalován `git` a příslušný pomocník pro AUR (`yay` nebo `paru`). Pokud nejsou nainstalovány, skript je automaticky nainstaluje. - Tyto skripty jsou určeny pro instalaci balíčků z Arch User Repository (AUR). Každý skript nejprve ověří, zda je nainstalován `git` a příslušný pomocník pro AUR (`yay` nebo `paru`). Pokud nejsou nainstalovány, skript je automaticky nainstaluje.
- Dále instaluje balíčky specifikované v proměnné `package_name`. Výchozí nastavení zahrnuje instalaci aplikací: - Dále instaluje balíčky specifikované v proměnné `package_name`. Výchozí nastavení zahrnuje instalaci aplikací:
- **autotiling** - Nástroj pro automatické přepínání orientace dlaždic v i3 nebo sway podle aktuálního layoutu. - **autotiling** - Nástroj pro automatické přepínání orientace dlaždic v i3 nebo sway podle aktuálního layoutu.
- **picom** - Kompozitní manažer pro Xorg, vylepšující vizuální výkon a poskytující efekty jako průhlednost a stínování oken. - **picom** - Kompozitní manažer pro Xorg, vylepšující vizuální výkon a poskytující efekty jako průhlednost a stínování oken.
Spustí se příkazem (v závislosti na vaší volbě): Spustí se příkazem (v závislosti na vaší volbě):
```bash ```bash
./install_yay.sh ./install_yay.sh
``` ```
nebo nebo
```bash ```bash
./install_paru.sh ./install_paru.sh
``` ```
- **pacman_packages.sh** - Tento skript je určen pro instalaci širokého spektra aplikací, které osobně preferuji pro každodenní použití v Arch Linuxu. Seznam aplikací obsahuje esenciální nástroje jako Firefox a Vim, multimediální aplikace jako SMPlayer a VLC, nástroje pro správu souborů jako Thunar a PCManFM, kancelářský balík LibreOffice a mnoho dalších. Skript dále aktualizuje systém před instalací balíčků, aby zajistil, že jsou instalovány nejnovější dostupné verze. Skript je nastaven tak, aby nevyžadoval potvrzení během instalace, což zrychluje proces. - **pacman_packages.sh** - Tento skript je určen pro instalaci širokého spektra aplikací, které osobně preferuji pro každodenní použití v Arch Linuxu. Seznam aplikací obsahuje esenciální nástroje jako Firefox a Vim, multimediální aplikace jako SMPlayer a VLC, nástroje pro správu souborů jako Thunar a PCManFM, kancelářský balík LibreOffice a mnoho dalších. Skript dále aktualizuje systém před instalací balíčků, aby zajistil, že jsou instalovány nejnovější dostupné verze. Skript je nastaven tak, aby nevyžadoval potvrzení během instalace, což zrychluje proces.
Skript je konfigurován pro snadnou úpravu, takže můžete přidat nebo odebrat aplikace podle vašich potřeb. Spustí se příkazem: Skript je konfigurován pro snadnou úpravu, takže můžete přidat nebo odebrat aplikace podle vašich potřeb. Spustí se příkazem:
```bash ```bash
./pacman_packages.sh ./pacman_packages.sh
``` ```
- **move_config_files.sh** Tento skript, automatizuje přesun konfiguračních souborů z naklonovaného repozitáře do odpovídajících složek v domovském adresáři.
- **move_config_files.sh** Tento skript, automatizuje přesun konfiguračních souborů z naklonovaného repozitáře do odpovídajících složek v domovském adresáři.
Upravte cesty: Upravte proměnné REPO_PATH a HOME_PATH tak, aby odpovídaly vašim cestám k naklonovanému repozitáři a vašemu domovskému adresáři. Upravte cesty: Upravte proměnné REPO_PATH a HOME_PATH tak, aby odpovídaly vašim cestám k naklonovanému repozitáři a vašemu domovskému adresáři.
Spusťte skript: Spusťte skript z terminálu příkazem Spusťte skript: Spusťte skript z terminálu příkazem
```bash ```bash
./move_config_files.sh ./move_config_files.sh
@ -91,16 +103,19 @@ Spusťte skript: Spusťte skript z terminálu příkazem
```bash ```bash
wget https://git.arch-linux.cz/Archos/Archlinux_I3/raw/branch/main/auto_install_i3.sh wget https://git.arch-linux.cz/Archos/Archlinux_I3/raw/branch/main/auto_install_i3.sh
``` ```
2. Nastavte skript jako spustitelný: 2. Nastavte skript jako spustitelný:
```bash ```bash
chmod +x auto_install_i3.sh chmod +x auto_install_i3.sh
``` ```
3. Spusťte skript: 3. Spusťte skript:
```bash ```bash
./auto_install_i3.sh ./auto_install_i3.sh
``` ```
Skript vám nabídne možnost upravit seznam balíčků před jejich instalací a zvolit mezi nástroji pro správu [AUR](https://wiki.archlinux.org/title/Arch_User_Repository), jako jsou Yay nebo Paru. Skript vám nabídne možnost upravit seznam balíčků před jejich instalací a zvolit mezi nástroji pro správu [AUR](https://wiki.archlinux.org/title/Arch_User_Repository), jako jsou Yay nebo Paru.
Po dokončení instalace Po dokončení instalace
@ -116,34 +131,41 @@ Skript nabízí možnost odstranit klonovaný repozitář a dočasné soubory, c
```bash ```bash
Chcete smazat složku s repozitářem? (y/n) Chcete smazat složku s repozitářem? (y/n)
``` ```
## Struktura Konfigurační Složky ## Struktura Konfigurační Složky
Projekt obsahuje klíčové konfigurační složky v adresáři .config, které jsou zásadní pro nastavení a personalizaci vašeho systému. Mnohé z těchto konfiguračních souborů jsou inspirovány nebo přímo převzaty z projektu EndeavourOS, což přináší osvědčené nastavení pro Arch Linux a jeho deriváty. Každá složka má specifický účel: Projekt obsahuje klíčové konfigurační složky v adresáři .config, které jsou zásadní pro nastavení a personalizaci vašeho systému. Mnohé z těchto konfiguračních souborů jsou inspirovány nebo přímo převzaty z projektu EndeavourOS, což přináší osvědčené nastavení pro Arch Linux a jeho deriváty. Každá složka má specifický účel:
### `/dunst` ### `/dunst`
- **Účel**: Obsahuje konfigurační soubory pro `dunst`, což je démon pro zobrazení notifikací v systému. Umožňuje přizpůsobení vzhledu a chování notifikací. - **Účel**: Obsahuje konfigurační soubory pro `dunst`, což je démon pro zobrazení notifikací v systému. Umožňuje přizpůsobení vzhledu a chování notifikací.
### `/gtk-3.0` ### `/gtk-3.0`
- **Účel**: Tato složka obsahuje konfigurační soubory pro GTK+ 3 aplikace, což zahrnuje nastavení témat, ikon a dalších grafických prvků. - **Účel**: Tato složka obsahuje konfigurační soubory pro GTK+ 3 aplikace, což zahrnuje nastavení témat, ikon a dalších grafických prvků.
### `/i3` ### `/i3`
- **Účel**: Hlavní konfigurační soubory pro správce oken i3. Zde naleznete soubory pro nastavení klávesových zkratek, vzhledu a dalších funkcí i3. - **Účel**: Hlavní konfigurační soubory pro správce oken i3. Zde naleznete soubory pro nastavení klávesových zkratek, vzhledu a dalších funkcí i3.
### `/i3/scripts` ### `/i3/scripts`
- **Účel**: Skripty specifické pro i3, které mohou zahrnovat utility pro správu okenních uspořádání, automatické spouštění aplikací a další. - **Účel**: Skripty specifické pro i3, které mohou zahrnovat utility pro správu okenních uspořádání, automatické spouštění aplikací a další.
### `/nano` ### `/nano`
- **Účel**: Konfigurační soubory pro textový editor Nano, včetně nastavení syntaxového zvýraznění a dalších editorových preferencí. - **Účel**: Konfigurační soubory pro textový editor Nano, včetně nastavení syntaxového zvýraznění a dalších editorových preferencí.
### `/rofi` ### `/rofi`
- **Účel**: Složka pro `rofi`, moderní zástupce tradičního dialogového okna pro spouštění programů. Obsahuje konfigurace, které definují vzhled a chování tohoto nástroje. - **Účel**: Složka pro `rofi`, moderní zástupce tradičního dialogového okna pro spouštění programů. Obsahuje konfigurace, které definují vzhled a chování tohoto nástroje.
### `/xfce4/terminal` ### `/xfce4/terminal`
- **Účel**: Nastavení pro terminál Xfce4, které umožňují přizpůsobení schémat barev, písma a dalších aspektů vzhledu terminálu. - **Účel**: Nastavení pro terminál Xfce4, které umožňují přizpůsobení schémat barev, písma a dalších aspektů vzhledu terminálu.
## Použití ## Použití
## Složka <a href="https://git.arch-linux.cz/Archos/Archlinux_I3/src/branch/main/utilities" target="_blank">utilities</a> ## Složka <a href="https://git.arch-linux.cz/Archos/Archlinux_I3/src/branch/main/utilities" target="_blank">utilities</a>
Tato složka obsahuje pomocné skripty, které rozšiřují funkcionalitu systému. Zde je přehled skriptů a jejich funkcí: Tato složka obsahuje pomocné skripty, které rozšiřují funkcionalitu systému. Zde je přehled skriptů a jejich funkcí:
@ -159,7 +181,6 @@ sudo pacman -S pacman-contrib
- **system_updates.sh** - Tento skript slouží k pravidelnému aktualizování systému a aplikací v Arch Linuxu. Skript zkontroluje dostupné aktualizace a provede je bez uživatelského zásahu. Pro zajištění, že uživatel bude informován o průběhu aktualizace, skript může zobrazovat notifikace pomocí desktopového notifikačního systému. - **system_updates.sh** - Tento skript slouží k pravidelnému aktualizování systému a aplikací v Arch Linuxu. Skript zkontroluje dostupné aktualizace a provede je bez uživatelského zásahu. Pro zajištění, že uživatel bude informován o průběhu aktualizace, skript může zobrazovat notifikace pomocí desktopového notifikačního systému.
### Integrace `check_updates.sh` ### Integrace `check_updates.sh`
#### Conky #### Conky
@ -169,18 +190,21 @@ sudo pacman -S pacman-contrib
```bash ```bash
${execi 600 /cesta/k/check_updates.sh} ${execi 600 /cesta/k/check_updates.sh}
``` ```
#### i3blocks #### i3blocks
&#x2022;Pro integraci výstupu skriptu update_check.sh do i3blocks, přidejte následující blok do vašeho konfiguračního souboru i3blocks: &#x2022;Pro integraci výstupu skriptu update_check.sh do i3blocks, přidejte následující blok do vašeho konfiguračního souboru i3blocks:
```bash ```bash
[updates] [updates]
command=/cesta/k/skripty/check_updates command=/cesta/k/skripty/check_updates
interval=600 interval=600
``` ```
- **update_notifier.sh** - ## Detaily Skriptu - **update_notifier.sh** - ## Detaily Skriptu
### update_notifier.sh ### update_notifier.sh
Tento skript kontroluje dostupné aktualizace pro systém Arch Linux a informuje uživatele pomocí desktopové notifikace. Skript je optimalizován pro spouštění z cronu, což vyžaduje speciální nastavení pro správnou funkčnost GUI notifikací: Tento skript kontroluje dostupné aktualizace pro systém Arch Linux a informuje uživatele pomocí desktopové notifikace. Skript je optimalizován pro spouštění z cronu, což vyžaduje speciální nastavení pro správnou funkčnost GUI notifikací:
- `export DBUS_SESSION_BUS_ADDRESS="unix:path=/run/user/1000/bus"`: Tento příkaz nastaví proměnnou prostředí, která umožňuje skriptu komunikovat s desktopovým prostředím uživatele a zobrazovat notifikace, i když je spuštěný z cronu. Bez této proměnné by skript v cronu nebyl schopen zobrazit GUI notifikace, protože cron typicky neběží v uživatelském desktopovém prostředí. - `export DBUS_SESSION_BUS_ADDRESS="unix:path=/run/user/1000/bus"`: Tento příkaz nastaví proměnnou prostředí, která umožňuje skriptu komunikovat s desktopovým prostředím uživatele a zobrazovat notifikace, i když je spuštěný z cronu. Bez této proměnné by skript v cronu nebyl schopen zobrazit GUI notifikace, protože cron typicky neběží v uživatelském desktopovém prostředí.
@ -194,6 +218,7 @@ Pro zjištění, který uživatel má UID 1000, můžete použít příkaz id s
```bash ```bash
id -nu 1000 id -nu 1000
``` ```
Tento příkaz vám vrátí uživatelské jméno spojené s UID 1000. Tento příkaz vám vrátí uživatelské jméno spojené s UID 1000.
Pro zjištění aktuálního uživatelského ID (UID) přihlášeného uživatele můžete použít příkaz `echo $UID`. Tento příkaz vypíše UID uživatele, který je právě přihlášen a spouští skript nebo příkazovou řádku. Je to jednoduchý a přímý způsob, jak zjistit UID: Pro zjištění aktuálního uživatelského ID (UID) přihlášeného uživatele můžete použít příkaz `echo $UID`. Tento příkaz vypíše UID uživatele, který je právě přihlášen a spouští skript nebo příkazovou řádku. Je to jednoduchý a přímý způsob, jak zjistit UID:
@ -201,14 +226,15 @@ Pro zjištění aktuálního uživatelského ID (UID) přihlášeného uživate
echo $UID echo $UID
``` ```
### Nastavení periodických aktualizací pomocí crontab ### Nastavení periodických aktualizací pomocí crontab
1. Otevřete `crontab` pro úpravy: 1. Otevřete `crontab` pro úpravy:
```bash ```bash
crontab -e crontab -e
``` ```
2. Přidejte následující řádek pro spouštění system_updates.sh každou hodinu. 2. Přidejte následující řádek pro spouštění system_updates.sh každou hodinu.
```bash ```bash
/59 * * * * /cesta/k/update_notifier.sh /59 * * * * /cesta/k/update_notifier.sh
@ -230,10 +256,13 @@ exec_always --no-startup-id /path/to/update_notifier.sh
``` ```
### Spouštění aktualizací pomocí i3 klávesové zkratky ### Spouštění aktualizací pomocí i3 klávesové zkratky
Ve složce `utilities` se nachází skript `update_yay.sh`, který slouží k automatickému spuštění aktualizací. Pro snadné použití přidejte následující zkratku do i3 konfiguračního souboru: Ve složce `utilities` se nachází skript `update_yay.sh`, který slouží k automatickému spuštění aktualizací. Pro snadné použití přidejte následující zkratku do i3 konfiguračního souboru:
```bash ```bash
bindsym $mod+Shift+u exec ~/utilities/update_yay.sh bindsym $mod+Shift+u exec ~/utilities/update_yay.sh
``` ```
Tímto způsobem budete moci spustit aktualizace jednoduše pomocí klávesové zkratky. Tímto způsobem budete moci spustit aktualizace jednoduše pomocí klávesové zkratky.
### Nastavení tapety v i3 pomocí feh ### Nastavení tapety v i3 pomocí feh
@ -255,7 +284,6 @@ exec_always --no-startup-id feh --bg-scale /path_to_your_wallpaper
- **--bg-scale** zajistí, že obrázek bude přizpůsoben velikosti vaší obrazovky. - **--bg-scale** zajistí, že obrázek bude přizpůsoben velikosti vaší obrazovky.
- **exec_always** znamená, že feh se spustí pokaždé, když i3 začne nebo se restartuje. - **exec_always** znamená, že feh se spustí pokaždé, když i3 začne nebo se restartuje.
### Aplikace změn ### Aplikace změn
Pro aplikaci změn restartujte i3. To můžete provést pomocí klávesové zkratky [mod+Shift+r] (mod klávesa obvykle odpovídá Windows klávese nebo Alt klávese, v závislosti na vaší konfiguraci). Pro aplikaci změn restartujte i3. To můžete provést pomocí klávesové zkratky [mod+Shift+r] (mod klávesa obvykle odpovídá Windows klávese nebo Alt klávese, v závislosti na vaší konfiguraci).
@ -271,7 +299,7 @@ Conky můžete nainstalovat pomocí správce balíčků vaší distribuce. Pro A
```bash ```bash
sudo pacman -S conky sudo pacman -S conky
``` ```
#### Konfigurace Conky #### Konfigurace Conky
Konfigurační soubory Conky jsou obvykle umístěny v ~/.config/conky/ nebo přímo v domovském adresáři uživatele jako ~/.conkyrc. Konfigurace Conky je velmi flexibilní od jednoduchého textového výpisu po komplexní grafické ukazatele. Konfigurační soubory Conky jsou obvykle umístěny v ~/.config/conky/ nebo přímo v domovském adresáři uživatele jako ~/.conkyrc. Konfigurace Conky je velmi flexibilní od jednoduchého textového výpisu po komplexní grafické ukazatele.
@ -280,7 +308,7 @@ Konfigurační soubory Conky jsou obvykle umístěny v ~/.config/conky/ nebo př
Pro automatické spuštění Conky při startu i3 můžete do vašeho konfiguračního souboru i3 (typicky ~/.config/i3/config) přidat následující řádek: Pro automatické spuštění Conky při startu i3 můžete do vašeho konfiguračního souboru i3 (typicky ~/.config/i3/config) přidat následující řádek:
```bash ```bash
exec_always --no-startup-id conky exec_always --no-startup-id conky
``` ```