i3blocks - מקוון בענן

תָכְנִית:

שֵׁם

i3blocks - מתזמן גמיש עבור i3bar

תַקצִיר

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

תיאור

i3blocks מאפשר לתאר בקלות בלוקים בפורמט פשוט, וליצור סטטוס
קו עבור i3bar(1). הוא מטפל בלחיצות, איתותים ומרווח זמן עבור סקריפטים של משתמשים.

אפשרויות

-c configfile
מציין נתיב חלופי לקובץ תצורה. כברירת מחדל, i3blocks מחפש
קבצי תצורה בסדר הבא (שים לב ש /וכו עשוי להיות קידומת של
/ usr / local בהתאם לדגלי הקומפילציה):

1. ~/.config/i3blocks/config (או $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. כל סעיף מתאר בלוק חדש. שורה
מתחיל בא # סימן הוא הערה, ומתעלמים משורות ריקות. נכס הוא א
מפתח=ערך זוג לכל שורה, ללא רווח סביב סימן השוויון. נכסים שהוכרזו בחוץ
בלוק (כלומר בתחילת הקובץ) מתאר הגדרות גלובליות.

הנה דוגמה לקובץ תצורה:

# זוהי תגובה
מרווח=5
color=#00FF00

[מזג אוויר]
פקודה =~/bin/weather.pl
מרווח=1800

[זְמַן]
command=date +%T

כדי להשתמש ב-i3blocks בתור שורת המצב שלך, הגדר אותו ב-a בָּר בלוק שלך ~/i3/config קובץ:

בר {
status_command i3blocks
}

BLOCK

המאפיינים המשמשים לתיאור בלוק הם המפתחות המצוינים בפרוטוקול i3bar
http://i3wm.org/docs/i3bar-protocol.html, בתוספת מאפיינים נוספים בשימוש על ידי i3blocks ל
תאר מתי וכיצד לעדכן בלוק. כל המאפיינים הנתמכים מתוארים להלן.

המפתחות הבאים הם סטנדרטיים, ראה http://i3wm.org/docs/i3bar-protocol.html לקבלת פרטים.

· טקסט מלא

· טקסט קצר

· צֶבַע

· min_width

· ליישר

· שם

· למשל

· דחוף

· מפריד

· separator_block_width

· סימון

המפתחות הבאים הם ספציפיים ל i3blocks.

הפקודה
הפקודה המבוצעת על ידי מעטפת, משמשת לעדכון הבלוק. ההתנהגות הצפויה היא
המתואר להלן, ב- פקודה סָעִיף.

הפסקה
אם זה מספר שלם חיובי, אז הבלוק נוצר עם ההפעלה והערך הוא
משמש כמרווח זמן בשניות לתזמן עדכונים עתידיים. אם לא צוין או 0,
החסימה לא תתבצע בעת ההפעלה (וזה שימושי כדי לדמות כפתורים). אם
"פעם אחת" (או -1), החסימה תתבצע רק בעת האתחול (שים לב שלחיצה על או
האות עדיין יפעיל עדכון). אם "חזרה" (או -2), החסימה תהיה
נוצר עם ההפעלה, וברגע שהוא מסתיים (שימושי כדי לחזור על חסימה
פקודות). השתמש בזהירות! אם "מתמיד" (או -3), החסימה תתבצע בלבד
בהפעלה, ומתעדכן ברגע שהוא מוציא שורה. לפיכך מוגבל לקו בודד
עדכונים.

אוֹת מספר האות המשמש לעדכון הבלוק. כל זמן אמת (תחשוב על סדר עדיפויות
אותות הניתנים לתור) זמינים למשתמש. המספר תקף בין 1 ל
N, כאשר SIGRTMIN+N = SIGRTMAX. (הערה: ישנם 31 אותות בזמן אמת בלינוקס.)
לדוגמה, אות=10 פירושו שבלוק זה יעודכן מתי i3blocks
מקבל SIGRTMIN+10.

תווית תווית אופציונלית להקדים ל- טקסט מלא לאחר עדכון.

פוּרמָט מאפיין זה מציין את הפורמט של טקסט הפלט. פורמט ברירת המחדל הוא רגיל
טקסט, כמתואר ב- פקודה סָעִיף. אם נעשה שימוש ב-"json" (או 1), הבלוק
הפלט מנותח כ-JSON.

פקודה

הערך של הפקודה המפתח יועבר ויבוצע כפי שהוא על ידי מעטפת.

הפלט הסטנדרטי של שורת הפקודה משמש לעדכון תוכן הבלוק. כל אחד
שורה לא ריקה של הפלט תחליף את המאפיין המתאים:

1. טקסט_מלא

2. טקסט קצר

3. צבע

לדוגמה, סקריפט זה מגדיר את טקסט מלא בכחול אבל לא טקסט קצר:

הד "הנה התווית שלי"
הד
הד \#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 מופע=$BLOCK_INSTANCE
מרווח=1

[לחץ עלי]
full_text=לחץ עליי!
command=echo button=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=button=1 x=1366 y=768
יישר = שמאל

שים לב כי i3blocks מספק קבוצה של סקריפטים אופציונליים לנוחות, כגון רשת
מצב, בדיקת סוללה, עומס מעבד, נפח וכו'.

דוגמאות

כדוגמה, הנה תצורה קרובה ל i3status(1) הגדרות ברירת מחדל:

הכל

מרווח=5
אות=10

[ipv6]

[חופשי]

[dhcp]

[vpn]

[וויי - פיי]

[אתרנט]
min_width=E: 255.255.255.255 (1000 Mbit/s)

[סוֹלְלָה]

[מעבד]

[תאריך תאריך]

הבלוק הבא מציג את השימוש ב אוֹת עם כמה i3(1) כריכות שמתאימות את
נפח, לפני הנפקת א pkill -RTMIN+1 i3blocks:

[כרך]
command=echo -n ´נפח: ´; amixer קבל מאסטר | grep -E -o ´[0-9][0-9]?%´
מרווח=פעם אחת
אות=1
# ללא מרווח, בדוק רק על SIGRTMIN+1

הנה דוגמה לתצורה מינימליסטית מאוד, בהנחה שיש לך חבורה של סקריפטים מתחת
~/bin/blocks/ עם אותו שם כמו הבלוקים:

פקודה =~/bin/blocks/$BLOCK_NAME
מרווח=1

[חופשי]
[וויי - פיי]
[אתרנט]
[סוֹלְלָה]
[מעבד]
[תאריך תאריך]

השתמש ב-i3blocks באופן מקוון באמצעות שירותי onworks.net