| NEWSBOAT(1) | NEWSBOAT(1) |
نام (NAME)
newsboat - یک خوراکخوان RSS/Atom برای ترمینالهای متنی
خلاصه دستور (SYNOPSIS)
newsboat [-r] [-e] [-i opmlfile] [-u urlfile] [-c cachefile] [-C configfile] [-X] [-o] [-x command...] [-h]
توضیحات (DESCRIPTION)
برنامه Newsboat یک خوراکخوان RSS/Atom برای ترمینالهای متنی است. RSS و Atom مجموعهای از قالبهای پرکاربرد XML برای انتقال، انتشار و همرسانی مقالات، مانند اخبار یا مقالات وبلاگی هستند. Newsboat برای استفاده در ترمینالهای متنی در سیستمهای یونیکس یا شبهیونیکس مانند GNU/Linux، BSD یا macOS طراحی شده است.
گزینهها (OPTIONS)
-h, --help
-r, --refresh-on-start
-e, --export-to-opml
--export-to-opml2
-X, --vacuum
--cleanup
علاوه بر این، اگر پیکربندی delete-read-articles-on-quit تنظیم شده باشد، تمام مقالات خواندهشده حذف خواهند شد (شامل مقالات خوراکهایی که هنوز در فایل urls هستند).
-v, -V, --version
-i opmlfile, --import-from-opml=opmlfile
-u urlfile, --url-file=urlfile
-c cachefile, --cache-file=cachefile
-C configfile, --config-file=configfile
--queue-file=queuefile
--search-history-file=searchhistoryfile
--cmdline-history-file=cmdlinehistoryfile
-x command ..., --execute=command...
-l loglevel, --log-level=loglevel
-d logfile, --log-file=logfile
-E file, --export-to-file=file
-I file, --import-from-file=file
گامهای نخست (FIRST STEPS)
پس از نصب Newsboat، میتوانید برای نخستین بار با تایپ newsboat در خط فرمان آن را اجرا کنید. با این کار پیام زیر نمایش داده میشود:
Error: no URLs configured. Please fill the file /home/ak/.newsboat/urls with RSS feed URLs or import an OPML file.
Newsboat 2.22
usage: ./newsboat [-i <file>|-e] [-u <urlfile>] [-c <cachefile>] [-x <command> ...] [-h]
-e, --export-to-opml export OPML feed to stdout
-r, --refresh-on-start refresh feeds on start
-i, --import-from-opml=<file> import OPML file
-u, --url-file=<urlfile> read RSS feed URLs from <urlfile>
-c, --cache-file=<cachefile> use <cachefile> as cache file
-C, --config-file=<configfile> read configuration from <configfile>
-X, --vacuum compact the cache
-x, --execute=<command>... execute list of commands
-q, --quiet quiet startup
-v, --version get version information
-l, --log-level=<loglevel> write a log with a certain loglevel (valid values: 1 to 6)
-d, --log-file=<logfile> use <logfile> as output log file
-E, --export-to-file=<file> export list of read articles to <file>
-I, --import-from-file=<file> import list of read articles from <file>
-h, --help this help
--cleanup remove unreferenced items from cache
این پیام به این معناست که Newsboat نمیتواند بدون هیچ خوراک پیکربندیشدهای آغاز به کار کند.
افزودن خوراکها (Adding Feeds)
برای افزودن خوراکها به Newsboat، کافی است در هر سطر از فایل پیکربندی ~/.newsboat/urls نشانی URL یک خوراک را اضافه کنید:
http://rss.cnn.com/rss/cnn_topstories.rss http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
شما همچنین میتوانید با اجرای دستور newsboat -i blogroll.opml یک فایل OPML را درونریزی کنید.
افزودن توضیحات سطرهایی که با # آغاز میشوند میتوانند هر متنی را در خود داشته باشند. توضیحات توسط Newsboat نادیده گرفته میشوند، اما میتوانند به عنوان مستندسازی برای شما عمل کنند. لطفاً توجه داشته باشید که غیرفعال کردن URLها با کامنتگذاری به منظور خطایابی ممکن است باعث از دست رفتن غیرمنتظره دادهها شود؛ برای جزئیات بیشتر به تنظیم cleanup-on-quit مراجعه کنید.
خوراکهای دارای دسترسی محدود
اگر نیاز به افزودن نشانیهایی دارید که دسترسی محدود دارند، کافی است نام کاربری/گذرواژه را در نشانی درج کنید:
در صورتی که در نام کاربری نویسه @ وجود داشته باشد، باید آن را به صورت %40 بنویسید.
به منظور محافظت از نامهای کاربری و گذرواژهها، حتماً دسترسی خواندن فایل ~/.newsboat/urls را تنها به خودتان و در صورت تمایل به گروهتان محدود کنید:
$ chmod u=rw,g=r,o= ~/.newsboat/urls
نرمافزار Newsboat اطمینان حاصل میکند که نامهای کاربری و گذرواژهها در رابط کاربری آن نمایش داده نشوند.
فایلهای محلی به عنوان خوراک
همچنین میتوانید با قرار دادن پیشوند file:// در ابتدای مسیر محلی و افزودن آن به فایل urls، فایلهای محلی را به عنوان خوراک پیکربندی کنید:
file:///var/log/rss_eventlog.xml
تعامل اولیه با رابط کاربری (First UI Interaction)
رابط کاربری اصلی Newsboat شامل سه نما است:
نمای فهرست خوراکها → نمای فهرست مقالات → نمای مقاله
با فشردن کلید Enter میتوانید وارد این نماها شوید و با فشردن کلید Q به نمای قبلی بازگردید. فشردن Q در نمای فهرست خوراکها — یا فشردن Shift + Q در هر کجای برنامه — موجب خروج از Newsboat میشود.
همچنین میتوانید با فشردن کلید / در نمای فهرست خوراکها یا نمای فهرست مقالات، در عنوان یا متن مقالات جستجو کنید. در نمای فهرست خوراکها تمامی مقالاتِ همه خوراکها جستجو میشوند. در نمای فهرست مقالات، تنها مقالات خوراک جاری بررسی میشوند. هنگام باز کردن مقالهای از پنجره نتایج جستجو، عبارت جستجوشده به صورت برجسته (highlight) نمایش داده میشود.
تاریخچه جستجو تاریخچه تمام جستجوهای شما در سیستم فایل و در فایل history.search (در کنار فایل cache.db) ذخیره میشود. به صورت پیشفرض، ۱۰۰ عبارت جستجوی اخیر نگهداری میشود.
میتوانید با پیکربندی تنظیم history-limit، تعداد عبارات جستجوی ذخیرهشده را تغییر دهید.
نمای فهرست خوراکها
هنگامی که Newsboat را آغاز میکنید، فهرستی از خوراکهایی که قبلاً اضافه کردهاید به شما نمایش داده میشود.
اکنون میتوانید کارهای زیر را انجام دهید:
مقالات محلی برنامه Newsboat مقالاتی را که دانلود میکند ذخیره نگه میدارد. وقتی دوباره Newsboat را باز کرده و خوراکی را بازخوانی میکنید، مقالات قدیمی همچنان قابل خواندن هستند حتی اگر دیگر در خوراکهای RSS جاری وجود نداشته باشند. حداکثر تعداد مقالات با تنظیم max-items کنترل میشود.
حافظه نهان (Caching) نرمافزار Newsboat با استفاده از دانلود مشروط بر بستر HTTP، تدابیری برای حفظ پهنای باند کاربران و ارائهدهندگان خوراک اتخاذ میکند. این برنامه مقادیر هدرهای پاسخ "Last-Modified" و "ETag" هر خوراک را (در صورت وجود) ذخیره میکند و به سرور HTTP خوراک اعلام میکند که تنها در صورت بهروزرسانی خوراک دادهها را ارسال کند. این سازوکار نه تنها بارگیری خوراکهای RSS فاقد بهروزرسانی را سریعتر میسازد، بلکه حجم دادههای منتقلشده در هر درخواست را نیز کاهش میدهد.
شما میتوانید دانلود مشروط HTTP را برای هر خوراک با استفاده از تنظیم always-download غیرفعال کنید.
نمای فهرست مقالات
پس از ورود به یک خوراک، میتوانید فهرست مقالات موجود را بر اساس عنوان آنها مشاهده کنید. وجود حرف N در سمت چپ نشان میدهد که مقاله هنوز خوانده نشده است.
اکنون میتوانید کارهای زیر را انجام دهید:
نمای مقاله
در نمای مقاله میتوانید در متن پیمایش کرده و آن را بخوانید. هر پیوند درون مقاله دارای یک شماره در کنار خود است.
اکنون میتوانید کارهای زیر را انجام دهید:
نمای مرورگر گاهی اوقات محتوای یک مقاله خالی است یا تنها یک چکیده و توضیح کوتاه دارد. شما همیشه میتوانید کلید O را فشار دهید تا مقاله کامل را در یک مرورگر مشاهده کنید. مرورگر پیشفرض lynx است.
میتوانید با پیکربندی تنظیم browser، از مرورگر دلخواه خود استفاده کنید.
پیکربندی (CONFIGURATION)
جنبههای گوناگون Newsboat را میتوان از طریق یک فایل config که در کنار فایل urls ذخیره میشود پیکربندی کرد. یک خط پیکربندی به طور کلی به این صورت است:
<config-command> <arg1> ...
فایل پیکربندی میتواند شامل توضیحات باشد که با نویسه # آغاز شده و تا انتهای سطر ادامه مییابند.
مشارکتهای کاربران (User contrib) نرمافزار Newsboat همچنین همراه با محتوای ارائهشده توسط کاربران مانند اسکریپتها و پوستههای رنگی عرضه میشود. این محتوا را میتوان در مسیر /usr/share/doc/newsboat/contrib/ یافت. به کاربران توصیه میشود نگاهی به آنها بیندازند، زیرا ممکن است موارد مفیدی بیابند.
مثال (Example)
یک نمونه پیکربندی به این صورت است:
# یک توضیح max-items& 100 # چنین توضیحاتی نیز امکانپذیر هستند browser& links show-read-feeds& no unbind-key& R bind& ^R feedlist reload-all
تقسیم خطوط طولانی به چند سطر (Splitting long lines into multiple ones)
تنظیماتی مانند ماکروها و ignore-article میتوانند بسیار طولانی باشند. یک سطر طولانی را میتوان با استفاده از بکاسلش به چند سطر شکست. بکاسلش باید آخرین نویسه روی خط باشد و بلافاصله آن سطر را به سطر بعدی پیوند میدهد. مهم است که هیچ چیز پس از \ روی همان سطر قرار نگیرد، در غیر این صورت با نویسه \ به صورت یک نویسه معمولی رفتار میشود. برای مثال:
macro p open; \ reload; quit; \ quit;& \ quit -- "Opens, reloads then makes sure to quit newsboat"
لطفاً توجه داشته باشید که بکاسلش تنها موجب میشود که Newsboat از خط جدید بعدی چشمپوشی کند. این کار هیچ اثر دیگری ندارد. برای مثال، این گزینه قالببندیشده:
ignore-article \
"*" \
"author =~ \"(\
John Doe| \
Mary Sue \
)\""
به این مورد تبدیل نمیشود:
ignore-article "*" "author =~ \"(John Doe|Mary Sue)\""
در عوض، از آنجا که تنها خطوط جدید حذف میشوند، به این شکل تبدیل میشود:
ignore-article& "*"& "author =~ \"(& John Doe|& Mary Sue& )\""
به همین دلیل، هنگام شکستن خطوط دقت کافی داشته باشید، زیرا ممکن است فاصلهها اهمیت داشته باشند.
استفاده از علامت نقلقول دوتایی (Using Double Quotes)
خلاصه (TL;DR) برای رشتههایی که حاوی فاصله یا دابل کوتیشن هستند از نقلقول دوتایی (double quote) استفاده کنید. دابل کوتیشنها (با \") و بکاسلشها (با \\) را escape کنید. عبارات بیرون از نقلقول را escape نکنید و از کوتیشن تکی استفاده نکنید — زیرا Newsboat از آن پشتیبانی نمیکند.
بسیاری از گزینههای Newsboat رشتهها را به عنوان آرگومان میپذیرند؛ از جمله دستورات، گذرواژهها، عناوین پنجرهها، نشانیهای URL و غیره. برخی گزینهها حتی چندین رشته را به طور همزمان دریافت میکنند. این رشتهها میتوانند حاوی فاصله باشند که ممکن است Newsboat را به اشتباه بیندازد، زیرا این برنامه از فاصله برای جداسازی نام گزینهها از آرگومانها استفاده میکند.
برای درک صحیح هدف شما توسط Newsboat، چنین رشتههایی را درون نقلقول دوتایی (دابل کوتیشن) قرار دهید:
browser "firefox --new-tab %u"
اگر به یک دابل کوتیشن درون رشته نیاز داشتید چطور؟ آن را با یک بکاسلش escape کنید:
ocnews-password "UnbalancedQuotes\"AreSoFun!"
و خود بکاسلش چطور؟ آن را نیز escape کنید! فرض کنید برنامهای به نام my favourite pager دارید و میخواهید مقالات را با آن مشاهده کنید. برنامه Newsboat در نهایت دستورات را به شل ارسال میکند و اگر میخواهید فاصلهها حفظ شوند، شل انتظار دارد که فاصلهها escape شوند. اما از آنجا که خود Newsboat بکاسلشها را تفسیر میکند، باید یک لایه دیگر از escape را اضافه کنید. بنابراین، دستوری مانند زیر خواهید داشت:
pager "/usr/bin/my\\ favourite\\ pager"
ارزیابی شل (Shell Evaluation)
همچنین امکان ادغام خروجی دستورات خارجی در پیکربندی وجود دارد. متنی که بین دو علامت بکتیک ` قرار دارد به عنوان دستور شل ارزیابی شده و خروجی آن استفاده میشود. این قابلیت مانند ارزیابی بکتیک در شلهای سازگار با Bourne کار میکند و به کاربران امکان میدهد از اطلاعات خارجی سیستم در پیکربندی استفاده کنند.
گریز دادن کاراکترها (Escaping)
نویسههای بکتیک و # را میتوان با استفاده از یک بکاسلش گریز داد (مانند \` و \#). در این حالت، آنها با نویسههای لفظی ` یا # در پیکربندی جایگزین میشوند.
کلیدهای میانبر (Key Bindings)
سبک جدید کلیدهای میانبر که در اینجا شرح داده شده است، از نسخه ۲٫۳۹ در Newsboat پشتیبانی میشود.
میتوانید با استفاده از دستور پیکربندی bind، یک کلید (یا توالی از کلیدها) را به یک عملیات (یا فهرستی از عملیات) مقید کنید.
ساختار دستوری برای تعریف میانبر به صورت زیر است:
bind <key-sequence> <dialog>[,<dialog>] <operation-list> [-- "<description>"]
هشدار: محدودیتها
میانبرهایی که پیشوند مشترک دارند باید همگی طول یکسانی داشته باشند؛ در غیر این صورت، تنها آخرین میانبر ایجاد میشود.
برای مثال:
bind ab everywhere … bind abc everywhere …
تنها یک میانبر برای abc ایجاد میکند. تغییر ترتیب دستورات موجب ایجاد میانبر برای ab خواهد شد.
این امر از ابهام در زمانی که ab تایپ میشود و Newsboat نمیداند آیا باید میانبر ab را اجرا کند یا اینکه کاربر کلید c بعدی را فشار خواهد داد و میانبر دیگر را فرا میخواند، جلوگیری میکند.
برای داشتن هر دو میانبر، یا:
توالی کلیدها (Key Sequence)
کلیدهای کوچک، کلیدهای بزرگ و نویسههای خاص به صورت دقیق و لفظی نوشته میشوند.
ترکیبهای کلیدی با Ctrl با استفاده از علامت هشتک (caret) ^ نوشته میشوند. برای نمونه، Ctrl + R معادل ^R است. لطفاً توجه داشته باشید که تمامی ترکیبهای کلیدی مرتبط با Ctrl باید با حروف بزرگ نوشته شوند.
همچنین، کلیدهای ترکیبی شامل Shift یا Ctrl را میتوان به صورت <S-a> و <C-a>، به ترتیب برای Shift + A و Ctrl + A نوشت. توجه داشته باشید که این ساختار جایگزین تنها با دستور bind کار میکند و در دستور قدیمیتر bind-key پشتیبانی نمیشود.
شناسههای زیر برای کلیدهای ویژه پشتیبانی میشوند:
چندین کلید میتوانند به صورت متوالی قرار گیرند. برای مثال gg به معنای فشردن دو بار کلید g و ^O<ENTER> به معنای فشردن Ctrl + O و سپس Enter است. فشردن Esc ورودی چندکلیدی را لغو میکند.
کادر گفتگو یا پنجره (Dialog)
یک پنجره (dialog) بستری است که میانبر کلیدی در آن فعال است. پنجرههای موجود عبارتند از:
چندین پنجره را میتوان با کاما مشخص کرد. برای مثال:
bind k feedlist,articlelist,urlview up bind j feedlist,articlelist,urlview down
یا با استفاده از everywhere برای اعمال میانبر در تمام پنجرهها:
bind k everywhere up bind j everywhere down
فهرست عملیات (Operation List)
عملیاتها با فشردن توالی متناظر کلیدها اجرا میشوند. برای مشاهده فهرست کامل عملیات موجود به بخشهای [_newsboat_operations] و [_podboat_operations] مراجعه کنید.
چندین عملیات را میتوان با جدا کردن آنها با نقطه ویرگول (;) تعیین کرد. برخی عملیاتها اجازه تعیین یک آرگومان را میدهند، به عنوان مثال دستور set <config option> <config value> میتواند برای تغییر یک گزینه پیکربندی استفاده شود.
یک توالی با دو خط تیره که به دنبال آن متنی در نقلقول دوتایی قرار دارد میتواند برای افزودن توضیحات به میانبر استفاده شود (مانند -- "some description"). در صورت وجود، این توضیحات در پنجره راهنما نمایش داده میشوند.
در ترکیب با یکدیگر، این موارد ممکن است به این شکل باشند:
bind of everywhere set browser "firefox" ; open-in-browser -- "Open in Firefox"
مثال بالا به این معناست که فشردن کلید o و به دنبال آن f، مرورگر پیکربندیشده را به firefox تغییر میدهد و سپس دستور open-in-browser را برای باز کردن خوراک/مقاله در مرورگر پیکربندیشده اجرا میکند.
دستور bind شبیه به ماکروهاست اما انعطافپذیرتر است. ماکروها به صورت سراسری پیکربندی میشوند، در حالی که bind میتواند روی پنجرههای خاص اعمال شود. علاوه بر این، ماکروها همیشه نیازمند فشردن ۲ کلید هستند (macro-prefix به دنبال کلید اختصاصی ماکرو)، در حالی که bind میتواند توالی کلیدی با هر طولی را مشخص کند.
کلیدهای میانبر سبک قدیمی (Old Style Key Bindings)
میتوانید با دستور پیکربندی bind-key یک کلید منفرد را به یک عملیات منفرد مقید کنید. این روش ساختاری قدیمیتر و محدودتر برای کلیدهای میانبر است. میتوانید یک پنجره اختیاری را نیز مشخص کنید که بستری است که میانبر کلیدی در آن فعال خواهد بود.
ساختار دستوری برای میانبر کلیدی سبک قدیمی به این شکل است:
bind-key <key> <operation> [<dialog>]
کلید (Key)
کلیدهای کوچک، کلیدهای بزرگ و نویسههای خاص به صورت دقیق و لفظی نوشته میشوند.
ترکیبهای کلیدی با Ctrl با استفاده از علامت هشتک (caret) ^ نوشته میشوند. برای نمونه، Ctrl + R معادل ^R است. لطفاً توجه داشته باشید که تمامی ترکیبهای کلیدی مرتبط با Ctrl باید با حروف بزرگ نوشته شوند.
شناسههای زیر برای کلیدهای ویژه پشتیبانی میشوند:
عملیات (Operation)
یک عملیات با فشردن کلید مربوطه اجرا میشود. برای مشاهده فهرست کامل عملیات موجود به بخشهای [_newsboat_operations] و [_podboat_operations] مراجعه کنید.
پنجره (Dialog)
یک پنجره (dialog) بستری است که میانبر کلیدی در آن فعال است. پنجرههای موجود عبارتند از:
رنگها (Colors)
پیکربندی تنظیمات رنگ سفارشی در Newsboat امکانپذیر است. ساختار پایه پیکربندی به صورت زیر است:
color <element> <foreground color> <background color> [<attribute> ...]
این به آن معناست که اگر رنگها را برای یک عنصر خاص پیکربندی میکنید، حداقل باید یک رنگ پیشزمینه و یک رنگ پسزمینه تعیین کنید. رنگهای زیر پشتیبانی میشوند:
رنگ default به این معناست که از رنگ پیشفرض ترمینال استفاده خواهد شد. نام رنگ color<n> (که در آن <n> یک عدد دهدهی است که با صفر شروع نمیشود) در صورتی که ترمینال شما از ۲۵۶ رنگ پشتیبانی کند (مانند gnome-terminal یا xterm با متغیر TERM تنظیمشده روی xterm-256color) میتواند استفاده شود. نرمافزار Newsboat از نسخه ۲٫۱ از ترمینالهای ۲۵۶ رنگ پشتیبانی میکند. برای جدول کامل رنگها و شمارههای متناظر آنها، لطفاً به پیوند زیر مراجعه کنید: https://www.calmar.ws/vim/256-xterm-24bit-rgb-color-chart.html.
همچنین میتوانید به صورت اختیاری یک یا چند صفت را اضافه کنید. صفتهای زیر پشتیبانی میشوند:
در حال حاضر، عناصر زیر پشتیبانی میشوند:
پیکربندی پیشفرض رنگ Newsboat به این صورت است:
color background& white& black color listnormal& white& black color listfocus& yellow& blue& bold color listnormal_unread& white& black& bold color listfocus_unread& yellow& blue& bold color title& yellow& blue& bold color info& yellow& blue& bold color hint-key& yellow& blue& bold color hint-keys-delimiter white& blue color hint-separator& white& blue& bold color hint-description& white& blue color article& white& black
دستورات پیکربندی (CONFIGURATION COMMANDS)
always-display-description (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
always-download (پارامترها: <url> [<url>...]؛ مقدار پیشفرض: n/a)
article-sort-order (پارامترها: <sortfield>[-<direction>]؛ مقدار پیشفرض: date-asc)
articlelist-format (پارامترها: <format>؛ مقدار پیشفرض: "%4i %f %D %6L %?T?|%-17T| ?%t")
articlelist-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Articles in feed '%T' (%u unread, %t total)%?F? matching filter '%F'&? - %U" (بومیسازیشده))
auto-reload (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
bind (پارامترها: <key-sequence> <dialog>[,<dialog>] <command-list> [-- "<binding description>"]؛ مقدار پیشفرض: n/a)
bind-key (پارامترها: <key> <operation> [<dialog>]؛ مقدار پیشفرض: n/a)
bookmark-autopilot (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
bookmark-cmd (پارامترها: <command>؛ مقدار پیشفرض: "")
bookmark-interactive (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
browser (پارامترها: <command>؛ مقدار پیشفرض: %BROWSER، در غیر این صورت lynx)
cache-file (پارامترها: <path>؛ مقدار پیشفرض: "~/.newsboat/cache.db" یا "~/.local/share/cache.db" (به بخش FILES مراجعه کنید))
cleanup-on-quit (پارامترها: [yes/no/nudge]؛ مقدار پیشفرض: nudge)
color (پارامترها: <element> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیشفرض: n/a)
confirm-delete-all-articles (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
confirm-exit (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
confirm-mark-all-feeds-read (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
confirm-mark-feed-read (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
cookie-cache (پارامترها: <path>؛ مقدار پیشفرض: "")
datetime-format (پارامترها: <date/time format>؛ مقدار پیشفرض: %b %d)
define-filter (پارامترها: <name> <filterexpr>؛ مقدار پیشفرض: n/a)
delete-read-articles-on-quit (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
dialogs-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Dialogs" (بومیسازیشده))
dirbrowser-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - %?O?Open Directory&Save File? - %f" (بومیسازیشده))
display-article-progress (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
download-full-page (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
download-retries (پارامترها: <number>؛ مقدار پیشفرض: 1)
download-timeout (پارامترها: <number>؛ مقدار پیشفرض: 30)
error-log (پارامترها: <path>؛ مقدار پیشفرض: "")
external-url-viewer (پارامترها: <command>؛ مقدار پیشفرض: "")
feed-sort-order (پارامترها: <sortfield>[-<direction>]؛ مقدار پیشفرض: none)
feedbin-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
feedbin-login (پارامترها: <login>؛ مقدار پیشفرض: "")
feedbin-password (پارامترها: <password>؛ مقدار پیشفرض: "")
feedbin-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
feedbin-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
feedbin-url (پارامترها: <url>؛ مقدار پیشفرض: "https://api.feedbin.com")
feedhq-flag-share (پارامترها: <flag>؛ مقدار پیشفرض: "")
feedhq-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
feedhq-login (پارامترها: <login>؛ مقدار پیشفرض: "")
feedhq-min-items (پارامترها: <number>؛ مقدار پیشفرض: 20)
feedhq-password (پارامترها: <password>؛ مقدار پیشفرض: "")
feedhq-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
feedhq-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
feedhq-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
feedhq-url (پارامترها: <url>؛ مقدار پیشفرض: "https://feedhq.org")
feedlist-format (پارامترها: <format>؛ مقدار پیشفرض: "%4i %n %11u %t")
feedlist-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - %?F?Feeds&Your feeds? (%u unread, %t total)%?F? matching filter '%F'&?%?T? - tag '%T'&?" (بومیسازیشده))
filebrowser-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - %?O?Open File&Save File? - %f" (بومیسازیشده))
freshrss-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
freshrss-login (پارامترها: <login>؛ مقدار پیشفرض: "")
freshrss-min-items (پارامترها: <number>؛ مقدار پیشفرض: 20)
freshrss-password (پارامترها: <password>؛ مقدار پیشفرض: "")
freshrss-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
freshrss-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
freshrss-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
freshrss-url (پارامترها: <url>؛ مقدار پیشفرض: "")
goto-first-unread (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
goto-next-feed (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
help-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Help" (بومیسازیشده))
highlight (پارامترها: <target> <regex> <fgcolor> [<bgcolor> [<attribute> ...]]؛ مقدار پیشفرض: n/a)
highlight-article (پارامترها: <filterexpr> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیشفرض: n/a)
highlight-feed (پارامترها: <filterexpr> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیشفرض: n/a)
history-limit (پارامترها: <number>؛ مقدار پیشفرض: 100)
html-renderer (پارامترها: <command>؛ مقدار پیشفرض: internal)
http-auth-method (پارامترها: <method>؛ مقدار پیشفرض: any)
ignore-article (پارامترها: <feed> <filterexpr>؛ مقدار پیشفرض: n/a)
ignore-mode (پارامترها: [download/display]؛ مقدار پیشفرض: download)
include (پارامترها: <path>؛ مقدار پیشفرض: n/a)
inoreader-app-id (پارامترها: <string>؛ مقدار پیشفرض: "")
inoreader-app-key (پارامترها: <string>؛ مقدار پیشفرض: "")
inoreader-flag-share (پارامترها: <flag>؛ مقدار پیشفرض: "")
inoreader-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
inoreader-login (پارامترها: <login>؛ مقدار پیشفرض: "")
inoreader-min-items (پارامترها: <number>؛ مقدار پیشفرض: 20)
inoreader-password (پارامترها: <password>؛ مقدار پیشفرض: "")
inoreader-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
inoreader-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
inoreader-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
itemview-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Article '%T' (%u unread, %t total)" (بومیسازیشده))
keep-articles-days (پارامترها: <number>؛ مقدار پیشفرض: 0)
macro (پارامترها: <macro key> <command list> [-- "<macro description>"]؛ مقدار پیشفرض: n/a)
mark-as-read-on-hover (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
max-browser-tabs (پارامترها: <number>؛ مقدار پیشفرض: 10)
max-download-speed (پارامترها: <number>؛ مقدار پیشفرض: 0)
max-items (پارامترها: <number>؛ مقدار پیشفرض: 0)
miniflux-flag-save (پارامترها: <flag>؛ مقدار پیشفرض: "")
miniflux-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
miniflux-login (پارامترها: <username>؛ مقدار پیشفرض: "")
miniflux-min-items (پارامترها: <number>؛ مقدار پیشفرض: 100)
miniflux-password (پارامترها: <password>؛ مقدار پیشفرض: "")
miniflux-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
miniflux-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
miniflux-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
miniflux-token (پارامترها: <API Token>؛ مقدار پیشفرض: "")
miniflux-tokeneval (پارامترها: <command>؛ مقدار پیشفرض: "")
miniflux-tokenfile (پارامترها: <API Token>؛ مقدار پیشفرض: "")
miniflux-url (پارامترها: <url>؛ مقدار پیشفرض: "")
newsblur-login (پارامترها: <login>؛ مقدار پیشفرض: "")
newsblur-min-items (پارامترها: <number>؛ مقدار پیشفرض: 20)
newsblur-password (پارامترها: <password>؛ مقدار پیشفرض: "")
newsblur-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
newsblur-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
newsblur-url (پارامترها: <url>؛ مقدار پیشفرض: "https://newsblur.com")
notify-always (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
notify-beep (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
notify-format (پارامترها: <string>؛ مقدار پیشفرض: "Newsboat: finished reload, %f unread feeds (%n unread articles total)" (بومیسازیشده))
notify-program (پارامترها: <command>؛ مقدار پیشفرض: "")
notify-screen (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
notify-xterm (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
ocnews-flag-star (پارامترها: <character>؛ مقدار پیشفرض: "")
ocnews-login (پارامترها: <username>؛ مقدار پیشفرض: "")
ocnews-password (پارامترها: <password>؛ مقدار پیشفرض: "")
ocnews-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
ocnews-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
ocnews-url (پارامترها: <url>؛ مقدار پیشفرض: "")
oldreader-flag-share (پارامترها: <flag>؛ مقدار پیشفرض: "")
oldreader-flag-star (پارامترها: <flag>؛ مقدار پیشفرض: "")
oldreader-login (پارامترها: <login>؛ مقدار پیشفرض: "")
oldreader-min-items (پارامترها: <number>؛ مقدار پیشفرض: 20)
oldreader-password (پارامترها: <password>؛ مقدار پیشفرض: "")
oldreader-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
oldreader-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
oldreader-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
openbrowser-and-mark-jumps-to-next-unread (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
opml-url (پارامترها: <url> ...؛ مقدار پیشفرض: "")
pager (پارامترها: [<command>/internal]؛ مقدار پیشفرض: internal)
podcast-auto-enqueue (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
prepopulate-query-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
proxy (پارامترها: <server:port>؛ مقدار پیشفرض: n/a)
proxy-auth (پارامترها: <auth>؛ مقدار پیشفرض: n/a)
proxy-auth-method (پارامترها: <method>؛ مقدار پیشفرض: any)
proxy-type (پارامترها: <type>؛ مقدار پیشفرض: http)
refresh-on-startup (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
reload-only-visible-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
reload-threads (پارامترها: <number>؛ مقدار پیشفرض: 1)
reload-time (پارامترها: <number>؛ مقدار پیشفرض: 60)
reset-unread-on-update (پارامترها: <url> [<url>...]؛ مقدار پیشفرض: n/a)
restrict-filename (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
run-on-startup (پارامترها: <list of operations>؛ مقدار پیشفرض: n/a)
save-path (پارامترها: <path-to-directory>؛ مقدار پیشفرض: ~/)
scrolloff (پارامترها: <number>؛ مقدار پیشفرض: 0)
search-highlight-colors (پارامترها: <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیشفرض: black yellow bold)
searchresult-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Search results for '%s' (%u unread, %t total)%?F? matching filter '%F'&?" (بومیسازیشده))
selectfilter-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Select Filter" (بومیسازیشده))
selecttag-format (پارامترها: <format>؛ مقدار پیشفرض: "%4i %T (%u)")
selecttag-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - Select Tag" (بومیسازیشده))
show-keymap-hint (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
show-read-articles (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
show-read-feeds (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
show-title-bar (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
ssl-verifyhost (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
ssl-verifypeer (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
suppress-first-reload (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
swap-title-and-hints (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
text-width (پارامترها: <number>؛ مقدار پیشفرض: 0)
toggleitemread-jumps-to-next (پارامترها: [yes/no]؛ مقدار پیشفرض: yes)
toggleitemread-jumps-to-next-unread (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
ttrss-flag-publish (پارامترها: <character>؛ مقدار پیشفرض: "")
ttrss-flag-star (پارامترها: <character>؛ مقدار پیشفرض: "")
ttrss-login (پارامترها: <username>؛ مقدار پیشفرض: "")
ttrss-mode (پارامترها: [multi/single]؛ مقدار پیشفرض: multi)
ttrss-password (پارامترها: <password>؛ مقدار پیشفرض: "")
ttrss-passwordeval (پارامترها: <command>؛ مقدار پیشفرض: "")
ttrss-passwordfile (پارامترها: <path>؛ مقدار پیشفرض: "")
ttrss-url (پارامترها: <url>؛ مقدار پیشفرض: "")
unbind-key (پارامترها: <key> [<dialog>]؛ مقدار پیشفرض: n/a)
urls-source (پارامترها: <source>؛ مقدار پیشفرض: "local")
urlview-title-format (پارامترها: <format>؛ مقدار پیشفرض: "%N %V - URLs" (بومیسازیشده))
use-proxy (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
user-agent (پارامترها: <string>؛ مقدار پیشفرض: "")
wrap-scroll (پارامترها: [yes/no]؛ مقدار پیشفرض: no)
عملیات موجود (AVAILABLE OPERATIONS)
open (کلید پیشفرض: ENTER)
quit (کلید پیشفرض: Q)
hard-quit (کلید پیشفرض: Shift + Q)
reload (کلید پیشفرض: R)
reload-all (کلید پیشفرض: Shift + R)
mark-feed-read (کلید پیشفرض: Shift + A)
mark-all-feeds-read (کلید پیشفرض: Shift + C)
mark-all-above-as-read (کلید پیشفرض: n/a)
save (کلید پیشفرض: S)
save-all (کلید پیشفرض: n/a)
next-unread (کلید پیشفرض: N)
prev-unread (کلید پیشفرض: P)
next (کلید پیشفرض: Shift + J)
prev (کلید پیشفرض: Shift + K)
random-unread (کلید پیشفرض: Ctrl + K)
open-in-browser (کلید پیشفرض: O)
open-in-browser-noninteractively (کلید پیشفرض: n/a)
open-in-browser-and-mark-read (کلید پیشفرض: Shift + O)
open-all-unread-in-browser (کلید پیشفرض: n/a)
open-all-unread-in-browser-and-mark-read (کلید پیشفرض: n/a)
help (کلید پیشفرض: ?)
toggle-source-view (کلید پیشفرض: Ctrl + U)
toggle-article-read (کلید پیشفرض: Shift + N)
toggle-show-read-feeds (کلید پیشفرض: L)
show-urls (کلید پیشفرض: U)
clear-tag (کلید پیشفرض: Ctrl + T)
set-tag (کلید پیشفرض: T)
open-search (کلید پیشفرض: /)
goto-url (کلید پیشفرض: #)
one (کلید پیشفرض: 1)
two (کلید پیشفرض: 2)
three (کلید پیشفرض: 3)
four (کلید پیشفرض: 4)
five (کلید پیشفرض: 5)
six (کلید پیشفرض: 6)
seven (کلید پیشفرض: 7)
eight (کلید پیشفرض: 8)
nine (کلید پیشفرض: 9)
zero (کلید پیشفرض: 0)
cmd-one (کلید پیشفرض: 1)
cmd-two (کلید پیشفرض: 2)
cmd-three (کلید پیشفرض: 3)
cmd-four (کلید پیشفرض: 4)
cmd-five (کلید پیشفرض: 5)
cmd-six (کلید پیشفرض: 6)
cmd-seven (کلید پیشفرض: 7)
cmd-eight (کلید پیشفرض: 8)
cmd-nine (کلید پیشفرض: 9)
enqueue (کلید پیشفرض: E)
edit-urls (کلید پیشفرض: Shift + E)
reload-urls (کلید پیشفرض: Ctrl + R)
redraw (کلید پیشفرض: Ctrl + L)
cmdline (کلید پیشفرض: :)
set-filter (کلید پیشفرض: Shift + F)
select-filter (کلید پیشفرض: F)
clear-filter (کلید پیشفرض: Ctrl + F)
bookmark (کلید پیشفرض: Ctrl + B)
edit-flags (کلید پیشفرض: Ctrl + E)
next-unread-feed (کلید پیشفرض: Ctrl + N)
prev-unread-feed (کلید پیشفرض: Ctrl + P)
next-feed (کلید پیشفرض: J)
prev-feed (کلید پیشفرض: K)
delete-article (کلید پیشفرض: Shift + D)
delete-all-articles (کلید پیشفرض: Ctrl + D)
purge-deleted (کلید پیشفرض: $)
view-dialogs (کلید پیشفرض: V)
close-dialog (کلید پیشفرض: Ctrl + X)
next-dialog (کلید پیشفرض: Ctrl + V)
prev-dialog (کلید پیشفرض: Ctrl + G)
pipe-to (کلید پیشفرض: |)
sort (کلید پیشفرض: G)
rev-sort (کلید پیشفرض: Shift + G)
up (کلید پیشفرض: UP)
down (کلید پیشفرض: DOWN)
pageup (کلید پیشفرض: PPAGE)
pagedown (کلید پیشفرض: NPAGE)
halfpageup (کلید پیشفرض: n/a)
halfpagedown (کلید پیشفرض: n/a)
home (کلید پیشفرض: HOME)
end (کلید پیشفرض: END)
macro-prefix (کلید پیشفرض: ,)
switch-focus (کلید پیشفرض: TAB)
goto-title (کلید پیشفرض: n/a)
prevsearchresults (کلید پیشفرض: Z)
article-feed (کلید پیشفرض: n/a)
رشتههای قالببندی (FORMAT STRINGS)
نیوزبوت شامل یک سیستم قدرتمند رشته قالببندی است که به کاربر امکان میدهد قالب بخشهای گوناگون برنامه را پیکربندی کند، مانند قالب مدخلها در فهرست خوراکها یا در فهرست مقالات.
رشتههای قالببندی مشابه مواردی هستند که در تابع printf در زبان برنامهنویسی C یافت میشوند. یک توالی قالب با نویسه % آغاز میشود و به دنبال آن نشانه تراز اختیاری میآید: اعداد مثبت نشان میدهند متنی که برای توالی درج میشود از سمت چپ تا رسیدن به عرض کلی مشخصشده با عدد فاصلهگذاری (pad) میشود، در حالی که اعداد منفی فاصلهگذاری در سمت راست را مشخص میکنند. پس از نشانه فاصلهگذاری، شناسه توالی واقعی میآید که معمولاً یک حرف تکی است. %=[width][identifier] توالی را در مرکز تراز میکند، که اگر w=0 باشد کل عرض پنجره استفاده میشود.
علاوه بر این، نیوزبوت توالیهای دیگری و قدرتمندتری ارائه میدهد، مانند %>[char]، که نشان میدهد متن سمت راست توالی در سمت راست صفحه تراز خواهد شد، و نویسههای میان متن سمت چپ و متن سمت راست با [char] پر میشوند. قالب قدرتمند دیگر، توالی شرطی است: %?[char]?[format 1]&[format 2]?: اگر متن شناسه توالی [char] شامل هرگونه نویسه غیرفضایخالی باشد، آنگاه [format 1] ارزیابی و درج میشود، در غیر این صورت [format 2] ارزیابی و درج خواهد شد. بخشهای & و [format 2] اختیاری هستند، یعنی اگر متن شناسه خالی باشد، یک رشته خالی درج میشود.
جدولهای زیر نشان میدهند چه شناسههای توالی برای کدام قالب در دسترس هستند:
جدول ۱. شناسههای موجود برای feedlist-format
| شناسه | معنی |
| d | شرح خوراک |
| i | نمایه خوراک |
| l | پیوند خوراک |
| L | نشانی URL خوراک RSS |
| n | فیلد پرچم "خواندهنشده" |
| S | وضعیت بارگیری |
| t | عنوان خوراک |
| T | نخستین برچسب خوراک در فایل URLs |
| u | فیلد "خواندهنشده/مجموع" |
| U | فیلد "خواندهنشده" |
| c | فیلد "مجموع" |
هنگامی که عملیات reload-all در حال اجرا است، وضعیت بارگیری وضعیت دانلود یک خوراک را نشان میدهد که میتواند "در انتظار بارگیری" (با "_" نشان داده میشود)، "در حال حاضر در حال بارگیری" (با "." نشان داده میشود)، با موفقیت بارگیریشده (با " " نشان داده میشود) و "خطای بارگیری" (با "x" نشان داده میشود) باشد.
جدول ۲. شناسههای موجود برای articlelist-format
| شناسه | معنی |
| a | نویسنده مقاله |
| D | تاریخ انتشار. این مورد میتواند با datetime-format بیشتر سفارشیسازی شود |
| f | دو نویسه: ۱) "N" اگر مقاله خواندهنشده باشد، "D" اگر مقاله حذف شده باشد، در غیر این صورت یک فاصله؛ ۲) "!" اگر مقاله دارای پرچم باشد، در غیر این صورت یک فاصله. |
| n | فیلد "خواندهنشده" |
| d | فیلد "حذفشده" |
| F | پرچمهای مقاله |
| i | نمایه مقاله |
| t | عنوان مقاله |
| T | اگر فهرست مقالات، مقالههایی از خوراکهای مختلف را نمایش دهد، آنگاه این شناسه شامل عنوان خوراکی است که مقاله به آن تعلق دارد. |
| L | طول مقاله |
| e | نشانی URL ضمیمه مقاله |
جدول ۳. شناسههای موجود برای selecttag-format
| شناسه | معنی |
| i | نمایه خط در فهرست |
| T | برچسبی که این خط متناظر با آن است |
| f | تعداد خوراکهای خواندهنشده زیر این برچسب |
| n | تعداد مقالات خواندهنشده در خوراکهای برچسبگذاریشده با این برچسب |
| u | تعداد خوراکهای برچسبگذاریشده با این برچسب |
جدول ۴. شناسههای موجود برای notify-format
| شناسه | معنی |
| n | تعداد مقالات خواندهنشده |
| f | تعداد خوراکهای خواندهنشده |
| d | تعداد مقالات خواندهنشده جدید (یعنی آنهایی که در آخرین بازنشانی اضافه شدهاند) |
| D | تعداد خوراکهای خواندهنشده جدید (یعنی آنهایی که در آخرین بازنشانی اضافه شدهاند) |
جدول ۵. شناسههای موجود برای podlist-format
| شناسه | معنی |
| i | نمایه بارگیری |
| d | اندازه بارگیریشده فعلی به مگابایت، با یک رقم دقت اعشار نمایش داده میشود |
| t | اندازه کل بارگیری به مگابایت، با یک رقم دقت اعشار نمایش داده میشود |
| p | درصد بارگیریشده، با یک رقم دقت اعشار نمایش داده میشود |
| k | سرعت بارگیری، با دو رقم دقت اعشار، همیشه به صورت KB/s (شامل متن "KB/s" نمیشود) |
| K | سرعت بارگیری، با دو رقم دقت اعشار، خوانا برای انسان (به صورت خودکار بین KB/s، MB/s و GB/s تغییر میکند) |
| S | وضعیت بارگیری، یکی از موارد زیر را نمایش میدهد: "queued"، "downloading"، "ready"، "canceled"، "deleted"، "missing"، "played"، "finished" یا "failed" |
| u | نشانی URL بارگیری |
| F | نام فایل مطلق بارگیری از دایرکتوری ریشه (مانند ~/downloads/podcast.mp3 → /home/name/downloads/podcast.mp3) |
| b | نام پایه (basename) بارگیری (مانند /home/name/downloads/podcast.mp3 → podcast.mp3) |
جدول ۶. شناسههای موجود برای download-path و download-filename-format
| شناسه | معنی |
| u | بخش نام فایل از نشانی URL بارگیری. ممکن است خالی باشد. ممکن است شامل یک رشته پرسوجو https://en.wikipedia.org/wiki/Query_string باشد. |
| n | نام خوراک پادکست |
| N | نام خوراک پادکست. حتی اگر از طریق یک خوراک پرسوجو انتخاب شده باشد، شامل نام خوراک اصلی است |
| h | نام هاست (hostname) خوراک پادکست |
| t | عنوان قسمت پادکست |
| e | پسوند قسمت پادکست |
| F | تاریخ انتشار قسمت پادکست قالببندیشده به صورت yyyy-mm-dd |
| m | ماهی که قسمت پادکست در آن منتشر شد |
| b | نام اختصاری ماهی که قسمت پادکست در آن منتشر شد |
| d | روزی که قسمت پادکست در آن منتشر شد |
| H | ساعتی که قسمت پادکست در آن منتشر شد |
| M | دقیقهای که قسمت پادکست در آن منتشر شد |
| S | ثانیهای که قسمت پادکست در آن منتشر شد |
| y | سال انتشار قسمت پادکست قالببندیشده به صورت yy |
| Y | سال انتشار قسمت پادکست قالببندیشده به صورت yyyy |
مثالها:
feedlist-format "%4i %n %11u %t" articlelist-format "%4i %f %D %?T?|%-17T| ?%t" notify-format "%d new articles (%n unread articles, %f unread feeds)" podlist-format "%4i [%-5p %%] %-12S %F"
عناوین کادرهای محاوره (DIALOG TITLES)
شما میتوانید قالب عنوان تمام کادرهای محاوره (دیالوگهای) موجود را سفارشیسازی کنید. در اینجا فهرستی از کادرهای محاوره به همراه متغیرهای پیکربندی قالب عنوان مربوط به آنها، و فهرستی از قالبهای موجود و معانی آنها آورده شده است. لطفاً توجه داشته باشید که قالبهای عنوان بومیسازی شدهاند، بنابراین اگر با زبان یا محلیسازی (locale) دیگری کار میکنید که توسط نیوزبوت پشتیبانی میشود، متن عنوان نمایشدادهشده ممکن است تفاوت داشته باشد مگر اینکه آن را سفارشی کنید.
جدول ۷. قالبهای عنوان کادرهای محاوره
| کادر محاوره | متغیر پیکربندی | مقدار پیشفرض |
| فهرست خوراکها | feedlist-title-format | %N %V - %?F?Feeds&Your feeds? (%u unread, %t total)%?F? matching filter '%F'&?%?T? - tag '%T'&? |
| فهرست مقالات | articlelist-title-format | %N %V - Articles in feed '%T' (%u unread, %t total)%?F? matching filter '%F'&? - %U |
| نتیجه جستجو | searchresult-title-format | %N %V - Search results for '%s' (%u unread, %t total)%?F? matching filter '%F'&? |
| مرورگر فایل | filebrowser-title-format | %N %V - %?O?Open File&Save File? - %f |
| مرورگر دایرکتوری | dirbrowser-title-format | %N %V - %?O?Open Directory&Save File? - %f |
| راهنما | help-title-format | %N %V - Help |
| کادر انتخاب برچسب | selecttag-title-format | %N %V - Select Tag |
| کادر انتخاب فیلتر | selectfilter-title-format | %N %V - Select Filter |
| نمای مقاله | itemview-title-format | %N %V - Article '%T' (%u unread, %t total) |
| نمای پیوندها | urlview-title-format | %N %V - URLs |
| فهرست کادرهای محاوره | dialogs-title-format | %N %V - Dialogs |
جدول ۸. شناسههای مشترک قالب عنوان
| شناسه | معنی |
| N | نام برنامه، یعنی "Newsboat" |
| V | نسخه برنامه |
جدول ۹. شناسههای قالب عنوان فهرست خوراکها
| شناسه | معنی |
| T | برچسب انتخابشده فعلی (اگر هیچ برچسبی انتخاب نشده باشد خالی است) |
| t | تعداد کل خوراکها |
| u | تعداد خوراکهای خواندهنشده |
| U | تعداد مقالات خواندهنشده |
| F | عبارت فیلتر فعلی (اگر فیلتری فعال نباشد خالی است) |
جدول ۱۰. شناسههای قالب عنوان فهرست مقالات
| شناسه | معنی |
| T | عنوان خوراک |
| U | نشانی URL خوراک |
| u | تعداد مقالات خواندهنشده |
| t | تعداد کل مقالات |
| F | عبارت فیلتر فعلی (اگر فیلتری فعال نباشد خالی است) |
جدول ۱۱. شناسههای قالب عنوان نتیجه جستجو
| شناسه | معنی |
| s | عبارت جستجو |
| بهعلاوه تمام مواردی که توسط articlelist-title-format پشتیبانی میشوند (جدول بالا را ببینید) |
جدول ۱۲. شناسههای قالب عنوان مرورگر فایل
| شناسه | معنی |
| f | مسیر فعلی |
| O | غیرخالی در صورتی که مرورگر فایل در حالت باز کردن باشد، خالی در صورت قرار داشتن در حالت ذخیره |
جدول ۱۳. شناسههای قالب عنوان مرورگر دایرکتوری
| شناسه | معنی |
| f | مسیر فعلی |
| O | غیرخالی در صورتی که مرورگر دایرکتوری در حالت باز کردن باشد، خالی در صورت قرار داشتن در حالت ذخیره |
جدول ۱۴. شناسههای قالب عنوان نمای مقاله
| شناسه | معنی |
| T | عنوان مقاله |
| F | عنوان خوراک |
| u | تعداد مقالات خواندهنشده |
| t | تعداد کل مقالات |
برچسبگذاری (TAGGING)
نیوزبوت امکان دستهبندی یا به اصطلاح "برچسبگذاری" خوراکهای RSS را فراهم میکند. به هر خوراک RSS میتوان ۰ یا چند برچسب اختصاص داد. در نیوزبوت، میتوانید انتخاب کنید که فقط خوراکهای RSS منطبق با یک برچسب خاص نمایش داده شوند. این امر دستهبندی خوراکهای شما را به روشی انعطافپذیر و قدرتمند آسان میسازد.
معمولاً فایل urls شامل یک نشانی URL خوراک RSS در هر خط است. برای اختصاص دادن یک برچسب به یک خوراک RSS، به سادگی آن را به صورت یک کلمه منفرد، با فاصلهگذاری مانند فاصله (space) یا تب (tab) اضافه کنید. اگر برچسب نیاز به فاصله داشته باشد، باید از نقلقول (") در اطراف برچسب استفاده کنید (مثال زیر را ببینید). یک فایل نمونه urls ممکن است شبیه به این باشد:
https://blog.fefe.de/rss.xml?html interesting conspiracy news "cool stuff" https://rss.orf.at/news.xml news orf https://www.heise.de/newsticker/heise.rdf news interesting
وقتی اکنون نیوزبوت را با این پیکربندی آغاز میکنید، میتوانید با فشردن T یک برچسب را انتخاب کنید. هنگامی که برچسب "news" را انتخاب میکنید، هر سه خوراک RSS را خواهید دید. با فشردن مجدد T و مثلاً انتخاب برچسب "conspiracy"، فقط خوراک RSS مربوط به https://blog.fefe.de/rss.xml?html را خواهید دید. فشردن Ctrl + T برچسب فعلی را پاک میکند و دوباره تمام خوراکهای RSS را بدون در نظر گرفتن برچسبهای اختصاصیافته آنها نمایش میدهد.
نوع خاصی از برچسبها، برچسبهایی هستند که با نویسه تیلده (~) آغاز میشوند. وقتی چنین برچسبی یافت شود، عنوان خوراک برابر با نام برچسب (به جز نویسه ~) تنظیم میشود. این نوع برچسبها هنگامی که هر نوع ویژگی "نخستین برچسب" (first tag) استفاده شود، نادیده گرفته میشوند. با این ویژگی میتوانید در فهرست خوراکهای خود هر عنوانی که میخواهید به خوراکها اختصاص دهید:
https://rss.orf.at/news.xml "~ORF News"
نوع خاص دیگری از برچسبها، برچسبهایی هستند که با علامت تعجب (!) آغاز میشوند. هنگامی که چنین برچسبی پیدا شود، خوراک از فهرست معمولی خوراکها پنهان میشود و محتوای آن تنها از طریق یک خوراک پرسوجو قابل دسترسی است.
https://rss.orf.at/news.xml ! news http://feeds.bbci.co.uk/news/world/rss.xml ! news "query:News from around the globe:tags # \"news\""
در این مثال، دو خوراک اول در فهرست خوراکها ظاهر نخواهند شد، اما مقالات آنها همچنان از طریق خوراک پرسوجو با عنوان "News from around the globe" در دسترس خواهند بود. برچسبهای "پنهان" در این مثال حتی نامی ندارند، زیرا تنها کاربرد آنها پنهان کردن خوراکی است که برچسبگذاری میکنند.
اسکریپتها و فیلترها (SCRIPTS AND FILTERS)
نیوزبوت از افزونههای Snownews پشتیبانی میکند. نرمافزارهای خواننده خوراک RSS مانند Snownews و Liferea یک روش مشترک برای گسترش قابلیتها با اسکریپتهای سفارشی دارند. دو سازوکار، یعنی اسکریپتهای نوع "execurl" و "filter"، در دسترس هستند و توسط نیوزبوت پشتیبانی میشوند.
یک اسکریپت "execurl" میتواند هر برنامهای باشد که اجرا شده و خروجی آن به عنوان یک خوراک RSS تفسیر میشود، در حالی که اسکریپتهای "filter" با محتوای یک نشانی URL پیکربندیشده تغذیه میشوند و خروجی آنها به عنوان خوراک RSS تفسیر میگردد.
پیکربندی ساده و سرراست است. کافی است خطوط پیکربندی مانند موارد زیر را به فایل urls خود اضافه کنید:
exec:~/bin/execurl-script filter:~/bin/filter-script:https://some.test/url
خط اول نحوه افزودن یک اسکریپت execurl را به پیکربندی نشان میدهد: خط را با exec: آغاز کنید و سپس بلافاصله مسیر اسکریپتی را که باید اجرا شود ضمیمه نمایید. اگر این اسکریپت به پارامترهای اضافی نیاز دارد، به سادگی از نقلقول استفاده کنید (برای جزئیات به بخش استفاده از نقلقول دوتایی مراجعه نمایید):
"exec:~/bin/execurl-script param1 param2"
خط دوم نحوه افزودن یک اسکریپت فیلتر را به پیکربندی شما نشان میدهد: خط را با filter: آغاز کنید، سپس بلافاصله مسیر اسکریپت را بیاورید، سپس یک دونقطه (:) بگذارید، و سپس نشانی URL فایلی را که باید به اسکریپت داده شود اضافه کنید. مجدداً، اگر اسکریپت به هرگونه پارامتر نیاز دارد، کل عبارت را داخل نقلقول قرار دهید:
"filter:~/bin/filter-script param1 param2:https://url/foobar"
در هر دو حالت، ویژگی برچسبگذاری که در بالا شرح داده شد همچنان در دسترس است:
exec:~/bin/execurl-script tag1 tag2 "quoted tag" filter:~/bin/filter-script:https://some.test/url tag3 tag4 tag5
اگر نیاز به نوشتن افزونه خود دارید، به این راهنمای کوتاه https://web.archive.org/web/20090724045314/http://kiza.kcore.de/software/snownews/snowscripts/writing برای آشنایی مراجعه کنید. مجموعهای از اسکریپتها https://sourceforge.net/p/snownews/code/ci/de3bd8b28191c4d4bc1be18275786613bcbc0c94/tree/docs/untested و فیلترهای https://sourceforge.net/p/snownews/code/ci/9fb45e4cdf1cf9dea55b9af66c13a4c238809851/tree/docs/filters موجود نیز ممکن است مفید باشند.
نیوزبوت به همراه یک اسکریپت نمونه exec ارائه میشود که روشی را برای ایجاد یک کانال RSS نشان میدهد. این اسکریپت همچنین شامل روشی برای مشاهده آرگومانهای دقیقی است که توسط نیوزبوت به اسکریپت ارسال میشوند. این نمونه را میتوان در زیردایرکتوری doc/examples پیدا کرد.
پروندههای مسدودسازی (KILLFILES)
گاهی اوقات کاربر با محتوای خاصی مواجه میشود که نمیخواهد آن را بخواند، برای مثال موضوعاتی که کاربر به آنها علاقهای ندارد یا مقالاتی که توسط افراد خاصی نوشته شدهاند. در یوزنت (Usenet)، این ویژگی در نرمافزارها به طور سنتی "killfile" (پرونده مسدودسازی) نامیده میشود؛ بدین معنی که بر اساس محتوای این فایل، مقالاتی که با شرایط خاصی مطابقت دارند نمایش داده نمیشوند و به هیچ وجه به کاربر ارائه نمیگردند.
در نیوزبوت، چنین قابلیتی میتواند بر مبنای هر مقاله از طریق فایل پیکربندی پیادهسازی شود. مهمترین دستور پیکربندی برای این کار ignore-article است:
ignore-article "https://synflood.at/blog/index.php?/feeds/index.rss2" "title =~ \"newsboat\"" ignore-article "regex:https?://nitter.net/.*" "title =~ \"^RT by\"" ignore-article "*" "title =~ \"Gentoo\""
این دستور دو پارامتر میپذیرد. اولین پارامتر یکی از موارد زیر است:
آرگومان دوم یک عبارت فیلتر برای یک مقاله است، احتمالاً در نقلقول دوگانه برای حفظ فاصلههای درون آن. اگر نیوزبوت در خوراک RSS مشخصشده با مقالهای برخورد کند که با عبارت فیلتر مشخصشده مطابقت دارد، آنگاه این مقاله نادیده گرفته شده و هرگز به کاربر نشان داده نمیشود. خود پیکربندی میتواند شامل هر تعداد دستور ignore-article که مایل باشید باشد.
شما همچنین میتوانید روش نادیدهگرفتن مقاله را تعیین کنید. دو روش در دسترس است:
هر دو حالت مزایا و معایب خود را دارند: در حالی که حالت نادیدهگیری هنگام بارگیری مقداری در فضای ذخیرهسازی صرفهجویی میکند، شما نمیتوانید صرفاً با حذف آن از فایل پیکربندی این نادیدهگیری را لغو (undo) کنید؛ زیرا اگر مقاله نادیدهگرفتهشده قبلاً از یک خوراک پاک شده باشد، دیگر مجدداً ظاهر نخواهد شد. از طرف دیگر، حالت نادیدهگیری هنگام نمایش به فضای بیشتری نیاز دارد، اما این مزیت را دارد که میتوان با حذف دستور ignore-article از پیکربندی، نادیدهگیری را لغو کرد.
حالت پیشفرض نادیدهگیری "download" است. شما میتوانید ignore-mode را در فایل پیکربندی تنظیم کنید:
ignore-mode "display"
پشتیبانی از پادکست (PODCAST SUPPORT)
پادکست یک فایل چندرسانهای است که با استفاده از خوراکهای اشتراک محتوا مانند RSS در اینترنت توزیع میشود تا بعداً در پخشکنندههای قابل حمل یا رایانهها پخش شود. نیوزبوت از بارگیری، ذخیره و پخش زنده (استریم) پادکستها پشتیبانی میکند، هرچند برای پخش به یک پخشکننده رسانه خارجی نیاز است. نحوه این پشتیبانی با سایر جمعآوریکنندههای پادکست یا "پادکچرها" کمی متفاوت است.
محتوای پادکست در خوراکهای RSS از طریق تگهای ویژهای به نام "enclosures" (ضمایم) انتقال مییابد. نیوزبوت این ضمایم را شناسایی کرده و اطلاعات مربوطه را برای هر مورد پادکست که در یک خوراک RSS پیدا کند، ذخیره مینماید. از نسخه ۲.۰ به بعد، نیوزبوت همچنین پسوندهای یاهو مدیا RSS را نیز شناسایی و مدیریت میکند.
واسطهای برنامهنویسی کاربردی راه دور (Remote APIs) همیشه این "ضمایم" را فهرست نمیکنند، بنابراین ممکن است پادکستها در نیوزبوت وجود نداشته باشند. چنین APIهایی در بخش مربوطه از اسناد ما مشخص شدهاند. اگر توضیحی در این مورد نبود اما همچنان ضمایم را در نیوزبوت مشاهده نمیکنید، لطفاً یک گزارش مشکل (issue) ثبت کنید تا موضوع را بررسی کنیم!
خط فرمان (COMMAND LINE)
مانند سایر نرمافزارهای مبتنی بر متن، نیوزبوت شامل یک خط فرمان داخلی برای تغییر متغیرهای پیکربندی به صورت موردی (ad hoc) و اجرای دستورات اختصاصی است. این خط فرمان دسترسی انعطافپذیری به عملکردهای نیوزبوت فراهم میسازد که به ویژه برای کاربران پیشرفته مفید است.
برای شروع خط فرمان، کلید : را فشار دهید. اعلان ":" را در پایین صفحه مشاهده خواهید کرد، مشابه ابزارهایی مانند vi(m) یا mutt. اکنون میتوانید دستورات را وارد کنید. با فشردن کلید Enter دستور اجرا شده (احتمالاً با ارائه بازخورد به کاربر) و خط فرمان بسته میشود. با فشردن کلید Esc میتوانید وارد کردن دستورات را لغو کنید. تاریخچه تمام دستوراتی که وارد میکنید در فایل history.cmdline ذخیره خواهد شد که در کنار فایل cache.db قرار دارد. به صورت پیشفرض تاریخچه به ۱۰۰ مدخل محدود شده است، اما با تنظیم متغیر پیکربندی history-limit قابل تغییر است. برای غیرفعال کردن ذخیره تاریخچه، history-limit را روی 0 تنظیم کنید.
اگر نام کامل دستورات خط فرمان را به خاطر نمیآورید، خط فرمان راهنماییهایی برای شما فراهم میکند. با فشردن کلید Tab، نیوزبوت تلاش میکند دستور شما را به صورت خودکار کامل کند. اگر بیش از یک تکمیل ممکن وجود داشته باشد، میتوانید متعاقباً کلید Tab را فشار دهید تا میان تمام نتایج جابهجا شوید. اگر هیچ تطابقی پیدا نشود، هیچ پیشنهادی در خط فرمان درج نخواهد شد. برای دستور set، تکمیل خودکار برای نام متغیرهای پیکربندی نیز کار میکند.
علاوه بر این، برخی از کلیدهای ترکیبی متداول مانند Ctrl + G (برای لغو ورودی)، Ctrl + K (برای حذف متن از موقعیت مکاننما تا انتهای خط)، Ctrl + U (برای پاک کردن کل خط) و Ctrl + W (برای حذف کلمه قبل از موقعیت فعلی مکاننما) افزوده شدهاند.
لطفاً توجه داشته باشید که تاریخچه ورودی هم برای خط فرمان و هم برای عملکردهای جستجو در سیستم فایل در فایلهای history.cmdline و history.search (در کنار فایل cache.db) ذخیره میشوند. به طور پیشفرض، ۱۰۰ مدخل آخر ذخیره میشوند، اما این مقدار قابل پیکربندی است (متغیر پیکربندی history-limit) و همچنین میتواند کاملاً غیرفعال شود (با تنظیم متغیر مذکور روی 0).
در حال حاضر، دستورات خط فرمان زیر در دسترس هستند:
quit
q
save <filename>
set <variable>[=<value>|&|!]
tag <tagname>
goto <case-insensitive substring>
source <filename> [...]
dumpconfig <filename>
<number>
فایلها (FILES)
بهطور پیشفرض، نیوزبوت تمام فایلها را به روش سنتی یونیکس ذخیره میکند، یعنی در یک "dotdir" (پوشه نقطهدار) واقع در ~/.newsboat. با این حال، از یک روش نوین نیز پشتیبانی میکند، مشخصات دایرکتوری پایه XDG https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html، که فایلها را بین مکانهای زیر تقسیم میکند:
اگر دایرکتوری newsboat در زیر XDG_CONFIG_HOME وجود داشته باشد، آنگاه نیوزبوت از دایرکتوریهای XDG استفاده خواهد کرد (و در صورت لزوم دایرکتوری داده را ایجاد میکند). در غیر این صورت، نیوزبوت به صورت پیشفرض از ~/.newsboat استفاده مینماید.
اگر در حال حاضر از ~/.newsboat/ استفاده میکنید اما مایل به مهاجرت به دایرکتوریهای XDG هستید، باید فایلها را به صورت زیر انتقال دهید:
config، urls
cache.db، history.search، history.cmdline، queue
نیوزبوت و پادبوت همچنین "فایلهای قفل" (lock files) ایجاد میکنند. این فایلها از اجرای همزمان دو نمونه از یک برنامه و در نتیجه از خراب شدن دادههای شما جلوگیری میکنند. نیوزبوت و پادبوت هنگام خروج از برنامه این فایلها را حذف میکنند، بنابراین نیازی به کپی کردن آنها در جایی نیست — فقط در صورتی که اسکریپتهایی مینویسید که با cache.db یا queue کار میکنند از آنها آگاه باشید. به طور پیشفرض، فایلهای قفل در مکانهای زیر قرار دارند:
| پوشه نقطهدار (dotdir) | دایرکتوری XDG | |
| Newsboat | ~/.newsboat/cache.db.lock | $XDG_DATA_HOME/newsboat/cache.db.lock |
| Podboat | ~/.newsboat/pb-lock.pid | $XDG_DATA_HOME/newsboat/.lock |
نیوزبوت فایل قفل را در کنار فایل حافظه نهان (کَش) قرار میدهد، بنابراین اگر تنظیم cache-file را مشخص کنید یا آرگومان خط فرمان —cache-file را ارسال نمایید، مسیر فایل قفل نیز تغییر خواهد کرد. قفل پادبوت میتواند با استفاده از آرگومان خط فرمان —lock-file در مکان دیگری قرار داده شود.
فایلهای نقطهدار (dotfiles)
~/.newsboat/urls
دایرکتوریهای XDG
$XDG_CONFIG_HOME/newsboat/urls
نکته: اگر متغیر محیطی XDG_CONFIG_HOME تنظیم نشده باشد، نیوزبوت به گونهای عمل میکند که گویی روی ~/.config تنظیم شده است.
محیط (ENVIRONMENT)
BROWSER
CURL_CA_BUNDLE
این گزینه در صورتی مفید است که libcurl شما بدون اطلاعات گواهی مفید کامپایل شده باشد و خودتان نتوانید کتابخانه را مجدداً کامپایل کنید.
EDITOR
NO_PROXY
این متغیر شامل فهرستی از نامهای هاست، نامهای دامنه و نشانیهای IP است که با کاما از یکدیگر جدا شدهاند.
نامهای دامنه با زیردامنهها مطابقت دارند، یعنی "example.com" با "foo.example.com" نیز مطابقت دارد. نامهای دامنهای که با یک نقطه شروع میشوند فقط با زیردامنهها تطبیق داده میشوند، به عنوان مثال ".example.com" با "bar.example.com" مطابقت دارد اما با خود "example.com" مطابقت ندارد.
نشانیهای IPv6 بدون براکت نوشته میشوند و به صورت رشته تطبیق داده میشوند. بنابراین "::1" با "::0:1" تطبیق ندارد، حتی اگر اینها همان نشانی باشند.
PAGER
TMPDIR
VISUAL
XDG_CONFIG_HOME
XDG_DATA_HOME
همچنین ببینید (SEE ALSO)
podboat(1)
نویسنده (AUTHOR)
Alexander Batischev
| 2026-06-21 |