<page xmlns="http://projectmallard.org/1.0/"
      type="topic"
      id="app-colors">

  <info>
    <revision version="0.1" date="2013-03-02" status="candidate"/>
    <link type="guide" xref="index#appearance"/>
    <link type="guide" xref="profile"/>

    <credit type="author copyright">
      <name>Sindhu S</name>
      <email>sindhus@live.in</email>
      <years>2013</years>
    </credit>
    <credit type="author copyright editor">
      <name>Ekaterina Gerasimova</name>
      <email>kittykat3756@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="copyright editor">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
      <years>2013</years>
    </credit>

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

    <desc>Change colors and backgrounds.</desc>

  </info>

  <title>Color schemes</title>

  <p>If you do not like the default <app>Terminal</app> theme, you may want to
  change the colors that are used for the text and background. You can use
  colors from your theme, select one of the presets or use a custom scheme.</p>

  <section id="system-theme">
    <title>Use colors from your system theme</title>

    <p>To use colors from the system theme:</p>

    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Profile Preferences</gui>
        <gui style="tab">Colors</gui></guiseq>.</p>
      </item>
      <item>
        <p>Check <gui style="checkbox">Use colors from system theme</gui>. The
        changes will be applied automatically.</p>
      </item>
    </steps>

  </section>

  <section id="built-in-scheme">
    <title>Built-in schemes</title>

    <p>You can choose one of the built-in color schemes: <gui>Black on light
    yellow</gui>, <gui>Black on white</gui>, <gui>Gray on black</gui>,
    <gui>Green on black</gui>, <gui>White on black</gui>, <gui>Solarized
    light</gui>, <gui>Solarized dark</gui>. To set any of the built-in
    schemes:</p>

    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Profile Preferences</gui>
        <gui style="tab">Colors</gui></guiseq>.</p>
      </item>
      <item>
        <p>Make sure that <gui style="checkbox">Use colors from system
        theme</gui> is unchecked. Choose the desired color scheme from
        <gui>Built-in schemes</gui>. Color scheme choices are applied
        automatically.</p>
        <note>
	  <p>Applications can choose to use a color from the palette rather
	  than the specified bold color.</p>
        </note>
      </item>
    </steps>

  </section>

  <section id="custom-scheme">
    <title>Custom color scheme</title>

    <p>You can use custom colors for the text and background in
    <app>Terminal</app>:</p>

    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Profile Preferences</gui>
        <gui style="tab">Colors</gui></guiseq>.</p>
      </item>
      <item>
        <p>Make sure that <gui style="checkbox">Use colors from system
        theme</gui> is unchecked. Select <gui>Custom</gui> from the
        <gui>Built-in schemes</gui> drop-down list.</p>
      </item>
      <item>
        <p>Click on the color sample next to the component you would like to
        change.</p>
      </item>
      <item>
        <p>Choose your desired color from the color sample and click
        <gui style="button">Select</gui>.</p>
        <p>If you wish to select a color from the color picker, click on
        <gui style="button">+</gui>. You can chose the desired color in the
	following ways:</p>
        <list>
          <item>
            <p>Input the hexadecimal color code in the input box.</p>
          </item>
          <item>
            <p>Drag the slider on the left to adjust the colors and click on
	    the desired color in the color selection area.</p>
          </item>
        </list>
	<p>Your changes will be saved automatically.</p>
      </item>
    </steps>

    <note style="tip">
      <p>You may also alter a color when you have chosen a built-in scheme by
      clicking on the color sample block. Once changed, your selection in the
      built-in scheme menu will change to <gui>Custom</gui>.</p>
    </note>

  </section>

</page>
