.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CMAKE-GUI" "1" "Aug 31, 2026" "4.4.3" "CMake"
.SH "نام (NAME)"
cmake-gui \- رابط گرافیکی تعاملی برای پیکربندی پروژه‌های CMake
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cmake\-gui [<options>]
cmake\-gui [<options>] \-B <path\-to\-build> [\-S <path\-to\-source>]
cmake\-gui [<options>] <path\-to\-source | path\-to\-existing\-build>
cmake\-gui [<options>] \-\-browse\-manual [<filename>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
فایل اجرایی \fBcmake\-gui\fP رابط گرافیکی کاربر (GUI) برای CMake است. تنظیمات
پیکربندی پروژه را می‌توان به صورت تعاملی مشخص کرد. دستورالعمل‌های مختصری
هنگام اجرای برنامه در پایین پنجره ارائه شده است.
.sp
ابزار CMake یک تولیدکننده چندسکویی سیستم ساخت است. پروژه‌ها فرآیند
ساخت خود را با فایل‌های لیست CMake مستقل از سکو که با نام \fBCMakeLists.txt\fP\&
در هر دایرکتوری از درخت سورس قرار دارند، مشخص می‌کنند.
کاربران با استفاده از CMake برای تولید یک سیستم ساخت متناسب با ابزار بومی
سکوی خود، پروژه را می‌سازند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-S <path\-to\-source>
مسیر دایرکتوری ریشه پروژه CMake برای ساخت.
.UNINDENT
.INDENT 0.0
.TP
.B \-B <path\-to\-build>
مسیر دایرکتوری که CMake از آن به عنوان ریشه دایرکتوری ساخت استفاده خواهد کرد.
.sp
اگر دایرکتوری از قبل وجود نداشته باشد، CMake آن را خواهد ساخت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-preset=<preset\-name>
نام پیش‌تنظیم مورد استفاده از فایل‌های
\fBpresets\fP \%<#\:manual:cmake-presets(7)> پروژه، در صورت وجود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-browse\-manual [<filename>]
کتابچه راهنمای مرجع CMake را در یک مرورگر باز کرده و بلافاصله خارج می‌شود. اگر
\fB<filename>\fP مشخص شده باشد، به جای \fBindex.html\fP\&، آن فایل را در کتابچه راهنمای مرجع
باز می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-version[=json\-v1] [<file>], \-\-version[=json\-v1] [<file>], /V[=json\-v1] [<file>], /version[=json\-v1] [<file>]
بنر نام و نسخه برنامه را نمایش داده و خارج می‌شود. اگر \fBjson\-v1\fP
مشخص شده باشد، اطلاعات تفصیلی نسخه را در قالب JSON چاپ می‌کند.
خروجی JSON حاوی نسخه‌های CMake و وابستگی‌های آن
است.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.sp
قالب خروجی JSON به شکل خوانا برای ماشین در
\fBthis JSON schema\fP\& توصیف شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-H, \-\-help, \-help, \-usage, /?
اطلاعات نحوه استفاده را چاپ کرده و خارج می‌شود.
.sp
نحوه استفاده، رابط خط فرمان پایه و گزینه‌های آن را شرح می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help <keyword> [<file>]
راهنما را برای یک کلیدواژه CMake چاپ می‌کند.
.sp
کلیدواژه \fB<keyword>\fP می‌تواند یک ویژگی (property)، متغیر، دستور، خط‌مشی (policy)، تولیدکننده (generator)
یا ماژول باشد.
.sp
مدخل مربوطه در کتابچه راهنما برای \fB<keyword>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.sp
تغییریافته در نسخه 3.28: پیش از CMake 3.28، این گزینه تنها از نام دستورات پشتیبانی می‌کرد.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-full [<file>]
تمام کتابچه‌های راهنما را چاپ کرده و خارج می‌شود.
.sp
تمام کتابچه‌های راهنما در یک قالب متنی خوانا برای انسان چاپ می‌شوند.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-manual <man> [<file>]
یک کتابچه راهنما را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای مشخص‌شده در یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-manual\-list [<file>]
کتابچه‌های راهنمای موجود را فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام کتابچه‌های راهنمایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-manual\fP همراه با نام کتابچه به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-command <cmd> [<file>]
راهنما را برای یک دستور چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> برای \fB<cmd>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-command\-list [<file>]
دستوراتی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام دستوراتی است که می‌توان با استفاده
از گزینه \fB\-\-help\-command\fP همراه با نام دستور به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-commands [<file>]
کتابچه راهنمای cmake\-commands را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> در یک
قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-module <mod> [<file>]
راهنما را برای یک ماژول چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> برای \fB<mod>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-module\-list [<file>]
ماژول‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام ماژول‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-module\fP همراه با نام ماژول به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-modules [<file>]
کتابچه راهنمای cmake\-modules را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> در یک قالب متنی خوانا
برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policy <cmp> [<file>]
راهنما را برای یک خط‌مشی چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> برای \fB<cmp>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policy\-list [<file>]
خط‌مشی‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام خط‌مشی‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-policy\fP همراه با نام خط‌مشی به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policies [<file>]
کتابچه راهنمای cmake\-policies را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-property <prop> [<file>]
راهنما را برای یک ویژگی چاپ کرده و خارج می‌شود.
.sp
مدخل‌های کتابچه راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> برای \fB<prop>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شوند.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-property\-list [<file>]
ویژگی‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام ویژگی‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-property\fP همراه با نام ویژگی به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-properties [<file>]
کتابچه راهنمای cmake\-properties را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variable <var> [<file>]
راهنما را برای یک متغیر چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> برای \fB<var>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variable\-list [<file>]
متغیرهایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام متغیرهایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-variable\fP همراه با نام متغیر به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variables [<file>]
کتابچه راهنمای cmake\-variables را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
منابع زیر برای دریافت راهنما در استفاده از CMake در دسترس هستند:
.INDENT 0.0
.TP
.B Home Page
\%<https://\:cmake\:.org>
.sp
نقطه شروع اصلی برای یادگیری درباره CMake.
.TP
.B Online Documentation and Community Resources
\%<https://\:cmake\:.org/\:documentation>
.sp
پیوندهای مربوط به مستندات موجود و منابع انجمن را می‌توان در
این صفحه وب یافت.
.TP
.B Discourse Forum
\%<https://\:discourse\:.cmake\:.org>
.sp
تالار گفتگوی Discourse میزبان گفتگوها و پرسش‌ها پیرامون CMake است.
.UNINDENT
.SH "حق نشر (COPYRIGHT)"
2000-2026 Kitware, Inc. and Contributors
.\" End of generated man page.