.\" -*- mode: troff; coding: utf-8 -*-
.TH "ALPM-REPO-FILES" "5" "" "Pacman" "راهنمای قالب‌های فایل"
.SH "نام (NAME)"
.LP
alpm-repo-files \- قالب پرونده برای فهرست کردن فایل‌ها و پوشه‌های موجود در یک \fBalpm-package\fR.
.SH "توضیحات (DESCRIPTION)"
.LP
قالب \fBalpm-files\fR یک قالب متنی است که پوشه‌ها و فایل‌های موجود در یک \fBalpm-package\fR منفرد را فهرست می‌کند.
.PP
چنین فایل‌هایی \fBfiles\fR نامیده می‌شوند و در فایل‌های \fBalpm-repo-db\fR قرار دارند.
آن‌ها توسط نرم‌افزار مدیریت مخزن بسته (مانند \fBdbscripts\fR [1]) ایجاد می‌شوند.
نرم‌افزار مدیریت بسته (مانند \fBpacman\fR) از آن‌ها برای فهرست کردن و پرسمان مسیرهای پوشه‌ها و فایل‌های موجود در یک فایل بسته استفاده می‌کند.
.PP
مهم است که \fBalpm-repo-files\fR را با \fBalpm-db-files\fR که از همان نام فایل (\fBfiles\fR) استفاده می‌کند اما در چارچوب یک \fBalpm-db\fR به کار می‌رود، اشتباه نگیرید.
.SS
قالب کلی
.LP
یک فایل \fBalpm-repo-files\fR یک فایل با کدگذاری UTF-8 و جداشده با خط جدید است.
.PP
این فایل شامل یک سربرگ بخش منفرد و صفر یا چند مدخل بخش است.
خطوط خالی نادیده گرفته می‌شوند.
از یادداشت‌ها (کامنت‌ها) پشتیبانی نمی‌شود.
.PP
نخستین خط باید عبارت رشته‌ای \f(CR%FILES%\fR باشد که سربرگ بخش را نشان می‌دهد.
بسته‌های بدون فایل (مانند \fBalpm-meta-packages\fR) ممکن است فقط شامل این سربرگ بخش باشند.
.PP
تمامی خطوط بعدی به عنوان مدخل‌های بخش، یکی در هر خط، و مرتب‌شده به ترتیب لغوی تفسیر می‌شوند.
هر مدخل بخش نمایانگر مسیر یک فایل یا پوشه منفرد است.
قوانین قالب‌بندی زیر بر مسیرها اعمال می‌شوند:
.IP "\(bu" 3
پوشه‌ها همیشه با یک ممیز انتهایی (\f(CR/\fR) فهرست می‌شوند.
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
تمام مسیرها نسبت به ریشه سیستم هستند (یعنی \f(CR/usr/bin/foo\fR به صورت \f(CRusr/bin/foo\fR نشان داده می‌شود).
.SH "مثال‌ها (EXAMPLES)"
.LP
در ادامه نمونه‌ای از یک فایل \fBalpm-repo-files\fR برای بسته‌ای به نام \f(CRfoo\fR آورده شده است:
.LP
.EX
%FILES%
usr/
usr/bin/
usr/bin/foo
usr/share/
usr/share/bash-completion/
usr/share/bash-completion/completions/
usr/share/bash-completion/completions/foo
usr/share/doc/
usr/share/doc/foo/
usr/share/doc/foo/README.md
usr/share/fish/
usr/share/fish/vendor_completions.d/
usr/share/fish/vendor_completions.d/foo.fish
usr/share/licenses/
usr/share/licenses/foo/
usr/share/licenses/foo/LICENSE-MIT
usr/share/zsh/
usr/share/zsh/site-functions/
usr/share/zsh/site-functions/_foo
.EE
.PP
فایل‌های بسته‌بندی‌شده شامل یک فایل دودویی (\f(CRusr/bin/foo\fR)، یک فایل README (\f(CRusr/share/doc/foo/README.md\fR) و یک فایل مجوز (\f(CRusr/share/licenses/foo/LICENSE-MIT\fR) در میان فایل‌های دیگر مانند اسکریپت‌های تکمیل خودکار برای پوسته‌های مختلف هستند.
.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBalpm-db-files\fR(5), \fBalpm\fR(7), \fBalpm-db\fR(7), \fBalpm-package\fR(7), \fBalpm-package-name\fR(7), \fBalpm-package-version\fR(7), \fBalpm-repo\fR(7), \fBalpm-repo-db\fR(7), \fBpacman\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP "1." 3
\fBdbscripts\fR
.IP
.UR https://gitlab.archlinux.org/archlinux/dbscripts
.UE