<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="mate-dconf" xml:lang="ja">
    <info><title>デスクトップの設定を保存する</title></info>

  <highlights>
    <para>この章では、MATE デスクトップの設定保存方法と、 <command>dconf</command> や <command>gsettings</command> のコマンドライン・ツールや <application>Dconf Editor</application> の GUI アプリケーショ ンを使う設定の取得と変更方法について説明します。</para>
  </highlights>

  <section xml:id="mate-dconf-intro"><info><title>はじめに</title></info>
    <para>MATE デスクトップの設定は、ハードウェアとソフトウェアの設定のためのキー・ベース設定システムである、 dconf によって管理、保存されています。</para>

    <para><application>dconf</application> は、GVDB バイナリ形式の複数のデータベース・ファイルを使用し、各ファイルにそれぞれのデータベースを使用します。dconf プロファイルは、GVDB 形式のデータベース・ファイルの一覧を含むプレーンテキスト形式で、単独のファイルを構成します。すべての dconf プロファイルは、<filename class="directory">/etc/dconf/profile</filename> フォルダに保存されます。</para>
    <para>ほとんどのシステムでは、~/.config/dconf/user に格納されている既定のデータベース user.db を使用しているだけなので、dconf プロファイル・ファイルは存在しません。このような場合、システム全体に影響する設定はなく、ユーザは各自で設定を行うだけです。</para>
    <para>ユーザプロファイルの内容の例 (/etc/dconf/profile/user file):</para>

<literallayout>user-db: user
system-db: local
system-db: site
system-db: distro</literallayout>

    <para>先の dconf プロファイルには、4つの GVDB ファイルが1行ごとに入っています。</para>

    <itemizedlist>
      <listitem>
        <para><database class="name">user</database>は、user のデータベースの名前です。データベースは通常、~/.config/dconf フォルダに格納されています。</para>
      </listitem>
      <listitem>
        <para><database class="name">local</database>、<database class="name">site</database>、<database class="name">distro</database> はシステムデータベースです。これらは通常、<filename class="directory">/etc/dconf/db</filename> フォルダに格納されています。</para>
      </listitem>
    </itemizedlist>

    <para>これらのデータベースは、ハッシュ・マップデータ構造を使用してキーと値のペアを保存します。これによって、文字列キーを GVariant 値にマッピングすることができ、ルックアップに非常に効率的です。ルックアップの優先順位は dconf プロファイル・ファイルでの出現順に決定され、先の dconf プロファイルの例では、ユーザのデータベースが最も優先されています。複数の設定ソースのキーは、論理的なツリー構造の中で共存しています。MATE デスクトップのキーバリュー・ハッシュマップ・エントリは、/org/mate 論理ノードの下にあり、通常はユーザのデータベースに格納されています。</para>

    <note>
      <para>dconf 設定システムの詳細については、<link xlink:href="man:dconf(7)"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>7</manvolnum></citerefentry></link> を参照してください。</para>
    </note>

  <section xml:id="mate-dconf-one-read"><info><title>dconf キーの値を読み取るには</title></info>
    

    <para>dconf キーの値は、<command>dconf</command> や <command>gsettings</command> のコマンドライン・ツール、または GUI アプリケーションの <application>Dconf Editor</application> を使って読み取ることができます。</para>

    <para>この節では、MATE デスクトップの背景画像を読み取る方法を説明します。この値が保存されているのは次の dconf キーです：</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/picture-filename</para>
      </listitem>
    </itemizedlist>

    <para>次の図は、この dconf キーのフルパスを表示したものです。他のディレクトリは展開されていないか、削除されていて、dconf ディレクトリのキーだけが表示されていることに注意してください。</para>

    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/</para>
      </listitem>
    </itemizedlist>

    <figure xml:id="dconf-logical-full-bakgroud-keys-fig"><info><title>/org/mate/desktop/background/ dconf directory</title></info>
       
      <mediaobject><imageobject> <imagedata fileref="figures/org_mate_desktop_background_logical_view.png" format="PNG"/> </imageobject> <textobject> <phrase>図は、 /org/mate/desktop/background/ dconf ディレクトリの内容を示します。</phrase> </textobject></mediaobject>
    </figure>

    <para>dconf キーの値を読み取ることが可能です。</para>

    <section xml:id="read-key-dconf-using-dconf-editor"><info><title>dconf エディタの GUI アプリケーションを使う</title></info>
      
      <para><application>Dconf エディタ</application> アプリケーションを使って dconf キーの値を表示するには、以下の手順を実行します。</para>
      <orderedlist>
        <listitem>
          <para>トップパネルから<menuchoice><guimenu>アプリケーション</guimenu><guimenuitem>システムツール</guimenuitem><guimenuitem>dconf エディタ</guimenuitem></menuchoice>を選択します。</para>
        </listitem>
        <listitem>
          <para>フォルダをクリックすると、dconf ディレクトリのフルパスが表示されます。</para>
        </listitem>
      </orderedlist>

      <figure><info><title>Dconf エディタ で /org/mate/desktop/background/picture-filename キーの値を表示する</title></info>
        
        <screenshot>
          <mediaobject><imageobject><imagedata fileref="figures/picture_filename_dconf_key_view.png" format="PNG"/></imageobject><textobject><phrase>Dconf エディタで /org/mate/desktop/background/picture-filename キーの値を表示する</phrase></textobject></mediaobject>
        </screenshot>
      </figure>
    </section>

    <section xml:id="read-key-dconf-using-dconf"><info><title>dconf コマンドライン・ツールを使用する</title></info>
      
      <para><command>dconf</command> コマンドラインツールを使って dconf キーの値を読み取るには、以下のコマンドを実行します。</para>
      <screen>$ dconf read /org/mate/desktop/background/picture-filename
