gedit.sgml

一个简单的文本编辑器

    </sect2>

    <sect2 id="email">
      <title>The Email Plugin</title>

      <figure id="email-fig">
	<title>Email Plugin</title>
	<screenshot>
	  <screeninfo>email plugin</screeninfo>
	  <graphic fileref="images/email" format="png"
		   srccredit="Eric Baudais">
	  </graphic>
	</screenshot>
      </figure>

      <para>
	The <guimenuitem>email</guimenuitem> plugin lets you send the text file you are editing as the body of 
	the email.  The subject will automatically be the filename, but can be changed in the dialog.  
	The <guilabel>From:</guilabel> text window will automatically have the email address provided by 
	your system.  You can also change it, if you wish the receiving party to send a reply to a different 
	email address.  You need to enter the receiver's email address in the <guilabel>To:</guilabel> 
	text window.  If the path to your sendmail compatible mailer
	<footnote>
	  <para>
	    A sendmail compatible mailer is a program that delivers your email to the correct server on the 
	    internet, so your email will reach its destination.  The program uses SMTP 
	    (Simple Mail Transfer Protocol) to send your email.  The distinction between a sendmail 
	    compatible mailer and a non-sendmail compatible mailer is the command line arguments.  
	    A sendmail compatible mailer will have the same command line arguments as 
	    <application>sendmail</application>, even if the way it handles everything else is completely 
	    different.
	  </para>
	</footnote>
	is not displayed at the bottom 
	of the dialog, you can change it by clicking the <guibutton>Change</guibutton> button.
	<figure id="mta-fig">
	  <title>Change sendmail directory</title>
	  <screenshot>
	    <screeninfo>change sendmail</screeninfo>
	    <graphic fileref="images/mta" format="png"
		   srccredit="Eric Baudais">
	    </graphic>
	  </screenshot>
	</figure>
	You then need to enter the correct path of your sendmail compatible mailer, for your system, 
	in the text window or click the 
	<guibutton>Browse</guibutton> button to find the sendmail compatible mailer on your system.  
	If you do not have a sendmail compatible mailer, you need one to use the email plugin.  
	After you have all the correct fields filled in, press the <guibutton>OK</guibutton> to send 
	the email or press the <guibutton>Cancel</guibutton> to not send the email.
      </para>
    </sect2>

    <sect2 id="time">
      <title>The Insert Time Plugin</title>

      <para>
	The <guimenuitem>insert time</guimenuitem> plugin puts the date and time into the document.  It 
	uses the <command>date</command> command and inserts the output into the text.
      </para>
    </sect2>

    <sect2 id="hello">
      <title>The Hello World Plugin</title>

      <para>
	The <guimenuitem>hello world</guimenuitem> plugin puts the text <quote>Hello World</quote> into 
	the document.  It is meant to be a template for all the other plugins.  If you are interested in 
	writing a plugin for <application>gedit</application>, take a look at the source code for the 
	<guimenuitem>hello world</guimenuitem> plugin and contact the <link linkend="authors">maintainers</link>
	, so your work isn't duplicated.
      </para>
    </sect2>
<!--
    <sect2 id="reverse">
      <title>The Reverse Plugin</title>

      <para>
	This plugin is still in development.  Write about it when it is done.
      </para>
    </sect2>-->

    <sect2 id="shell">
      <title>The Shell Output Plugin</title>

      <figure id="shell-fig">
	<title>Shell Output Plugin</title>
	<screenshot>
	  <screeninfo>shell output plugin</screeninfo>
	  <graphic fileref="images/shell" format="png"
		   srccredit="Eric Baudais">
	  </graphic>
	</screenshot>
      </figure>

      <para>
	The <guimenuitem>shell output</guimenuitem> plugin executes the command in the directory that is 
	displayed and puts the output in the <systemitem>Main Window</systemitem>.The shell output 
	plugin is designed for inserting text resulting from the execution of a console based command.  
	However, <application>gedit</application> will not stop you if you try to launch another 
	application, such as <application>gnumeric</application>.  So, should only execute commands 
	displaying text on the console and commands which are not interactive.
      </para>
      <para>
	The shell you are using 
	will stay the same for the shell output plugin.  So, if you use <application>bash</application> as your shell, 
	<application>gedit</application> will execute the command in <application>bash</application>.  This lets 
	you put output you would normally see in a console or terminal in the middle of the text file 
	you are editing.
      </para>
    </sect2>

  </sect1>

  <sect1 id="prefs-0">
    <title>Customization</title>

    <para>
      To change the application settings, select
      <guimenuitem>Preferences&hellip;</guimenuitem> from the
      <guimenu>Settings</guimenu> menu. This opens the
      <interface>Preferences</interface> dialog.
    </para>

    <para>
      You can make gedit your default editor.  The default editor will start when a 
      document opens, you need to edit, by another application.  To make 
      <application>gedit</application> your default editor, enter <command>export</command> 
      EDITOR='gedit' in the terminal.  This will only change your 
      system settings until you reboot again.  To make the change permanent, edit your 
      <filename>.bash_profile</filename>, if you are using <application>bash</application>.  
      Add the line <quote><command>export</command> EDITOR='gedit'</quote> 
      to <filename>.bash_profile</filename>.  If you are using another shell, you need to find 
      out what file to change and change the environment variable $EDITOR to gedit.
    </para>

    <sect2 id="general">
      <title>General</title>
      
    <figure id="preferences-fig">
      <title>The Preferences Dialog with the General Tab Highlighted</title>
      <screenshot>
	<screeninfo>Preferences dialog with General tab</screeninfo>
	<graphic fileref="images/prefs-general" format="png"
		 srccredit="Eric Baudais">
	</graphic>
      </screenshot>
    </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>Appearance</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guibutton>Show Statusbar</guibutton> &mdash;
		    This option determines whether the status bar at the bottom of the 
		    <interface>Main Window</interface> is shown or hidden.  The status bar 
		    gives you a brief description of the various menu items or messages about 
		    what <application>gedit</application> is currently doing.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Set toolbar according to system settings</guibutton> &mdash;
		    This option displays the toolbar with the system settings for GNOME.  You can 
		    change the system settings for the toolbar in the 
		    <application>Control Center</application>. To change the system settings for 
		    GNOME, start the <application>Control Center</application>by selecting 
		    <guimenuitem>GNOME Control Center</guimenuitem> from the
		    <guisubmenu>Settings</guisubmenu> submenu of the <guimenu>Main
		    Menu</guimenu>.  Then select the <guisubmenu>Applications</guisubmenu> submenu 
		    from the <guimenu>User Interface</guimenu> menu.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Set toolbar to Icons only</guibutton> &mdash;
		    This option displays the toolbar with just the icons.  There is no text under 
		    each icon to tell you what it does.  The option overrides whatever you have 
		    selected for the toolbar behavior in the <application>Control Center</application>.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Set toolbar to Icons with text</guibutton> &mdash;
		    This option displays the toolbar with the explanatory text under each icon.
		    The option overrides whatever you have selected for the toolbar behavior 
		    in the <application>Control Center</application>.
		  </para>
		</listitem>
	      </itemizedlist>

	    </para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><guilabel>Editor Behavior</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">

		<listitem>
		  <para>
		    <guibutton>Enable Auto-indent</guibutton> &mdash;
		    This option turns on the auto-indent ability in <application>gedit</application>.  
		    Auto-indent automatically indents the text at the same place in the line as the 
		    text in the previous line.  Auto-indent is very useful when you are writing 
		    configuration files, scripts, code, etc&hellip;  If you want to write paragraphs 
		    of text, the auto-indent function can be a hassle.
		  </para>
		</listitem>
