نام (NAME)

DVIasm - ابزار TeX برای ویرایش مستقیم فایل‌های DVI

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

dviasm [<options>] <dvi_file>|<dvi_dump_file>

توضیحات (DESCRIPTION)

برنامه DVIasm یک ابزار TeX است که برای ویرایش مستقیم فایل‌های مستقل از دستگاه (DVI) طراحی شده است. این ابزار از یک اسکریپت پایتون منفرد، dviasm.py، در یک قالب متنی خوانا برای انسان تشکیل شده است. این برنامه روی هر بستری که Python 3 روی آن نصب باشد اجرا می‌شود.

قابلیت‌های DVIasm عبارتند از:

: 1) دیس‌اسمبل کردن یک فایل DVI (یا فایل XDV در XeTeX) به یک فایل متنی خوانا برای انسان، که ویرایش محتویات آن آسان است.
: 2) اسمبل کردن مجدد فایل متنی خروجی به قالب باینری.

چندین جایگزین برای دامپ و ویرایش فایل‌های DVI وجود دارد:

: 1) برنامه DVItype توسعه‌یافته توسط Donald E. Knuth از تبدیل یک‌طرفه از DVI به یک قالب متنی پشتیبانی می‌کند. همچنین مشتقاتی از آن وجود دارد: pDVItype برای pTeX، upDVItype برای upTeX، و ODVItype برای Omega.
: 2) برنامه‌های dv2dt و dt2dv می‌توانند به‌صورت جفت برای تبدیل دوطرفه بین DVI و زبان متنی DVI (یا DTL) استفاده شوند.
: 3) برنامه dvispc (بخشی از پیش‌نمایش‌گر DVIOUT) نیز توانایی تبدیل بین DVI و متن را دارد.

در میان آن‌ها، DVIasm به گونه‌ای طراحی شده است که به کاربران امکان ویرایش آسان فایل‌های DVI را می‌دهد؛ برای نمونه با یکپارچه‌سازی “right1”–“right4” در یک دستور واحد “right” که می‌تواند بدون در نظر گرفتن مقدار جابه‌جایی استفاده شود.

گزینه‌ها (OPTIONS)

--version: نمایش شماره نسخه برنامه و خروج.
-h, --help: نمایش این پیام راهنما و خروج.
-u <STR>, --unit=<STR>: تنظیم یکا [پیش‌فرض: `pt']. مقادیر مجاز عبارتند از: `sp'، `pt'، `bp'، `mm'، `cm' و `in'.
-o <FILE>, --output=<FILE>: تنظیم نام فایل برای خروجی به جای stdout.
-e <STR>, --encoding=<STR>: تنظیم کدگذاری ورودی/خروجی متن دامپ‌شده [پیش‌فرض: `utf8']. مقادیر مجاز عبارتند از: `ascii'، `latin1'، `utf8'، `sjis' و `eucjp'. در صورت استفاده به همراه گزینه -p (یا --ptex)، تنها مقادیر مجاز `utf8'، `sjis' و `eucjp' هستند.

# نکته: این قابلیت از دامپ کردن از طریق stdout پشتیبانی نمی‌کند.

-x <STR>, --xxx-encoding=<STR>: تنظیم کدگذاری برای تفسیر رشته‌های `xxx:' [پیش‌فرض: `none']. مقادیر مجاز عبارتند از: `none'، `utf8'، `sjis' و `eucjp'.

این گزینه به کاربران اجازه می‌دهد کدگذاری صحیح را برای دامپ/کامپایل محتوای \special تعیین کنند.

کاربردهای متداول به شرح زیر است:

: 1) به‌طور پیش‌فرض، محتویات \special به‌صورت توالی‌های گریز بایت‌به‌بایت در قالب `\x..' دامپ/کامپایل می‌شوند. این حالت در صورتی که نیازی به خواندن/ویرایش محتویات \special نداشته باشید کافی خواهد بود.
: 3) برای کاربران XeTeX و upTeX، استفاده از `-x utf8' مفید خواهد بود چرا که این موتورها از UTF-8 برای کدگذاری رشته‌ها درون دستورهای \special استفاده می‌کنند.
: 2) برای کاربران pTeX با DVI دارای کدگذاری ISO-2022-JP، انتخاب گزینه مناسب `-x eucjp' (برای Unix) یا `-x sjis' (برای Windows) مفید خواهد بود تا با کدگذاری داخلی کانجی (Kanji) مورد استفاده توسط موتور pTeX سازگار باشد.

-t <INT>, --tabsize=<INT>: تنظیم اندازه تب (tab) برای push/pop [پیش‌فرض: 2].
-p, --ptex: دامپ و کامپایل DVI با کدگذاری ISO-2022-JP برای pTeX ژاپنی. این گزینه برای رمزگشایی یا کدگذاری صحیح نویسه‌های ژاپنی در حال حروف‌چینی (با استفاده از `set2' یا `put2') ضروری است.
-s <STR>, --subfont=<STR>: مشخص کردن فهرست قلم‌ها با طرح زیرقلم UCS2 در قالبی که با ویرگول از هم جدا شده‌اند. اگر <STR> خالی باشد، فهرست زیرقلم داخلی پیش‌فرض غیرفعال می‌شود.

این گزینه به عنوان مثال هنگام استفاده از بسته CJK مفید خواهد بود.

مثال‌ها (EXAMPLES)

مستندات 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)

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

نسخه نخست در سال ۲۰۰۷ با Python 2 توسط Jin-Hwan Cho نوشته شد. Khaled Hosny پشتیبانی از دامپ/کامپایل قالب XDV در XeTeX را در سال ۲۰۱۴ آغاز کرد. Arthur Reutenauer در سال ۲۰۱۹ این اسکریپت را به Python 3 پورت کرد. نگه‌دارنده کنونی DVIasm از سال ۲۰۲۰، Hironobu Yamashita است.

گزارش باگ‌ها (BUGS)

لطفاً به مخزن گیت‌هاب https://github.com/aminophen/dviasm مراجعه کنید.

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

dvitype(1), dv2dt(1), dt2dv(1), dvispc(1).