نام (NAME)

dblatex - تبدیل اسناد DocBook به LaTeX، DVI، PostScript و PDF

خلاصه دستور (SYNOPSIS)

dblatex [گزینه‌ها] {فایل | -}

توضیحات (DESCRIPTION)

این صفحه راهنما به‌طور خلاصه دستور dblatex را مستند می‌کند. برای جزئیات بیشتر راهنمای PDF را مطالعه کنید؛ به بخش زیر مراجعه فرمایید.

برنامه dblatex ابزاری است که اسناد DocBook مبتنی بر SGML/XML شما را در اولین گام با ترجمه آن‌ها به کد خالص LaTeX به قالب‌های DVI، PostScript یا PDF تبدیل می‌کند. نشانه‌گذاری‌های MathML 2.0 نیز پشتیبانی می‌شوند. این پروژه در ابتدا به‌عنوان یک کلون از DB2LaTeX آغاز شد.

گزینه‌ها (OPTIONS)

خلاصه‌ای از گزینه‌ها در زیر آمده است. برای توضیحات کامل به راهنمای PDF مراجعه کنید.

-h, --help

نمایش پیام راهنما و خروج.

-b backend, --backend=backend

درایور بک‌اند مورد استفاده: pdftex (پیش‌فرض)، dvips، یا xetex.

-B, --no-batch

تمام خروجی‌های tex چاپ می‌شوند.

-c config, -S config, --config=config

فایل پیکربندی. می‌توان از فایل پیکربندی برای گروه‌بندی تمام گزینه‌ها و سفارشی‌سازی‌ها استفاده کرد.

-d, --debug

حالت اشکال‌زدایی: نگه‌داشتن دایرکتوری موقتی که dblatex در آن کار می‌کند.

-D, --dump

دامپ کردن پشته خطا هنگام وقوع خطا (جهت اهداف اشکال‌زدایی).

-e indexstyle, --indexstyle indexstyle

فایل سبک نمایه برای ارسال به makeindex به‌جای سبک نمایه پیش‌فرض dblatex.

-f figure_format, --fig-format=figure_format

قالب تصویر ورودی: fig، eps. زمانی استفاده می‌شود که از پسوند فایل تصویر قابل تشخیص نباشد.

-F input_format, --input-format=input_format

قالب فایل ورودی: sgml، xml (پیش‌فرض).

-i texinputs, --texinputs texinputs

مسیری که به TEXINPUTS افزوده می‌شود.

-I figure_path, --fig-path=figure_path

مسیر جستجوی اضافی برای تصاویر.

-l bst_path, --bst-path=bst_path

مسیر جستجوی اضافی برای سبک‌های BibTeX.

-L bib_path, --bib-path=bib_path

مسیر جستجوی اضافی برای پایگاه‌داده‌های BibTeX.

-m xslt, --xslt=xslt

موتور XSLT مورد استفاده. موتورهای موجود عبارتند از: xsltproc (پیش‌فرض)، 4xslt، saxon.

-o output, --output=output

نام فایل خروجی. در صورت عدم تعیین، از نام فایل ورودی همراه با پسوند قالب خروجی استفاده می‌شود. اگر چندین کتاب از یک مجموعه تکه‌تکه (chunk) شوند، این گزینه نادیده گرفته شده و گزینه -O اعمال می‌شود.

-O output_dir, --output-dir=output_dir

دایرکتوری خروجی برای کتاب‌های ساخته‌شده از یک مجموعه. در صورت عدم تعیین، از دایرکتوری کاری فعلی استفاده می‌شود. این گزینه در صورت خروجی یک سند واحد نادیده گرفته شده و گزینه -o لحاظ می‌گردد.

-p xsl_user, --xsl-user=xsl_user

شیوه‌نامه (stylesheet) کاربری XSL برای استفاده. چندین شیوه‌نامه کاربری را می‌توان مشخص کرد، اما ترتیب گزینه‌ها مهم است: شیوه‌نامه کاربری جدیدتر بر موارد قبلی اولویت دارد.

-P param=value, --param=param=value

تنظیم یک پارامتر XSL از طریق خط فرمان.

-q, --quiet

حالت کم‌گو، نمایش تنها پیام‌های خروجی TeX و پیام‌های خطا.

-r [plugin:]script, --texpost=[plugin:]script

