<copyright its:translate="no">

<year>2015-2020</year>

</copyright>

<copyright its:translate="no">

<year>2007</year>

</copyright>

<copyright its:translate="no">

<year>2002</year>

<year>2003</year>

<year>2004</year>

</copyright>

<copyright its:translate="no">

<year>2000</year>

</copyright>

<publisher>

<affiliation>

<orgname its:translate="yes">GNOME Documentation Project</orgname>

</affiliation>

</author>

<othercredit role="other">

<personname>

<imageobject>

<imagedata fileref="figures/pluma_window.png" format="PNG"/>

</imageobject>

<phrase its:translate="yes">Shows pluma main window.</phrase>

</textobject>

</mediaobject>

<para>The <application>pluma</application> window contains the following elements:</para>

<variablelist>

<term>Menubar</term>

<listitem>

<para>The menus on the menubar contain all the commands you need to work with files in <application>pluma</application>.</para>

</listitem>

</varlistentry>

<term>Toolbar</term>

<listitem>

<para>The toolbar contains a subset of the commands that you can access from the menubar.</para>

</listitem>

</varlistentry>

<term>Display area</term>

<listitem>

<para>The display area contains the text of the file that you are editing.</para>

</listitem>

</varlistentry>

<term>Statusbar</term>

<listitem>

<para>The statusbar displays information about current <application>pluma</application> activity and contextual information about the menu items. The statusbar also displays the following information:</para>

</itemizedlist>

</listitem>

</varlistentry>

<term>Side Pane</term>

<listitem>

<para>The side pane displays a list of open documents, and other information depending on which plugins are enabled.</para>

<para>By default, the side pane is not shown. To show it, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Side Pane</guimenuitem> </menuchoice>.</para>

</listitem>

</varlistentry>

<term>Bottom Pane</term>

<listitem>

<para>The bottom pane is used by programming tools such as the <application>Python Console</application> plugin to display output.</para>

<info>

<title>Finding Text</title>

</info>

<para>To search a file for a string of text, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<listitem>

</menuchoice> to display the <guilabel>Find</guilabel> dialog.</para>

</listitem>

<listitem>

<para>Click <guibutton>Find</guibutton> to search the file for the first occurrence of the string after your current cursor position. If <application>pluma</application> finds the string, the application selects first occurrence of the string. Other occurrences of the string are highlighted.</para>

</listitem>

<listitem>

</menuchoice>.</para>

</listitem>

</orderedlist>

</menuchoice>.</para>

</menuchoice>.</para>

<para>Refer to the <link xlink:href="man:pcrepattern"> <citerefentry> <refentrytitle>pcrepattern</refentrytitle> <manvolnum>3</manvolnum> </citerefentry> </link> for more information about the syntax and the semantics of the regular expressions supported on <guilabel>Find</guilabel> dialog.</para>

</section>

<info>

<title>Incremental Search</title>

</info>

<para>Incremental search highlights matching text in the document as you type it letter by letter. (This is similar to the search feature in several web browsers.)</para>

</menuchoice>. The search box appears at the top of the display area. </para>

<para>Begin typing, and text that matches will be highlighted in the document. The first instance after the cursor position is also selected.</para>

<para>To advance the selection to the next match while keeping the incremental search box open, press <keycombo>

<para>To search a file for a string, and replace the string with an alternative string, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<listitem>

</menuchoice> to display the <guilabel>Replace</guilabel> dialog.</para>

</listitem>

<listitem>

<info>

<title>Find and Replace Options</title>

</info>

<para>The <guilabel>Find</guilabel> dialog and the <guilabel>Replace</guilabel> dialog both have the following options:</para>

<itemizedlist>

<listitem>

<info>

<title>Special Characters</title>

</info>

<para>You can include the following escape sequences in the text to find or replace to represent special characters:</para>

<variablelist>

<varlistentry>

<title>General Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Select this option to print syntax highlighting. For more information about syntax highlighting, see <xref linkend="pluma-set-highlightmode"/>.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Select this option to include a header on each page that you print. You cannot configure the header. </para>

