.\" -*- 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 "LR_XML2MAIL.IN 1"
.TH LR_XML2MAIL.IN 1 2025-09-28 "Lire 2.1.1" "LogReport's Lire Documentation"
.\" 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)"
lr_xml2mail \- قالب‌بندی یک گزارش XML و ارسال آن از طریق ایمیل
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBlr_xml2mail\fR \fB[\fR\fIoptions\fR\fB]\fR \fIreport.xml\fR \fIrecipieint\fR...
.PP
\&\fBlr_xml2mail\fR \fB\-\-version\fR
.PP
\&\fBlr_xml2mail\fR \fB\-\-help\fR \fB[dlf\-converters|output\-formats|report\-templates]\fR
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-help\fR \fB[\fR\fIsection\fR\fB]\fR" 4
.IX Item "--help [section]"
اگر هیچ آرگومانی داده نشود، اطلاعات نحوهٔ استفاده را چاپ کرده و خارج می‌شود. آرگومان می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP dlf\-converters 4
.IX Item "dlf-converters"
فهرست مبدل‌های DLF موجود را چاپ کرده و خارج می‌شود.
.IP output\-formats 4
.IX Item "output-formats"
فهرست قالب‌های خروجی موجود را چاپ کرده و خارج می‌شود.
.IP report\-templates 4
.IX Item "report-templates"
فهرست الگوهای گزارش موجود را چاپ کرده و خارج می‌شود.
.RE
.RS 4
.RE
.IP "\fB\-\-output\-format\fR \fIoutput format\fR" 4
.IX Item "--output-format output format"
قالب خروجی مورد نظر برای تولید گزارش را انتخاب می‌کند.
.IP "\fB\-\-template\fR \fIname\fR" 4
.IX Item "--template name"
از الگوی پیکربندی گزارش با نام \fIname\fR برای ادغام گزارش‌ها استفاده می‌کند. این گزینه هنگام استفاده از گزینهٔ \fB\-\-merge\fR برای ادغام گزارش‌ها الزامی است.
.IP "\fB\-\-merge\fR \fIreport_file\fR" 4
.IX Item "--merge report_file"
فایل \fIreport_file\fR را پیش از قالب‌بندی گزارش ادغام می‌کند. این گزینه می‌تواند چندین بار برای ادغام بیش از دو گزارش به کار رود.
.IP "\fB\-\-subject\fR \fIsubject\fR" 4
.IX Item "--subject subject"
موضوع پیام ایمیل را تنظیم می‌کند. مقدار پیش‌فرض \*(AqYour \fIformat\fR report\*(Aq است.
.IP "\fB\-\-extra\-file\fR \fIfile\fR" 4
.IX Item "--extra-file file"
یک فایل متنی اضافی که همراه با گزارش ارسال خواهد شد. اگر قالب خروجی txt باشد، به انتهای گزارش الحاق می‌شود.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBlr_xml2mail\fR گزارش‌های XML تولیدشده توسط Lire را به قالب‌های خروجی مختلف تبدیل کرده و آن را از طریق ایمیل برای گیرندگانی که به عنوان آرگومان‌های بعدی مشخص شده‌اند ارسال می‌کند.
.PP
این دستور بسته به قالب خروجی انتخاب‌شده اطمینان حاصل می‌کند که گزارش به‌درستی درون MIME کپسوله‌سازی شود. برای نمونه، یک گزارش PDF به‌صورت یک پیوست ارسال خواهد شد و خروجی (X)HTML در قالب یک پیام ایمیل HTML ظاهر می‌شود. همچنین نوع محتوا (content\-type) پیام MIME نیز به‌طور مناسب تنظیم خواهد شد.
.PP
سرآیندهای From و Reply\-To از متغیرهای پیکربندی \f(CW\*(C`lr_from\*(C'\fR و \&\f(CW\*(C`lr_reply_to\*(C'\fR مقداردهی اولیه می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlr_log2mail\fR\|(1), \fBlr_log2report\fR\|(1), \fBlr_xml2report\fR\|(1), \fBlire\fR\|(1), \fBlire\fR\|(7),
مستندات موجود در راهنمای کاربر Lire
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
.Vb 1
\&  Francis J. Lacoste <flacoste@logreport.org>
.Ve
.SH "نسخه (VERSION)"
.IX Header "VERSION"
\&\f(CW$Id:\fR lr_xml2mail.in,v 1.23 2006/07/23 13:16:33 vanbaal Exp $
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (C) 2002\-2004 بنیاد Stichting LogReport به آدرس LogReport@LogReport.org
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بالاتر بعدی، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید یک نسخه از «پروانه عمومی همگانی گنو» را همراه با این برنامه دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت، نشانی <http://www.gnu.org/copyleft/gpl.html> را بررسی کنید.