# 🎨 Poradnik modderski: Własne motywy i języki

## 🌍 Część 1: Super prosto - dodaj język

Ten poradnik jest dla każdego, kto chce samodzielnie zmieniać języki. Nie potrzebujesz Pythona ani umiejętności programowania. Wystarczy zwykły edytor tekstu. Dzięki niemu możesz zmieniać istniejące pliki językowe albo tworzyć nowe.

### ✅ Wystarczy zwykły edytor tekstu

Otwórz plik językowy w folderze `lang` w zwykłym edytorze tekstu. Możesz go poprawić, skopiować albo utworzyć nowy plik - nic więcej nie jest potrzebne.

To znaczy, że możesz zmienić istniejący język albo dodać nowy. Bez żadnego kodu źródłowego.

### Krok 1: Skopiuj plik

Otwórz folder `lang` i skopiuj jeden z istniejących plików językowych. Potem zmień nazwę kopii, na przykład na `fr_FR.json`, `es_ES.json`, `it_IT.json`, `nl_NL.json` albo `pt_BR.json`.

### Krok 2: Zmieniaj tylko tekst po prawej stronie

Bardzo ważne: po lewej stronie jest klucz, a po prawej tekst. Tłumaczysz tylko tekst za dwukropkiem. Lewa część musi zostać dokładnie taka sama.

    Poprawnie:
    "save": "Zapisz"
    "cancel": "Anuluj"
    "open": "Otwórz"

    Błędnie:
    "save": "save"
    "Zapisz": "Anuluj"

Po lewej stronie nazwa zostaje taka sama. Tłumaczenie trafia po prawej stronie. Dzięki temu program czyta plik poprawnie.

### Krok 3: Możesz też użyć AI

Możesz też poprosić AI o zrobienie tłumaczenia. Wklej plik językowy do ChatGPT albo innego narzędzia AI i napisz: tłumacz tylko tekst po prawej stronie, ale nie zmieniaj nazw po lewej.

### Krok 4: Zapisz i uruchom ponownie

Zapisz plik w folderze `lang` i uruchom program ponownie. Nowy język pojawi się potem automatycznie na liście.

## 🖌?Część 2: Tworzenie własnego motywu

Od wersji 4.1.0 motywy są przechowywane jako zewnętrzne pliki JSON w folderze `themes`. Nie trzeba już edytować plików Python.

### Krok 1: Skopiuj istniejący motyw

Otwórz folder `themes` i skopiuj istniejący plik, np. `light.json`. Zmień nazwę kopii na przykład na `my_theme.json`.

### Krok 2: Zmień kolory

    {
        "name": "my_theme",

        "bg": "#E0E0E0",              // Główne tło aplikacji
        "fg": "#000000",              // Główny kolor tekstu
        "info_bg": "#ffffff",         // Pola tekstowe i dziennik procesu
        "separator": "#808080",       // Obramowania i separatory
        "entry_bg": "#ffffff",        // Pola wejściowe i listy rozwijane
        "disabled_fg": "#6d6d6d",     // Tekst elementów wyłączonych
        "error_bg": "#f2b8b5",        // Podświetlenie błędów
        "button_bg": "#d3d1ce",       // Przyciski i nieaktywne karty
        "button_hover": "#e4e0d8",    // Stan najechania i aktywny
        "text_relief": "sunken",      // flat, sunken, ridge lub groove
        "accent": "#0a64ad",          // Główny kolor akcentu
        "tree_selected": "#0a64ad",   // Tło zaznaczonego wiersza pliku
        "tree_selected_fg": "#ffffff",// Kolor tekstu zaznaczonego wiersza
        "tree_row_alt": "#f7f7f7"     // Kolor naprzemiennych wierszy
    }

Zapisz plik. Program wykryje go automatycznie.

### Krok 3: Wybierz motyw

Uruchom program. Wszystkie poprawne motywy JSON znajdujące się w folderze `themes` pojawią się automatycznie na liście wyboru motywu.