نام (NAME)

regconvert - تبدیل بین قالب‌های مختلف فایل Regina

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

regconvert [ -2 | -3 ] [ -x | -u ] old-file [ new-file ]

regconvert { -v, --version | -?, --help }

توضیحات (DESCRIPTION)

این ابزار برای تبدیل متقابل بین قالب‌های مختلف فایل Regina به کار می‌رود.

قالب‌های فایل Regina شامل موارد زیر است:

XML نسل سوم (Third-generation XML): این قالب مدرن XML است که در Regina 7.0 معرفی شد. نسخه‌های قدیمی‌تر Regina (نسخه 6.0.1 و قبل از آن) اصلاً قادر به خواندن آن نیستند.
XML نسل دوم (Second-generation XML): این قالب اولیه XML است که در Regina 3.0-6.0.1 (از ۲۰۰۲ تا ۲۰۲۱) استفاده می‌شد. نسخه‌های فعلی Regina در صورت نیاز همچنان می‌توانند این قالب را بخوانند و بنویسند.
قالب باینری نسل اول (First-generation binary format): این قالب باینری بسیار قدیمی است که در Regina 2.x (از ۲۰۰۰ تا ۲۰۰۲) استفاده می‌شد. پشتیبانی از این قالب در سپتامبر ۲۰۱۳ به‌طور کامل متوقف شد و نسخه‌های جدید Regina نمی‌توانند آن را بخوانند یا بنویسند.
اگر هنوز فایل‌های بسیار قدیمی دارید که از این قالب استفاده می‌کنند، باید نسخه‌ای از Regina 3.0-4.93 (از ۲۰۰۲ تا ۲۰۱۲) را پیدا کنید که می‌تواند این فایل‌های باینری قدیمی را به قالب XML نسل دوم تبدیل کند.

آرگومان old-file باید فایلی باشد که خوانده و تبدیل می‌شود؛ آرگومان new-file نیز باید نام فایل تبدیل‌شده جدید برای نوشتن باشد. این دو نام فایل می‌توانند یکسان باشند که در این صورت، فایل قدیمی با فایل جدید جایگزین خواهد شد.

اگر آرگومان new-file مشخص نشود، فایل جدید در خروجی استاندارد نوشته می‌شود که این امر خروجی را وادار می‌کند تا به صورت XML فشرده‌نشده باشد (گزینه -u را ببینید).

گزینه‌ها (OPTIONS)

-2: تبدیل به قالب قدیمی‌تر XML نسل دوم، همان‌طور که در Regina 3.0-6.0.1 استفاده می‌شد.
-3 (پیش‌فرض): تبدیل به قالب مدرن XML نسل سوم، معرفی‌شده در Regina 7.0.
-x (پیش‌فرض): نوشتن خروجی به‌صورت XML فشرده‌شده.
-u: نوشتن خروجی به‌صورت XML فشرده‌نشده (متن ساده).
-v, --version: نمایش نسخه مورد استفاده از Regina و خروج فوری.
-?, --help: نمایش اطلاعات مختصر درباره نحوه استفاده و خروج فوری.

کاربران MACOS (MACOS USERS)

اگر نسخه app bundle را به‌صورت کشیدن و رها کردن (drag-and-drop) دانلود کرده‌اید، این ابزار درون آن قرار دارد. اگر Regina را به پوشه اصلی Applications منتقل کرده‌اید، می‌توانید آن را به صورت زیر اجرا کنید: /Applications/Regina.app/Contents/MacOS/regconvert.

کاربران ویندوز (WINDOWS USERS)

ابزارهای خط فرمان در زیر دایرکتوری Program Files نصب می‌شوند؛ در برخی سیستم‌ها این دایرکتوری Program Files (x86) نام دارد. می‌توانید این ابزار را با اجرای مسیر زیر اجرا کنید: c:\Program Files\Regina\Regina 7.4.1\bin\regconvert.exe.

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

regfiletype, regina-gui.

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

این ابزار توسط Benjamin Burton <bab@maths.uq.edu.au> نوشته شده است. افراد بسیاری در توسعه Regina مشارکت داشته‌اند؛ برای فهرست کامل مشارکت‌کنندگان به راهنمای کاربران مراجعه کنید.