</listitem>

</varlistentry>

<term>

<guilabel>Line Numbers</guilabel>

</term>

<para>Use the <guilabel>Number every ... lines </guilabel> spin box to specify how often to print the line numbers, for example every 5 lines, every 10 lines, and so on.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable text wrapping</guilabel> option to wrap text onto the next line, at a character level, when you print a file. The application counts wrapped lines as one line for line numbering purposes.</para>

<title>Fonts</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Click on this button to select the font used to print the body text of a file.</para>

</listitem>

</varlistentry>

<term>

<guilabel>Line numbers</guilabel>

</term>

<para>Click on this button to select the font used to print line numbers.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Click on this button to select the font to use to print the headers and footers in a file. </para>

<title>Job Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Select one of the following options to determine how many pages to print:</para>

</itemizedlist>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use the <guilabel>Number of copies</guilabel> spin box to specify the number of copies of the file that you want to print.</para>

<info>

<title>Printer Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the printer to which you want to print the file.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the printer settings.</para>

<para>To configure the printer, click <guibutton>Configure</guibutton>. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select one of the following print destinations:</para>

</variablelist>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

<info>

<title>Paper Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the size of the paper to which you want to print the file.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this spin box to specify the height of the paper.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the orientation of the paper in the printer.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the page orientation.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the <guilabel>Preview</guilabel> area.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

</listitem>

</varlistentry>

</variablelist>

<info>

<title>Syntax Highlighting</title>

</info>

<para>Syntax highlighting makes source code easier to read by showing different parts of the text in different colors.</para>

<para><application>pluma</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 the following menu items:</para>

<variablelist>

</row>

<row valign="top">

<entry>

<para>Alt + Up</para>

</entry>

<entry>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable text wrapping</guilabel> option to have long lines of text flow into paragraphs instead of running off the edge of the text window. This avoids having to scroll horizontally</para>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Use the <guilabel>Tab width</guilabel> spin box to specify the width of the space that <application> pluma</application> inserts when you press the <keycap>Tab</keycap> key. </para>

</varlistentry>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable auto indentation</guilabel> option to specify that the next line starts at the indentation level of the current line. </para>

</varlistentry>

<varlistentry>

<term>

</term>

<listitem>

<para>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>

<info>

<title>Font &amp; Colors Preferences</title>

</info>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Use default theme font</guilabel> option to use the default system font for the text in the <application>pluma</application> text window. </para>

<info>

<title>Disabling a Plugin</title>

</info>

<para>A plugin remains enabled when you quit <application>pluma</application>. </para>

<para>To disable a <application>pluma</application> plugin, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<itemizedlist>

<listitem>

<para>

<xref linkend="pluma-document-statistics-plugin"/> shows the number of lines, words, and characters in the document.

</para>

</listitem>

</note>

</section>

<section xml:id="pluma-document-statistics-plugin">

<info>

<title>Document Statistics Plugin</title>

</info>

<para>To configure the Insert Date/Time plugin, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>.</para>

</listitem>

<para>Select the <guilabel>Plugins</guilabel> tab.</para>

</listitem>

<para>Select the <guilabel>Insert Date/Time</guilabel> plugin.</para>

</listitem>

<para>Click <guibutton>Configure Plugin</guibutton> to display the <guilabel>Configure insert date/time plugin</guilabel> dialog.</para>

</listitem>

<para>Select one of the options, as follows: </para>

<itemizedlist>

<listitem>

</listitem>

</itemizedlist>

</listitem>

<para>Click <guibutton>OK</guibutton> to close the <guilabel>Configure insert date/time plugin</guilabel> dialog.

</para>

</listitem>

<para>To close the <guilabel>Preferences</guilabel> dialog, click <guibutton>Close</guibutton>.</para>

</listitem>

</orderedlist>

<listitem>

<para>When your document is ready, save it.</para>

</listitem>

<para>You will see that any trailing whitespaces has been stripped after the document has been saved.</para>

</listitem>

</orderedlist>