.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "LEI-ADD-EXTERNAL 1"
.TH LEI-ADD-EXTERNAL 1 1993-10-02 public-inbox.git "public-inbox user manual"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
lei\-add\-external \- افزودن صندوق پستی یا نمایه خارجی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
lei add\-external [OPTIONS] LOCATION
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
پیکربندی \fBlei\fR برای جستجو در یک منبع خارجی (یک صندوق پستی یا نمایهٔ خارجی). هنگامی که \f(CW\*(C`LOCATION\*(C'\fR یک مسیر محلی موجود باشد، باید به دایرکتوری‌ای اشاره کند که مقدار \f(CW\*(C`publicinbox.$NAME.inboxdir\*(C'\fR یا \f(CW\*(C`extindex.$NAME.topdir\*(C'\fR در فایل \f(CW~/.public\-inbox/config\fR باشد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \-\-boost=NUMBER 4
.IX Item "--boost=NUMBER"
تنظیم اولویت یک مکان جدید یا موجود.
.Sp
پیش‌فرض: 0
.IP \-\-mirror=URL 4
.IX Item "--mirror=URL"
ایجاد \f(CW\*(C`LOCATION\*(C'\fR از طریق آینه‌سازی (mirroring) از \fBpublic\-inbox\fR واقع در \f(CW\*(C`URL\*(C'\fR. در \f(CW\*(C`LOCATION\*(C'\fR یک Makefile با هدف \f(CW\*(C`make update\*(C'\fR برای به‌روزرسانی منبع خارجی قرار خواهد گرفت.
.IP \-\-epoch=RANGE 4
.IX Item "--epoch=RANGE"
محدود کردن کلون‌های صندوق‌های پستی \fBpublic\-inbox\-v2\-format\fR\|(5) به بازهٔ داده‌شده از دوره‌ها (epochs). این بازه می‌تواند یک عدد صحیح غیرمنفی منفرد یا یک بازه (احتمالاً بدون انتهای بسته) از اعداد صحیح غیرمنفی به‌صورت \f(CW\*(C`LOW..HIGH\*(C'\fR باشد. می‌توان نماد \f(CW\*(C`~\*(C'\fR را به عنوان پیشوند به هر یک از مقادیر صحیح (یا هر دو) اضافه کرد تا افست (فاصله) از بیشینه مقدار ممکن را نشان دهد.
.Sp
برای نمونه، \f(CW\*(C`\-\-epoch=~0\*(C'\fR به‌تنهایی فقط آخرین دوره را کلون می‌کند، و \f(CW\*(C`\-\-epoch=~2..\*(C'\fR سه دورهٔ اخیر را کلون می‌نماید.
.Sp
پیش‌فرض: \f(CW\*(C`0..~0\*(C'\fR یا \f(CW0..\fR یا \f(CW\*(C`..~0\*(C'\fR
(همهٔ دوره‌ها، هر سه مثال معادل یکدیگر هستند)
.IP \-v 4
.IX Item "-v"
.PD 0
.IP \-\-verbose 4
.IX Item "--verbose"
.PD
ارائه بازخورد بیشتر در خروجی خطای استاندارد (stderr).
.IP \-q 4
.IX Item "-q"
.PD 0
.IP \-\-quiet 4
.IX Item "--quiet"
.PD
جلوگیری از نمایش پیام‌های بازخورد.
.SS "آینه‌سازی (MIRRORING)"
.IX Subsection "MIRRORING"
.IP \-\-torsocks=auto|no|yes 4
.IX Item "--torsocks=auto|no|yes"
.PD 0
.IP \-\-no\-torsocks 4
.IX Item "--no-torsocks"
.PD
تعیین اینکه آیا دستورات \fBgit\fR\|(1) و \fBcurl\fR\|(1) در \fBtorsocks\fR\|(1) محصور (wrap) شوند یا خیر.
.Sp
پیش‌فرض: \f(CW\*(C`auto\*(C'\fR
.IP \-\-inbox\-version=NUM 4
.IX Item "--inbox-version=NUM"
اجبار نسخهٔ \fBpublic\-inbox\fR راه دور (باید \f(CW1\fR یا \f(CW2\fR باشد). این مقدار به‌طور پیش‌فرض به‌صورت خودکار تشخیص داده می‌شود، و این گزینه عمدتاً برای آزمایش کاربرد دارد.
.PP
گزینه‌های زیر به \fBpublic\-inbox\-init\fR\|(1) ارسال می‌شوند:
.IP "\-j JOBS, \-\-jobs=JOBS" 4
.IX Item "-j JOBS, --jobs=JOBS"
.PD 0
.IP "\-L LEVEL, \-\-indexlevel=LEVEL" 4
.IX Item "-L LEVEL, --indexlevel=LEVEL"
.PD
.PP
گزینه‌های زیر به \fBpublic\-inbox\-index\fR\|(1) ارسال می‌شوند:
.IP \-\-batch\-size=SIZE 4
.IX Item "--batch-size=SIZE"
.PD 0
.IP \-\-compact 4
.IX Item "--compact"
.IP "\-j JOBS, \-\-jobs=JOBS" 4
.IX Item "-j JOBS, --jobs=JOBS"
.IP \-\-max\-size=SIZE 4
.IX Item "--max-size=SIZE"
.IP \-\-sequential\-shard 4
.IX Item "--sequential-shard"
.IP \-\-skip\-docdata 4
.IX Item "--skip-docdata"
.PD
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
فایل پیکربندی \fBlei\fR در مسیر \f(CW\*(C`$XDG_CONFIG_HOME/lei/config\*(C'\fR قرار دارد.
.SH "تماس (CONTACT)"
.IX Header "CONTACT"
ارسال بازخورد از طریق رایانامهٔ متنی ساده به <mailto:meta@public\-inbox.org> مورد استقبال است.
.PP
بایگانی‌های رایانامه در نشانی‌های <https://public\-inbox.org/meta> و <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta> میزبانی می‌شوند.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر ۲۰۲۱ متعلق به همهٔ مشارکت‌کنندگان <mailto:meta@public\-inbox.org>
.PP
مجوز: AGPL\-3.0+ <https://www.gnu.org/licenses/agpl\-3.0.txt>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlei\-forget\-external\fR\|(1), \fBlei\-ls\-external\fR\|(1), \fBlei\-import\fR\|(1),
\&\fBpublic\-inbox\-index\fR\|(1), \fBpublic\-inbox\-extindex\fR\|(1),
\&\fBpublic\-inbox\-extindex\-format\fR\|(5)