<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="plugin-color-picker" xml:lang="ar">

  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-additional-plugins"/> 
    <revision version="3.4" date="2013-02-24" status="review"/>

    <credit type="author">
      <name>Jim Campbell</name>
      <email its:translate="no">jwcampbell@gmail.com</email>
    </credit>

    <desc>Pick a color from a dialog and insert its hexadecimal representation.</desc>
  </info>

  <title>Color Picker</title>

  <p>The <app>Color Picker</app> plugin helps you to insert the character codes
  that represent a certain color. This can make it easier to choose and use the
  correct color in your programs.</p>
  
  <p>To enable the color picker plugin, select
  <guiseq><gui style="menu">gedit</gui><gui style="menuitem">Preferences</gui>
  <gui>Plugins</gui><gui>Color Picker</gui></guiseq>.</p>
  
  <steps>
    <title>To open and use the color picker:</title>
    <item>
      <p>Place your cursor at the point in your document where you want to
      insert the color code.</p>
    </item>
    <item>
      <p>Select <guiseq><gui>Tools</gui><gui>Pick Color…</gui></guiseq>.  The
      color picker dialog will appear.</p>
    </item>
    <item>
      <p>Click on the desired color in the color picker window.</p>
    </item>
    <item>
      <p>The appropriate color code will be inserted where you had placed your
      cursor.</p>
    </item>
    <item>
      <p>To close the <app>color picker</app>, click <gui>Close</gui>.</p>
    </item>
  </steps>

  <!--TODO: Update this section for the "Custom" values -->
  <note style="tip">
    <p>You can make fine-grained adjustments to the color by adjusting the
    values for Hue, Saturation, Value, Red, Green, or Blue.</p>
    <p>Additionally, you can save colors by right-clicking on any of the
    colored boxes in the color picker, and selecting <gui>Save color
    here</gui>. This will make it easier to insert commonly-used colors
    later.</p>
  </note>     

</page>