'\" t
.\"     Title: \fBkate\fR
.\"    Author: Lauri Watts <lauri@kde.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2021-07-12
.\"    Manual: Kate User's Manual
.\"    Source: KDE Gear KDE Gear 21.08
.\"  Language: English
.\"
.TH "\FBKATE\FR" "1" "2021\-07\-12" "KDE Gear KDE Gear 21.08" "Kate User's Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
kate \- ویرایشگر متن پیشرفته توسط KDE
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBkate\fR\ 'u
\fBkate\fR [\fB\-s, \-\-start\fR\fI
name\fR] [\fB\-\-startanon\fR] [\fB\-n, \-\-new\fR] [\fB\-b, \-\-block\fR] [\fB\-p, \-\-pid\fR\fI
pid\fR] [\fB\-e, \-\-encoding\fR\fI
name\fR] [\fB\-l, \-\-line\fR\fI
line\fR] [\fB\-c, \-\-column\fR\fI column\fR] [\fB\-i, \-\-stdin\fR] [\fB\-\-tempfile\fR] [\fB\fIfile\fR\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
Kate
ویرایشگر متن پیشرفته‌ی
KDE
است\&.
.PP
Kate
همچنین بخش ویرایشگر را برای برنامه‌های متعددی، تحت نام
KWrite
فراهم می‌آورد\&.
.PP
برخی از امکانات پرشمار
Kate
شامل برجسته‌سازی نحوی (syntax highlighting) قابل پیکربندی برای زبان‌هایی از C و ++C گرفته تا
HTML
و اسکریپت‌های bash، قابلیت ایجاد و مدیریت پروژه‌ها، یک رابط چند سندی (MDI)، و یک شبیه‌ساز پایانهٔ توکار است\&.
.PP
اما
Kate
فراتر از یک ویرایشگر برای برنامه‌نویسان است\&. توانایی آن در باز کردن هم‌زمان چندین فایل، آن را برای ویرایش فایل‌های پیکربندی پرشمار
UNIX\(rg
به گزینه‌ای ایده‌آل تبدیل می‌کند\&. این سند در
Kate
نوشته شده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-s\fR, \fB\-\-start\fR \fIname\fR
.RS 4
راه‌اندازی
Kate
با یک نشست (session) مشخص\&.
.RE
.PP
\fB\-\-startanon\fR
.RS 4
راه‌اندازی
Kate
با یک نشست ناشناس جدید؛ به معنی استفاده از
\fB\-n\fR
نیز هست\&.
.RE
.PP
\fB\-n\fR, \fB\-\-new\fR
.RS 4
اجبار به راه‌اندازی یک نمونهٔ (instance) جدید از
Kate
(اگر از
\fBstart\fR
استفاده شود و نمونهٔ دیگری از
Kate
از پیش نشست داده‌شده را باز کرده باشد، نادیده گرفته می‌شود)؛ در صورتی که هیچ پارامتر یا نشانی اینترنتی (URL) داده نشود، اجباری است\&.
.RE
.PP
\fB\-b\fR, \fB\-\-block\fR
.RS 4
در صورت استفاده از یک نمونهٔ در حال اجرای
Kate،
اگر URLهایی برای باز شدن داده شده باشند، تا زمان بسته شدن آن مسدود می‌شود (صبر می‌کند)\&.
.RE
.PP
\fB\-p, \-\-pid\fR \fI pid\fR
.RS 4
تنها تلاش برای استفادهٔ مجدد از نمونهٔ kate با این
\fIpid\fR
(اگر از
\fBstart\fR
استفاده شود و نمونهٔ دیگری از
Kate
پیش‌تر نشست داده‌شده را باز کرده باشد، نادیده گرفته می‌شود)\&.
.RE
.PP
\fB\-e, \-\-encoding\fR \fI name\fR
.RS 4
تنظیم کدگذاری (encoding) برای فایلی که باید باز شود\&.
.sp
برای نمونه می‌توانید از این گزینه برای باز کردن اجباری یک فایل در قالب utf\-8 استفاده کنید\&. (دستور
\fBiconv \-l\fR
فهرستی از کدگذاری‌ها را ارائه می‌دهد که ممکن است برای شما مفید باشد\&.)
.RE
.PP
\fB\-l, \-\-line\fR \fI line\fR
.RS 4
رفتن به این خط\&.
.RE
.PP
\fB\-c, \-\-column\fR \fI column\fR
.RS 4
رفتن به این ستون\&.
.RE
.PP
\fB\-i, \-\-stdin\fR
.RS 4
خواندن محتوای
stdin\&.
.RE
.PP
\fB\-\-tempfile\fR
.RS 4
فایل‌ها/URLهای بازشده توسط برنامه، پس از استفاده حذف خواهند شد\&.
.RE
.PP
\fB\fIfile\fR\fR
.RS 4
فایل برای باز شدن\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.RS 4
مستندات دقیق‌تر کاربر در \m[blue]\fBhelp:/kate\fR\m[] در دسترس است
(می‌توانید این URL را در Konqueror وارد کنید، یا دستور
\fB\fBkhelpcenter\fR\fR\fB
\fR\fB\fIhelp:/kate\fR\fR
را اجرا نمایید)\&.
.RE
.RS 4
kf6options(7)
.RE
.RS 4
qt6options(7)
.RE
.RS 4
همچنین اطلاعات تکمیلی در \m[blue]\fBوب‌گاه Kate\fR\m[]\&\s-2\u[1]\d\s+2 موجود است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای باز کردن فایلی به نام
source\&.cpp
در ستون ۱۵ و خط ۲۵، در پنجرهٔ فعال موجود از
Kate،
می‌توانید از دستور زیر استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBkate\fR\fR\fB \fR\fB\fB\-c 15\fR\fR\fB \fR\fB\fB\-l 25\fR\fR\fB \fR\fBsource\&.cpp\fR
.fi
.if n \{\
.RE
.\}
.PP
اگر اتصال اینترنت فعال دارید، می‌توانید از قابلیت شفافیت شبکه (network transparency) در
KDE
برای باز کردن فایلی از یک پایگاه
FTP
بهره ببرید\&. اگر در سرور دوردست دسترسی نوشتن نداشته باشید، فایل به صورت فقط‌خواندنی باز خواهد شد و در صورت ایجاد تغییرات، از شما یک نام فایل محلی برای ذخیره‌سازی خواسته می‌شود\&. اگر دسترسی نوشتن داشته باشید، تغییرات به صورت یکپارچه از طریق شبکه ذخیره خواهد شد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fB\fBkate\fR\fR\fB \fR\fB\fB\fI\m[blue]\fBftp://ftp\&.kde\&.org/pub/kde/\fR\m[]\fR\fIREADME\fR\fR\fR
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.PP
نگه‌دارندهٔ
Kate
شخص
Christoph Cullmann
<cullmann@kde\&.org>
است\&. فهرست جامع نویسندگان و مشارکت‌کنندگان در راهنمای کامل کاربر که در بالا به آن اشاره شد، موجود است\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBLauri Watts\fR <\&lauri@kde\&.org\&>
.RS 4
نویسنده.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
وب‌گاه Kate
.RS 4
\%https://kate-editor.org
.RE