gedit.sgml

一个简单的文本编辑器

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

      <variablelist>
	<varlistentry>
	  <term><guilabel>Fonts</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guilabel>Default Font</guilabel> &mdash;
		    This option changes the font used in <application>gedit</application>.
		  </para>
		</listitem>
	      </itemizedlist>

	    </para>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guilabel>Colors</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guilabel>Background:</guilabel> &mdash;
		    This option lets you choose the background color in <application>gedit</application>.  
		    This is the background color of the <interface>Main Window</interface>.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guilabel>Foreground:</guilabel> &mdash;
		    This option lets you choose the foreground color in <application>gedit</application>. 
		    This is the background color of the <interface>Main Window</interface>.
		  </para>
		</listitem>
	      </itemizedlist>

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

    <sect2 id="printing">
      <title>Printing</title>

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

      <variablelist>
	<varlistentry>
	  <term><guilabel>Printing</guilabel></term>

	  <listitem>
	    <para>
	      This section contains:

	      <itemizedlist mark="opencircle">
		<listitem>
		  <para>
		    <guibutton>Add header</guibutton> &mdash;
		    This option adds a header to each page you print in <application>gedit</application>.  
		    As of <application>gedit</application> version 0.8.0, you cannot configure 
		    the header.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Enable word wrapping</guibutton> &mdash;
		    This option turns on wordwrap.  Wordwrap automatically puts the text you typed on the next 
		    line, if you exceed the page's width you select in the <link linkend="paper">Paper tab 
		    of the Preferences dialog</link>.  So, you do not have to explicitly press the 
		    <keysym>return</keysym> key for each line you wanted printed.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Print line numbers every:</guibutton> &mdash;
		    This option prints the line number of the file.  You also have to select how often 
		    you want to line numbers printed.  The default is to print the line number every five 
		    lines.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Portrait</guibutton> &mdash;
		    This option selects to print the page using the portrait style.  The portrait style 
		    has the text printed across the smallest side of the paper.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guibutton>Landscape</guibutton> &mdash;
		    This option selects to print the page using the portrait style.  The portrait style 
		    has the text printed across the largest side of the paper.
		  </para>
		</listitem>
	      </itemizedlist>

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

    <sect2 id="paper">
      <title>Paper</title>

    <figure id="paper-fig">
      <title>The Preferences Dialog with the Paper Tab Highlighted</title>
      <screenshot>
	<screeninfo>Fonts/Colors dialog with Paper tab</screeninfo>
	<graphic fileref="images/prefs-paper" format="png"
		 srccredit="Eric Baudais">
	</graphic>
      </screenshot>
    </figure>
      
      <para>
	This section contains:
	
	<itemizedlist mark="opencircle">
	  <listitem>
	    <para>
	      <guilabel>Paper:</guilabel> &mdash;
	      This option selects the type of paper you will use to print the document.  
	      The <guilabel>width</guilabel> and <guilabel>height</guilabel> boxes will 
	      change automatically for the correct paper size.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <guilabel>Width:</guilabel> &mdash;
	      This option selects the width of the paper you will use to print the document.
	      To the right of the <guilabel>width</guilabel> box is another box you can use 
	      to change the units the paper is measured in for the <guilabel>width</guilabel> 
	      and <guilabel>height</guilabel> boxes.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <guilabel>Height:</guilabel> &mdash;
	      This option selects the height of the paper you will use to print the document.
	      To the right of the <guilabel>height</guilabel> box is the units the height 
	      of the paper is measured in.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <guibutton>Set System Paper Size</guibutton> &mdash;
	      This option sets the paper size in the <guilabel>width</guilabel> and 
	      <guilabel>height</guilabel> boxes to the system paper size.  The system 
	      paper size is determined by the number in the environment variable $PAPERCONF 
	      or in the file <filename>paperconf</filename>.
	    </para>
	  </listitem>
	</itemizedlist>

      </para>
    </sect2>
  </sect1>

  <sect1 id="menus">
    <title>Menus</title>

    <para>
      In <application>gedit</application> there are three different type of menus. The 
      <interface>menu bar</interface> contains all the commands, options, and plug-ins. 
      The <interface>toolbar</interface> contains selected commands the user uses the 
      most.  The <interface>right click menu</interface> in the <interface>text window</interface>, 
      contains the commands that are useful while editing a file.  Only the <interface>menu bar</interface> 
      is described in this section because it is so large.  The
      <interface>toolbar</interface> and <link linkend="pop-up-menu"><interface>
      right click menu</interface></link> are talked about in other sections of <application>
      gedit's</application> manual.
    </para>

    <sect2 id="menubar">
      <title>Menu Bar</title>
      <para>
	The <interface>menu bar</interface> can be moved around the 
	<interface>desktop</interface>.  When you click on the far left side 
	of the <interface>menu bar</interface>, on the raised dotted portion, you 
	can drag
	<footnote>
	  <para>
	    Dragging refers to the action in which you click on an object, with your mouse, 
	    and move the mouse pointer without releasing the previously clicked button.  
	    You can then release the mouse button and the object you were moving with the 
	    mouse will stay on the desktop where you released the mouse button.  This 
	    action is generally called <quote>drag and drop.</quote>
	  </para>
	</footnote>
	the menu bar with your mouse and move it anywhere on your desktop.  The 
	<interface>menu bar</interface> can also snap into place on all four sides 
	of the <interface>Main Window</interface>, if you place your mouse close 
	to the edge of the <interface>Main Window</interface>.  The menu bar's 
	default position is located at the top of the <interface>Main Window</interface> 
	and contains the following menus:
      </para>

      <variablelist>
	
	<varlistentry>
	  <term><guimenu>File</guimenu></term>

	  <listitem>
	    <para>
	      The menu contains:

	      <itemizedlist mark="opencircle">

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>New</guimenuitem>
		    </menuchoice> &mdash; 
		    This item opens a new file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keysym>F3</keysym>
		      </shortcut>
		      <guimenuitem>Open&hellip;</guimenuitem>
		    </menuchoice> &mdash; 
		    This item brings up the <interface>Open File&hellip;</interface> dialog.  From there 
		    you can open an existing file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <shortcut>
			<keysym>Ctl-S</keysym>
		      </shortcut>
		      <guimenuitem>Save</guimenuitem>
		    </menuchoice> &mdash; 
		    This item saves the current file, if the file was previously saved, or brings 
		    up the <interface>Save As&hellip</interface> dialog to save the file.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>Save All</guimenuitem>
		    </menuchoice> &mdash; 
		    This item saves all the files that are open in <application>gedit</application>.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>Save As&hellip;</guimenuitem>
		    </menuchoice> &mdash; 
		    This item brings up the <interface>Save As&hellip</interface> dialog to save the selected file 
		    in <application>gedit</application>.  You should use this command if you want to save the 
		    file under a different name.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>Revert</guimenuitem>
		    </menuchoice> &mdash; 
		    This item discards all changes you made to your unsaved file and opens the 
		    original file in the <interface>Main Window</interface>.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>1.</guimenuitem>
		    </menuchoice> &mdash; 
		    This part of the <guimenu>File</guimenu> menu shows the four most recent 
		    files you opened with <application>gedit</application>.  When you click on 
		    one of the files displayed, that specific file is opened.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <menuchoice>
		      <guimenuitem>Print</guimenuitem>
		    </menuchoice> &mdash; 

		    <figure id="print-dialog-fig">
		      <title>Print Document Dialog</title>
		      <screenshot>
			<screeninfo>Print Document dialog</screeninfo>
			<graphic fileref="images/print" format="png"
				 srccredit="Eric Baudais">
			</graphic>
		      </screenshot>
		    </figure>

		      This item brings up the <interface>Print Document</interface> dialog.  
		      The <interface>Print Document</interface> dialog is divided into two 
		      parts: the <guilabel>Select printer</guilabel> section and the 
		      <guilabel>Print Range</guilabel> section.
		    </para>

		    <para>
		      The <guilabel>Select printer</guilabel> section lets you specify whether 
		      the file will be printed to a printer or printed to a pre-press 
		      <footnote>
		        <para>