.TH MPOST 1 "31 December 2018" "Web2C 2026"
.\"=====================================================================
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.if n .ds MP MetaPost
.if t .ds MP MetaPost
.if n .ds MF Metafont
.if t .ds MF Metafont
.if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\h'-0.17m'\v'+0.21m'E\v'-0.21m'\h'-0.04m'X\fP
.el .ds OX TeX
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH "نام (NAME)"
mpost, pmpost, upmpost \- متامپست، سامانه‌ای برای ایجاد گرافیک
r-mpost, r-pmpost, r-upmpost \- متامپست محدودشده
.SH "خلاصه دستور (SYNOPSIS)"
.B mpost
.RI [ options ]
.RI [ commands ]
.PP
.B mpost 
.B --dvitomp
.IR dvifile [\fB.dvi\fP]
.RI [ mpxfile [\fB.mpx\fP]]

.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
\*(MP زبان \*(MP را تفسیر کرده و تصاویر PostScript (EPS)
یا گرافیک برداری مقیاس‌پذیر (SVG) تولید می‌کند. زبان \*(MP شبیه به
\*(MF دانلد کنوت است، همراه با قابلیت‌های افزوده برای گنجاندن دستورات
.BR tex (1)
یا
.BR troff (1)
و دسترسی به ویژگی‌هایی از PostScript که در \*(MF یافت نمی‌شوند.
.PP
\*(MP معمولاً با مجموعه‌ای از ماکروهای پایه استفاده می‌شود و از نام فایل
اجرایی خود به عنوان نام فایل پیش‌بارگذاری‌شده استفاده می‌کند. برای نمونه، هنگامی که به عنوان
.B mpost
فراخوانی می‌شود، فایل
.I mpost.mp
مورد استفاده قرار می‌گیرد، که صرفاً
.IR plain.mp
را می‌خواند.
هنگامی که گزینهٔ
.B --ini
داده شود، پیش‌بارگذاری انجام نمی‌شود.
.PP
دستورات (
.IR commands )
داده‌شده در خط فرمان به برنامهٔ \*(MP، به عنوان نخستین خط ورودی به آن ارسال می‌شوند.
(اما معمولاً تایپ آرگومان‌های طولانی به عنوان نخستین خط ورودی ساده‌تر است،
چرا که پوسته‌های یونیکس تمایل دارند نمادهای محبوب \*(MP مانند سمیکالن را، مگر آنکه
در گیومه قرار گیرند، ببلعند یا به اشتباه تفسیر کنند.) کاربرد معمول به صورت
.I mpost figs
برای پردازش فایل
.IR figs.mp
است. نام پایهٔ
.I figs
به «نام کار» (\(lqjobname\(rq) تبدیل می‌شود و در ساخت نام فایل‌های خروجی
به کار می‌رود. اگر فایلی مشخص نشده باشد، نام کار به
.IR mpout
تبدیل می‌شود. پسوند پیش‌فرض، یعنی
.IR .mp ،
را می‌توان با مشخص کردن صریح یک پسوند بازنویسی کرد.
.PP
هنگامی که گزینهٔ
.B --dvitomp
داده شود، \*(MP تنها به عنوان یک تبدیل‌کنندهٔ DVI به MPX عمل می‌کند.
برای جزئیات به
.BR dvitomp (1)
مراجعه کنید.
.PP
برنامهٔ
.B pmpost 
گونه‌ای با پشتیبانی از زبان ژاپنی است، و
.B upmpost
دارای پشتیبانی از زبان ژاپنی با قابلیت یونیکد است، مشابه ptex و uptex.
.PP
هر سه گونه همچنین با پیشوند \(aqr\-\(aq نصب شده‌اند، یعنی
.BR r-mpost ،
.BR r-pmpost ،
.BR r-upmpost ،
که به صورت ضمنی گزینهٔ
.B --restricted
را مشخص می‌کنند تا اجرای MetaPost روی ورودی‌های ناشناخته ایمن شود؛
دستورات tex، makempx و ویرایشگر غیرفعال هستند.
.PP
این صفحهٔ راهنما صرفاً یک ساختار کلی است. برای مشاهدهٔ فهرست همهٔ گزینه‌های خط فرمان، گزینهٔ
.B --help
را اجرا کنید.
.PP
مستندات اصلی این نسخه از \*(MP را می‌توان در راهنمای کاربر یافت که می‌بایست
همراه با برنامه نصب شده باشد و همچنین در نشانی https://tug.org/metapost نیز در دسترس است.
.PP
زبان \*(MP شبیه به \*(MF است، اما راهنما فرض می‌کند هیچ شناختی
از \*(MF ندارید. \*(MP فاقد دستورات خروجی نقشه‌بیتی (bitmap) یا سازوکار نمایش آنلاین \*(MF است.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.TP
.I plain.mp
فایل پیش‌بارگذاری استاندارد.
.TP
.I mfplain.mp
فایل پیش‌بارگذاری سازگار با \*(MF.
.TP
.I $TEXMFMAIN/metapost/base/*.mp
ماکروهای استاندارد \*(MP موجود در توزیع اصلی.
.TP
.I $TEXMFMAIN/metapost/support/*
جدول‌های گوناگون برای مدیریت
.I tex
و
.IR troff
گنجانده‌شده.
.TP
.I $TEXMFMAIN/metapost/support/trfonts.map
جدول نام‌های قلم‌های متناظر برای
.I troff 
و PostScript.
.TP
.I psfonts.map
جدول نام‌های قلم‌های متناظر برای
.I tex
و PostScript.
.TP
.I $TEXMFMAIN/doc/metapost/*
راهنمای \*(MP و منبع آموزشی، همچنین شامل اشکال نمونه.
.\"=====================================================================
.SH "مطالعه پیشنهادی (SUGGESTED READING)"
دانلد ای. کنوت (Donald E. Knuth)،
.I "The \*(MF\^book"
(جلد C از
.IR "Computers & Typesetting" ).
.br
.I TUGboat
(نشریهٔ \*(TX Users Group).
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR dvitomp (1),
.BR epstopdf (1),
.BR mf (1),
.BR mptopdf (1),
.BR tex (1),
.br
.URL "https://tug.org/metapost" "صفحه خانگی MetaPost" .
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
\*(MP توسط John D. Hobby با به‌کارگیری الگوریتم‌هایی از برنامهٔ
\*(MF دانلد کنوت (Donald E. Knuth) ساخته شد.
.PP
Ulrik Vieth برنامهٔ \*(MP را به منظور بهره‌گیری از قابلیت‌های پیشرفتهٔ جستجوی
مسیر در نسخه‌های جدیدتر Web2C تطبیق داد و برای یکپارچه‌سازی کامل \*(MP
در توزیع معیار \*(TX یونیکس تلاش کرد.
.PP
نویسندهٔ اصلی نسخهٔ فعلی \*(MP تاکو هوک‌واتر (Taco Hoekwater) با همراهی
Hans Hagen و افراد بسیار دیگری بود. در حال حاضر توسط Luigi Scarso نگهداری می‌شود.
.\"=====================================================================
.SH "گزارش باگ‌ها (BUGS)"
صفحهٔ خانگی MetaPost در نشانی https://tug.org/metapost است.