Rola Ansible: oh_my_zsh_p10k

Jest to rola Ansible, która instaluje i konfiguruje oh-my-zsh z motywem powerlevel10k dla określonych użytkowników. Możesz dostarczyć własne pliki .zshrc i .p10k.zsh lub skorzystać z dostarczonych.

Wymagania

Dostęp do Internetu - jeśli działasz za proxy, rozważ użycie roli tomereli.proxy przed tą.

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (zobacz defaults/main.yml):

# domyślny motyw
oh_my_zsh_theme: powerlevel10k

# domyślne wtyczki
oh_my_zsh_plugins:
    - git
    - zsh-autosuggestions
    - zsh-syntax-highlighting

# domyślny szablon .zshrc; wskazuje na domyślny szablon dostarczony z tą rolą
zshrc_src_template: .zshrc.j2

# domyślny plik .p10k.zsh; wskazuje na domyślny plik dostarczony z tą rolą
p10k_src_file: .p10k.zsh

Zależności

Brak, używane są tylko wbudowane moduły.

Przykład Playbooka

Poniższy playbook konfiguruje oh-my-zsh z motywem powerlevel10k dla testuser1 i testuser2:

- hosts: all
  roles:
    - role: tomereli.oh_my_zsh_p10k
      vars:
        users:
            - username: testuser1
            - username: testuser2

Jeśli chcesz dostarczyć własny szablon dla pliku .zshrc, możesz ustawić zmienną zshrc_src_template, aby wskazywała na Twój niestandardowy szablon, np. przechowywany w templates/custom.zshrc.j2 w katalogu Twojego repozytorium.
Możesz także dostarczyć swoją wersję .p10k.zsh, ustawiając zmienną p10k_src_file i przechowując swój niestandardowy szablon w na przykład files/custom.p10k.zsh.

- hosts: all
  roles:
    - role: tomereli.oh_my_zsh_p10k
      vars:
        users:
            - username: testuser1
        zshrc_src_template: custom.zshrc.j2
        p10k_src_file: custom.p10k.zsh

Uwagi dotyczące .zshrc:

• Nie używaj .zshrc.j2 jako nazwy pliku swojego niestandardowego szablonu, ponieważ zostanie wybrany domyślny szablon zamiast.
• Jeśli nie chcesz korzystać z funkcji szablonów, możesz również dostarczyć swoje .zshrc bez składni Jinja2 i końcówki pliku.

Uwagi dotyczące p10k.zsh:

• Zalecaną metodą jest wygenerowanie własnego pliku, uruchamiając p10k configure na systemie, który ma już zainstalowane oh-my-zsh z powerlevel10k, a następnie skopiowanie wygenerowanego pliku (znalezionego w ~/.p10k.zsh) do katalogu projektu.
• Nie używaj .p10k.zsh jako nazwy pliku swojego niestandardowego pliku, ponieważ zostanie wybrany domyślny szablon.
• W przeciwieństwie do szablonu .zshrc.j2, niestandardowy plik .p10k.zsh zostanie skopiowany bez dalszych modyfikacji, tzn. składnia Jinja2 nie jest obsługiwana w tym pliku.

Licencja

MIT / BSD

Informacje o autorze

Ta rola została stworzona w 2020 roku przez Tomer Arbel-Eliyahu