i3blocks - Online sa Cloud

PROGRAMA:

NAME

i3blocks - Isang flexible scheduler para sa i3bar

SINOPSIS

i3blocks [-c configfile] [-v]... [-h] [-V]

DESCRIPTION

i3blocks nagbibigay-daan sa isa na madaling ilarawan ang mga bloke sa isang simpleng format, at bumuo ng isang katayuan
linya para sa i3bar(1). Pinangangasiwaan nito ang mga pag-click, signal at agwat ng oras para sa mga script ng user.

Opsyon

-c configfile
Tinutukoy ang isang alternatibong path ng configuration file. Bilang default, hinahanap ng i3blocks
configuration file sa sumusunod na pagkakasunud-sunod (tandaan na / atbp maaaring lagyan ng prefix ng
/ usr / lokal depende sa mga flag ng compilation):

1. ~/.config/i3blocks/config (o $XDG_CONFIG_HOME/i3blocks/config kung nakatakda)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (o $XDG_CONFIG_DIRS/i3blocks/config kung nakatakda)
4. /etc/i3blocks.conf

-v
Antas ng log. Ang pagpipiliang ito ay pinagsama-sama. Bilang default, ang mga mensahe ng error ay ipinapakita sa stderr.
Naipasa nang isang beses, ang isang pagkabigo sa panahon ng pag-update ay ipinapakita sa loob ng block. Nakapasa nang dalawang beses
ang mga debug na mensahe sa stderr.

-V
I-print ang bersyon at lumabas.

-h
I-print ang mensahe ng tulong at lumabas.

Configuration

Ang configuration file ay isang ini file. Ang bawat seksyon ay naglalarawan ng isang bagong bloke. Isang linya
nagsisimula sa a # ang sign ay isang komento, at ang mga walang laman na linya ay binabalewala. Ang ari-arian ay a
susi=halaga pares sa bawat linya, na walang puwang sa paligid ng equal sign. Ipinahayag ang mga ari-arian sa labas
isang bloke (ibig sabihin sa simula ng file) na naglalarawan ng mga pandaigdigang setting.

Narito ang isang halimbawa ng config file:

# Ito ay isang komento
pagitan=5
kulay=#00FF00

[panahon]
utos =~/bin/weather.pl
pagitan=1800

[oras]
command=date +%T

Upang gamitin ang i3blocks bilang iyong linya ng katayuan, tukuyin ito sa a bar bloke ng iyong ~/i3/config file:

bar {
status_command i3blocks
}

BLOCK

Ang mga katangian na ginagamit upang ilarawan ang isang bloke ay ang mga key na tinukoy sa i3bar protocol
http://i3wm.org/docs/i3bar-protocol.html, kasama ang mga karagdagang katangian na ginagamit ng i3blocks sa
ilarawan kung kailan at paano mag-update ng block. Ang lahat ng mga sinusuportahang katangian ay inilarawan sa ibaba.

Ang mga sumusunod na susi ay pamantayan, tingnan http://i3wm.org/docs/i3bar-protocol.html para sa mga detalye.

· buong_teksto

· maikling_teksto

· kulay

· min_width

· align

· pangalan

· halimbawa

· apurahan

· panghiwalay

· separator_block_width

· markup

Ang mga sumusunod na key ay partikular sa i3blocks.

utos
Ang utos na pinaandar ng isang shell, na ginagamit upang i-update ang block. Ang inaasahang pag-uugali ay
inilalarawan sa ibaba, sa COMMAND seksyon.

agwat
Kung ito ay isang positibong integer, pagkatapos ay ang block ay spawned sa startup at ang halaga ay
ginamit bilang agwat ng oras sa mga segundo upang mag-iskedyul ng mga update sa hinaharap. Kung hindi tinukoy o 0,
ang block ay hindi isasagawa sa startup (na kapaki-pakinabang upang gayahin ang mga pindutan). Kung
"minsan" (o -1), ang block ay isasagawa lamang sa startup (tandaan na ang isang pag-click o
magti-trigger pa rin ng update ang signal). Kung "ulitin" (o -2), ang block ay magiging
spawned sa startup, at sa sandaling ito ay natapos (kapaki-pakinabang upang ulitin ang pagharang
mga utos). Gamitin nang may pag-iingat! Kung "magpapatuloy" (o -3), ang block ay isasagawa lamang
sa startup, at na-update sa sandaling mag-output ito ng isang linya. Kaya limitado sa isang linya
update.