<!--            ***This option is deprecated or just not around.***
		<listitem>
		  <para>
		    <guibutton>Enable Wordwrap</guibutton> &mdash;
		    This option turns on wordwrap.  Wordwrap automatically puts the text you type on the next 
		    line, if your text exceeds the visible area in the <interface>text window</interface>.
		  </para>
		</listitem>-->

	      </itemizedlist>

	    </para>
	  </listitem>
	</varlistentry>

      </variablelist>
    </sect2>

    <sect2 id="documents">
      <title>Documents</title>
      
    <figure id="documents-fig">
      <title>The Preferences Dialog with the Documents Tab Highlighted</title>
      <screenshot>
	<screeninfo>Preferences dialog with Documents tab</screeninfo>
	<graphic fileref="images/prefs-documents" format="png"
		 srccredit="Eric Baudais">
	</graphic>
      </screenshot>
    </figure>

      <variablelist>
	<varlistentry>
	  <term><guilabel>MDI (Multiple Document Interface)</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guilabel>Mode:</guilabel> &mdash;
		    This option specifies the way <application>gedit</application> displays the 
		    <interface>Main Window</interface> and how it opens new documents.  The option 
		    determines the user interface you like to use for the <interface>Main Window</interface>
		    There are 4 types of modes <application>gedit</application> can use.  They 
		    are the notebook, toplevel, modal, and default modes.
		  </para>

		  <para>
		    The notebook style looks strikingly similar to the 
		    <guimenuitem>Preferences&hellip;</guimenuitem> dialog.  The most notable thing about 
		    this style is the tabs at the top of the <interface>Main Window</interface>.  The 
		    highlighted tab is the document you are currently viewing.  To change the document 
		    to another open document, just click on the cooresponding tab.  In the notebook 
		    style you cannot view multiple documents at the same time.  Only the current 
		    document can be seen.
		  </para>

		  <para>
		    The toplevel style opens a new occurance of <application>gedit</application> for 
		    each document opened.  The windows are stacked one on top of another, so they 
		    completely overlap.  From this position, you can move the multiple 
		    <application>gedit</application> windows around to your liking.  This lets you 
		    see more than one document, or different positions in the same document.
		  </para>

		  <para>
		    The modal style will only open one occurance of gedit, no matter how many documents 
		    you open.  You have to use the <guimenu>Documents</guimenu> menu to change between 
		    different documents.  The default style is the same style as the modal style.  This 
		    is a change from previous versions of <application>gedit</application>.  The modal 
		    style is a very plain style for <application>gedit</application>.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guilabel>Notebook Tab Position:</guilabel> &mdash;
		    This option changes the place the tabs for the notebook style are located.  
		  </para>
		</listitem>
	      </itemizedlist>

	    </para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><guilabel>Undo</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guilabel>Set limit on undo levels to:</guilabel> &mdash;
		    This option sets the number of times you can undo a mistake.  So, if 
		    you set the limit to 5 undo levels, then you can only use the undo button 
		    five times.  If you make a lot of mistakes, like me, you might want to set 
		    this level higher than the default of 5 undo levels.
		    <note>
		      <para>
			Users with low memory, under 16 MB, should set the number of undo levels 
			lower because <application>gedit</application> stores each 
			command into memory to the undo level limit.  So, if you set the undo 
			level limit to 50, then <application>gedit</application> will store 
			up to 50 commands in your main memory.
		      </para>
		    </note>
		  </para>
		</listitem>
	      </itemizedlist>

	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="fonts">
      <title>Fonts/Colors</title>