.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "REGCONVERT" "1" "25 August 2025" "" "The Regina Handbook"

.SH "نام (NAME)"
regconvert \- تبدیل بین قالب‌های مختلف فایل Regina
.SH "خلاصه دستور (SYNOPSIS)"

\fBregconvert\fR [ \fB-2\fR | \fB-3\fR ] [ \fB-x\fR | \fB-u\fR ] \fB\fIold-file\fB\fR [ \fB\fInew-file\fB\fR ]


\fBregconvert\fR { \fB-v, --version\fR | \fB-?, --help\fR }

.SH "توضیحات (DESCRIPTION)"
.PP
این ابزار برای تبدیل متقابل بین قالب‌های مختلف فایل Regina به کار می‌رود.
.PP
قالب‌های فایل Regina شامل موارد زیر است:
.TP
\fBXML نسل سوم (Third-generation XML)\fR
این قالب مدرن XML است که در Regina\~7.0 معرفی شد.
نسخه‌های قدیمی‌تر Regina (نسخه 6.0.1 و قبل از آن) اصلاً قادر به خواندن آن نیستند.
.TP
\fBXML نسل دوم (Second-generation XML)\fR
این قالب اولیه XML است که در Regina\~3.0-6.0.1 (از ۲۰۰۲ تا ۲۰۲۱) استفاده می‌شد.
نسخه‌های فعلی Regina در صورت نیاز همچنان می‌توانند این قالب را بخوانند و بنویسند.
.TP
\fBقالب باینری نسل اول (First-generation binary format)\fR
این قالب باینری بسیار قدیمی است که در Regina\~2.x (از ۲۰۰۰ تا ۲۰۰۲) استفاده می‌شد.
پشتیبانی از این قالب در سپتامبر\~۲۰۱۳ به‌طور کامل متوقف شد و نسخه‌های جدید Regina نمی‌توانند آن را بخوانند یا بنویسند.

اگر هنوز فایل‌های بسیار قدیمی دارید که از این قالب استفاده می‌کنند، باید نسخه‌ای از Regina\~3.0-4.93 (از ۲۰۰۲ تا ۲۰۱۲) را پیدا کنید که می‌تواند این فایل‌های باینری قدیمی را به قالب XML نسل دوم تبدیل کند.
.PP
آرگومان \fIold-file\fR باید فایلی باشد که خوانده و تبدیل می‌شود؛ آرگومان \fInew-file\fR نیز باید نام فایل تبدیل‌شده جدید برای نوشتن باشد. این دو نام فایل می‌توانند یکسان باشند که در این صورت، فایل قدیمی با فایل جدید جایگزین خواهد شد.
.PP
اگر آرگومان \fInew-file\fR مشخص نشود، فایل جدید در خروجی استاندارد نوشته می‌شود که این امر خروجی را وادار می‌کند تا به صورت XML فشرده‌نشده باشد (گزینه \fB-u\fR را ببینید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-2\fR
تبدیل به قالب قدیمی‌تر XML نسل دوم، همان‌طور که در Regina\~3.0-6.0.1 استفاده می‌شد.
.TP
\fB-3 (پیش‌فرض)\fR
تبدیل به قالب مدرن XML نسل سوم، معرفی‌شده در Regina\~7.0.
.TP
\fB-x (پیش‌فرض)\fR
نوشتن خروجی به‌صورت XML فشرده‌شده\&.
.TP
\fB-u\fR
نوشتن خروجی به‌صورت XML فشرده‌نشده (متن ساده)\&.
.TP
\fB-v, --version\fR
نمایش نسخه مورد استفاده از Regina و خروج فوری.
.TP
\fB-?, --help\fR
نمایش اطلاعات مختصر درباره نحوه استفاده و خروج فوری.
.SH "کاربران MACOS (MACOS USERS)"
.PP
اگر نسخه app bundle را به‌صورت کشیدن و رها کردن (drag-and-drop) دانلود کرده‌اید، این ابزار درون آن قرار دارد. اگر Regina را به پوشه اصلی Applications منتقل کرده‌اید، می‌توانید آن را به صورت زیر اجرا کنید:
/Applications/Regina.app/Contents/MacOS/regconvert\&.
.SH "کاربران ویندوز (WINDOWS USERS)"
.PP
ابزارهای خط فرمان در زیر دایرکتوری \fIProgram\~Files\fR نصب می‌شوند؛ در برخی سیستم‌ها این دایرکتوری \fIProgram\~Files\~(x86)\fR نام دارد\&.
می‌توانید این ابزار را با اجرای مسیر زیر اجرا کنید:
c:\\Program\~Files\\Regina\\Regina\~7.4.1\\bin\\regconvert.exe\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
regfiletype,
regina-gui\&.
.SH "نویسندگان (AUTHORS)"
.PP
این ابزار توسط Benjamin Burton
<bab@maths.uq.edu.au> نوشته شده است\&.
افراد بسیاری در توسعه Regina مشارکت داشته‌اند؛ برای فهرست کامل مشارکت‌کنندگان به راهنمای کاربران مراجعه کنید.