'\" t
.\"     Title: dblatex
.\"    Author: Benoit Guillon
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net>
.\"      Date: March 6, 2015
.\"    Manual: Dblatex Manual Page
.\"    Source: dblatex \fI0.3.12\fR
.\"  Language: Persian
.\"
.TH "DBLATEX" "1" "6 مارس 2015" "dblatex \fI0\&.3\&.12\fR" "صفحه راهنمای Dblatex"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.SH "نام (NAME)"
dblatex \- تبدیل اسناد DocBook به LaTeX، DVI، PostScript و PDF
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdblatex\fR\ 'u
\fBdblatex\fR [\fBگزینه‌ها\fR] {\fIفایل\fR\ |\ \-}
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما به‌طور خلاصه دستور
\fBdblatex\fR
را مستند می‌کند\&. برای جزئیات بیشتر راهنمای PDF را مطالعه کنید؛ به بخش زیر مراجعه فرمایید\&.
.PP
برنامه
\fBdblatex\fR
ابزاری است که اسناد
DocBook
مبتنی بر
SGML/XML
شما را در اولین گام با ترجمه آن‌ها به کد خالص
LaTeX
به قالب‌های
DVI،
PostScript
یا
PDF
تبدیل می‌کند\&.
نشانه‌گذاری‌های MathML 2\&.0 نیز پشتیبانی می‌شوند\&.
این پروژه در ابتدا به‌عنوان یک کلون از DB2LaTeX آغاز شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
خلاصه‌ای از گزینه‌ها در زیر آمده است\&.
برای توضیحات کامل به راهنمای PDF مراجعه کنید\&.
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش پیام راهنما و خروج\&.
.RE
.PP
\fB\-b \fR\fB\fIbackend\fR\fR, \fB\-\-backend=\fR\fB\fIbackend\fR\fR
.RS 4
درایور بک‌اند مورد استفاده:
\fIpdftex\fR
(پیش‌فرض)،
\fIdvips\fR، یا
\fIxetex\fR\&.
.RE
.PP
\fB\-B\fR, \fB\-\-no\-batch\fR
.RS 4
تمام خروجی‌های tex چاپ می‌شوند\&.
.RE
.PP
\fB\-c \fR\fB\fIconfig\fR\fR, \fB\-S \fR\fB\fIconfig\fR\fR, \fB\-\-config=\fR\fB\fIconfig\fR\fR
.RS 4
فایل پیکربندی\&. می‌توان از فایل پیکربندی برای گروه‌بندی تمام گزینه‌ها و سفارشی‌سازی‌ها استفاده کرد\&.
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
حالت اشکال‌زدایی: نگه‌داشتن دایرکتوری موقتی که dblatex در آن کار می‌کند\&.
.RE
.PP
\fB\-D\fR, \fB\-\-dump\fR
.RS 4
دامپ کردن پشته خطا هنگام وقوع خطا (جهت اهداف اشکال‌زدایی)\&.
.RE
.PP
\fB\-e \fR\fB\fIindexstyle\fR\fR, \fB\-\-indexstyle \fR\fB\fIindexstyle\fR\fR
.RS 4
فایل سبک نمایه برای ارسال به
\fBmakeindex\fR
به‌جای سبک نمایه پیش‌فرض dblatex\&.
.RE
.PP
\fB\-f \fR\fB\fIfigure_format\fR\fR, \fB\-\-fig\-format=\fR\fB\fIfigure_format\fR\fR
.RS 4
قالب تصویر ورودی:
\fIfig\fR،
\fIeps\fR\&. زمانی استفاده می‌شود که از پسوند فایل تصویر قابل تشخیص نباشد\&.
.RE
.PP
\fB\-F \fR\fB\fIinput_format\fR\fR, \fB\-\-input\-format=\fR\fB\fIinput_format\fR\fR
.RS 4
قالب فایل ورودی:
\fIsgml\fR،
\fIxml\fR
(پیش‌فرض)\&.
.RE
.PP
\fB\-i \fR\fB\fItexinputs\fR\fR, \fB\-\-texinputs \fR\fB\fItexinputs\fR\fR
.RS 4
مسیری که به
\fBTEXINPUTS\fR
افزوده می‌شود\&.
.RE
.PP
\fB\-I \fR\fB\fIfigure_path\fR\fR, \fB\-\-fig\-path=\fR\fB\fIfigure_path\fR\fR
.RS 4
مسیر جستجوی اضافی برای تصاویر\&.
.RE
.PP
\fB\-l \fR\fB\fIbst_path\fR\fR, \fB\-\-bst\-path=\fR\fB\fIbst_path\fR\fR
.RS 4
مسیر جستجوی اضافی برای سبک‌های BibTeX\&.
.RE
.PP
\fB\-L \fR\fB\fIbib_path\fR\fR, \fB\-\-bib\-path=\fR\fB\fIbib_path\fR\fR
.RS 4
مسیر جستجوی اضافی برای پایگاه‌داده‌های BibTeX\&.
.RE
.PP
\fB\-m \fR\fB\fIxslt\fR\fR, \fB\-\-xslt=\fR\fB\fIxslt\fR\fR
.RS 4
موتور XSLT مورد استفاده\&. موتورهای موجود عبارتند از: xsltproc (پیش‌فرض)، 4xslt، saxon\&.
.RE
.PP
\fB\-o \fR\fB\fIoutput\fR\fR, \fB\-\-output=\fR\fB\fIoutput\fR\fR
.RS 4
نام فایل خروجی\&. در صورت عدم تعیین، از نام فایل ورودی همراه با پسوند قالب خروجی استفاده می‌شود\&. اگر چندین کتاب از یک مجموعه تکه‌تکه (chunk) شوند، این گزینه نادیده گرفته شده و گزینه
\fB\-O\fR
اعمال می‌شود\&.
.RE
.PP
\fB\-O \fR\fB\fIoutput_dir\fR\fR, \fB\-\-output\-dir=\fR\fB\fIoutput_dir\fR\fR
.RS 4
دایرکتوری خروجی برای کتاب‌های ساخته‌شده از یک مجموعه\&. در صورت عدم تعیین، از دایرکتوری کاری فعلی استفاده می‌شود\&. این گزینه در صورت خروجی یک سند واحد نادیده گرفته شده و گزینه
\fB\-o\fR
لحاظ می‌گردد\&.
.RE
.PP
\fB\-p \fR\fB\fIxsl_user\fR\fR, \fB\-\-xsl\-user=\fR\fB\fIxsl_user\fR\fR
.RS 4
شیوه‌نامه (stylesheet) کاربری
XSL
برای استفاده\&. چندین شیوه‌نامه کاربری را می‌توان مشخص کرد، اما ترتیب گزینه‌ها مهم است: شیوه‌نامه کاربری جدیدتر بر موارد قبلی اولویت دارد\&.
.RE
.PP
\fB\-P \fR\fB\fIparam\fR\fR\fB=\fR\fB\fIvalue\fR\fR, \fB\-\-param=\fR\fB\fIparam\fR\fR\fB=\fR\fB\fIvalue\fR\fR
.RS 4
تنظیم یک پارامتر
XSL
از طریق خط فرمان\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
حالت کم‌گو، نمایش تنها پیام‌های خروجی TeX و پیام‌های خطا\&.
.RE
.PP
\fB\-r \fR\fB[plugin:]\fR\fB\fIscript\fR\fR, \fB\-\-texpost=\fR\fB[plugin:]\fR\fB\fIscript\fR\fR
.RS 4
اسکریپتی که در انتهای کامپایل tex فراخوانی می‌شود\&. وظیفه آن اصلاح فایل tex یا یکی از فایل‌های کامپایل پیش از دور آخر است\&. مقدار
\fIscript\fR
می‌تواند یک پلاگین پایتون باشد\&. در این حالت پیشوند 'plugin:' را اضافه کنید\&.
.RE
.PP
\fB\-s \fR\fB\fIlatex_style\fR\fR, \fB\-\-texstyle=\fR\fB\fIlatex_style\fR\fR
.RS 4
سبک لاتک مورد اعمال\&. می‌تواند نام یک بسته یا مستقیماً مسیر یک بسته لاتک باشد\&. نام بسته باید بدون مسیر دایرکتوری و بدون پسوند '.sty' باشد\&. برعکس، مسیر کامل بسته لاتک می‌تواند شامل مسیر دایرکتوری باشد، اما باید به پسوند '.sty' ختم شود\&.
.RE
.PP
\fB\-t \fR\fB\fIformat\fR\fR, \fB\-\-type=\fR\fB\fIformat\fR\fR
.RS 4
قالب خروجی\&. قالب‌های موجود:
\fItex\fR،
\fIdvi\fR،
\fIps\fR،
\fIpdf\fR
(پیش‌فرض)\&.
.RE
.PP
\fB\-\-dvi\fR
.RS 4
خروجی DVI\&. معادل
\fB\-tdvi\fR\&.
.RE
.PP
\fB\-\-pdf\fR
.RS 4
خروجی PDF\&. معادل
\fB\-tpdf\fR\&.
.RE
.PP
\fB\-\-ps\fR
.RS 4
خروجی PostScript\&. معادل
\fB\-tps\fR\&.
.RE
.PP
\fB\-T \fR\fB\fIstyle\fR\fR, \fB\-\-style=\fR\fB\fIstyle\fR\fR
.RS 4
سبک خروجی، سبک‌های از پیش تعریف‌شده عبارتند از:
\fIdb2latex\fR،
\fIsimple\fR،
\fInative\fR
(پیش‌فرض)\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه dblatex\&.
.RE
.PP
\fB\-V\fR, \fB\-\-verbose\fR
.RS 4
حالت پرگو، نمایش دستورات در حال اجرا\&.
.RE
.PP
\fB\-x \fR\fB\fIxslt_options\fR\fR, \fB\-\-xslt\-opts=\fR\fB\fIxslt_options\fR\fR
.RS 4
آرگومان‌هایی که مستقیماً به موتور XSLT ارسال می‌شوند\&.
.RE
.PP
\fB\-X\fR, \fB\-\-no\-external\fR
.RS 4
غیرفعال‌سازی پشتیبانی از فایل‌های متنی خارجی\&. این پشتیبانی برای calloutهای فایل‌های خارجی که توسط textdata یا imagedata ارجاع داده شده‌اند لازم است، اما اگر سند فاقد چنین مواردی باشد می‌توان آن را غیرفعال کرد\&. غیرفعال کردن این ویژگی می‌تواند عملکرد پردازش را برای اسناد حجیم بهبود بخشد\&.
.RE
.SH "فایل‌ها و دایرکتوری‌ها (FILES AND DIRECTORIES)"
.PP
$HOME/\&.dblatex/
.RS 4
دایرکتوری پیکربندی کاربر\&.
.RE
.PP
/etc/dblatex/
.RS 4
دایرکتوری پیکربندی سراسری سیستم\&.
.RE
.PP
سبک‌های خروجی از پیش تعریف‌شده در دایرکتوری بسته نصب‌شده قرار دارند\&.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBDBLATEX_CONFIG_FILES\fR
.RS 4
دایرکتوری‌های پیکربندی اضافی که ممکن است شامل فایل‌های پیکربندی dblatex باشند\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
تولید
myfile\&.pdf
از
myfile\&.xml:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
تنظیم برخی پارامترهای XSL از طریق خط فرمان:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-P latex\&.babel\&.language=de myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
استفاده از شیوه‌نامه XSL خودتان:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-p myconfig\&.xsl myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
استفاده از سبک خروجی db2latex:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-T db2latex myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
اعمال سبک لاتک سفارشی خود:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-s mystyle myfile\&.xml
dblatex \-s /path/to/mystyle\&.sty myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
ارسال آرگومان‌های اضافی به موتور XSLT:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-x "\-\-path /path/to/load/entity" myfile\&.xml
.fi
.if n \{\
.RE
.\}
.PP
استفاده از
\fBdblatex\fR
همراه با نمایه کردن (profiling):
.sp
.if n \{\
.RS 4
.\}
.nf
xsltproc \-\-param profile\&.attribute "\*(Aqoutput\*(Aq" \e
         \-\-param profile\&.value "\*(Aqpdf\*(Aq" \e
         /path/to/profiling/profile\&.xsl \e
         myfile\&.xml | dblatex \-o myfile\&.pdf \-
.fi
.if n \{\
.RE
.\}
.PP
ساخت مجموعه‌ای از کتاب‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
dblatex \-O /path/to/chunk/dir \-Pset\&.book\&.num=all myfile\&.xml
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
این برنامه به‌طور کامل در
"DocBook to LaTeX Publishing \- User Manual"
موجود در دایرکتوری مستندات بسته، مستند شده است\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBBenoit Guillon\fR
.RS 4
نگه‌دارنده بالادست (Upstream)
.RE
.PP
\fBAndreas Hoenen\fR <\&andreas\&.hoenen@arcor\&.de\&>
.RS 4
نگه‌دارنده دبیان
.RE
.SH "حق نشر (COPYRIGHT)"
.br
Copyright \(co 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Andreas Hoenen
.br
.PP
این صفحه راهنما برای سیستم دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود)\&.
.PP
مجوز کپی، توزیع یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GPL)، نسخه 2 یا هر نسخه بالاتر منتشر شده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود\&.
.PP
در سیستم‌های دبیان، متن کامل مجوز عمومی همگانی گنو در مسیر /usr/share/common\-licenses/GPL در دسترس است\&.
.sp