نام (NAME)

lcdproc-config - قالب فایل‌های پیکربندی LCDproc

ساختار دستوری (SYNTAX)

ساختار فایل‌های پیکربندی LCDproc به سبک فایل‌های INI است.

آن‌ها فایل‌های متنی ۸-بیتی هستند که به بخش‌هایی تقسیم شده‌اند و هر بخش شامل صفر یا چند جفت کلید-مقدار است. بخش‌ها با برچسب‌های بخش که با «[» شروع شده و با «]» پایان می‌یابند مشخص می‌شوند، و جفت‌های کلید-مقدار هر کدام از یک نام کلید، یک علامت «=» و یک مقدار تشکیل شده‌اند.

نام‌های کلید دنباله‌ای از نویسه‌های غیرفاصله‌ای هستند که با «[» شروع نمی‌شوند و شامل «=» یا «\n» نیستند، در حالی که مقادیر رشته‌هایی شبیه به پوسته هستند؛ بدین معنی که یا دنباله‌های ساده‌ای از نویسه‌های غیرفاصله‌ای هستند، یا رشته‌های داخل نقل‌قول دوگانه با نحو زبان C (به‌جز عدم پشتیبانی از توالی‌های گریز «\NNN» و «\xNN») یا ترکیبی از هر دوی این حالت‌ها هستند.

برچسب‌های بخش و نام‌های کلید به حروف بزرگ و کوچک حساس نیستند (case-insensitive) و ممکن است بیش از یک بار تکرار شوند. کلیدهای بخش‌های تکراری در یک بخش ادغام خواهند شد، در حالی که مقادیر کلیدهای تکراری در یک بخش به یکدیگر پیوست می‌شوند تا آرایه‌ای از مقادیر را برای آن کلید تشکیل دهند. (در برنامه، تمام مقادیر یک کلید می‌توانند به‌صورت جداگانه دریافت شوند).

فاصله‌های اطراف برچسب‌های بخش، کلیدها و مقادیر نادیده گرفته می‌شوند. خطوطی که با «;» یا «#» شروع می‌شوند، به عنوان توضیح (کامنت) در نظر گرفته شده و نادیده گرفته می‌شوند.

اگرچه تمام موارد فوق در بیشتر پیاده‌سازی‌های فایل‌های INI مشترک است، چند ویژگی خاص وجود دارد که فایل‌های پیکربندی LCDproc را متمایز می‌کند:

• برچسب‌های بخش می‌توانند شامل هر نویسه‌ای به‌جز «]»، «\n» یا «\0» باشند. با این حال، تمام نویسه‌ها به‌صورت تحت‌اللفظی تفسیر می‌شوند (یعنی نه نقل‌قول و نه توالی‌های گریز پردازش نمی‌شوند).
• نام‌های کلید می‌توانند شامل هر نویسه غیرفاصله‌ای به‌جز «\n» یا «\0» باشند. با این حال، تمام نویسه‌ها به‌صورت تحت‌اللفظی تفسیر می‌شوند (یعنی نه نقل‌قول و نه توالی‌های گریز پردازش نمی‌شوند).
• نوشتن توضیحات پس از برچسب‌های بخش و جفت‌های کلید-مقدار مجاز است.
• مقادیر می‌توانند ترکیبی از رشته‌های نقل‌قول‌شده و نقل‌قول‌نشده باشند، مشابه روشی که رشته‌ها در پوسته تفسیر می‌شوند. برای مثال، مقدار 'string" with "blanks"\t!"' به‌صورت 'string with blanks<TAB>!' تجزیه می‌شود که در آن <TAB> نمایانگر نویسه تب است.

در صورت بروز خطای تجزیه، باقی‌مانده خط نادیده گرفته شده و فرایند تجزیه از خط بعدی ادامه می‌یابد.

مثال‌ها (EXAMPLES)

در اینجا یک نمونه کاملاً کاربردی از LCDd.conf آورده شده است (با فرمت‌بندی کمی غیرمعمول برای نمایش ویژگی‌ها):

# بخش سرور
[server]
Bind=127.0.0.1
Port=13666
User="nobody"
#Foreground=no
#ReportLevel=3
#ReportToSyslog=yes
Driver="my Curses Driver"
DriverPath=/usr/lib/lcdproc/
WaitTime= "5"
ServerScreen=no
# اختصاص کلیدها به عملکردهای خاص #
ToggleRotateKey = Enter
PrevScreenKey = Left
NextScreenKey = Right
# ScrollUpKey = Up
 #ScrollDownKey=Down
#  بخش منو: تعریف کلیدهای مورد استفاده در منوی سرور #
	 [menu]
MenuKey = Escape	# کلید ESC به منوی سرور تغییر وضعیت می‌دهد
EnterKey =Enter
UpKey= Up	
DownKey="Down"
 LeftKey= "Left"
 RightKey = "Right"
# پیکربندی درایور curses #
[my curses Driver]	# بله، من از درایور curses استفاده می‌کنم
File= "curses.so"
Size="20"x"4"		# ابعاد صفحه نمایش LCD
TopLeftX=7		# موقعیت صفحه: مختصات X
TopLeftY=7		# موقعیت صفحه: مختصات Y
Foreground=blue		# رنگ پیش‌زمینه
Background=cyan		# رنگ پس‌زمینه هنگام خاموش بودن نور پس‌زمینه
Backlight=red		# رنگ پس‌زمینه هنگام روشن بودن نور پس‌زمینه

فایل‌ها (FILES)

این‌ها فایل‌های پیکربندی پیش‌فرض برای بخش‌های مختلف مجموعه LCDproc هستند:

/etc/LCDd.conf

پیکربندی دیمن سرور LCDd

/etc/lcdproc.conf

پیکربندی کلاینت پایش سیستم lcdproc

/etc/lcdexec.conf

پیکربندی کلاینت راه‌انداز برنامه lcdexec

/etc/lcdvc.conf

پیکربندی کلاینت کنسول مجازی lcdvc

همچنین ببینید (SEE ALSO)

LCDd(8), lcdproc(1), lcdexec(1)

نویسندگان (AUTHORS)

این صفحه راهنما توسط Peter Marschall <peter@adpm.de> نوشته شده است.