'\" t
.\"     Title: i3blocks
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2019-08-12
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "I3BLOCKS" "1" "2019-08-12" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
i3blocks \- یک تولیدکننده فید برای نوارهای وضعیت مبتنی بر متن
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBi3blocks\fP [\fIOPTION\fP]...
.SH "توضیحات (DESCRIPTION)"
.sp
دستور i3blocks(1) یک خط وضعیت برای i3bar(1) تولید می‌کند.
این دستور خطوط فرمانی را که در یک فایل پیکربندی ساده شرح داده شده‌اند، در بازه‌های زمانی مشخص، پس از دریافت سیگنال یا هنگام کلیک‌ها زمان‌بندی و اجرا می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h\fP
.RS 4
نمایش پیام راهنما و خروج.
.RE
.sp
\fB\-c\fP \fICONFIGFILE\fP
.RS 4
مسیر فایل پیکربندی جایگزین را مشخص می‌کند.
.RE
.sp
\fB\-v\fP
.RS 4
سطح گزارش‌گیری (log level) را افزایش می‌دهد.
این گزینه انباشت‌پذیر است.
به‌طور پیش‌فرض تنها خطاهای مهلک در نوار وضعیت نمایش داده می‌شوند.
ارسال این گزینه برای یک‌بار، پیام‌های خطا را نیز نمایش می‌دهد.
استفاده از \fB\-vv\fP و بیشتر، خروجی اشکال‌زدایی (debug) بیشتری را در خطای استاندارد نمایش خواهد داد.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
برنامه i3blocks باید به عنوان دستور خط وضعیت برای بلوک \fBbar\fP که در فایل پیکربندی i3(1) شما شرح داده شده است، تعریف شود:
.sp
.if n .RS 4
.nf
bar {
  status_command i3blocks
}
.fi
.if n .RE
.sp
به‌طور پیش‌فرض، i3blocks به ترتیب زیر به دنبال فایل پیکربندی می‌گردد (توجه داشته باشید که بسته به پرچم‌های زمان کامپایل، ممکن است پیشوند /usr/local قبل از /etc قرار گیرد):
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
\fI$XDG_CONFIG_HOME/i3blocks/config\fP (یا \fI~/.config/i3blocks/config\fP)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
\fI~/.i3blocks.conf\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
\fI$XDG_CONFIG_DIRS/i3blocks/config\fP (یا \fI/etc/xdg/i3blocks/config\fP)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
\fI/etc/i3blocks.conf\fP
.RE
.sp
برای اطلاع از محتوای فایل پیکربندی، لطفاً به وب‌سایت i3blocks مراجعه کنید: \c
.URL "https://vivien.github.io/i3blocks" "" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
i3(1), i3bar(1), i3status(1)
.SH "نویسندگان (AUTHORS)"
.sp
i3blocks توسط Vivien Didelot و دیگر مشارکت‌کنندگان نوشته شده است.
.SH "منابع (RESOURCES)"
.sp
\fBوب‌سایت پروژه:\fP \c
.URL "https://vivien.github.io/i3blocks" "" ""
.sp
\fBمخزن کد مبدأ و ردیاب مشکلات در Git:\fP \c
.URL "https://github.com/vivien/i3blocks" "" ""
.sp
\fBمجموعه رسمی اسکریپت‌ها برای i3blocks:\fP \c
.URL "https://github.com/vivien/i3blocks\-contrib" "" ""
.sp
\fBپروتکل i3bar:\fP \c
.URL "http://i3wm.org/docs/i3bar\-protocol.html" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر \(co متعلق است به Vivien Didelot.
استفاده آزاد از این نرم‌افزار تحت شرایط مجوز \fIGPLv3+\fP مجاز است.