senyas Ang signal number na ginamit para i-update ang block. Lahat ng real-time (isipin ang priyoridad
at queueable) na mga signal ay available sa user. Ang numero ay may bisa sa pagitan ng 1 at
N, kung saan SIGRTMIN+N = SIGRTMAX. (Tandaan: mayroong 31 real-time na signal sa Linux.)
Halimbawa, signal=10 nangangahulugan na ang block na ito ay maa-update kapag i3blocks
tumatanggap ng SIGRTMIN+10.

etiketa Isang opsyonal na label na ihahanda sa buong_teksto pagkatapos ng update.

format Tinutukoy ng property na ito ang format ng output text. Ang default na format ay plain
teksto, tulad ng inilarawan sa COMMAND seksyon. Kung "json" (o 1) ang ginamit, ang block
ang output ay na-parse bilang JSON.

COMMAND

Ang halaga ng utos Ang susi ay ipapasa at isasagawa tulad ng isang shell.

Ang karaniwang output ng command line ay ginagamit upang i-update ang block content. Bawat isa
ang walang laman na linya ng output ay papatungan ang kaukulang property:

1. buong_teksto

2. maikling_teksto

3. kulay

Halimbawa, itinatakda ng script na ito ang buong_teksto naka blue pero wala maikling_teksto:

echo "Narito ang aking label"
miss
echo \#0000FF

Kung ang command line ay nagbabalik ng 0 o 33, ang block ay ina-update. Kung hindi, ito ay itinuturing na a
kabiguan at ang unang linya (kung mayroon man) ay ipinapakita pa rin. Tandaan na ang stderr ay hindi pinapansin. A
itatakda ng return code ng 33 ang apurahan bandila sa totoo.

Halimbawa, ang script na ito ay nagpi-print ng porsyento ng baterya at nagtatakda ng apurahang bandila kung ito ay
mas mababa sa 10%:

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

echo "BAT: $BAT"
pagsubok ${BAT%?} -le 10 && exit 33 || labasan 0

Kapag nag-forking ng block command, i3blocks itatakda ang kapaligiran na may ilan BLOCK_*
mga variable. Ang mga sumusunod na variable ay palaging ibinibigay, na sa huli ay isang walang laman na string bilang
ang halaga.

BLOCK_NAME
Ang pangalan ng block (karaniwan ay ang pangalan ng seksyon).

BLOCK_INSTANCE
Isang opsyonal na argumento sa script.

BLOCK_BUTTON
Button ng mouse (1, 2 o 3) kung na-click ang block.

BLOCK_X at BLOCK_Y
Mga coordinate kung saan naganap ang pag-click, kung na-click ang block.

Narito ang isang halimbawa gamit ang kapaligiran:

[block]
command=echo name=$BLOCK_NAME instance=$BLOCK_INSTANCE
pagitan=1

[pindutin mo ako]
full_text=I-click ako!
command=echo button=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=button=1 x=1366 y=768
align=left

Tandaan na ang i3blocks nagbibigay ng isang hanay ng mga opsyonal na script para sa kaginhawahan, gaya ng network
katayuan, pagsusuri ng baterya, pag-load ng cpu, dami, atbp.

HALIMBAWA

Bilang halimbawa, narito ang malapit na pagsasaayos sa i3status(1) mga default na setting:

LAHAT

pagitan=5
signal=10

[ipv6]

[libre]

[dhcp]

[vpn]

[wifi]

[ethernet]
min_width=E: 255.255.255.255 (1000 Mbit/s)

[baterya]

[cpu]

[datetime]

Ang sumusunod na bloke ay nagpapakita ng paggamit ng senyas may ilang i3(1) mga binding na nag-aayos ng
dami, bago mag-isyu ng a pkill -RTMIN+1 i3blocks:

[volume]
command=echo -n ´Volume: ´; amixer makakuha ng Master | grep -E -o ´[0-9][0-9]?%´
pagitan=isang beses
signal=1
# walang agwat, tingnan lamang sa SIGRTMIN+1

Narito ang isang halimbawa ng isang napaka minimalist na config, sa pag-aakalang mayroon kang isang grupo ng mga script sa ilalim
~/bin/blocks/ na may parehong pangalan ng mga bloke:

utos =~/bin/blocks/$BLOCK_NAME
pagitan=1

[libre]
[wifi]
[ethernet]
[baterya]
[cpu]
[datetime]

Gumamit ng i3blocks online gamit ang mga serbisyo ng onworks.net