'\" t
.\"     Title: podboat
.\"    Author: Alexander Batischev
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PODBOAT" "1" "2026-06-21" "\ \&" "\ \&"
.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)"
podboat \- یک مدیر بارگیری پادکست برای ترمینال‌های متنی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpodboat\fP [\fB\-C\fP \fIconfigfile\fP] [\fB\-q\fP \fIqueuefile\fP] [\fB\-a\fP] [\fB\-h\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fIPodboat\fP یک مدیر پادکست برای ترمینال‌های متنی است. این برنامه به عنوان یک ابزار کمکی برای \fINewsboat\fP عمل می‌کند که بارگیری‌های پادکست را درون یک فایل صف‌بندی می‌نماید. سپس این بارگیری‌های صف‌بندی‌شده می‌توانند توسط \fIPodboat\fP بارگیری شوند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش راهنما
.RE
.sp
\fB\-C\fP \fIconfigfile\fP, \fB\-\-config\-file\fP=\fIconfigfile\fP
.RS 4
استفاده از یک فایل پیکربندی جایگزین
.RE
.sp
\fB\-q\fP \fIqueuefile\fP, \fB\-\-queue\-file\fP=\fIqueuefile\fP
.RS 4
استفاده از یک فایل صف جایگزین
.RE
.sp
\fB\-\-lock\-file\fP=\fIlockfile\fP
.RS 4
استفاده از یک فایل قفل جایگزین
.RE
.sp
\fB\-a\fP, \fB\-\-autodownload\fP
.RS 4
شروع بارگیری خودکار تمامی فایل‌های درون صف هنگام راه‌اندازی
.RE
.sp
\fB\-l\fP \fIloglevel\fP, \fB\-\-log\-level\fP=\fIloglevel\fP
.RS 4
تولید یک فایل گزارش با یک \fIloglevel\fP مشخص (مقادیر معتبر: ۱ تا ۶، به ترتیب برای خطای کاربر، بحرانی، خطا، هشدار، اطلاعاتی و اشکال‌زدایی).
نام فایل می‌تواند با استفاده از گزینه \fB\-\-log\-file\fP مشخص شود. در صورت مشخص نشدن، نام فایلی به صورت podboat_<date\-time>.log تولید می‌شود.
.RE
.sp
\fB\-d\fP \fIlogfile\fP, \fB\-\-log\-file\fP=\fIlogfile\fP
.RS 4
استفاده از این \fIlogfile\fP به عنوان خروجی هنگام ثبت پیام‌های اشکال‌زدایی. لطفاً توجه داشته باشید که این گزینه تنها زمانی کار می‌کند که سطح گزارش (loglevel) ارائه شده باشد.
.RE
.SH "پشتیبانی از پادکست (PODCAST SUPPORT)"
.sp
پادکست یک فایل چندرسانه‌ای است که با استفاده از خوراک‌های اشتراک محتوا نظیر RSS از طریق اینترنت توزیع می‌شود تا بعداً در دستگاه‌های پخش قابل حمل یا رایانه‌ها بازپخش شود.
برنامه Newsboat از بارگیری، ذخیره و پخش جریانی پادکست‌ها پشتیبانی می‌کند، هرچند برای بازپخش به یک پخش‌کننده رسانه خارجی نیاز است. این پشتیبانی در شیوه پیاده‌سازی، کمی با دیگر گردآورنده‌های پادکست یا «podcatcher»ها تفاوت دارد.
.sp
محتوای پادکست در خوراک‌های RSS از طریق برچسب‌های ویژه‌ای به نام «enclosures» منتقل می‌شود. برنامه Newsboat این محفظه‌ها را شناسایی کرده و اطلاعات مربوطه را برای هر مورد پادکستی که در یک خوراک RSS پیدا کند، ذخیره می‌نماید. از نسخه 2.0، این برنامه همچنین افزونه‌های Yahoo Media RSS را شناسایی کرده و مدیریت می‌کند.
.sp
رابط‌های برنامه‌نویسی راه دور (Remote APIs) همیشه این «enclosures» را فهرست نمی‌کنند، بنابراین ممکن است پادکست‌ها در Newsboat مفقود باشند. چنین رابط‌هایی در بخش مربوطه از مستندات ما مشخص شده‌اند. اگر توضیحی درج نشده است اما همچنان محفظه‌ها را در Newsboat مشاهده نمی‌کنید، لطفاً یک گزارش مشکل ارسال کنید تا آن را به طور کامل بررسی نماییم!
.SH "مدیریت فایل‌های صوتی با PODBOAT (MANAGING AUDIO FILES WITH PODBOAT)"
.sp
کاری که کاربر می‌تواند انجام دهد این است که نشانی اینترنتی (URL) بارگیری پادکست را به یک صف بارگیری اضافه کند. به عنوان راهکاری جایگزین، Newsboat می‌تواند طوری پیکربندی شود که این کار را به صورت خودکار انجام دهد. این صف در فایل \fIqueue\fP در کنار فایل \fIcache.db\fP ذخیره می‌شود.
.sp
سپس کاربر می‌تواند از مدیر بارگیری \fIpodboat\fP برای بارگیری این فایل‌ها در دایرکتوری روی فایل‌سیستم محلی استفاده کند. برنامه Podboat همراه با بسته Newsboat ارائه می‌شود و از لحاظ ظاهر و رفتار بسیار شبیه به Newsboat است. این برنامه همچنین از همان فایل پیکربندی مشترک استفاده می‌کند.
.sp
پادکست‌هایی که بارگیری شده‌اند اما هنوز پخش نشده‌اند در صف باقی می‌مانند اما به عنوان بارگیری‌شده علامت‌گذاری می‌شوند. می‌توانید با پاکسازی آن‌ها از صف با استفاده از کلید \f(CRShift\0+\0P\fP، آن‌ها را حذف کنید. پس از اینکه فایلی را پخش کردید و Podboat را بستید، از صف حذف خواهد شد. فایل بارگیری‌شده روی فایل‌سیستم باقی می‌ماند، مگر اینکه گزینه «delete\-played\-files» فعال شده باشد.
.sp
یک کاربرد متداول این است که Newsboat را برای قرار دادن خودکار نشانی‌های URL بارگیری پادکست‌های تازه‌یافت‌شده در صف پیکربندی کنید. سپس، کاربر خوراک‌های RSS پادکست را در Newsboat بازبارگذاری کرده و پس از آن، از Podboat برای مشاهده صف جاری استفاده می‌کند، و یا فایل‌های خاصی را به صورت انتخابی بارگیری کرده یا با فشردن کلید \f(CRA\fP در محیط Podboat، همه آن‌ها را به صورت خودکار با هم بارگیری می‌نماید.
.SH "دستورات پیکربندی (CONFIGURATION COMMANDS)"
.sp
\fIdelete\-played\-files\fP (پارامترها: [yes/no]؛ مقدار پیش‌فرض: \fIno\fP)
.RS 4
اگر روی \fIyes\fP تنظیم شود، Podboat فایل‌ها را هنگامی که مدخل متناظر آن‌ها در صف حذف می‌شود، پاک خواهد کرد (این شامل مدخل‌های «finished» و «deleted» نیز می‌شود). (مثال: delete\-played\-files yes)
.RE
.sp
\fIdownload\-path\fP (پارامترها: <path>؛ مقدار پیش‌فرض: \fI~/\fP)
.RS 4
دایرکتوری مقصدی را مشخص می‌کند که Podboat فایل‌ها را در آن بارگیری می‌نماید. به صورت اختیاری، می‌توان از متغیرهای جایگزین برای قرار دادن بارگیری‌ها در یک ساختار دایرکتوری استفاده کرد. برای جزئیات مربوط به قالب‌های در دسترس، بخش FORMAT STRINGS از راهنمای Newsboat را ببینید. این تنظیم در زمان صف‌بندی اعمال می‌شود؛ تغییر آن تاثیری بر مسیر بارگیری پادکست‌هایی که پیش‌تر به صف اضافه شده‌اند نخواهد داشت. (مثال: download\-path "~/Downloads/%h/%n")
.RE
.sp
\fIdownload\-filename\-format\fP (پارامترها: <string>؛ مقدار پیش‌فرض: \fI"%?u?%u&%Y\-%b\-%d\-%H%M%S.unknown?"\fP)
.RS 4
مشخص می‌کند که Podboat چگونه فایل‌های بارگیری‌شده را نام‌گذاری کند (همچنین \fIdownload\-path\fP را ببینید). برای جزئیات در مورد قالب‌های موجود، بخش FORMAT STRINGS در راهنمای Newsboat را ببینید. (مثال: download\-filename\-format "%F\-%t.%e")
.RE
.sp
\fImax\-downloads\fP (پارامترها: <number>؛ مقدار پیش‌فرض: \fI1\fP)
.RS 4
حداکثر تعداد بارگیری‌های موازی را هنگامی که بارگیری خودکار فعال است مشخص می‌کند. (مثال: max\-downloads 3)
.RE
.sp
\fIplayer\fP (پارامترها: <player command>؛ مقدار پیش‌فرض: \fI""\fP)
.RS 4
پخش‌کننده‌ای را مشخص می‌کند که برای بازپخش فایل‌های بارگیری‌شده استفاده خواهد شد. (مثال: player "mp3blaster")
.RE
.sp
\fIpodlist\-format\fP (پارامترها: <format>؛ مقدار پیش‌فرض: \fI"%4i [%6dMB/%6tMB] [%5p %%] [%12K] %\-20S %u \(-> %F"\fP)
.RS 4
این متغیر قالب مدخل‌ها را در فهرست بارگیری Podboat تعیین می‌کند. برای اطلاعات بیشتر درباره رشته‌های قالب‌بندی، بخش FORMAT STRINGS را در مستندات ببینید. (مثال: podlist\-format "%i %u %\-20S %F")
.RE
.SH "رشته‌های قالب‌بندی (FORMAT STRINGS)"
.sp
برنامه Newsboat شامل یک سیستم قدرتمند رشته‌های قالب‌بندی است تا امکان پیکربندی قالب جنبه‌های مختلف برنامه، مانند قالب مدخل‌ها در فهرست خوراک‌ها یا در فهرست مقالات را برای کاربر فراهم کند.
.sp
رشته‌های قالب‌بندی شبیه مواردی هستند که در تابع \fIprintf\fP در زبان برنامه‌نویسی C یافت می‌شوند. یک توالی قالب‌بندی با نویسه \fI%\fP آغاز می‌شود و به دنبال آن مشخص‌کننده اختیاری تراز قرار می‌گیرد: اعداد مثبت نشان می‌دهند که متن درج‌شده برای توالی باید از سمت چپ به اندازه عرض کلی مشخص‌شده توسط عدد فاصله‌گذاری (pad) شود، در حالی که اعداد منفی فاصله‌گذاری از سمت راست را تعیین می‌کنند. پس از تعیین فاصله‌گذاری، شناسه اصلی توالی می‌آید که معمولاً یک حرف منفرد است. \fI%=[width][identifier]\fP توالی را در مرکز قرار می‌دهد، که اگر w=0 باشد کل عرض پنجره استفاده می‌شود.
.sp
علاوه بر این، Newsboat توالی‌های قدرتمندتر دیگری نیز فراهم می‌کند، مانند \fI%>[char]\fP که مشخص می‌کند متنِ سمت راستِ توالی در صفحه راست‌چین خواهد شد، و نویسه‌های بین متن سمت چپ و متن سمت راست با \fI[char]\fP پر می‌شوند. قالب قدرتمند دیگر، توالی شرطی \fI%?[char]?[format 1]&[format 2]?\fP است: اگر متنِ شناسه توالی \fI[char]\fP شامل هرگونه نویسه غیرفاصله‌ای باشد، آنگاه \fI[format 1]\fP ارزیابی و درج می‌شود، در غیر این صورت \fI[format 2]\fP ارزیابی و درج خواهد شد. بخش \fI&\fP و \fI[format 2]\fP اختیاری هستند، یعنی اگر متن شناسه خالی باشد، یک رشته خالی درج خواهد شد.
.sp
جدول‌های زیر نشان می‌دهند که چه شناسه‌های توالی برای کدام قالب در دسترس هستند:
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۱. شناسه‌های موجود برای feedlist\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
d
T}:T{
.sp
توضیحات خوراک
T}
T{
.sp
i
T}:T{
.sp
نمایه خوراک
T}
T{
.sp
l
T}:T{
.sp
پیوند خوراک
T}
T{
.sp
L
T}:T{
.sp
نشانی RSS خوراک
T}
T{
.sp
n
T}:T{
.sp
فیلد نشانگر «خوانده‌نشده» (unread)
T}
T{
.sp
S
T}:T{
.sp
وضعیت بارگیری
T}
T{
.sp
t
T}:T{
.sp
عنوان خوراک
T}
T{
.sp
T
T}:T{
.sp
اولین برچسب یک خوراک در فایل URLs
T}
T{
.sp
u
T}:T{
.sp
فیلد «خوانده‌نشده/مجموع»
T}
T{
.sp
U
T}:T{
.sp
فیلد «خوانده‌نشده»
T}
T{
.sp
c
T}:T{
.sp
فیلد «مجموع»
T}
.TE
.sp
.sp
هنگامی که عملیات \fIreload\-all\fP در حال اجرا است، وضعیت بارگیری نشان‌دهنده وضعیت بارگیری یک خوراک است که می‌تواند «در انتظار بارگیری» (مشخص‌شده با «_»)، «در حال بارگیری» (مشخص‌شده با «.»)، بارگیری موفقیت‌آمیز (مشخص‌شده با « ») و «خطای بارگیری» (مشخص‌شده با «x») باشد.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۲. شناسه‌های موجود برای articlelist\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
a
T}:T{
.sp
نویسنده مقاله
T}
T{
.sp
D
T}:T{
.sp
تاریخ انتشار. این مورد می‌تواند با datetime\-format بیشتر سفارشی‌سازی شود.
T}
T{
.sp
f
T}:T{
.sp
دو نویسه: ۱) «N» اگر مقاله خوانده‌نشده باشد، «D» اگر مقاله حذف شده باشد، در غیر این صورت یک فاصله؛ ۲) «!» اگر مقاله نشان‌گذاری شده باشد، در غیر این صورت یک فاصله.
T}
T{
.sp
n
T}:T{
.sp
فیلد «خوانده‌نشده»
T}
T{
.sp
d
T}:T{
.sp
فیلد «حذف‌شده»
T}
T{
.sp
F
T}:T{
.sp
نشان‌های مقاله
T}
T{
.sp
i
T}:T{
.sp
نمایه مقاله
T}
T{
.sp
t
T}:T{
.sp
عنوان مقاله
T}
T{
.sp
T
T}:T{
.sp
اگر فهرست مقالات، مقالاتی از خوراک‌های مختلف را نمایش دهد، این شناسه حاوی عنوان خوراکی است که مقاله به آن تعلق دارد.
T}
T{
.sp
L
T}:T{
.sp
طول مقاله
T}
T{
.sp
e
T}:T{
.sp
نشانی URL محفظه (enclosure) مقاله
T}
.TE
.sp
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۳. شناسه‌های موجود برای selecttag\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
i
T}:T{
.sp
نمایه سطر در فهرست
T}
T{
.sp
T
T}:T{
.sp
برچسبی که این سطر با آن متناظر است
T}
T{
.sp
f
T}:T{
.sp
تعداد خوراک‌های خوانده‌نشده تحت این برچسب
T}
T{
.sp
n
T}:T{
.sp
تعداد مقالات خوانده‌نشده در خوراک‌های نشان‌گذاری‌شده با این برچسب
T}
T{
.sp
u
T}:T{
.sp
تعداد خوراک‌های نشان‌گذاری‌شده با این برچسب
T}
.TE
.sp
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۴. شناسه‌های موجود برای notify\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
n
T}:T{
.sp
تعداد مقالات خوانده‌نشده
T}
T{
.sp
f
T}:T{
.sp
تعداد خوراک‌های خوانده‌نشده
T}
T{
.sp
d
T}:T{
.sp
تعداد مقالات خوانده‌نشده جدید (یعنی مواردی که در آخرین بازبارگذاری اضافه شده‌اند)
T}
T{
.sp
D
T}:T{
.sp
تعداد خوراک‌های خوانده‌نشده جدید (یعنی مواردی که در آخرین بازبارگذاری اضافه شده‌اند)
T}
.TE
.sp
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۵. شناسه‌های موجود برای podlist\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
i
T}:T{
.sp
نمایه بارگیری
T}
T{
.sp
d
T}:T{
.sp
اندازه فعلی بارگیری‌شده به مگابایت، با دقت یک رقم اعشار
T}
T{
.sp
t
T}:T{
.sp
اندازه کل بارگیری به مگابایت، با دقت یک رقم اعشار
T}
T{
.sp
p
T}:T{
.sp
درصد بارگیری‌شده، با دقت یک رقم اعشار
T}
T{
.sp
k
T}:T{
.sp
سرعت بارگیری با دقت دو رقم اعشار، همیشه به کیلوبایت بر ثانیه (شامل عبارت «KB/s» نمی‌شود)
T}
T{
.sp
K
T}:T{
.sp
سرعت بارگیری با دقت دو رقم اعشار، خوانا برای انسان (تغییر خودکار بین KB/s، MB/s و GB/s)
T}
T{
.sp
S
T}:T{
.sp
وضعیت بارگیری، یکی از موارد زیر را نمایش می‌دهد: «queued»، «downloading»، «ready»، «canceled»، «deleted»، «missing»، «played»، «finished» یا «failed»
T}
T{
.sp
u
T}:T{
.sp
نشانی اینترنتی (URL) بارگیری
T}
T{
.sp
F
T}:T{
.sp
نام فایل مطلق بارگیری از دایرکتوری ریشه (مانند ~/downloads/podcast.mp3 \(-> /home/name/downloads/podcast.mp3)
T}
T{
.sp
b
T}:T{
.sp
نام پایه (basename) بارگیری (مانند /home/name/downloads/podcast.mp3 \(-> podcast.mp3)
T}
.TE
.sp
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۶. شناسه‌های موجود برای download\-path و download\-filename\-format
.TS
allbox tab(:);
ltB ltB.
T{
.sp
شناسه
T}:T{
.sp
معنا و کاربرد
T}
.T&
lt lt.
T{
.sp
u
T}:T{
.sp
بخش نام فایل از URL بارگیری. ممکن است خالی باشد. ممکن است شامل \c
.URL "https://en.wikipedia.org/wiki/Query_string" "یک رشته پرس‌وجو (query string)" ""
باشد
T}
T{
.sp
n
T}:T{
.sp
نام خوراک پادکست
T}
T{
.sp
N
T}:T{
.sp
نام خوراک پادکست. حاوی نام اصلی خوراک است، حتی زمانی که از طریق یک خوراک پرس‌وجو انتخاب شده باشد
T}
T{
.sp
h
T}:T{
.sp
نام میزبان (hostname) خوراک پادکست
T}
T{
.sp
t
T}:T{
.sp
عنوان قسمت پادکست
T}
T{
.sp
e
T}:T{
.sp
پسوند فایل قسمت پادکست
T}
T{
.sp
F
T}:T{
.sp
تاریخ انتشار قسمت پادکست با قالب yyyy\-mm\-dd
T}
T{
.sp
m
T}:T{
.sp
ماهی که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
b
T}:T{
.sp
نام اختصاری ماهی که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
d
T}:T{
.sp
روزی که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
H
T}:T{
.sp
ساعتی که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
M
T}:T{
.sp
دقیقه‌ای که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
S
T}:T{
.sp
ثانیه‌ای که قسمت پادکست در آن منتشر شده است
T}
T{
.sp
y
T}:T{
.sp
سال انتشار قسمت پادکست در قالب yy
T}
T{
.sp
Y
T}:T{
.sp
سال انتشار قسمت پادکست در قالب yyyy
T}
.TE
.sp
.sp
مثال‌ها:
.sp
.if n .RS 4
.nf
.fam C
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"
.fam
.fi
.if n .RE
.SH "فایل‌ها (FILES)"
.sp
به صورت پیش‌فرض، Newsboat تمام فایل‌ها را به روش سنتی یونیکس ذخیره می‌کند، یعنی در یک پوشه پنهان («dotdir») واقع در \fI~/.newsboat\fP. با این حال، از روش مدرن
.URL "https://standards.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html" "مشخصات دایرکتوری پایه XDG" ","
نیز پشتیبانی می‌کند که فایل‌ها را بین مکان‌های زیر تقسیم می‌نماید:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
\fI$XDG_CONFIG_HOME/newsboat/\fP (مقدار پیش‌فرض \fIXDG_CONFIG_HOME\fP برابر با \fI~/.config\fP است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
\fI$XDG_DATA_HOME/newsboat/\fP (مقدار پیش‌فرض \fIXDG_DATA_HOME\fP برابر با \fI~/.local/share\fP است)
.RE
.sp
اگر دایرکتوری \fInewsboat\fP در زیر \fIXDG_CONFIG_HOME\fP وجود داشته باشد، آنگاه Newsboat از دایرکتوری‌های XDG استفاده خواهد کرد (و در صورت نیاز دایرکتوری داده را ایجاد می‌کند). در غیر این صورت، Newsboat به طور پیش‌فرض از \fI~/.newsboat\fP استفاده می‌نماید.
.sp
اگر در حال حاضر از \fI~/.newsboat/\fP استفاده می‌کنید اما مایل هستید به دایرکتوری‌های XDG مهاجرت نمایید، باید فایل‌ها را به شرح زیر منتقل کنید:
.sp
\fIconfig\fP, \fIurls\fP
.RS 4
به \fI$XDG_CONFIG_HOME/newsboat/\fP
.RE
.sp
\fIcache.db\fP, \fIhistory.search\fP, \fIhistory.cmdline\fP, \fIqueue\fP
.RS 4
به \fI$XDG_DATA_HOME/newsboat/\fP
.RE
.sp
برنامه‌های Newsboat و Podboat همچنین «فایل‌های قفل» (lock files) ایجاد می‌کنند. این فایل‌ها از اجرای هم‌زمان دو نمونه از یک برنامه و در نتیجه از آسیب دیدن داده‌های شما جلوگیری می‌کنند. Newsboat و Podboat این فایل‌ها را هنگام خروج از برنامه حذف می‌نمایند، بنابراین نیازی به کپی کردن آن‌ها در جای دیگری نیست — فقط در صورتی که اسکریپت‌هایی می‌نویسید که با \fIcache.db\fP یا \fIqueue\fP کار می‌کنند، از وجود آن‌ها مطلع باشید. به صورت پیش‌فرض، فایل‌های قفل در مسیرهای زیر قرار دارند:
.TS
allbox tab(:);
ltB ltB ltB.
T{
.sp

T}:T{
.sp
dotdir
T}:T{
.sp
XDG
T}
.T&
lt lt lt.
T{
.sp
Newsboat
T}:T{
.sp
\fI~/.newsboat/cache.db.lock\fP
T}:T{
.sp
\fI$XDG_DATA_HOME/newsboat/cache.db.lock\fP
T}
T{
.sp
Podboat
T}:T{
.sp
\fI~/.newsboat/pb\-lock.pid\fP
T}:T{
.sp
\fI$XDG_DATA_HOME/newsboat/.lock\fP
T}
.TE
.sp
.sp
برنامه Newsboat فایل قفل را در کنار فایل حافظه موقت قرار می‌دهد، بنابراین اگر تنظیم cache\-file را مشخص کنید یا آرگومان خط فرمان \fI\(emcache\-file\fP را پاس دهید، مسیر فایل قفل نیز تغییر خواهد کرد. فایل قفل Podboat را می‌توان با استفاده از آرگومان خط فرمان \fI\(emlock\-file\fP در جای دیگری قرار داد.
.sp
dotfiles
.RS 4
\fI~/.newsboat/config\fP
.sp
\fI~/.newsboat/queue\fP
.RE
.sp
XDG
.RS 4
\fI$XDG_CONFIG_HOME/newsboat/config\fP
.sp
\fI$XDG_DATA_HOME/newsboat/queue\fP
.sp
نکته: اگر متغیر محیطی \fIXDG_CONFIG_HOME\fP تنظیم نشده باشد، Podboat طوری رفتار می‌کند که گویی روی \fI~/.config\fP تنظیم شده است. به طور مشابه، \fIXDG_DATA_HOME\fP به صورت پیش‌فرض \fI~/.local/share\fP است.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fIBROWSER\fP
.RS 4
به Newsboat می‌گوید در صورتی که تنظیم \fIbrowser\fP در فایل پیکربندی وجود نداشته باشد، از چه مرورگری استفاده کند. اگر این متغیر وجود نداشته باشد، مقدار پیش‌فرض \fIlynx(1)\fP استفاده خواهد شد.
.RE
.sp
\fICURL_CA_BUNDLE\fP
.RS 4
به Newsboat می‌گوید از فایل گواهی مشخص‌شده برای اعتبارسنجی طرف مقابل (peer) استفاده کند. فایل ممکن است حاوی چندین گواهی باشد. گواهی(ها) باید در قالب PEM باشند.
.sp
این گزینه زمانی مفید است که libcurl شما بدون اطلاعات گواهی مفید کامپایل شده باشد و شما نتوانید کتابخانه را خودتان کامپایل مجدد کنید.
.RE
.sp
\fIEDITOR\fP
.RS 4
به Newsboat می‌گوید هنگام ویرایش فایل \fIurls\fP از طریق عملیات \fIedit\-urls\fP در صورتی که متغیر محیطی \fIVISUAL\fP تنظیم نشده باشد، از چه ویرایشگر جایگزینی استفاده کند. اگر این متغیر نیز وجود نداشته باشد، مقدار پیش‌فرض \fIvi(1)\fP استفاده خواهد شد.
.RE
.sp
\fINO_PROXY\fP
.RS 4
به Newsboat می‌گوید تنظیم \fIproxy\fP را برای برخی سایت‌ها نادیده بگیرد.
.sp
این متغیر حاوی فهرستی از نام‌های میزبان، نام‌های دامنه و نشانی‌های IP است که با کاما از هم جدا شده‌اند.
.sp
نام‌های دامنه با زیردامنه‌ها تطبیق داده می‌شوند؛ یعنی «example.com» با «foo.example.com» نیز مطابقت دارد. نام‌های دامنه‌ای که با یک نقطه شروع می‌شوند فقط با زیردامنه‌ها مطابقت دارند؛ برای مثال «.example.com» با «bar.example.com» مطابقت دارد اما با خود «example.com» مطابقت ندارد.
.sp
آدرس‌های IPv6 بدون کروشه نوشته می‌شوند و \fIبه عنوان رشته تطبیق داده می‌شوند\fP. بنابراین «::1» با «::0:1» مطابقت ندارد، حتی اگر این‌ها همان آدرس یکسان باشند.
.RE
.sp
\fIPAGER\fP
.RS 4
به Newsboat می‌گوید در صورتی که تنظیم \fIpager\fP در فایل پیکربندی به طور صریح روی یک رشته خالی تنظیم شده باشد، از چه صفحه‌بندی استفاده کند.
.RE
.sp
\fITMPDIR\fP
.RS 4
به Newsboat می‌گوید از دایرکتوری مشخص‌شده برای ذخیره فایل‌های موقت استفاده کند. اگر این متغیر وجود نداشته باشد، مقدار پیش‌فرض \fI/tmp\fP استفاده خواهد شد.
.RE
.sp
\fIVISUAL\fP
.RS 4
به Newsboat می‌گوید هنگام ویرایش فایل \fIurls\fP از طریق عملیات \fIedit\-urls\fP از چه ویرایشگری استفاده کند. اگر این متغیر وجود نداشته باشد، متغیر محیطی \fIEDITOR\fP استفاده خواهد شد.
.RE
.sp
\fIXDG_CONFIG_HOME\fP
.RS 4
به Newsboat می‌گوید از کدام دایرکتوری پایه برای فایل‌های پیکربندی استفاده کند. همچنین برای اطلاعات بیشتر، بخش مربوط به فایل‌ها را ببینید.
.RE
.sp
\fIXDG_DATA_HOME\fP
.RS 4
به Newsboat می‌گوید از کدام دایرکتوری پایه برای فایل‌های داده استفاده کند. همچنین برای اطلاعات بیشتر، بخش مربوط به فایل‌ها را ببینید.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
newsboat(1)
.SH "نویسنده (AUTHOR)"
.sp
Alexander Batischev