.\" Copyright (C) 2008, 2009 Vincent Penquerc'h.
.\" This file is part of the Kate codec library.
.\" Written by Vincent Penquerc'h.
.\"
.\" Use, distribution and reproduction of this library is governed
.\" by a BSD style source license included with this source in the
.\" file 'COPYING'. Please read these terms before distributing. */


.TH "KATEENC" 1 "13 october 2010" "libkate 0.4.3" "libkate documentation"

.SH "نام (NAME)"
kateenc \- ایجاد جریان‌های Kate از ورودی متنی

.SH "خلاصه دستور (SYNOPSIS)"
.B kateenc
.B "[\-hVM]"
.BI "[\-o " outfile ]
.BI "[\-l " language ]
.BI "[\-c " category ]
.BI "[\-s " serial ]
.BI "[\-C " tag=value ]
.BI "[\-R " threshold ]
.BI "[\-K " threshold ]
.BI "\-t " filetype
[ infile ]

.SH "توضیحات (DESCRIPTION)"
دستور
.B kateenc
جریان‌های Kate را از روی فایل‌های ورودی (مانند زیرنویس‌های SubRip SRT، متن ترانه‌های LRC، و زبان توصیف سفارشی libkate) تولید می‌کند\&. هنگام ذخیره در یک جریان Ogg (رفتار پیش‌فرض)، می‌توان جریان Kate را با استفاده از ابزارهای oggz با سایر جریان‌های Ogg (مانند ویدیوی Theora) ادغام کرد\&.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR
نمایش راهنمای خط فرمان\&.
.TP
\fB\-V\fR
نمایش اطلاعات نسخه\&.
.TP
\fB\-M\fR
امکان استفاده از نشانه‌گذاری‌های ساده مشابه HTML را در فایل‌های SRT فراهم می‌کند\&. در صورت استفاده از این پارامتر، رشته‌هایی مانند "<i>" به‌جای آنکه عیناً نمایش داده شوند، به صورت متن ایتالیک تفسیر می‌شوند\&. توجه داشته باشید که پخش‌کننده‌های مختلف ممکن است مجموعه متفاوتی از تگ‌های HTML را تفسیر کنند، و برخی اصلاً آن‌ها را پشتیبانی نمی‌کنند\&.
.TP
\fB\-o\fR outfile
نوشتن جریان خروجی Kate در نام فایل مشخص‌شده (در صورت عدم تعیین، در خروجی استاندارد stdout نوشته می‌شود)\&.
.TP
\fB\-l\fR language
تعیین زبان جریان (پیش‌فرض همان زبان تعیین‌شده در ورودی، یا هیچ است)\&.
.TP
\fB\-c\fR category
تعیین دسته‌بندی جریان (پیش‌فرض همان دسته‌بندی تعیین‌شده در ورودی، یا هیچ است)\&.
.TP
\fB\-s\fR serial
تعیین شماره سریال برای جریان خروجی Kate (بر جریان‌های خام اعمال نمی‌شود)\&.
.TP
\fB\-C\fR tag=value
افزودن یک کامنت/توضیح برای کدگذاری درون جریان خروجی Kate\&. کامنت باید به فرم tag=value باشد و با قوانین کامنت‌های Vorbis مطابقت داشته باشد (به‌عنوان مثال، tag متشکل از زیرمجموعه خاصی از نویسه‌های ASCII و value یک رشته معتبر UTF-8 باشد)\&. توجه داشته باشید که ممکن است نیاز باشد برای در نظر گرفته شدن به عنوان یک پارامتر واحد، کامنت را داخل کوتیشن قرار دهید یا کاراکترهای آن را اسکیپ کنید\&.
.TP
\fB\-t\fR filetype
تعیین نوع ورودی (srt, lrc, kate)
.TP
\fB\-R\fR threshold
استفاده از بسته‌های تکراری (repeat packets) با آستانه مشخص‌شده (به ثانیه)\&. بسته‌های داده تا زمانی که فعال هستند در فواصل زمانی تقریباً برابر با threshold ثانیه تکرار خواهند شد\&.
.TP
\fB\-K\fR threshold
استفاده از بسته‌های زنده نگه‌داشتن (keepalive packets) با آستانه مشخص‌شده (به ثانیه)\&. بسته‌های keepalive زمانی ارسال خواهند شد که در طول تقریباً threshold ثانیه هیچ بسته دیگری فرستاده نشده باشد\&.

.SH "مثال‌ها (EXAMPLES)"
.PP
ایجاد یک جریان Kate برای زیرنویس به زبان ولزی از یک فایل SubRip:
.PP
.RS 4
.nf
kateenc \-t srt \-l cy \-c SUB \-o output.ogg input.srt
.fi
.RE

.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBkatedec\fR(1), \fBkatalyzer\fR(1)