'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Dark.png'</screen>
      <para>概要：</para>
      <synopsis>dconf read [-d] KEY</synopsis>
      <para><command>dconf</command> コマンドラインツールの使い方については <link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle> <manvolnum>1</manvolnum></citerefentry></link> を参照。</para>
      <tip><para><keycap>Tab</keycap> キーを使うことで、dconf キーへのパスを自動補完できます。</para></tip>
    </section>

    <section xml:id="read-key-dconf-using-gsettings"><info><title>gsettings コマンドライン・ツールを使用する</title></info>
      
      <para><command>gsettings</command> コマンドライン・ツールを使って dconf キーの値を読み取るには、次のコマンドを実行します。</para>
      <screen>$ gsettings get org.mate.background picture-filename
'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Dark.png'</screen>
      <para>概要：</para>
      <synopsis>gsettings [--schemadir SCHEMADIR] get SCHEMA[:PATH] KEY</synopsis>
      <para><command>gsettings</command> コマンドライン・ツールの詳しい使用方法については、<link xlink:href="man:gsettings"><citerefentry><refentrytitle>gsettings</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>をご覧ください。</para>
    </section>
  </section>

  <section xml:id="mate-dconf-one-change"><info><title>dconf キーの値を変更するには</title></info>
    

    <para>dconf キーの値は、<command>dconf</command> コマンドまたは <application>Dconf エディタ</application> アプリケーションを使って変更できます。</para>
    <para>この節では、MATE デスクトップの背景画像を読み取る方法を説明します。この値は、次の dconf キーに保存されています。</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/picture-filename</para>
      </listitem>
    </itemizedlist>

    <para>次の図は、この dconf キーのフルパスを表示したものです。他のディレクトリは展開されていないか、削除されていて、dconf ディレクトリのキーだけが表示されていることに注意してください。</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/</para>
      </listitem>
    </itemizedlist>

    <figure xml:id="dconf-logical-short-bakgroud-keys-fig"><info><title>/org/mate/desktop/background/ dconf directory</title></info>
      
      <mediaobject><imageobject> <imagedata fileref="figures/org_mate_desktop_background_only_logical_view.png" format="PNG"/> </imageobject> <textobject> <phrase> /org/mate/desktop/background/ dconf ディレクトリの内容を示している図です。</phrase> </textobject></mediaobject>
    </figure>

    <para>dconf キーの値は変更できます。</para>

    <section xml:id="modify-key-dconf-using-dconf-editor"><info><title>dconf エディタの GUI アプリケーションを使う</title></info>
      
      <para><application>Dconf エディタ</application> で MATE デスクトップの背景画像を編集するには、次の手順を行ってください。</para>

      <orderedlist>
        <listitem>
            <para>トップパネルから<menuchoice><guimenu>アプリケーション</guimenu><guimenuitem>システムツール</guimenuitem><guimenuitem>dconf エディタ</guimenuitem></menuchoice>を選択します。</para>
        </listitem>
        <listitem>
          <para>フォルダをクリックして dconf ディレクトリのフルパスを取得し、dconf キーをクリックして値を編集してください。</para>
        </listitem>
        <listitem>
           <para>カスタム値の<guilabel>テキスト・ボックス</guilabel>に新しい値を入力してください。</para>
        </listitem>
        <listitem>
           <para>チェックマークのボタンをクリックすると、変更が適用されます。</para>
        </listitem>
      </orderedlist>

      <figure><info><title>Dconf エディタで /org/mate/desktop/background/picture-filename キーの値を編集する</title></info>
        
        <screenshot>
          <mediaobject><imageobject><imagedata fileref="figures/picture_filename_dconf_key_edit.png" format="PNG"/></imageobject><textobject><phrase>Dconf エディタで /org/mate/desktop/background/picture-filename キーの値を表編集する</phrase></textobject></mediaobject>
        </screenshot>
      </figure>
    </section>

    <section xml:id="modify-key-dconf-using-dconf"><info><title>dconf コマンドライン・ツールを使用する</title></info>
      
      <para>MATE デスクトップの背景画像を変更するには、次のコマンドを実行してください。</para>
      <screen>$ dconf write /org/mate/desktop/background/picture-filename \
"'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Light.png'"</screen>
      <para>概要：</para>
      <synopsis>dconf write キーの値</synopsis>
      <para><command>dconf</command> の詳しい使い方については、<link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> をご覧ください。</para>
    </section>

    <section xml:id="modify-key-dconf-using-gsettings"><info><title>gsettings コマンドライン・ツールを使用する</title></info>
      
      <para>MATE デスクトップの背景画像を変更するには、次のコマンドを実行してください。</para>
      <screen>$ gsettings set org.mate.background picture-filename \
"'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Light.png'"</screen>
      <para>概要：</para>
      <synopsis>gsettings [--schemadir SCHEMADIR] set SCHEMA[:PATH] KEY VALUE</synopsis>
      <para><command>dconf</command> の使い方については <link xlink:href="man:gsettings"><citerefentry><refentrytitle>gsettings</refentrytitle> <manvolnum>1</manvolnum></citerefentry></link> を参照。</para>
    </section>
  </section>

  <section xml:id="mate-dconf-some-changes"><info><title>dconf キーの値を変更するには</title></info>
    

    <para>複数の dconf キーの値を同時に変更するには、次の手順で行います。</para>
    <orderedlist>
      <listitem>
        <para>dconf ディレクトリの内容を次のようにして、新規平文テキストのファイルにダンプします。</para>
        <screen>$ dconf dump /org/mate/desktop/background/ &gt; file.dconf</screen>
      </listitem>
      <listitem>
        <para>平文テキストファイルに変更を加える</para>
<literallayout>[/]
color-shading-type='vertical-gradient'
primary-color='rgb(88,145,188)'
picture-options='zoom'
picture-filename='/usr/share/backgrounds/mate/desktop/MATE-Stripes-Light.png'
secondary-color='rgb(60,143,37)'
</literallayout>
      </listitem>
      <listitem>
        <para>平文テキストファイルの内容を dconf ディレクトリに読み込む</para>
        <screen>$ dconf load /org/mate/desktop/background/ &lt; file.dconf</screen>
      </listitem>
    </orderedlist>
    <tip><para>複数のディレクトリを同時に、ダンプまたはロードすることも可能です。例えば次のようにして、MATE デスクトップの全ての設定をバックアップと復元することができます。</para>
        <screen>$ dconf dump /org/mate/ &gt; backup.dconf
$ dconf load /org/mate/ &lt; backup.dconf</screen>
    </tip>

    <para><command>dconf</command> コマンドラインツールの使い方については <link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle> <manvolnum>1</manvolnum></citerefentry></link> を参照。</para>

  </section>

  </section>

  <xi:include href="gosdconfkeys.xml"/>   <!-- List of dconf keys -->

</chapter>
