i3block - آنلاین در ابر

برنامه:

نام

i3blocks - یک زمانبندی انعطاف پذیر برای i3bar

خلاصه

i3blocks [-ج پیکربندی] [-v]... [-h] [-V]

شرح

i3blocks به شخص اجازه می دهد تا بلوک ها را به راحتی در قالبی ساده توصیف کند و وضعیت ایجاد کند
خط برای i3bar(1). کلیک ها، سیگنال ها و فاصله زمانی اسکریپت های کاربر را کنترل می کند.

OPTIONS

-c پیکربندی
یک مسیر فایل پیکربندی جایگزین را مشخص می کند. به طور پیش فرض، i3block به دنبال آن است
فایل های پیکربندی به ترتیب زیر (توجه داشته باشید که /و غیره ممکن است با پیشوند باشد
/ usr / محلی بسته به پرچم های مجموعه):

1. ~/.config/i3blocks/پیکربندی (یا $XDG_CONFIG_HOME/i3blocks/config در صورت تنظیم)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (یا $XDG_CONFIG_DIRS/i3blocks/config در صورت تنظیم)
4. /etc/i3blocks.conf

-v
سطح گزارش. این گزینه به صورت تجمعی است. به طور پیش فرض، پیام های خطا در stderr نمایش داده می شود.
یک بار عبور، یک شکست در طول به روز رسانی در بلوک نشان داده می شود. گذشت دو بار را قادر می سازد
پیام های اشکال زدایی در stderr.

-V
نسخه را پرینت بگیرید و خارج شوید.

-h
پیام راهنما را چاپ کنید و خارج شوید.

پیکربندی

فایل پیکربندی یک فایل ini است. هر بخش یک بلوک جدید را توصیف می کند. یک خط
شروع با a # علامت یک نظر است و خطوط خالی نادیده گرفته می شوند. یک ملک یک است
کلید = ارزش جفت در هر خط، بدون فاصله در اطراف علامت مساوی. املاک اعلام شده در خارج
یک بلوک (یعنی در ابتدای فایل) تنظیمات جهانی را توصیف می کند.

در اینجا یک فایل پیکربندی نمونه است:

# این یک نظر است
فاصله = 5
color=#00FF00

[آب و هوا]
فرمان =~/bin/weather.pl
فاصله = 1800

[زمان]
command=date +%T

برای استفاده از i3block به عنوان خط وضعیت خود، آن را در a تعریف کنید بار بلوک شما ~/i3/config فایل:

بار {
status_command i3blocks
}

BLOCK

ویژگی های مورد استفاده برای توصیف یک بلوک، کلیدهای مشخص شده در پروتکل i3bar هستند
http://i3wm.org/docs/i3bar-protocol.html، به علاوه خواص اضافی مورد استفاده توسط i3blocks به
زمان و نحوه به روز رسانی یک بلوک را توضیح دهید. تمام ویژگی های پشتیبانی شده در زیر توضیح داده شده است.

کلیدهای زیر استاندارد هستند، ببینید http://i3wm.org/docs/i3bar-protocol.html برای جزئیات بیشتر.

· متن کامل

· متن کوتاه

· رنگ

· حداقل عرض

· تراز

· نام

· نمونه

· فوری

· جدا ساز

· separator_block_width

· نشانه گذاری

کلیدهای زیر خاص هستند i3blocks.

فرمان
دستوری که توسط یک پوسته اجرا می شود و برای به روز رسانی بلوک استفاده می شود. رفتار مورد انتظار است
شرح داده شده در زیر، در COMMAND بخش.

فاصله
اگر یک عدد صحیح مثبت باشد، بلوک در هنگام راه اندازی ایجاد می شود و مقدار آن است
به عنوان یک فاصله زمانی در ثانیه برای برنامه ریزی به روز رسانی های آینده استفاده می شود. اگر نامشخص یا 0 باشد،
بلوک در هنگام راه اندازی اجرا نمی شود (که برای شبیه سازی دکمه ها مفید است). اگر
"یک بار" (یا -1)، بلوک فقط در هنگام راه اندازی اجرا می شود (توجه داشته باشید که یک کلیک یا
سیگنال همچنان یک به روز رسانی را راه اندازی می کند). اگر "تکرار" (یا -2)، بلوک خواهد بود
در هنگام راه اندازی ایجاد می شود و به محض پایان آن (برای تکرار مسدود کردن مفید است
دستورات). با احتیاط استفاده کنید! اگر "persist" (یا -3) باشد، بلوک فقط اجرا می شود
هنگام راه اندازی، و به محض خروج از یک خط به روز رسانی می شود. بنابراین به یک خط محدود می شود
به روز رسانی.

