i3blocks - Online di Cloud

PROGRAM:

NAMA

i3block - Penjadwal fleksibel untuk i3bar

RINGKASAN

i3block [-C file konfigurasi] [-v]... [-h] [-V]

DESKRIPSI

i3block memungkinkan seseorang untuk dengan mudah menggambarkan blok dalam format sederhana, dan menghasilkan status
baris untuk i3bar(1). Ini menangani klik, sinyal, dan interval waktu untuk skrip pengguna.

PILIHAN

-c file konfigurasi
Menentukan jalur file konfigurasi alternatif. Secara default, i3blocks mencari
file konfigurasi dalam urutan berikut (perhatikan bahwa / Etc dapat diawali dengan
/ usr / local tergantung pada flag kompilasi):

1. ~/.config/i3blocks/config (atau $XDG_CONFIG_HOME/i3blocks/config jika disetel)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (atau $XDG_CONFIG_DIRS/i3blocks/config jika disetel)
4. /etc/i3blocks.conf

-v
tingkat log. Opsi ini bersifat kumulatif. Secara default, pesan kesalahan ditampilkan di stderr.
Lulus sekali, kegagalan selama pembaruan ditampilkan di dalam blok. Lulus dua kali memungkinkan
pesan debug di stderr.

-V
Cetak versi dan keluar.

-h
Cetak pesan bantuan dan keluar.

KONFIGURASI

File konfigurasi adalah file ini. Setiap bagian menjelaskan blok baru. Sebuah garis
dimulai dengan # tanda adalah komentar, dan baris kosong diabaikan. Sebuah properti adalah
kunci = nilai pasang per baris, tanpa spasi di sekitar tanda sama dengan. Properti dinyatakan di luar
blok (yaitu di awal file) menjelaskan pengaturan global.

Berikut adalah contoh file konfigurasi:

# Ini adalah komentar
selang=5
warna=#00FF00

[cuaca]
perintah =~/bin/weather.pl
selang=1800

[waktu]
perintah=tanggal +%T

Untuk menggunakan i3blocks sebagai baris status Anda, tentukan di a bar blok Anda ~/i3/config File:

batang {
status_command i3blocks
}

BLOK

Properti yang digunakan untuk mendeskripsikan blok adalah kunci yang ditentukan dalam protokol i3bar
http://i3wm.org/docs/i3bar-protocol.html, ditambah properti tambahan yang digunakan oleh i3block untuk
jelaskan kapan dan bagaimana memperbarui blok. Semua properti yang didukung dijelaskan di bawah ini.

Kunci berikut adalah standar, lihat http://i3wm.org/docs/i3bar-protocol.html untuk rincian.

· teks_lengkap

· teks pendek

· warna

· min_lebar

· meluruskan

· nama

· contoh

· mendesak

· alat pemisah

· pemisah_blok_lebar

· markup

Kunci berikut khusus untuk i3block.

Command
Perintah yang dieksekusi oleh shell, digunakan untuk memperbarui blok. Tingkah laku yang diharapkan adalah
dijelaskan di bawah ini, dalam COMMAND bagian.

selang
Jika itu adalah bilangan bulat positif, maka blok tersebut muncul saat startup dan nilainya adalah
digunakan sebagai interval waktu dalam hitungan detik untuk menjadwalkan pembaruan di masa mendatang. Jika tidak ditentukan atau 0,
blok tidak akan dieksekusi saat startup (yang berguna untuk mensimulasikan tombol). Jika
"sekali" (atau -1), blok akan dijalankan hanya saat startup (perhatikan bahwa klik atau
sinyal masih akan memicu pembaruan). Jika "ulangi" (atau -2), blok akan menjadi
muncul saat startup, dan segera setelah berakhir (berguna untuk mengulangi pemblokiran
perintah). Gunakan dengan hati-hati! Jika "bertahan" (atau -3), blok hanya akan dieksekusi
saat startup, dan diperbarui segera setelah mengeluarkan satu baris. Jadi terbatas pada satu baris
update.

