Raspberry PI OS - po(d)ręczny Conky ;) - Składnia

Spis treści

Składnia

Conky tworzy obraz "bezpośrednio"...Od wersji 1.10 Conky stosuje składnię pliku konfiguracyjnego zgodną z językiem Lua.

Twórcy Conky deklarują możliwość konwersji "w locie" starego formatu do nowego.

W wielu przypadkach tak jest. IMO warto jednak znać podstawowe reguły obowiązującej składni pliku konfiguracyjnego Conky.... totalny rozjazd! :/

Ten opis to nie podręcznik, a "elementarz" podstawowych zasad!

Czy istotny? Spójrz na obrazek z prawej. Zrozumiesz dlaczego uważam, że tak!

Plik konfiguracyjny (.conkyrc domyślnie umieszczony w $HOME) składa się z dwóch sekcji: konfiguracyjnej oraz treści składającego się z tekstu, zmiennych oraz zdefiniowanych elementów graficznych.

conky.config={
...Sekcja konfiguracji...
};
conky.text = [[
.... Sekcja treści ....
]]

Pisanie w oknie ConkySekcja konfiguracji może zawierać:

  • definiowanie (istniejących) i deklaracje zmiennych (logicznych, tj. true/false, numerycznych oraz tekstowych,
  • definicja/deklaracja składa się z nazwy zmiennej, znaku przypisania (równości, =) oraz argumentu/wartości,
  • definicja/deklaracja zmiennej bez wartości (pusta) traktowana jest jako błąd,
  • deklaracja kolorów (color, color0...color9) odbywa się w pełnej (8 znaków) notacji szestnastkowej RGB bez(!) poprzedzającego znaku hash (#) lub nazwy z tabeli kolorów RGB,
  • jeśli argument/wartość nie jest: liczbą lub wartością logiczną musi być ujęta w cudzysłów (", '),
  • każda (z wyjątkiem ostatniej) definicja/deklaracja musi być zakończona przecinkiem (,),
  • wartość zmiennych użytkownika (template0...template9) winny być "zamykane" w: [[templateN]],
  • komentarze: jeśli w jednej linii to zaczynające się od "--", komentarze wieloliniowe zaczynają się od: "--[[", kończą: "]]".

Sekcja treści może zawierać:

  • znaki ASCI, elementy (obrazy) graficzne, zmienne oraz wynik wykonanych: poleceń powłoki, skryptów, itp., które będą wyświetlane w oknie programu zgodnie z regułami ujętymi w sekcji konfiguracji,
  • wartości zmiennych określane są poprzez: $zmienna - dla zmiennych bez argumentów lub ${zmienna arg1 arg2} - dla zmiennych z argumentami,
  • elementy pozycjonujące składniki treści,
  • komentarze rozpoczynające się od nowej linii, gdzie pierwszym znakiem jest hash (#).

Istotna uwaga: nie można zamiennie w sekcjach konfiguracji lub treści stosować znaków określających początek linii komentarza.

Użycie znaku hash (#) w Sekcji konfiguracji nie jest traktowane jako komentarz i wywoła błąd.

Użycie łańcucha "--" w Sekcji treści również nie zostanie potraktowane jako początek komentarza. Łańcuch (i to co po nim następuje) zostanie wyświetlone w oknie Conky. I będzie totalny rozjazd! :/