.TH DVIASM 1
.SH "نام (NAME)"
DVIasm \- ابزار TeX برای ویرایش مستقیم فایل‌های DVI
.SH "خلاصه دستور (SYNOPSIS)"
\fBdviasm\fR [<\fIoptions\fR>] <\fIdvi_file\fR>|<\fIdvi_dump_file\fR>
.SH "توضیحات (DESCRIPTION)"
برنامه \fBDVIasm\fR یک ابزار TeX است که
برای ویرایش مستقیم فایل‌های مستقل از دستگاه (DVI) طراحی شده است.
این ابزار از یک اسکریپت پایتون منفرد، dviasm.py،
در یک قالب متنی خوانا برای انسان تشکیل شده است.
این برنامه روی هر بستری که Python 3 روی آن نصب باشد اجرا می‌شود.
.TP 2
قابلیت‌های \fBDVIasm\fR عبارتند از:
.IP
1) دیس‌اسمبل کردن یک فایل DVI (یا فایل XDV در XeTeX) به
یک فایل متنی خوانا برای انسان، که ویرایش محتویات آن آسان است.
.IP
2) اسمبل کردن مجدد فایل متنی خروجی به قالب باینری.
.TP 2
چندین جایگزین برای دامپ و ویرایش فایل‌های DVI وجود دارد:
.IP
1) برنامه \fBDVItype\fR توسعه‌یافته توسط Donald E. Knuth از
تبدیل یک‌طرفه از DVI به یک قالب متنی پشتیبانی می‌کند.
همچنین مشتقاتی از آن وجود دارد: \fBpDVItype\fR برای pTeX،
\fBupDVItype\fR برای upTeX، و \fBODVItype\fR برای Omega.
.IP
2) برنامه‌های \fBdv2dt\fR و \fBdt2dv\fR می‌توانند
به‌صورت جفت برای تبدیل دوطرفه بین DVI و
زبان متنی DVI (یا DTL) استفاده شوند.
.IP
3) برنامه \fBdvispc\fR (بخشی از پیش‌نمایش‌گر DVIOUT)
نیز توانایی تبدیل بین DVI و متن را دارد.
.PP
در میان آن‌ها، \fBDVIasm\fR به گونه‌ای طراحی شده است که به کاربران امکان ویرایش
آسان فایل‌های DVI را می‌دهد؛ برای نمونه با یکپارچه‌سازی
\(lqright1\(rq\(en\(lqright4\(rq در یک دستور واحد \(lqright\(rq
که می‌تواند بدون در نظر گرفتن مقدار جابه‌جایی استفاده شود.
.SH "گزینه‌ها (OPTIONS)"
.PP
.TP 10
\fB--version\fR
نمایش شماره نسخه برنامه و خروج.
.TP 10
\fB-h\fR, \fB--help\fR
نمایش این پیام راهنما و خروج.
.TP 10
\fB-u\fR <\fISTR\fR>, \fB--unit=\fR<\fISTR\fR>
تنظیم یکا [پیش‌فرض: `pt'].
مقادیر مجاز عبارتند از: `sp'، `pt'، `bp'، `mm'، `cm' و `in'.
.TP 10
\fB-o\fR <\fIFILE\fR>, \fB--output=\fR<\fIFILE\fR>
تنظیم نام فایل برای خروجی به جای stdout.
.TP 10
\fB-e\fR <\fISTR\fR>, \fB--encoding=\fR<\fISTR\fR>
تنظیم کدگذاری ورودی/خروجی متن دامپ‌شده [پیش‌فرض: `utf8'].
مقادیر مجاز عبارتند از: `ascii'، `latin1'، `utf8'، `sjis' و `eucjp'.
در صورت استفاده به همراه گزینه \fB-p\fR (یا \fB--ptex\fR)،
تنها مقادیر مجاز `utf8'، `sjis' و `eucjp' هستند.
.RS 10
# نکته: این قابلیت از دامپ کردن از طریق stdout پشتیبانی نمی‌کند.
.RE
.TP 10
\fB-x\fR <\fISTR\fR>, \fB--xxx-encoding=\fR<\fISTR\fR>
تنظیم کدگذاری برای تفسیر رشته‌های `xxx:' [پیش‌فرض: `none'].
مقادیر مجاز عبارتند از: `none'، `utf8'، `sjis' و `eucjp'.
.RS 10
این گزینه به کاربران اجازه می‌دهد کدگذاری صحیح را برای
دامپ/کامپایل محتوای \\special تعیین کنند.
.TP 2
کاربردهای متداول به شرح زیر است:
.IP
1) به‌طور پیش‌فرض، محتویات \\special به‌صورت توالی‌های گریز
بایت‌به‌بایت در قالب `\\x..' دامپ/کامپایل می‌شوند.
این حالت در صورتی که نیازی به خواندن/ویرایش محتویات \\special
نداشته باشید کافی خواهد بود.
.IP
3) برای کاربران XeTeX و upTeX، استفاده از `\fB-x utf8\fR' مفید خواهد بود
چرا که این موتورها از UTF-8 برای کدگذاری رشته‌ها درون
دستورهای \\special استفاده می‌کنند.
.IP
2) برای کاربران pTeX با DVI دارای کدگذاری ISO-2022-JP،
انتخاب گزینه مناسب `\fB-x eucjp\fR' (برای Unix) یا `\fB-x sjis\fR' (برای Windows)
مفید خواهد بود تا با کدگذاری داخلی کانجی (Kanji) مورد استفاده توسط
موتور pTeX سازگار باشد.
.RE
.TP 10
\fB-t\fR <\fIINT\fR>, \fB--tabsize=\fR<\fIINT\fR>
تنظیم اندازه تب (tab) برای push/pop [پیش‌فرض: 2].
.TP 10
\fB-p\fR, \fB--ptex\fR
دامپ و کامپایل DVI با کدگذاری ISO-2022-JP برای pTeX ژاپنی.
این گزینه برای رمزگشایی یا کدگذاری صحیح نویسه‌های ژاپنی در حال حروف‌چینی
(با استفاده از `set2' یا `put2') ضروری است.
.TP 10
\fB-s\fR <\fISTR\fR>, \fB--subfont=\fR<\fISTR\fR>
مشخص کردن فهرست قلم‌ها با طرح زیرقلم UCS2
در قالبی که با ویرگول از هم جدا شده‌اند.
اگر <\fISTR\fR> خالی باشد، فهرست زیرقلم داخلی پیش‌فرض
غیرفعال می‌شود.
.RS 10
این گزینه به عنوان مثال هنگام استفاده از بسته CJK مفید خواهد بود.
.RE
.SH "مثال‌ها (EXAMPLES)"
مستندات
.B DVIasm
توسط نویسنده اصلی، Jin-Hwan Cho، به شرح زیر منتشر شده است:
     https://tug.org/TUGboat/Articles/tb28-2/tb89cho.pdf (TUGboat)
     http://ajt.ktug.kr/assets/2008/5/1/0201cho.pdf (Asian Journal of TeX)
.SH "نویسندگان (AUTHORS)"
نسخه نخست در سال ۲۰۰۷ با Python 2 توسط Jin-Hwan Cho نوشته شد.
Khaled Hosny پشتیبانی از دامپ/کامپایل قالب XDV در XeTeX را در سال ۲۰۱۴ آغاز کرد.
Arthur Reutenauer در سال ۲۰۱۹ این اسکریپت را به Python 3 پورت کرد.
نگه‌دارنده کنونی \fBDVIasm\fR از سال ۲۰۲۰، Hironobu Yamashita است.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً به مخزن گیت‌هاب <https://github.com/aminophen/dviasm> مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR dvitype (1),
.BR dv2dt (1),
.BR dt2dv (1),
.BR dvispc (1).