sinyal Nomor sinyal yang digunakan untuk memperbarui blok. Semua waktu nyata (pikirkan diprioritaskan
dan dapat diantrekan) sinyal tersedia bagi pengguna. Nomor ini berlaku antara 1 dan
N, di mana SIGRTMIN+N = SIGRTMAX. (Catatan: ada 31 sinyal waktu nyata di Linux.)
Misalnya, sinyal = 10 berarti blok ini akan diperbarui ketika i3block
menerima SIGRTMIN+10.

label Label opsional untuk mengawali ke teks_lengkap setelah pembaruan.

format Properti ini menentukan format teks keluaran. Format defaultnya polos
teks, seperti yang dijelaskan dalam COMMAND bagian. Jika "json" (atau 1) digunakan, blok
output diuraikan sebagai JSON.

COMMAND

Nilai dari Command kunci akan diteruskan dan dieksekusi apa adanya oleh shell.

Output standar dari baris perintah digunakan untuk memperbarui konten blok. Setiap
baris output yang tidak kosong akan menimpa properti yang sesuai:

1. teks_lengkap

2. teks_pendek

3. warna

Misalnya, skrip ini mengatur teks_lengkap dengan warna biru tapi tidak teks pendek:

echo "Ini label saya"
gema
gema \#0000FF

Jika baris perintah mengembalikan 0 atau 33, blok diperbarui. Jika tidak, itu dianggap sebagai
kegagalan dan baris pertama (jika ada) masih ditampilkan. Perhatikan bahwa stderr diabaikan. A
kode pengembalian 33 akan mengatur mendesak bendera menjadi benar.

Misalnya, skrip ini mencetak persentase baterai dan menetapkan tanda darurat jika:
di bawah 10%:

BAT=`acpi -b | grep -E -o [0-9][0-9]?%´`

gema "BAT: $BAT"
test ${BAT%?} -le 10 && keluar 33 || keluar 0

Saat melakukan forking perintah blok, i3block akan mengatur lingkungan dengan beberapa MEMBLOKIR_*
variabel. Variabel berikut selalu disediakan, dengan string kosong sebagai
nilai.

BLOCK_NAME
Nama blok (biasanya nama bagian).

BLOCK_INSTANCE
Argumen opsional untuk skrip.

BLOCK_BUTTON
Tombol mouse (1, 2 atau 3) jika blok diklik.

BLOK_X dan BLOK_Y
Koordinat tempat klik terjadi, jika blok diklik.

Berikut adalah contoh menggunakan lingkungan:

[memblokir]
perintah=nama gema=$BLOCK_NAME contoh=$BLOCK_INSTANCE
selang=1

[klik saya]
full_text=Klik saya!
perintah=tombol gema=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=tombol=1 x=1366 y=768
rata = kiri

Perhatikan bahwa i3block menyediakan satu set skrip opsional untuk kenyamanan, seperti jaringan
status, pemeriksaan baterai, beban cpu, volume, dll.

CONTOH

Sebagai contoh, berikut adalah konfigurasi dekat untuk status i3(1) pengaturan default:

SEMUA

selang=5
sinyal = 10

[ipv6]

[bebas]

[dhcp]

[vpn]

[Wifi]

[jaringan]
min_width=E: 255.255.255.255 (1000 Mbit/dtk)

[baterai]

[cpu]

[tanggal Waktu]

Blok berikut menunjukkan penggunaan sinyal dengan beberapa i3(1) binding yang menyesuaikan
volume, sebelum mengeluarkan a pkill -RTMIN+1 i3block:

[volume]
perintah=echo -n Volume: ; amixer mendapatkan Guru | grep -E -o [0-9][0-9]?%´
interval=sekali
sinyal = 1
# tidak ada interval, hanya cek di SIGRTMIN+1

Berikut adalah contoh konfigurasi yang sangat minimalis, dengan asumsi Anda memiliki banyak skrip di bawah
~/bin/blok/ dengan nama yang sama dengan blok:

perintah =~/bin/blok/$BLOCK_NAME
selang=1

[bebas]
[Wifi]
[jaringan]
[baterai]
[cpu]
[tanggal Waktu]

Gunakan i3blocks online menggunakan layanan onworks.net