نام (NAME)

xedit - ویرایشگر متن ساده برای X

سینتکس (SYNTAX)

xedit [ -toolkitoption ... ] [ filename ... ]

توضیحات (DESCRIPTION)

Xedit پنجره‌ای شامل چهار بخش زیر را فراهم می‌کند:

بخش دستورها

مجموعه‌ای از دستورها که به شما امکان خروج از xedit، ذخیره فایل یا بارگذاری فایلی جدید در پنجره ویرایش را می‌دهد.

پنجره پیام

پیام‌های xedit را نمایش می‌دهد. علاوه بر این، این پنجره می‌تواند به عنوان چرک‌نویس نیز استفاده شود.

نمایش نام فایل

نام فایلی را که در حال حاضر ویرایش می‌شود و اینکه آیا این فایل Read-Write (خواندنی-نوشتنی) است یا Read Only (فقط‌خواندنی)، نمایش می‌دهد.

پنجره ویرایش

متن فایلی را که در حال ویرایش یا ایجاد آن هستید نمایش می‌دهد.

گزینه‌ها (OPTIONS)

Xedit تمامی گزینه‌های استاندارد خط فرمان X Toolkit را می‌پذیرد (نگاه کنید به X(7)). ترتیب گزینه‌های خط فرمان اهمیتی ندارد.

filename

فایل(هایی) را مشخص می‌کند که باید هنگام راه‌اندازی بارگذاری شوند. این همان فایلی است که ویرایش خواهد شد. اگر فایلی مشخص نشود، xedit به شما امکان می‌دهد پس از راه‌اندازی، فایل‌ها را بارگذاری کرده یا فایل‌های جدید ایجاد کنید.

ویرایش (EDITING)

ویجت متنی Athena برای سه بخش از این برنامه که اجازه ورود متن را می‌دهند استفاده می‌شود. نویسه‌های تایپ‌شده به ویجت متنی منتقل خواهند شد که فوکوس ورودی را دارد، یا ویجت متنی که مکان‌نمای اشاره‌گر در حال حاضر روی آن قرار دارد.

ترکیب کلیدهای زیر تعریف شده‌اند:

علاوه بر این، می‌توان از اشاره‌گر برای برش و چسباندن (cut و paste) متن استفاده کرد:

[line-number[,line-number]]command[parameters]

.

خط متنی جاری.

$

آخرین خط فایل.

number

شماره خط به‌صورت صریح number.

- or ^

خط قبلی. معادل با -1.

-number or ^number

خط جاری منهای number.

+

خط بعدی. معادل با +1.

+number

خط جاری به‌علاوه number.

, or %

از اولین تا آخرین خط. معادل با 1,$.

;

از خط جاری تا آخرین خط. معادل با .,$.

دستور می‌تواند به صورت‌های زیر مشخص شود:

s

جایگزینی متن در خط‌های مشخص‌شده.

/re/

جست‌وجوی رو به جلو برای الگوی عبارت باقاعده re.

?re?

جست‌وجوی رو به عقب برای الگوی عبارت باقاعده re.

پارامترها می‌توانند به صورت‌های زیر مشخص شوند:

/re/

به عنوان پارامتری برای i یا به عنوان یک دستور عمل می‌کند.

/re/text/

جست‌وجوی رو به جلو برای re و جایگزینی آن با text.

گزینه‌ها می‌توانند در ادامه بیایند یا به عنوان پارامتر باشند؛ مقادیر شناخته‌شده عبارتند از:

i

جست‌وجوی غیرحساس به حروف بزرگ و کوچک.

g

تطابق سراسری (Global) هنگام جایگزینی متن. در صورت عدم تعیین، فقط n-امین مورد تطابق (که پیش‌فرض آن ۱ است) جایگزین خواهد شد.

c

تأیید گرفتن (Confirm) پیش از جایگزینی متن.

number

تنها رخدادی که توسط number مشخص شده جایگزین شود.

دستورها نگارش‌های گوناگونی را می‌پذیرند، به عنوان مثال:

/pattern/i
i/pattern/
i/pattern

,sc/pattern/text
,sc/pattern/text/
,s/pattern/text/c

,s/pattern/text/number

هنگام جست‌وجوی متن، برای رفتن به تطابق بعدی <Return> را بزنید. هنگام جایگزینی تعاملی متن، برای پذیرش تغییر کلید y یا Y را بزنید، و برای نادیده گرفتن آن و رفتن به تطابق بعدی کلید n یا N را وارد کنید..SH "دستورها (COMMANDS)"

Quit

از نشست ویرایش فعلی خارج می‌شود. اگر تغییراتی ذخیره نشده باشند، xedit پیام هشداری نمایش می‌دهد و به کاربر امکان می‌دهد آن‌ها را ذخیره کند.

Save

اگر پشتیبان‌گیری از فایل فعال باشد (بخش «منابع (RESOURCES)» در زیر را ببینید)، xedit رونوشتی از فایل اصلی و ویرایش‌نشده را در <prefix>file<suffix> ذخیره می‌کند، سپس file را با محتویات پنجرهٔ ویرایش بازنویسی می‌نماید. نام فایل مستقیماً از ویجت متنی (Text widget) واقع در سمت راست دکمهٔ Load دریافت می‌شود.

Load

فایلی را که نام آن در ویجت متنی بلافاصله سمت راست این دکمه آمده است بارگیری کرده و آن را در پنجرهٔ Edit نمایش می‌دهد.

منابع (RESOURCES)

برای xedit منابع موجود عبارتند از:

tagsName (Class TagsName)

نام فایل tags را جهت جستجو هنگام بارگیری فایل جدید تعیین می‌کند. مقدار پیش‌فرض tags است.

loadTags (Class LoadTags)

مقداری بولی برای فعال یا غیرفعال کردن جستجو برای فایل‌های tags. پیش‌فرض True است.

enableBackups (Class EnableBackups)

مشخص می‌کند که هنگام ذخیرهٔ ویرایش‌های انجام‌شده روی یک فایل موجود، xedit پیش از ذخیرهٔ تغییرات، نسخهٔ اصلی آن فایل را در <prefix>file<suffix> کپی کند. مقدار پیش‌فرض برای این منبع ``on'' است که بیانگر ضرورت ایجاد نسخه‌های پشتیبان است.

backupNamePrefix (Class BackupNamePrefix)

رشته‌ای را مشخص می‌کند که باید به ابتدای نام فایل پشتیبان اضافه شود. پیش‌فرض این است که هیچ رشته‌ای اضافه نشود.

backupNameSuffix (Class BackupNameSuffix)

رشته‌ای را مشخص می‌کند که باید به انتهای نام فایل پشتیبان اضافه شود. پیش‌فرض، استفاده از ``~'' به عنوان پسوند است.

positionFormat (Class Format)

رشتهٔ قالبی را مشخص می‌کند که برای نمایش موقعیت مکان‌نما به کار می‌رود. این رشته از ساختاری شبیه به printf(3) استفاده می‌کند، که در آن %l شماره خط، %c شماره ستون، %p آفست موقعیت درج، و %s اندازهٔ فعلی فایل را چاپ می‌کند. همچنین امکان تعیین اندازهٔ فیلدها با ساختار %-?[0-9]+ نیز وجود دارد. رشتهٔ قالب پیش‌فرض ``L%l'' است که نویسهٔ ``L'' و در ادامه شماره خط را نشان می‌دهد.

hints (Class Hints)

فهرستی از رشته‌ها را مشخص می‌کند که با خطوط جدید (newline) از هم جدا شده‌اند و در پنجرهٔ bc_label نمایش داده خواهند شد.

hintsInterval (Class Interval)

بازهٔ زمانی را بر حسب ثانیه مشخص می‌کند که طی آن رشتهٔ راهنما در پنجرهٔ bc_label تغییر خواهد کرد.

changedBitmap (Class Bitmap)

نام نگاشت بیتی (Bitmap) را تعیین می‌کند که هنگام تغییر فایل در حال ویرایش، در fileMenu نمایش داده می‌شود.

autoReplace (Class Replace)

این منبع برای تصحیح خودکار اشتباهات املایی رایج مفید است، اما همچنین می‌تواند برای ایجاد ماکروهای ساده استفاده شود. قالب به صورت {non-blanks}{blanks}[{string}] است. فیلدها با خطوط جدید از هم جدا می‌شوند. مثالی از استفاده:

nto	  not\n\
/macro some long string with \\\n newlines \\\n

هنگام تایپ این کلمات، به طور خودکار کلمهٔ nto با not و /macro با some long string with
newlines جایگزین خواهد شد.

ispell.dictionaries (Class ispell.Dictionary)

فهرستی از نام‌های واژه‌نامه را مشخص می‌کند که با فاصله از هم جدا شده‌اند و در دسترس برنامهٔ ispell هستند. مقدار پیش‌فرض "american americamed+ english" است.

ispell.dictionary (Class ispell.Dictionary)

واژه‌نامه پیش‌فرض جهت استفاده را مشخص می‌کند.

ispell*<DICTIONARY>.wordChars (Class ispell*Chars)

مجموعه‌ای از نویسه‌ها را تعیین می‌کند که می‌توانند بخشی از یک کلمهٔ معتبر باشند. فیلد <DICTIONARY> یکی از واژه‌نامه‌های مشخص‌شده در منبع dictionaries است.

ispell.ispellCommand (Class ispell.CommandLine)

مسیر برنامهٔ ispell و احتمالاً آرگومان‌های اضافی. نیازی به تعیین گزینهٔ -w یا گزینهٔ -a= ندارید. برای اطلاعات بیشتر در مورد گزینه‌های ispell به صفحه راهنمای ispell(1) مراجعه کنید.

ispell.formatting (Class ispell.TextFormat)

قالب‌بندی متنی مورد استفاده هنگام غلط‌یابی املایی فایل را مشخص می‌کند. قالب‌های موجود text و html هستند.

ispell*text.skipLines (Class ispell*text.Skip)

خطوطی که با یکی از نویسه‌های این رشته شروع می‌شوند، غلط‌یابی نخواهند شد. این منبع فقط در حالت text استفاده می‌شود.

ispell.terseMode (Class ispell.Terse)

در صورت فعال بودن، ispell را در حالت خلاصه اجرا می‌کند و برای کلمات ایجادشده از طریق ترکیب کلمات (هنگام استفاده از گزینهٔ ispel -C) یا کلمات ایجادشده از طریق حذف وند، تعاملی از کاربر درخواست نمی‌کند. مقدار پیش‌فرض False است.

ispell.lookCommand (Class ispell.CommandLine)

مسیر برنامه برای جستجوی کلمات جایگزین، و احتمالاً، آرگومان‌های اضافی. برنامهٔ پیش‌فرض مورد استفاده /usr/bin/egrep است.

ispell.wordsFile (Class ispell.Words)

مسیر فایل(ها) برای جستجوی کلمات جایگزین. فایل پیش‌فرض /usr/share/dict/words است.

ispell.guessLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که ispell فهرستی حدسی از یک یا چند کلمه را برمی‌گرداند. مقدار پیش‌فرض Guess است.

ispell.missLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که ispell فهرستی از یک یا چند کلمه را برای تطبیق با کلمهٔ دارای اشتباه املایی برمی‌گرداند. مقدار پیش‌فرض Miss است.

ispell.rootLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمه در واژه‌نامه موجود نیست، اما می‌تواند از طریق یک کلمهٔ ریشه ساخته شود. مقدار پیش‌فرض Root: است و به دنبال آن یک فاصله و کلمهٔ ریشه می‌آید.

ispell.noneLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که هیچ مورد مشابهی وجود ندارد. مقدار پیش‌فرض None است.

ispell.compoundLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمهٔ در حال بررسی از الحاق دو کلمه تشکیل شده باشد. مقدار پیش‌فرض Compound است.

ispell.okLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمهٔ بررسی‌شده در واژه‌نامه موجود است. این رشته تنها هنگام استفاده از دکمهٔ check در رابط ispell برنامهٔ xedit نمایش داده می‌شود. مقدار پیش‌فرض Ok است.

ispell.eofLabel (Class ispell.Status)

رشته‌ای که پس از رسیدن به انتهای فایل در نوار وضعیت ispell نمایش داده می‌شود. مقدار پیش‌فرض End Of File است.

ispell.repeatLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell هنگامی که دو کلمهٔ یکسان در کنار یکدیگر در فایل پیدا شوند، نمایش داده می‌شود. مقدار پیش‌فرض Repeat است.

ispell.lookLabel (Class ispell.Status)

رشته‌ای که پس از نمایش نتایج دستور Look در نوار وضعیت ispell نمایش داده می‌شود. اگر هیچ نتیجه‌ای یافت نشود، مقدار منبع ispell.noneLabel نشان داده می‌شود.

ispell.workingLabel (Class ispell.Status)

رشته‌ای که در نوار وضعیت ispell هنگام ارتباط xedit با ispell نمایش داده می‌شود. مقدار پیش‌فرض ... است..SH "ویجت‌ها (WIDGETS)" به‌منظور مشخص‌کردن منابع، دانستن سلسله‌مراتب ویجت‌هایی که xedit را تشکیل می‌دهند مفید است. در نشانه‌گذاری زیر، تورفتگی بیانگر ساختار سلسله‌مراتبی است. ابتدا نام کلاس ویجت و سپس نام نمونهٔ ویجت آورده شده است.

Xedit  xedit
        Paned  paned
                Paned  buttons
                        Command  quit
                        Command  save
                        Command  load
                        Text     filename
                Label  bc_label
                Text   messageWindow
                Label  labelWindow
                Text   editWindow

محیط (ENVIRONMENT)

DISPLAY

برای به‌دست آوردن میزبان و شمارهٔ نمایشگر پیش‌فرض.

XENVIRONMENT

برای به‌دست آوردن نام فایل منبعی که جایگزین منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER می‌شود.

فایل‌ها (FILES)

/usr/share/X11/app-defaults/Xedit

منابع مورد نیاز را مشخص می‌کند.

همچنین ببینید (SEE ALSO)

xrdb(1), X(7), Athena Widget Set

محدودیت‌ها (RESTRICTIONS)

Xedit جایگزینی برای Emacs نیست.

نویسندگان (AUTHORS)

Chris D. Peterson, MIT X Consortium
Paulo Cesar Pereira de Andrade, The XFree86 Project