اسکریپتی که در انتهای کامپایل tex فراخوانی می‌شود. وظیفه آن اصلاح فایل tex یا یکی از فایل‌های کامپایل پیش از دور آخر است. مقدار script می‌تواند یک پلاگین پایتون باشد. در این حالت پیشوند 'plugin:' را اضافه کنید.

-s latex_style, --texstyle=latex_style

سبک لاتک مورد اعمال. می‌تواند نام یک بسته یا مستقیماً مسیر یک بسته لاتک باشد. نام بسته باید بدون مسیر دایرکتوری و بدون پسوند '.sty' باشد. برعکس، مسیر کامل بسته لاتک می‌تواند شامل مسیر دایرکتوری باشد، اما باید به پسوند '.sty' ختم شود.

-t format, --type=format

قالب خروجی. قالب‌های موجود: tex، dvi، ps، pdf (پیش‌فرض).

--dvi

خروجی DVI. معادل -tdvi.

--pdf

خروجی PDF. معادل -tpdf.

--ps

خروجی PostScript. معادل -tps.

-T style, --style=style

سبک خروجی، سبک‌های از پیش تعریف‌شده عبارتند از: db2latex، simple، native (پیش‌فرض).

-v, --version

نمایش نسخه dblatex.

-V, --verbose

حالت پرگو، نمایش دستورات در حال اجرا.

-x xslt_options, --xslt-opts=xslt_options

آرگومان‌هایی که مستقیماً به موتور XSLT ارسال می‌شوند.

-X, --no-external

غیرفعال‌سازی پشتیبانی از فایل‌های متنی خارجی. این پشتیبانی برای calloutهای فایل‌های خارجی که توسط textdata یا imagedata ارجاع داده شده‌اند لازم است، اما اگر سند فاقد چنین مواردی باشد می‌توان آن را غیرفعال کرد. غیرفعال کردن این ویژگی می‌تواند عملکرد پردازش را برای اسناد حجیم بهبود بخشد.

فایل‌ها و دایرکتوری‌ها (FILES AND DIRECTORIES)

$HOME/.dblatex/

دایرکتوری پیکربندی کاربر.

/etc/dblatex/

دایرکتوری پیکربندی سراسری سیستم.

سبک‌های خروجی از پیش تعریف‌شده در دایرکتوری بسته نصب‌شده قرار دارند.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

DBLATEX_CONFIG_FILES

دایرکتوری‌های پیکربندی اضافی که ممکن است شامل فایل‌های پیکربندی dblatex باشند.

مثال‌ها (EXAMPLES)

تولید myfile.pdf از myfile.xml:

dblatex myfile.xml

تنظیم برخی پارامترهای XSL از طریق خط فرمان:

dblatex -P latex.babel.language=de myfile.xml

استفاده از شیوه‌نامه XSL خودتان:

dblatex -p myconfig.xsl myfile.xml

استفاده از سبک خروجی db2latex:

dblatex -T db2latex myfile.xml

اعمال سبک لاتک سفارشی خود:

dblatex -s mystyle myfile.xml
dblatex -s /path/to/mystyle.sty myfile.xml

ارسال آرگومان‌های اضافی به موتور XSLT:

dblatex -x "--path /path/to/load/entity" myfile.xml

استفاده از dblatex همراه با نمایه کردن (profiling):

xsltproc --param profile.attribute "'output'" \
         --param profile.value "'pdf'" \
         /path/to/profiling/profile.xsl \
         myfile.xml | dblatex -o myfile.pdf -

ساخت مجموعه‌ای از کتاب‌ها:

dblatex -O /path/to/chunk/dir -Pset.book.num=all myfile.xml

همچنین ببینید (SEE ALSO)

این برنامه به‌طور کامل در "DocBook to LaTeX Publishing - User Manual" موجود در دایرکتوری مستندات بسته، مستند شده است.

نویسندگان (AUTHORS)

Benoit Guillon

نگه‌دارنده بالادست (Upstream)

Andreas Hoenen <andreas.hoenen@arcor.de>

نگه‌دارنده دبیان

حق نشر (COPYRIGHT)

این صفحه راهنما برای سیستم دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).

مجوز کپی، توزیع یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GPL)، نسخه 2 یا هر نسخه بالاتر منتشر شده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود.

در سیستم‌های دبیان، متن کامل مجوز عمومی همگانی گنو در مسیر /usr/share/common-licenses/GPL در دسترس است.