سیگنال شماره سیگنال مورد استفاده برای به روز رسانی بلوک. تمام زمان واقعی (به اولویت فکر کنید
و قابل صف) سیگنال ها در دسترس کاربر هستند. عدد بین 1 تا معتبر است
N، جایی که SIGRTMIN+N = SIGRTMAX. (توجه: 31 سیگنال بلادرنگ در لینوکس وجود دارد.)
به عنوان مثال، سیگنال=10 به این معنی است که این بلوک زمانی به روز می شود i3blocks
SIGRTMIN+10 را دریافت می کند.

برچسب یک برچسب اختیاری برای preprending به متن کامل پس از یک به روز رسانی

قالب این ویژگی فرمت متن خروجی را مشخص می کند. فرمت پیش فرض ساده است
متن، همانطور که در COMMAND بخش. اگر از "json" (یا 1) استفاده شود، بلوک
خروجی به صورت JSON تجزیه می شود.

COMMAND

مقدار فرمان کلید همانطور که هست توسط یک پوسته ارسال و اجرا می شود.

خروجی استاندارد خط فرمان برای به روز رسانی محتوای بلوک استفاده می شود. هر یک
خط غیر خالی خروجی، ویژگی مربوطه را بازنویسی می کند:

1. متن کامل

2. متن کوتاه

3. رنگ

به عنوان مثال، این اسکریپت را تنظیم می کند متن کامل به رنگ آبی اما نه متن کوتاه:

پژواک "اینجا برچسب من است"
از دست
echo \#0000FF

اگر خط فرمان 0 یا 33 را برگرداند، بلوک به روز می شود. در غیر این صورت الف محسوب می شود
شکست و خط اول (در صورت وجود) همچنان نمایش داده می شود. توجه داشته باشید که stderr نادیده گرفته می شود. آ
کد بازگشتی 33 را تنظیم می کند فوری پرچم به درستی

به عنوان مثال، این اسکریپت درصد باتری را چاپ می کند و در صورت وجود، پرچم فوری را تنظیم می کند
زیر 10 درصد:

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

پژواک "BAT: $BAT"
تست ${BAT%?} -le 10 && خروج 33 || خروج 0

هنگام فورک کردن یک فرمان بلوک، i3blocks محیط را با برخی تنظیم خواهد کرد مسدود کردن_*
متغیرها متغیرهای زیر همیشه با یک رشته خالی به عنوان ارائه می شوند
ارزش.

BLOCK_NAME
نام بلوک (معمولاً نام بخش).

BLOCK_INSTANCE
یک آرگومان اختیاری برای اسکریپت.

BLOCK_BUTTON
اگر روی بلوک کلیک شده باشد، دکمه ماوس (1، 2 یا 3).

BLOCK_X و BLOCK_Y
اگر روی بلوک کلیک شده باشد، مختصات جایی که کلیک روی داده است.

در اینجا یک مثال با استفاده از محیط آورده شده است:

[مسدود کردن]
command=echo name=$BLOCK_NAME instance=$BLOCK_INSTANCE
فاصله = 1

[مرا کلیک کن]
full_text=روی من کلیک کن!
فرمان=دکمه اکو=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width = دکمه = 1 x = 1366 y = 768
تراز = چپ

توجه داشته باشید که i3blocks مجموعه ای از اسکریپت های اختیاری را برای راحتی فراهم می کند، مانند شبکه
وضعیت، بررسی باتری، بار پردازنده، حجم صدا و غیره

مثال ها

به عنوان مثال، در اینجا یک پیکربندی نزدیک به i3status(1) تنظیمات پیش فرض:

ALL

فاصله = 5
سیگنال=10

[ipv6]

[رایگان]

[dhcp]

[vpn]

[وای فای]

[شبکه محلی کابلی]
min_width=E: 255.255.255.255 (1000 مگابیت بر ثانیه)

[باتری]

[cpu]

[زمان قرار]

بلوک زیر استفاده از سیگنال با برخی از i3(1) اتصالات که تنظیم می کند
جلد، قبل از صدور الف pkill -RTMIN+1 i3blocks:

[جلد]
command=echo -n ´Volume: ´; میکسر دریافت مستر | grep -E -o ´[0-9][0-9]؟%´
فاصله = یک بار
سیگنال=1
# بدون فاصله، فقط SIGRTMIN+1 را بررسی کنید

در اینجا یک مثال از یک پیکربندی بسیار مینیمالیستی است، با فرض اینکه شما یک دسته از اسکریپت ها را زیر آن دارید
~/bin/blocks/ با همان نام بلوک ها:

فرمان =~/bin/blocks/$BLOCK_NAME
فاصله = 1

[رایگان]
[وای فای]
[شبکه محلی کابلی]
[باتری]
[cpu]
[زمان قرار]

از i3block به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید