<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY appversion "3.2.2">
<!ENTITY manrevision "3.1">
<!ENTITY date "January 2022">
<!ENTITY app "xed">
]>
<!-- =============Document Header ============================= -->
<?db.chunk.max_depth 2?>
<article id="index" lang="ar">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo>
	 <title>دليل محرر النصوص</title>

	 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
	 <revhistory>
<!-- Remember to remove the &manrevision; entity from the revision entries other
   than the current revision. -->
		<revision lang="en">
		  <revnumber>xed V1.0</revnumber>
		  <date>2000</date>
		  <revdescription>
			 <para role="author" lang="en">Eric Baudais <email>baudais@okstate.edu</email>
				</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.0</revnumber>
		  <date>March 2002</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.1</revnumber>
		  <date>June 2002</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.2</revnumber>
		  <date>August 2002</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.3</revnumber>
		  <date>September 2002</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.4</revnumber>
		  <date>January 2003</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.5</revnumber>
		  <date>March 2003</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.6</revnumber>
		  <date>September 2003</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.7</revnumber>
		  <date>March 2004</date>
		  <revdescription>
			 <para role="author" lang="en">Sun GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
   	<revision lang="en">
		  <revnumber>xed Manual V2.8</revnumber>
		  <date>Unknown 200x</date>
		  <revdescription>
			 <para role="author" lang="en">Sun Java Desktop System Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
		<revision lang="en">
		  <revnumber>xed Manual V2.9;</revnumber>
		  <date>July 2006;</date>
		  <revdescription>
			 <para role="author" lang="en">GNOME Documentation Team</para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
   		<revision lang="en">
		  <revnumber>xed Manual V3.0;</revnumber>
		  <date>July 2015</date>
		  <revdescription>
			 <para role="author" lang="en">MATE Documentation Team</para>
			 <para role="publisher" lang="en">MATE Documentation Project</para>
		  </revdescription>
		</revision>
   		<revision lang="en">
		  <revnumber>xed Manual V3.1</revnumber>
		  <date>January 2022</date>
		  <revdescription>
			 <para role="author" lang="en">Garod Vindal <email>mandospring@gmail.com</email></para>
			 <para role="publisher" lang="en">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
	 </revhistory>
	 <releaseinfo lang="en"> This manual describes version 3.2.2 of xed.
		</releaseinfo>
  </articleinfo>
  <indexterm lang="en"><primary>xed</primary></indexterm>
  <indexterm lang="en"><primary>text editor</primary></indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="xed-intro">
	 <title>مقدمة</title>

   <!-- removed ids, here as anchors to prevent possible breakage -->
	 <anchor id="xed-customize-toolbar"/>

	 <para>التطبيق <application>xed</application> يتيح لك إنشاء وتحرير الملفات النصية.</para>

	 <para>غاية <application>محرر النصوص</application> أن يكون محرر نصوص بسيط وسهل. مزايا أقوى يمكن أن تُفعّل مع  <firstterm>ملحقات</firstterm>، تسمح بمزايا عديدة لمهام متعلقة بتحرير النص.</para>
  </sect1>
<!-- ============= Getting Started =========================== -->
  <sect1 id="xed-getting-started">
	 <title>البدء</title>

<!-- ============= To Start xed ============================ -->
	 <sect2 id="xed-to-start">
		<title>بدء محرر النصوص</title>
		<para>تستطيع بدء <application>محرر النصوص</application> بالطريق التالية:</para>
		<variablelist>
    		<varlistentry>
    		<term>قائمة <guimenu>التطبيقات</guimenu></term>
    		<listitem>
    		<para>اختر <menuchoice><guisubmenu>الملحقات</guisubmenu><guimenuitem>محرر النصوص</guimenuitem></menuchoice>.</para>
    		</listitem>
    		</varlistentry>
    		<varlistentry>
    		<term>سطر الأوامر</term>
    		<listitem>
    		<para>شغّل السطر التالي: <command>xed</command></para>
    		</listitem>
    		</varlistentry>
    	</variablelist>
    <para>مبدئيا، عند فتح مستند نصي في مدير الملفات، سوف يبدأ محرر النصوص، ويعرض المستند.</para>
	</sect2>

	<sect2 id="xed-when-you-start">

		<title>نافذة محرر النصوص.</title>
		<para>عند بدء <application>محرر النصوص</application>، النافذة التالية تُعرض:</para>

		<figure id="xed-window">
		  <title>نافذة محرر النصوص.</title>
		  <screenshot>
			 <mediaobject lang="en">
				<imageobject>
				  <imagedata fileref="figures/xed_window.png" format="PNG"/>
					 </imageobject>
				<textobject> <phrase>Shows xed main window.</phrase>
				</textobject>
			</mediaobject>
		  </screenshot>
		</figure>

		<para>نافذة <application>xed</application> تحتوي العناصر التالية:</para>
		<variablelist>
		  <varlistentry> <term>شريط القوائم</term>
			 <listitem>
				<para>القوائم على شريط القوائم تحتوي كل الأوامر التي تحتاجها للعمل مع الملفات في <application>xed</application>.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>شريط الأدوات </term>
			 <listitem>
				<para>شريط الأدوات يحتوي رصّة فرعية من الأوامر التي تستطيع الوصول إليها من شريط الأدوات.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>منطقة العرض</term>
			 <listitem>
				<para>تحتوي منطقة العرض نص الملف الذي تحرّره.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>شريط الحالة </term>
			 <listitem>
				<para>شريط الحالة يعرض معلومات حول نشاط <application>xed</application> الحالي ومعلومات مُتسقة حول عناصر القائمة. شريط الحال يعرض أيضا المعلومات التالية:</para>
		  <itemizedlist>
		  <listitem>
		  <para>موضع المؤشر: رقم السطر ورقم العمود حيث يقع المؤشر.</para>
		  </listitem>
		  <listitem>
		  <para>نمط التحرير: إذا كان المحرر في وضع الإدراج، شريط الحالي يحتوي النص <guilabel>إضافة</guilabel>. إذا كان المحرر في وضع الكتابة الفوقية، شريط الحالي يحتوي <guilabel>استبدال</guilabel>. اضغط مفتاح <keycap>Insert</keycap> لتغيير نمط التحرير.</para>
		  </listitem>
		  </itemizedlist>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>اللوحة الجانبية</term>
			 <listitem>
				<para>تعرض اللوحة الجانبية قائمة المستندات المفتوحة، ومعلومات أخرى مبنية على الملحقات المُفعّلة.</para>
				<para>ابتدائيا  ليست معروضة،  لعرضها، اختر <menuchoice><guimenu>عرض</guimenu><guimenuitem>اللوحة الجانبية</guimenuitem></menuchoice>.</para>
			 </listitem>
		  </varlistentry>
		</variablelist>
		<para>عندما تنقر يمينا في نافذة <application>محرر النصوص</application>، يعرض التطبيق قائمة منبثقة. القائمة المنبثقة تحتوي معظم أوامر تحرير النصوص الشائعة.</para>

	 </sect2>

<!-- ============= To Open Multiple Files from the Command Line ========= -->
	 <sect2 id="xed-run-from-cmd-line">
		<title>تشغيل محرر النصوص من سطر الأوامر.</title>
		<para>تستطيع تشغيل <application>محرر النصوص</application> من سطر الأوامر وفتح ملف وحيد أو ملفات متعددة. لفتح ملفات متعددة من سطر الأوامر، اطبع الأمر التالي، ثم انقر <keycap>إدخال</keycap>:</para>
		<para lang="en"><command>xed <replaceable>file1.txt file2.txt file3.txt</replaceable></command></para>
		<para>بدلا من ذلك، تستطيع تحديد مسار بدلا من اسم ملف.</para>
    <para>لمزيد من المعلومات عن كيفية تشغيل <application>محرر النصوص</application> من سطر الأوامر، راجع صفحة دليل يونكس لمحرر النصوص، <ulink url="man:xed" type="man"><citerefentry><refentrytitle>محرر النصوص</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
	 </sect2>
  </sect1>
<!-- ================ Usage ================================ -->
  <sect1 id="xed-usage">
	 <title>العمل مع الملفات</title>

<!-- ============= To Create a New File ======================== -->
	 <sect2 id="xed-create-new-file">
		<title>إنشاء مستند جديد </title>
		<para>لإنشاء مستند جديد، اختر <menuchoice><guimenu>ملف</guimenu><guimenuitem>جديد</guimenuitem></menuchoice>. التطبيق يعرض مستند فارغ في نافذة <application>محرر النصوص</application>.</para>
	 </sect2>

<!-- ============= To Open a File ============================= -->
	 <sect2 id="xed-open-file">
		<title>فتح ملف</title>
		<para>لفتح ملف، اختر <menuchoice><guimenu>ملف</guimenu><guimenuitem>افتح</guimenuitem></menuchoice> لعرض حوار <guilabel>فتح ملف</guilabel>. انتقِ الملف الذي تريد فتحه، ثم انقر <guibutton>افتح</guibutton>. الملف يُعرض في نافذة <application>محرر النصوص</application>.</para>

		<para lang="en">The application records the paths and filenames of the five most recent files that you edited and displays the files as sub-menu items under the <menuchoice><guimenu>File</guimenu><guimenuitem>Recents</guimenuitem></menuchoice> menu choice.</para>

		<note><para>تستطيع فتح ملفات متعددة في <application>محرر النصوص</application>. يضيف التطبيق لسان لكل فتح ملف إلى النافذة. للمزيد عن هذا راجع <xref linkend="xed-tabs"/>.</para></note>

	 </sect2>

<!-- ============= To Save a File ============================== -->
	 <sect2 id="xed-save-file">
		<title>حفظ ملف</title>
		<para>تستطيع حفظ ملفات بالطرق التالية:</para>
		<itemizedlist>
		  <listitem><para>لحفظ التغييرات لملف موجود، اختر <menuchoice><guimenu>ملف</guimenu><guimenuitem>احفظ</guimenuitem></menuchoice>.</para>
		  </listitem>
		  <listitem><para lang="en">To save a new file or to save an existing file under a new filename, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As</guimenuitem> </menuchoice>. Enter a name for the file in the <guilabel>Save As</guilabel> dialog, then click <guibutton>Save</guibutton>. </para>
		  </listitem>
		  <listitem><para lang="en">To save all of the files that are currently open in <application>xed</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Save All</guimenuitem> </menuchoice>.</para>
		  </listitem>
		</itemizedlist>
		<para lang="en">To close all of the files that are currently open in <application>xed</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Close All</guimenuitem> </menuchoice>.</para>
	 </sect2>


<!-- ============= Working with tabs ======================== -->
	 <sect2 id="xed-tabs">
	   <title>العمل مع الألسنة</title>

		 <para>عندما يفتح أكثر من ملف، يعرض <application>محرر النصوص</application> <firstterm>لسان</firstterm> لكل مستند أعلى منطقة العرض. للتبديل إلى مستند آخر، انقر لسانها.</para>
		 <para>لنقل مستند إلى نافذة <application>محرر النصوص</application> أخرى، ألقِ اللسان الملائم للملف إلى النافذة التي تريدها لنقله.</para>
		 <para lang="en">To move a document to a new <application> xed</application> window, either drag its tab to the desktop, or choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Move to New Window</guimenuitem> </menuchoice>.</para>
	 </sect2>

  </sect1>

  <sect1 id="working-with-text">
    <title>العمل مع النص</title>

<!-- ============= To Edit Text ================================ -->
	 <sect2 id="xed-edit-text">
		<title>تحرير النص</title>
		<para>تستطيع تعديل نص ملف بالطرق التالية:</para>
		<itemizedlist>
		  <listitem><para>اطبع النص الجديد من لوحة المفاتيح. <firstterm>مؤشر الإدخال</firstterm> النابض يعلّم النقطة حيث يضاف النص. لتغيير هذا، استخدام مفاتيح الأسهم على لوحة المفاتيح أو انقر بالفأرة.</para>
		  </listitem>
		  <listitem><para lang="en">To copy the selected text to the clipboard, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem> </menuchoice>.</para>
		  </listitem>
		  <listitem><para lang="en">To delete the selected text from the file and move the selected text to the clipboard, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice>.</para>
		  </listitem>
		  <listitem><para lang="en">To permanently delete the selected text from the file, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Delete</guimenuitem> </menuchoice>.</para>
		  </listitem>
		  <listitem><para lang="en">To insert the contents of the clipboard at the cursor position, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice>. You must cut or copy text before you can paste text into the file, either from xed or another application.</para>
		  </listitem>
		  <listitem><para lang="en">To select all of the text in a file, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Select All</guimenuitem> </menuchoice>. </para>
		  </listitem>
		</itemizedlist>
	 </sect2>
<!-- ============== To Undo or Redo Edits ====================== -->
	 <sect2 id="xed-undo-redo-edits">
		<title>استرجاع وإعادة التغييرات</title>
		<para lang="en">To undo a change you have made, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice>. To reverse this action, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem> </menuchoice>.</para>
	 </sect2>

	</sect1>
	<sect1 id="xed-find">
		<title>الإيجاد والاستبدال</title>

<!-- ============= To Find Text ================================ -->
	 <sect2 id="xed-find-text">
		<title>إيجاد النص</title>
		<para>للبحث في ملف عن مقطع من نص، أدِ الخطوات التالية:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice>. The <guilabel>Find</guilabel> pane will open at the bottom of the xed window.</para>
		  </listitem>
		  <listitem><para>اطبع المقطع الذي تريد إيجاده في حقل <guilabel>ابحث عن</guilabel>. تستطيع تضمين محارف خاصة مثل سطر جديد أو Tab: راجع <xref linkend="xed-find-escapes"/>.</para>
		  </listitem>
		  <listitem><para lang="en">Click <guibutton>Find</guibutton> to search the file for the first occurrence of the string after your current cursor position. If <application>xed</application> finds the string, the application selects the first occurrence of the string. Other occurrences of the string are highlighted.</para>
		  </listitem>
		  <listitem><para lang="en">To find the next occurrence of the string, click <guibutton>Find</guibutton> or choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Next</guimenuitem> </menuchoice>. To find the previous occurrence of the text, choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Previous</guimenuitem> </menuchoice>.</para>
		  </listitem>
		</orderedlist>
		<para lang="en">After you have closed the <guilabel>Find</guilabel> dialog, you can still move the selection to other occurrences of the text by choosing  <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Next</guimenuitem> </menuchoice> and  <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Previous</guimenuitem> </menuchoice>.</para>
	 </sect2>

<!-- ============= To Find and Replace Text =================== -->
	 <sect2 id="xed-find-replace-text">
		<title>استبدال نص</title>

		<para>للبحث في ملف عن نص، واستبدال النص بنص بديل، أدِ الخطوات التالية:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Replace</guimenuitem> </menuchoice> to display the <guilabel>Replace</guilabel> pane at the bottom of the xed window.</para>
		  </listitem>
		  <listitem><para>اطبع النص الذي تريد إيجاده، في حقل <guilabel>ابحث عن</guilabel>. تستطيع تضمين محارف خاصة مثل سطر جديد أو اللسان: راجع <xref linkend="xed-find-escapes"/>.</para></listitem>
		  <listitem><para>اطبع النص الذي تريد استخدامه لاستبدال النص الذي وجدته، في حقل <guilabel>استبدل بـ:</guilabel></para>
		  </listitem>
		</orderedlist>

		<para lang="en">If <application>xed</application> finds the string, the application selects the string. Click <guibutton>Replace</guibutton> to replace the selected occurrence of the string. The selected text will be replaced and the next match to the search string will be selected. To find the next occurrence of the string without changing the current selection, click <guibutton>Next</guibutton>(or <guibutton>Previous</guibutton>).</para>
		<para>لاستبدال كل مصادفات النص على طول المستند، انقر <guibutton>استبدل الكل</guibutton>.</para>
	 </sect2>

<!-- ============= Find and Replace Options ============================ -->
  <sect2 id="xed-find-options">
		<title>خيارات البحث والاستبدال</title>
		<para lang="en">Four buttons on the left side the <guilabel>Find</guilabel> or <guilabel>Replace</guilabel> pane control the following options respectively: Regular expression search, Match case, Match whole word, and Wrap search. Each option can be toggled by clicking on its button.</para>
		<imageobject>
		  <imagedata fileref="figures/xed_search_pane_buttons.png" format="PNG"/>
		</imageobject>
		<itemizedlist>
		  <listitem><para lang="en">Select the <guilabel>Regular Expression</guilabel> option to search using regular expressions.  For some basics on the use of regular expressions for searching see: <ulink url="man:grep" type="man"><citerefentry><refentrytitle>grep</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink></para>
		  </listitem>
		  <listitem><para>انتقِ الخيار <guilabel>طابق الحالة</guilabel> لإيجاد أي حالات للنص تطابق حالة النص الذي طبعته. على سبيل المثال، مع انتقاء <guilabel>طابق الحالة</guilabel>، "TEXT" لن تطابق "text".</para>
		  </listitem>
		  <listitem><para>انتقِ الخيار <guilabel>طابق كامل الكلمة فقط</guilabel> لإيجاد فقط مصادفات النص التي تطابق كلمات النص الكاملة التي طبعتها. على سبيل المثال، مع انتقاء <guilabel>طابق كامل الكلمة فقط</guilabel>، "نص" لن تطابق "نصي".</para>
		  </listitem>
		  <listitem><para>انتقِ خيار <guilabel>لف حول</guilabel> للبحث إلى نهاية المستند ثم استمرار البحث من النهاية الأخرى للملف.</para>
		  </listitem>
		</itemizedlist>
  </sect2>

<!-- ============= Special Characters ============================ -->
	 <sect2 id="xed-find-escapes">
	   <title>المحارف الخاصة</title>
	     <para>يمكنك تضمين التسلسلات الهاربة التالية في النص للإيجاد أو الاستبدال إلى المحارف الممثلة التالية:</para>
			 <variablelist>
        <varlistentry>
          <term lang="en"><literal>\n</literal></term>
    				<listitem>
              <para>يحدد سطرا جديدا.</para>
    				</listitem>
        </varlistentry>
        <varlistentry>
          <term lang="en"><literal>\t</literal></term>
    				<listitem>
              <para>يحدد محرّف اللسان.</para>
    				</listitem>
        </varlistentry>
        <varlistentry>
          <term lang="en"><literal>\r</literal></term>
    				<listitem>
              <para>يحدد عودة ناقل.</para>
    				</listitem>
        </varlistentry>
        <varlistentry>
          <term lang="en"><literal>\\</literal></term>
    				<listitem>
              <para>محرّف الخط المائل العكسي ذاته يجب أن يهرب إذا بُحث عنه. على سبيل المثال، إذا كنت تبحث عن "<literal>\n</literal>" حرفيا، عليك طباعة "\\n" في حقل <guilabel>ابحث عن</guilabel>. أو إذا كنت تبحث عن تسلسل خطوط مائلة عكسية، عليك مضاعفة عدد الحطوط المائلة المعكوسة المبحوث عنها.</para>
    				</listitem>
        </varlistentry>
			 </variablelist>
    </sect2>

<!-- ============= To Position the Cursor on a Specific Line ======================= -->
    <sect2 id="xed-goto-line">
      <title>وضع المؤشر على سطر محدد</title>

      <para lang="en">To position the cursor on a specific line in the current file, choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Go to Line</guimenuitem> </menuchoice>. The line number box appears at the top of the display area.</para>
      <para>عندما تطبع رقم السطر الذي تريد نقل المؤشر إليه، سوف يلف المستند إلى السطر المحدد.</para>
      <para>لإيقاف الصندوق وتحريك المؤشر إلى السطر المحدد، اضغط <keycap>إدخال</keycap>.</para>
    </sect2>

  </sect1>

<!-- ============= To Print a File ============================ -->
  <sect1 id="xed-printing">
    <title>الطباعة</title>
        <para lang="en">Two printing options appear under the <guimenu>File</guimenu>menu choice:  <guimenuitem>Print</guimenuitem> which opens a print dialog box allowing the setting of options before printing, and <guimenuitem>Print Preview</guimenuitem> which opens a view of the printed document on the screen in place of editor view.</para>

<!-- ============= Print Dialog ============================ -->
    <sect2 id="xed-file-print">
        <title lang="en">File Print Dialog</title>
        <para lang="en">The dialog allows selection of the printer, setting of the print options and finally printing.</para>
        <sect3 id="xed-file-print-general">
            <title lang="en">General Tab</title>
            <para lang="en">The print dialog opens on the <guilabel>General</guilabel> Tab by default.  On this tab, the printer can be selected--including "Print to File"--as well the pages and number of copies.  If print to file is selected additional options appear to selecting the format (PDF, Postscript or SVG), and the output file name.  Clicking on the output filename button opens a file selection dialog.</para>
        </sect3>

        <sect3 id="xed-print-page-setup">
            <title lang="en">Page Setup Tab</title>
            <para lang="en">Use this tab to select printer-specific options such as: page size, page source, orientation, scale, etc.</para>
        </sect3>

        <sect3 id="xed-print-text-editor">
            <title lang="en">Text Editor Tab</title>
			<para lang="en">Use the settings in this tab to control for the printed output the following things:</para>
			<itemizedlist>
				<listitem lang="en">Syntax highlighting</listitem>
				<listitem>رقم السطور</listitem>
				<listitem>لف النص</listitem>
				<listitem lang="en">Page header</listitem>
				<listitem>الخطوط</listitem>
			</itemizedlist>
        </sect3>
    </sect2>

	<sect2 id="xed-file-print-preview">
		<title lang="en">Print Preview</title>
        <para lang="en">The print preview has several buttons with icon labels for navigating around the printed output, zooming in and out, and finally print the output if satisfied with the way it looks.  Rolling over a button will expose a tool tip showing its purpose. </para>
        <tip lang="en">If you click the print button <guibutton><imageobject>
				  <imagedata fileref="figures/xed_print_button.png" format="PNG"/>
					 </imageobject></guibutton>
 the file will be immediately printed without entering any print dialog.  So make sure desired options have been set using the <menuchoice><guimenu>File</guimenu><guimenuitem> Print...</guimenuitem></menuchoice> dialog.</tip>
    </sect2>

  </sect1>

  <sect1 id="xed-programming-features">
	  <title>مزايا البرمجة</title>

	  <para lang="en">Several of <application>xed</application>'s features for programming are provided with plugins. For example, the Tag List plugin provides a list of commonly-used tags for different markup languages: see <xref linkend="xed-tag-list-plugin"/>.  Several other plugins exist.  See <xref linkend="xed-plugins"/>.</para>  

<!-- ============= Syntax Highlighting =================== -->
	 <sect2 id="xed-set-highlightmode">
	 <title>إبراز الصياغة</title>
	 <para>يجعل ابراز صياغة الكود المصدري أسهل للقراءة بعرض الأجزاء المختلفة من النص بألوان مختلفة.</para>

	 <para lang="en"><application>xed</application> chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Highlight Mode</guimenuitem> </menuchoice>, then choose one of a large list of text file formats falling into the rough categories below:</para>
		  <variablelist>
		    <varlistentry>
		      <term lang="en"><guimenuitem>Plain Text</guimenuitem></term>
		      <listitem>
		        <para>لا تعرض أي إبراز صياغة.</para>
		      </listitem>
		    </varlistentry>
		    <varlistentry>
		      <term lang="en"><guisubmenu>Sources</guisubmenu></term>
		      <listitem>
		        <para lang="en">Source code for a number of programming languages.</para>
		      </listitem>
		    </varlistentry>
		    <varlistentry>
		      <term lang="en"><guisubmenu>Markup</guisubmenu></term>
		      <listitem>
		        <para lang="en">Markup code such as HTML, XML, Markdown and others.</para>
		      </listitem>
		    </varlistentry>
		    <varlistentry>
		      <term lang="en"><guisubmenu>Scripts</guisubmenu></term>
		      <listitem>
		        <para lang="en">Script code (Bash, sh, etc.). </para>
		      </listitem>
		    </varlistentry>
		    <varlistentry>
		      <term lang="en"><guisubmenu>Others</guisubmenu></term>
		      <listitem>
		        <para lang="en">Other types of code (e.g. makefiles, awk, sed, etc.).</para>
		      </listitem>
		    </varlistentry>
		  </variablelist>
     <para lang="en">A search box at the top of the combo box facilitates finding of the desired format by typing in some the letters.</para>
	 </sect2>
</sect1>

<!-- ================ Shortcut Keys ============================= -->
<sect1 id="xed-shortcutkeys">
  <title>مفاتيح الاختصار</title>
  <para>استخدم مفاتيح الاختصار لتأدية المهام الشائعة أسرع من الفأرة والقوائم. الجداول التالية تضع كل مفاتيح اختصار <application>محرر النصوص</application> في قائمة.</para>

  <!-- ============= Tabs ======================== -->
	<bridgehead>ألسنة</bridgehead>
	<para lang="en">Shortcuts for notebook tabs:</para>
  <informaltable frame="all">
    <tgroup cols="2" colsep="1" rowsep="1">
      <colspec colname="COLSPEC0" colwidth="50*"/>
      <colspec colname="COLSPEC1" colwidth="50*"/>
      <thead>
        <row valign="top">
          <entry colname="COLSPEC0">
            <para>مفتاح الاختصار</para></entry>
          <entry colname="COLSPEC1" align="left">
            <para>الأمر</para></entry>
        </row>
      </thead>
      <tbody>
        <row valign="top">
          <entry><para>Ctrl + Alt + PageDown</para><para lang="en">or Ctrl + Tab</para></entry>
          <entry><para>يحوّل إلى اللسان التالي إلى اليسار.</para></entry>
        </row>
        <row valign="top">
          <entry><para>Ctrl + Alt + PageDown</para><para lang="en"> or Ctrl + Shift + Tab</para></entry>
          <entry><para>يحوّل إلى اللسان التالي إلى اليمين.</para></entry>
        </row>
        <row valign="top">
          <entry><para>Ctrl + W</para></entry>
          <entry><para>أغلق اللسان.</para></entry>
        </row>
        <row valign="top">
          <entry><para>Ctrl + Shift + L</para></entry>
          <entry><para>احفظ كل الألسنة.</para></entry>
        </row>
        <row valign="top">
          <entry><para>Ctrl + Shift + W</para></entry>
          <entry><para>أغلق كل الألسنة.</para></entry>
        </row>
        <row valign="top">
          <entry><para>Alt + n</para></entry>
          <entry><para>يقفز إلى اللسان الأعلى.</para></entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>

  <!-- ============= Files ======================== -->
	<bridgehead>ملفات</bridgehead>
	<para>اختصارات العمل مع الملفات:</para>
  <informaltable frame="all">
                  <tgroup cols="2" colsep="1" rowsep="1">
                    <colspec colname="COLSPEC0" colwidth="50*"/>
                    <colspec colname="COLSPEC1" colwidth="50*"/>
                    <thead>
                      <row valign="top">
                        <entry colname="COLSPEC0">
                          <para>مفتاح الاختصار</para></entry>
                        <entry colname="COLSPEC1" align="left">
                          <para>الأمر</para></entry>
                      </row>
                    </thead>
                    <tbody>
                      <row valign="top">
                        <entry><para>Ctrl + N</para></entry>
                        <entry><para>أنشئ مستندا جديدا.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + O</para></entry>
                        <entry><para>افتح مستندا.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + S</para></entry>
                        <entry><para>احفظ المستند الحالي إلى القرص.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + Shift + S</para></entry>
                        <entry><para>احفظ المستند الحالي باسم ملف جديد.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + P</para></entry>
                        <entry><para>اطبع المستند الحالي.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + Shift + P</para></entry>
                        <entry><para>عينة الطباعة.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + W</para></entry>
                        <entry><para lang="en">Close the current document (if only on tab open).</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + Q</para></entry>
                        <entry><para>يخرج محرر النصوص.</para></entry>
                      </row>
                    </tbody>
                  </tgroup>
                </informaltable>

  <!-- ============= Edit ======================= -->
	<bridgehead>تحرير</bridgehead>
	<para>اختصارات تحرير المستندات:</para>
	  <informaltable frame="all">
                  <tgroup cols="2" colsep="1" rowsep="1">
                    <colspec colname="COLSPEC0" colwidth="50*"/>
                    <colspec colname="COLSPEC1" colwidth="50*"/>
                    <thead>
                      <row valign="top">
                        <entry colname="COLSPEC0">
                          <para>مفتاح الاختصار</para></entry>
                        <entry colname="COLSPEC1" align="left">
                          <para>الأمر</para></entry>
                      </row>
                    </thead>
                    <tbody>
                      <row valign="top">
                        <entry><para>Ctrl + Z</para></entry>
                        <entry><para>استرجاع آخر إجراء.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + Y</para></entry>
                        <entry><para>إعادة آخر إجراء مُسترجع.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + X</para></entry>
                        <entry><para>قص النص أو المنطقة المنقاة ووضعها في الحافظة.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + C</para></entry>
                        <entry><para>نسخ النص أو المنقطة المنقاة إلى الحافظة.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + V</para></entry>
                        <entry><para>لصق محتويات الحافظة.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + A</para></entry>
                        <entry><para>انتقِ الكل.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + D</para></entry>
                        <entry><para>احذف السطر الحالي</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Alt + Up</para></entry>
                        <entry><para lang="en">Move the selected line up one line.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Alt + Down</para></entry>
                        <entry><para lang="en">Move the selected line down one line.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Alt + Right</para></entry>
                        <entry><para lang="en">Move the selected word one word to the right.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Alt + Left</para></entry>
                        <entry><para lang="en">Move the selected word one word to the left.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Ctrl + U</para></entry>
                        <entry><para lang="en">Change case to all upper.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + L</para></entry>
                        <entry><para lang="en">Change case to all lower.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + T</para></entry>
                        <entry><para lang="en">Change case to Title Case.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Ctrl + Shift + A</para></entry>
                        <entry><para lang="en">Increment number at cursor.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Ctrl + Shift + X</para></entry>
                        <entry><para lang="en">Decrement number at cursor.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Ctrl + J</para></entry>
                        <entry><para lang="en">Join lines.</para></entry>
                      </row>
                    </tbody>
                  </tgroup>
                </informaltable>

  <!-- ============= View ======================= -->
	<bridgehead lang="en">View</bridgehead>
	<para>اختصارات عرض وإخفاء اللوحات:</para>
	  <informaltable frame="all">
          <tgroup cols="2" colsep="1" rowsep="1">
            <colspec colname="COLSPEC0" colwidth="50*"/>
            <colspec colname="COLSPEC1" colwidth="50*"/>
            <thead>
              <row valign="top">
                <entry colname="COLSPEC0">
                  <para>مفتاح الاختصار</para></entry>
                <entry colname="COLSPEC1" align="left">
                  <para>الأمر</para></entry>
              </row>
            </thead>
            <tbody>
              <row valign="top">
                <entry><para>F9</para></entry>
                <entry><para>إظهار/إخفاء اللوحة الجانبية.</para></entry>
              </row>
              <row valign="top">
                <entry><para>Ctrl + F9</para></entry>
                <entry><para>إظهار/إخفاء اللوحة السفلية.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + F</para></entry>
                <entry><para lang="en">Open the <guilabel>File</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + E</para></entry>
                <entry><para lang="en">Open the <guilabel>Edit</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + V</para></entry>
                <entry><para lang="en">Open the <guilabel>View</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + S</para></entry>
                <entry><para lang="en">Open the <guilabel>Search</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + T</para></entry>
                <entry><para lang="en">Open the <guilabel>Tools</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + D</para></entry>
                <entry><para lang="en">Open the <guilabel>Documents</guilabel> menu.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Alt + H</para></entry>
                <entry><para lang="en">Open the <guilabel>Help</guilabel> menu.</para></entry>
              </row>
            </tbody>
          </tgroup>
      </informaltable>

	<para lang="en">Shortcuts for Adjusting text size:</para>
	  <informaltable frame="all">
          <tgroup cols="2" colsep="1" rowsep="1">
            <colspec colname="COLSPEC0" colwidth="50*"/>
            <colspec colname="COLSPEC1" colwidth="50*"/>
            <thead>
              <row valign="top">
                <entry colname="COLSPEC0">
                  <para>مفتاح الاختصار</para></entry>
                <entry colname="COLSPEC1" align="left">
                  <para>الأمر</para></entry>
              </row>
            </thead>
            <tbody>
              <row valign="top">
                <entry><para lang="en">Ctrl + =</para></entry>
                <entry><para lang="en">Increase text size.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Ctrl + -</para></entry>
                <entry><para lang="en">Decrease text size.</para></entry>
              </row>
              <row valign="top">
                <entry><para lang="en">Ctrl + 0</para></entry>
                <entry><para lang="en">Default text size.</para></entry>
              </row>
            </tbody>
          </tgroup>
      </informaltable>

  <!-- ============= Search ======================= -->
	<bridgehead>البحث</bridgehead>
	<para>اختصارات البحث:</para>
	  <informaltable frame="all">
                  <tgroup cols="2" colsep="1" rowsep="1">
                    <colspec colname="COLSPEC0" colwidth="50*"/>
                    <colspec colname="COLSPEC1" colwidth="50*"/>
                    <thead>
                      <row valign="top">
                        <entry colname="COLSPEC0">
                          <para>مفتاح الاختصار</para></entry>
                        <entry colname="COLSPEC1" align="left">
                          <para>الأمر</para></entry>
                      </row>
                    </thead>
                    <tbody>
                      <row valign="top">
                        <entry><para>Ctrl + D</para></entry>
                        <entry><para>جِد نصا.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + G</para></entry>
                        <entry><para>جِد المماثل التالي للنص.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + Shift + G</para></entry>
                        <entry><para>جِد المماثل السابق للنص.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + K</para></entry>
                        <entry><para>بحث تفاعلي.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + H</para></entry>
                        <entry><para>ابحث واستبدل.</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Ctrl + I</para></entry>
                        <entry><para>اذهب إلى سطر.</para></entry>
                      </row>
                    </tbody>
                  </tgroup>
                </informaltable>
  <!-- ============= Tools ======================= -->
	<bridgehead>أدوات</bridgehead>
	<para>اختصارات الأدوات:</para>
	  <informaltable frame="all">
                  <tgroup cols="2" colsep="1" rowsep="1">
                    <colspec colname="COLSPEC0" colwidth="50*"/>
                    <colspec colname="COLSPEC1" colwidth="50*"/>
                    <thead>
                      <row valign="top">
                        <entry colname="COLSPEC0">
                          <para>مفتاح الاختصار</para></entry>
                        <entry colname="COLSPEC1" align="left">
                          <para>الأمر</para></entry>
                      </row>
                    </thead>
                    <tbody>
                      <row valign="top">
                        <entry><para>Shift + F7</para></entry>
                        <entry><para>دقق الإملاء (بملحق)</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>Alt + F12</para></entry>
                        <entry><para>أزل المسافات المفرطة (بملحق).</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Tab</para></entry>
                        <entry><para lang="en">Indent (if block including newline selected).</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">Shift + Tab</para></entry>
                        <entry><para lang="en">Remove Indent (if block including newline selected).</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para>F8</para></entry>
                        <entry><para>شغلّ "make" في الدليل الحالي (بملحق).</para></entry>
                      </row>
                      <row valign="top">
                        <entry><para lang="en">F10</para></entry>
                        <entry><para lang="en">Sort all of the lines.</para></entry>
                      </row>
                   </tbody>
                  </tgroup>
                </informaltable>
  <!-- ============= Help ======================= -->
	<bridgehead>مساعدة</bridgehead>
	<para>اختصارات المساعدة:</para>
  <informaltable frame="all">
    <tgroup cols="2" colsep="1" rowsep="1">
      <colspec colname="COLSPEC0" colwidth="50*"/>
      <colspec colname="COLSPEC1" colwidth="50*"/>
      <thead>
        <row valign="top">
          <entry colname="COLSPEC0">
            <para>مفتاح الاختصار</para></entry>
          <entry colname="COLSPEC1" align="left">
            <para>الأمر</para></entry>
        </row>
      </thead>
      <tbody>
        <row valign="top">
          <entry><para>F1</para></entry>
          <entry><para lang="en">Open <application>xed</application>'s user manual (this help).</para></entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>

</sect1>



<!-- ============= Preferences ============================= -->
  <sect1 id="xed-prefs">
    <title>التفضيلات</title>

    <para lang="en">To configure <application>xed</application>, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. The <guilabel>Preferences</guilabel> dialog contains four categories:</para>

    <sect2 id="xed-prefs-editor">
      <title lang="en">Editor General Preferences</title>
      <para lang="en">The settings visible under this tab are organized into the categories: Font, Display, Highlighing, Indentation, Wrapping, and Tab scrolling.  Details on each are given below:</para>

      <sect3 id="xed-prefs-font">
        <title>الخط</title>
        <para lang="en">If the user chooses not to use the system fixed width font, a button appears showing the currently selected font and size.  Clicking on the button opens a dialog box where a diffent font and size can be selected.</para>
      </sect3>

      <sect3 id="xed-prefs-disp">
        <title lang="en">Display</title>
        <para lang="en">Several options control viewing of the file being edited.  These options do not affect the content of the file being edited, only the way that the file is viewed.</para>
        <variablelist>
          <varlistentry>
            <term lang="en"><guilabel>Display line numbers</guilabel></term>
            <listitem>
              <para lang="en">Select the <guilabel>Display line numbers</guilabel> option to display line numbers on the left side of the document viewing window. </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Display overview map</guilabel></term>
            <listitem>
              <para lang="en">Controls the option to display an overview map (bird's eye view) of the document in a pane on the right side of the <application>xed</application> window. </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Display right margin</guilabel></term>
            <listitem>
              <para lang="en">If this is selected a numeric selection box appears for entering the column number of the right margin, and if the document viewing window is widened horizontally beyond the right margin, the background shading changes to help the user avoid typing lines that are too long.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Draw whitespace</guilabel></term>
            <listitem>
              <para lang="en">This Controls the visibility of whitespace. If enabled, four additional lines appear for setting the type of whitespace that is visible: Leading whitespace, Trailing whitespace, Whitespace inside of text, and The Newline character.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="xed-prefs-highlighting">
        <title lang="en">Highlighting</title>
        <note><para lang="en">This preference option is for types of highlighting other than syntax highlighting, which is covered elsewhere.</para></note>
        <variablelist>
          <varlistentry>
            <term lang="en"><guilabel>High current line</guilabel></term>
            <listitem>
              <para lang="en">Changes the background color of the line the cursor is on.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Highlight matching brackets</guilabel></term>
            <listitem>
              <para lang="en">When enabled and the cursor is on a bracket, (e.g. (), {}, [], &lt;&gt;) the background color of that bracket and its matching bracket are changed to aid in matching bracket pairs.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="xef-prefs-indent">
      <title lang="en">Indentation</title>
      <para lang="en">Three lines control the use of tabs in the text:</para>
      <variablelist>
        <varlistentry>
          <term lang="en"><guilabel>Tab width</guilabel></term>
          <listitem>
            <para lang="en">Sets the tab width.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term lang="en"><guilabel>Use Spaces instead of tabs</guilabel></term>
          <listitem>
            <para lang="en">When enabled, <application>xed</application> inserts the number of spaces from <guilabel>Tab width</guilabel> in place of the tab character, when the <keycap>Tab</keycap> key is typed. </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term lang="en"><guilabel>Automatic indentation</guilabel></term>
          <listitem>
            <para lang="en">If enabled, <application>xed</application> will automatically indent the next line the same amount as the current line when the newline (<keycap>Enter</keycap>) key is typed. </para>
          </listitem>
        </varlistentry>
      </variablelist>
      </sect3>

      <sect3 id="xed-prefs-wrap">
        <title lang="en">Word wrap</title>
        <para lang="en">Word wrapping does not effect the contents of the text file, only the way it is viewed in the editing window. If word wrapping is not enabled, a horizontal scroll bar appears at the bottom of the editing window when a line a text exceeds the window boundaries.  If <guilabel>Word wrap</guilabel> is enabled an additional option, "<guilabel>Split words over two lines</guilabel>" appears, allowing the editor to break up words to facilitate wrapping.</para>
      </sect3>

      <sect3 id="xed-prefs-tabscroll">
        <title lang="en">Tab scrolling</title>
        <para lang="en">This refers to the tabs at the top of the window for selecting the document being edited. If this option is enabled, and the mouse point is over the document tab area, rolling the mouse wheel will cycle through the different document tabs.</para>
      </sect3>

      <sect3 id="xed-prefs-autoclose">
        <title lang="en">Auto close</title>
        <para lang="en">If this option is enabled, once the last tab is closed, the window will close.</para>
      </sect3>
    </sect2>

    <sect2 id="xed-prefs-save">
      <title lang="en">Save Preferences </title>

      <sect3 id="xed-prefs-filesave">
        <title lang="en">File saving</title>
        <variablelist>
          <varlistentry>
            <term lang="en"><guilabel>File Saving</guilabel> </term>
            <listitem>
              <para lang="en">Select the <guilabel>Create a backup copy of files before saving</guilabel> option to create a backup copy of a file each time you save the file. The backup copy of the file contains a ~ at the end of the filename.</para>
             </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Auto Saving</guilabel> </term>
            <listitem>
             <para lang="en">Select the <guilabel>Autosave files</guilabel> option to automatically save the current file at regular intervals. Use the spin box to specify how often you want to save the file.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term lang="en"><guilabel>Ensure Trailing Newline</guilabel> </term>
            <listitem>
             <para lang="en">If enabled <application>xed</application> will add a newline at the end of the file if one does not already exist.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>
    </sect2>

    <sect2 id="xed-prefs-theme">
      <title lang="en">Color Themes</title>
      <sect3 id="xed-dark-theme">
          <title lang="en"><guilabel>Dark Theme</guilabel></title>
            <para lang="en">Some schemes may come in both dark and light varients.  Enable this option to select the dark varient in case the scheme comes in both variants.</para>
      </sect3>
      <sect3 id="xed-style-scheme">
          <title lang="en"><guilabel>Style Scheme</guilabel></title>
            <para lang="en">You can choose a color scheme from the list of color schemes. By default, the following color schemes are installed:</para>
            <variablelist>
              <varlistentry>
                <term lang="en"><guilabel>Classic</guilabel></term>
                <listitem>
                  <para lang="en">Classic color scheme based on the gvim color scheme.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term lang="en"><guilabel>Cobalt</guilabel></term>
                <listitem>
                  <para lang="en">Blue based color scheme.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term lang="en"><guilabel>Kate</guilabel></term>
                <listitem>
                  <para lang="en">Color scheme used in the Kate text editor.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term lang="en"><guilabel>Oblivion</guilabel></term>
                <listitem>
                  <para lang="en">Dark color scheme using the Tango color palette.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term lang="en"><guilabel>Solarized Dark</guilabel></term>
                <listitem>
                  <para lang="en">Another Dark color scheme.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term lang="en"><guilabel>Tango</guilabel></term>
                <listitem>
                  <para lang="en">Color scheme using the Tango color scheme.</para>
                </listitem>
              </varlistentry>
            </variablelist>
            <para lang="en">You can add a new color scheme by clicking on <guilabel>Add...</guilabel>, and selecting a color scheme file</para>
            <para lang="en">You can remove the selected color scheme by clicking on <guilabel>Remove</guilabel></para>
      </sect3>
    </sect2>

    <sect2 id="xed-prefs-plugins" xreflabel="Plugins Preferences">
      <title>تفضيلات الملحقات</title>
      <para>تضيف الملحقات مزايا إضافية إلى <application>محرر النصوص</application>. لمزيد من المعلومات حول الملحقات وكيفية استخدام الملحقات المضمّنة، راجع <xref linkend="xed-plugins-overview"/>.</para>

<!-- ============= To Load xed Plugins ========================= -->
	 <sect3 id="xed-install-plugins">
		<title>تفعيل ملحق</title>
		<para>لتفعيل ملحق <application>محرر النصوص</application>، أدِ الخطوات التالية:</para>
                <orderedlist>
                  <listitem>
                    <para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. </para>
                  </listitem>
                  <listitem>
                    <para>انتق اللسان <guilabel>الملحقات</guilabel>.</para>
                  </listitem>
                  <listitem>
                    <para>انتقِ صندوق التأشير التالي لاسم الملحق الذي تريد تفعليه.</para>
                  </listitem>
                  <listitem>
                    <para>انقر <guibutton>أغلق</guibutton> لإغلاق حوار <guilabel>التفضيلات</guilabel>.</para>
                  </listitem>
                </orderedlist>
	 </sect3>

<!-- ============= To Remove xed Plugins ========================= -->
  	 <sect3 id="xed-remove-plugins">
  		<title>تعطيل ملحق</title>
  		<para>يظل الملحق مفعلا عند مغادرتك <application>محرر النصوص</application>.</para>
  		<para>لتعطيل ملحق <application>محرر النصوص</application>، أدِ الخطوات التالية:</para>
                  <orderedlist>
                    <listitem>
                      <para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. </para>
                    </listitem>
                    <listitem>
                      <para>انتق اللسان <guilabel>الملحقات</guilabel>.</para>
                    </listitem>
                    <listitem>
                      <para>ألغِ انتقاء صندوق التأشير التاليلاسم الملحق الذي تريد تعطيله.</para>
                    </listitem>
                    <listitem>
                      <para>انقر <guibutton>أغلق</guibutton> لإغلاق حوار <guilabel>التفضيلات</guilabel>.</para>
                    </listitem>
                  </orderedlist>
  	 </sect3>
	 </sect2>

 </sect1>
<!-- ============= To Use the xed Plugins ========================= -->
	 <sect1 id="xed-plugins">
		<title>الملحقات</title>
		<sect2 id="xed-plugins-overview">
		  <title>العمل مع الملحقات</title>
  		<para>يمكنك إضافة مزايا إضافية إلى <application>محرر النصوص</application> بتفعيل <firstterm>الملحقات</firstterm>. الملحق هو برنامج متمم يعزز أداء وظائف التطبيق. الملحقات تضيف عناصر جديدة إلى قوائم <application>محرر النصوص</application> للمزايا الجديدة التي تقدمها.</para>
  		<para lang="en">Several plugins come built-in with <application>xed</application>, and you can install more.</para>
  		<para lang="en">To enable and disable plugins, or see which plugins are currently enabled, and/or available use the <xref linkend="xed-prefs-plugins"/>.</para>
  		<para>الملحقات التالية تأتي مُضمّنة مع <application>محرر النصوص</application>:</para>
  		<itemizedlist>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-bracket-completion-plugin"/> for enclosing bracket characters,  automatically adds closing bracket if opening bracket is typed. </para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-change-case-plugin"/> allows you to change the case of the selected text. (NOTE: This plug-in doesn't appear in th <guilabel>Preferences -&gt; Plugins</guilabel> dialog because it is always enabled.)</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-document-statistics-plugin"/> shows the number of lines, words, and characters in the document. </para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-file-browser-plugin"/> allows you to browse your files and folders in the side pane.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-insert-date-time-plugin"/> adds the current date and time into a document.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-modelines-plugin"/> allows you to set editing preferences for individual documents, and supports <application>Emacs</application>, <application>Kate</application> and <application>Vim</application>-style modelines.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-trailers-plugin"/> eliminates any trailing spaces on each line when document is saved.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-sort-plugin"/> arranges selected lines of text into alphabetical order. (NOTE: Plug-in doesn't appear in preferences; always enabled.)</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-spell-checker-plugin"/> corrects the spelling in the selected text, or marks errors automatically in the document.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-tag-list-plugin"/> lets you insert commonly-used tags for HTML and other languages from a list in the side pane.</para>
  		  </listitem>
  		  <listitem>
  		    <para lang="en"><xref linkend="xed-word-complete-plugin"/> trys to predict the rest of the word after a few characters have been typed.</para>
  		  </listitem>
  		</itemizedlist>
  	  </sect2>

<sect2 id="xed-change-case-plugin" xreflabel="Change Case">
<title>ملحق تغيير الحالة</title>
	<para>ملحق <application>تغيير الحالة</application> يغير حالة النص المنتقى.</para>
	 <para lang="en">The change case selection is available in the context (right click) menu when some text is selected:</para>

  <informaltable frame="all">
    <tgroup cols="3" colsep="1" rowsep="1">
      <colspec colname="COLSPEC0" colwidth="33*"/>
      <colspec colname="COLSPEC1" colwidth="33*"/>
      <colspec colname="COLSPEC2" colwidth="33*"/>
      <thead>
        <row valign="top">
          <entry colname="COLSPEC0">
            <para>عنصر القائمة</para></entry>
          <entry colname="COLSPEC1">
            <para>الإجراء</para></entry>
          <entry colname="COLSPEC2">
            <para>مثال</para></entry>
        </row>
      </thead>
      <tbody>
        <row valign="top">
          <entry><para lang="en"><menuchoice><guimenu>Right Click</guimenu>
<guisubmenu>Change Case</guisubmenu><guimenuitem>All Upper Case</guimenuitem></menuchoice></para></entry>
          <entry><para>تغيير كل محرف إلى الحالة العلوية.</para></entry>
          <entry><para><literal>This text</literal> تصبح <literal>THIS TEXT</literal></para></entry>
        </row>
        <row valign="top">
          <entry><para lang="en"><menuchoice><guimenu>Right Click</guimenu>
<guisubmenu>Change Case</guisubmenu><guimenuitem>All Lower Case</guimenuitem></menuchoice></para></entry>
          <entry><para>تغيير كل محرف إلى الحالة السفلية.</para></entry>
          <entry><para><literal>This Text</literal> تصبح <literal>this text</literal></para></entry>
        </row>
        <row valign="top">
          <entry><para lang="en"><menuchoice><guimenu>Right Click</guimenu>
<guisubmenu>Change Case</guisubmenu><guimenuitem>Invert Case</guimenuitem></menuchoice></para></entry>
          <entry><para>تغيير حالة سفلية إلى حالة علوية، وتغيير كل حالة علوية إلى حالة سفلية.</para></entry>
          <entry><para><literal>This Text</literal> تصبح <literal>tHIS tEXT</literal></para></entry>
        </row>
        <row valign="top">
          <entry><para lang="en"><menuchoice><guimenu>Right Click</guimenu>
<guisubmenu>Change Case</guisubmenu><guimenuitem>Title Case</guimenuitem></menuchoice></para></entry>
          <entry><para>تغيير أول محرف من كل كلمة إلى الحالة العلوية.</para></entry>
          <entry><para><literal>this text</literal> تصبح <literal>This Text</literal></para></entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>
</sect2>

<sect2 id="xed-document-statistics-plugin" xreflabel="Document Statistics">
<title>ملحق إحصاءات المستند</title>
	<para>الملحق <application>إحصاءات المستند</application> يعد عدد الأسطر، والحروف، والمحارف مع الماسفات، والمحارف بدون المسافات، والبايتات في الملف الحالي. الملحق يعرض النتائج في حوار <guilabel>إحصاءات المستند</guilabel>. لاستخدام احصاءات المستند، أدِ الخطوات التالية:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Document Statistics</guimenuitem> </menuchoice> to display the <guilabel>Document Statistics</guilabel> dialog. The <guilabel>Document Statistics</guilabel> dialog displays the following information about the file:
				</para>
		      <itemizedlist>
		      <listitem><para>عدد الأسطر في المستند الحالي.</para>
		      </listitem>
		      <listitem><para>عدد الكلمات في المستند الحالي.</para>
		      </listitem>
		      <listitem><para>عدد المحارف -بما في ذلك المسافات- في المستند الحالي.</para>
		      </listitem>
		      <listitem><para>عدد المسافات -لا تتضمن المسافات- في المستند الحالي.</para>
		      </listitem>
		      <listitem><para>عدد البايتات في المستند الحالي.</para>
		      </listitem>
		      </itemizedlist>
		  </listitem>
		  <listitem><para>بإمكانك الاستمرار في تحديث ملف <application>محرر النصوص</application> أثناء فتح حوار <guilabel>إحصاءات المستند</guilabel>. لإنعاش محتويات حوار <guilabel>إحصاءات المستند</guilabel>، انقر <guibutton>حدّث</guibutton>.</para>
		  </listitem>
		</orderedlist>
</sect2>

<sect2 id="xed-file-browser-plugin" xreflabel="File Browser">
  <title>ملحق متصفح الملفات</title>
  <para lang="en">The <application>File Browser</application> Plugin shows your files and folders in the side pane, allowing you to quickly open files.</para>
  <para lang="en">To view the File Browser, choose <menuchoice><guimenu>View</guimenu> <guimenuitem>Side Pane</guimenuitem> </menuchoice> and then click on the tab showing the File Browser icon at the top of the side pane.</para>
  <sect3 id="xed-file-browser-plugin-browsing">
    <title>تصفح ملفاتك</title>
    <para lang="en">The File Browser tab initially shows your file manager bookmarks. To browse the contents of any item, double-click it.</para>
    <para lang="en">To show a parent folder, choose from the drop-down list, or press the up arrow on the File Browser's toolbar.</para>
    <para lang="en">To show the folder that contains the document you are currently working on, right-click in the file list and choose <guimenuitem>Set root to active document</guimenuitem>.</para>
  </sect3>
  <sect3 id="xed-file-browser-plugin-open">
    <title>فتح ملف</title>
    <para lang="en">To open a file in <application>xed</application>, double-click it in the file list.</para>
  </sect3>
  <sect3 id="xed-file-browser-plugin-create">
    <title>إنشاء ملفات ومجلدات جديدة</title>
    <para lang="en">To create a new, empty text file in the current folder shown in the browser, right-click in the file list and choose <guimenuitem>New File</guimenuitem>.</para>
    <para lang="en">To create a new folder in the current folder shown in the browser, right-click in the file list and choose <guimenuitem>New Folder</guimenuitem>.</para>
    </sect3>
</sect2>

<sect2 id="xed-bracket-completion-plugin" xreflabel="Bracket Completion">
<title lang="en">Bracket Completion Plugin</title>
	<para lang="en">The <application>Bracket Completion</application> plugin automatically adds closing bracket if opening bracket is typed.  The list of enclosing character types (depending on the language) may include: </para>
	<para lang="en"><textobject> ()  {}  []  ""  ''  &lt;&gt; `` </textobject> </para>
</sect2>

<sect2 id="xed-insert-date-time-plugin" xreflabel="Insert Date/Time">
<title>ملحق إدراج التاريخ/الوقت</title>
	<para lang="en">The <application>Insert Date/Time</application> plugin inserts the current date and time into a document. To use the Insert Date/Time plugin, perform the following steps:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>. </para>
        <para lang="en">If you have not configured the Insert Date/Time plugin to automatically insert the date/time without prompting you for the format, <application>xed</application> displays the <guilabel>Insert Date and Time</guilabel> dialog. Select the appropriate date/time format from the list. Click <guibutton>Insert</guibutton> to close the <guilabel>Insert Date and Time</guilabel> dialog. <application>xed</application> inserts the date/time at the cursor position in the current file. </para>
				<para lang="en">If you have configured <application>xed</application> to use one particular date/time format, the <guilabel>Insert Date and Time</guilabel> dialog is not displayed. The date/time is automatically entered at the cursor position in the current file. </para>
		  </listitem>
		</orderedlist>

<sect3 id="xed-date-time-configure">
<title>اضبط الملحق إدراج التاريخ/الوقت</title>
<para>لضبط الملحق إدراج التاريخ/الوقت، شكّل الخطوات التالية:</para>
		<orderedlist>
		  <listitem> <para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>.
                    </para>
		  </listitem>
		  <listitem> <para>انتق اللسان <guilabel>الملحقات</guilabel>.</para>
		  </listitem>
		  <listitem> <para>انتقِ الملحق <guilabel>إدراج التاريخ/الوقت</guilabel>.</para>
		  </listitem>
		  <listitem> <para lang="en">Click <guibutton>Configure Plugin</guibutton> to display the <guilabel>Configure insert date/time plugin</guilabel> dialog.
                    </para>
		  </listitem>
		  <listitem> <para>انتقِ واحد من الخيارات، كالتالي:</para>
		      <itemizedlist>
		      <listitem><para lang="en">To specify the date/time format each time you insert the date/time, select the <guilabel>Prompt for a format</guilabel> option.
		                </para>
		      </listitem>
		      <listitem><para lang="en">To use the same <application>xed</application>-provided date/time format each time you insert the date/time, select the <guilabel>Use the selected format</guilabel> option, then select the appropriate format from the list. When you select this option, <application>xed</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
		                </para>
		      </listitem>
		      <listitem><para lang="en">To use the same customized date/time format each time you insert the date/time, select the <guilabel>Use custom format</guilabel> option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see <ulink url="man:strftime" type="man"><citerefentry><refentrytitle>strftime</refentrytitle><manvolnum>3</manvolnum></citerefentry></ulink>. When you select this option, <application>xed</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
		                </para>
		      </listitem>
		      </itemizedlist>
		  </listitem>
		  <listitem> <para lang="en">Click <guibutton>OK</guibutton> to close the <guilabel>Configure insert date/time plugin</guilabel> dialog.
                    </para>
		  </listitem>
		  <listitem> <para>لإغلاق حوار <guilabel>التفضيلات</guilabel>، انقر <guibutton>أغلق</guibutton>.</para>
		  </listitem>
		</orderedlist>
</sect3>
</sect2>

<sect2 id="xed-modelines-plugin" xreflabel="Modelines">
  <title lang="en">Modelines Plugin</title>
    <para lang="en">The <application>Modelines</application> plugin allows you to set  preferences for individual documents. A <firstterm>modeline</firstterm> is a line of text at the start or end of the document with settings that <application>xed</application> recognises.</para>
    <para lang="en">Preferences set using modelines take precedence over the ones specified in the preference dialog.</para>
    <para>تستطيع ضبط التفضيلات التالية</para>
    <itemizedlist>
      <listitem>
        <para>عرض اللسان</para>
      </listitem>
      <listitem>
        <para lang="en">Indent width</para>
      </listitem>
      <listitem>
        <para lang="en">Insert spaces instead of tabs</para>
      </listitem>
      <listitem>
        <para>لف النص</para>
      </listitem>
      <listitem>
        <para lang="en">Right margin width</para>
      </listitem>
    </itemizedlist>

    <para lang="en">The <application>Modelines</application> plugin supports a subset of the options used by other text editors <application>Emacs</application>, <application>Kate</application> and <application>Vim</application>.</para>

    <sect3 id="xed-modelines-plugin-emacs">
      <title lang="en">Emacs Modelines</title>
      <para lang="en">The first two lines of a document are scanned for <application>Emacs</application> modelines.</para>
      <para lang="en">The <application>Emacs</application> options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the <ulink type="http" url="http://www.gnu.org/software/emacs/manual/html_node/emacs/index.html">GNU Emacs Manual</ulink>.</para>
    </sect3>
    <sect3 id="xed-modelines-plugin-kate">
      <title lang="en">Kate Modelines</title>
      <para lang="en">The first and last ten lines of a document are scanned for <application>Kate</application> modelines.</para>
      <para lang="en">The <application>Kate</application> options for tab-width, indent-width, space-indent, word-wrap and word-wrap-column are supported. For more information, see the <ulink type="http" url="http://www.kate-editor.org">Kate website</ulink>.</para>
    </sect3>
    <sect3 id="xed-modelines-plugin-vim">
      <title lang="en">Vim Modelines</title>
      <para lang="en">The first and last three lines of a document are scanned for <application>Vim</application> modelines.</para>
      <para lang="en">The <application>Vim</application> options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the <ulink type="http" url="http://vimdoc.sourceforge.net/htmldoc/options.html#modeline">Vim website</ulink>.</para>
    </sect3>
</sect2>

<sect2 id="xed-trailers-plugin" xreflabel="Remove Trailing Spaces">
<title lang="en">Remove Trailing Spaces</title>
  <para lang="en">This plug-in eliminates any trailing spaces from lines of the document.  Trailing spaces would be considered extraneous in almost all cases.  The elimination occurs upon any saving of the document.</para>
</sect2>

<sect2 id="xed-sort-plugin" xreflabel="Sort">
<title>ملحق الترتيب</title>
	<para lang="en">The <application>Sort</application> plugin arranges selected lines of text into alphabetical order.</para>
              <para>لاستخدام ملحق الترتيب، أدِ الاعدادات التالية:</para>
		<orderedlist>
		  <listitem>
		    <para>انتقِ سطور النص التي تريد ترتيبها.</para>
		  </listitem>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Sort</guimenuitem> </menuchoice>.
				</para>
				<note lang="en">If no lines are selected, the entire document will be sorted.</note>
		  </listitem>
		</orderedlist>
</sect2>

<sect2 id="xed-spell-checker-plugin" xreflabel="Spell Checker">
<title>ملحق المدقق الإملائي</title>
	<para lang="en">The <application>Spell Checker</application> plugin checks the spelling in the selected text. You can configure <application>xed</application> to check the spelling automatically, or you can check the spelling manually, in the specified language. The language setting, and the autocheck spelling properties, apply per document. To use the Spell checker plugin, perform the following steps:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Set Language</guimenuitem> </menuchoice> to display the <guilabel>Set language</guilabel> dialog. Select the appropriate language from the list. Click <guibutton>OK</guibutton> to close the <guilabel>Set language</guilabel> dialog.
				</para>
		  </listitem>
		  <listitem><para lang="en">To check the spelling automatically, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice>. To unset the automatic spell check, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice> again. When automatic spell checking is set, an icon is displayed beside the <guimenuitem>Autocheck Spelling</guimenuitem> menu item. Automatic spell checking is unset by default, each time <application>xed</application> starts.</para>
                            <para lang="en">Unknown spellings are displayed in a different color, and underlined. Right-click on an unknown spelling, then select <guimenu>Spelling Suggestions</guimenu> from the popup menu:
				</para>
		    <itemizedlist>
		      <listitem><para lang="en">To replace the unknown spelling with another spelling in the list, select the replacement spelling from the <guimenu>Spelling Suggestions</guimenu> popup menu.
				</para>
		      </listitem>
		      <listitem><para lang="en">To add the unknown spelling to your personal dictionary, select <menuchoice> <guimenu>Spelling Suggestions</guimenu> <guimenuitem>Add</guimenuitem> </menuchoice>.
				</para>
		      </listitem>
		      <listitem><para lang="en">To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select <menuchoice> <guimenu>Spelling Suggestions</guimenu> <guimenuitem>Ignore All</guimenuitem> </menuchoice>. The unknown word is ignored in the current <application>xed</application> session only.
				</para>
		      </listitem>
		    </itemizedlist>
		  </listitem>
		  <listitem><para lang="en">To check the spelling manually, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Check Spelling</guimenuitem> </menuchoice>.
				</para>
				<para lang="en">If there are no spelling errors, an <guilabel>Information</guilabel> dialog displays a message stating that the document does not contain misspelled words. Click <guibutton>OK</guibutton> to close the <guilabel>Information</guilabel> dialog.
				</para>
				<para lang="en">If there are spelling errors, the <guilabel>Check Spelling</guilabel> dialog is displayed:
				</para>
		    <itemizedlist>
		      <listitem><para lang="en">The <guilabel>Misspelled word</guilabel> is displayed at the top of the dialog.
				</para>
		      </listitem>
		      <listitem><para lang="en">A suggested known spelling is displayed in the <guilabel>Change to</guilabel> text box. You can replace this with another known spelling by selecting a spelling from the <guilabel>Suggestions</guilabel> list, or you can enter text directly into the <guilabel>Change to</guilabel> text box.
				</para>
		      </listitem>
		      <listitem><para lang="en">To check the spelling of the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Check Word</guibutton>. If this is a known word, the <guilabel>Suggestions</guilabel> list is replaced with the text <literal>(correct spelling)</literal>. If the word is not known, new entries appear in the <guilabel>Suggestions</guilabel> list.
				</para>
		      </listitem>
		      <listitem><para lang="en">To ignore the current occurrence of the unknown word, click <guibutton>Ignore</guibutton>. To ignore all occurrences of the unknown word, click <guibutton>Ignore All</guibutton>. The unknown word is ignored in the current <application>xed</application> session only.
				</para>
		      </listitem>
		      <listitem><para lang="en">To change the current occurrence of the unknown word to the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Change</guibutton>. To change all occurrences of the unknown word to the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Change All</guibutton>.
				</para>
		      </listitem>
		      <listitem><para lang="en">To add the unknown word to your personal dictionary, click <guibutton>Add word</guibutton>.
				</para>
		      </listitem>
		      <listitem><para lang="en">To close the <guilabel>Check Spelling</guilabel> dialog, click <guibutton>Close</guibutton>.
				</para>
		      </listitem>
		    </itemizedlist>
		  </listitem>
		</orderedlist>
</sect2>

<sect2 id="xed-tag-list-plugin" xreflabel="Tag List">
<title>ملحق وسم القائمة</title>
	<para lang="en">The <application>Tag List</application> plugin allows you to insert common tags  (i.e. pieces of text) from a list in the side pane. This is most useful probably for XML or HTML types of files where sets of tags are used to identify formatting for different sections of text.  Such tags are typing intensive.   A number of standard tag lists come by default with xed, and other tag lists can be configured.  Configuration is done by creating a file in the user's configuration directory (~/.config/xed/taglist/).  The file suffix is ".tags". The format of this type of XML file is beyond the scope of this help document, but example tag list files can be found in the installation files (e.g. .../share/xed/plugins/taglist/*)</para>
  <para lang="en">To use the Tag List plugin, perform the following steps:</para>
		<orderedlist>
		  <listitem><para lang="en">Choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Side Pane</guimenuitem> </menuchoice>.
				</para>
		  </listitem>
		  <listitem>
		    <para lang="en">By default, the side pane shows a tab containing a list of open documents. Click on the tab showing a + icon at the top of the side pane to show the tag list tab.</para>
		  </listitem>
		  <listitem><para lang="en">Select the appropriate tag category from the drop-down list. For example, <guilabel>HTML - Tags</guilabel>.
				</para>
		  </listitem>
		  <listitem><para lang="en">Scroll through the tag list to find the required tag.
				</para>
		  </listitem>
		  <listitem><para lang="en">To insert a tag at the cursor position in the current file, double-click on the tag in the tag list. You can also insert a tag as follows:</para>
		    <itemizedlist>
		      <listitem><para lang="en">To insert a tag in the current file and change the focus from the side pane to the display area, press <keycap>Return</keycap>.
				</para>
		      </listitem>
		      <listitem><para lang="en">To insert a tag in the current file and maintain the focus on the <guilabel>Tag list plugin</guilabel> window, press <keycombo><keycap>Shift</keycap><keycap>Return</keycap></keycombo>.
				</para>
		      </listitem>
		    </itemizedlist>
		  </listitem>
		</orderedlist>
</sect2>

<sect2 id="xed-word-complete-plugin" xreflabel="Word Completion">
<title lang="en">Word Completion Plugin</title>
  <para lang="en">This will try to guess the remainder of a word after the first few characters have been typed. A drop-down box will appear with the word choices.  Select the desired word using the a mouse click, or arrow keys.</para>
</sect2>

</sect1>

</article>
