<?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="it">
    <info><title>Memorizzazione delle impostazioni del Desktop</title></info>

  <highlights>
    <para>Questo capitolo descrive come sono memorizzate le impostazioni del vostro desktop MATE, e come recuperarle o modificarle utilizzando gli strumenti dalla riga di comando <command>dconf</command> o <command>gsettings</command>, oppure l'applicazione grafica <application>Dconf Editor</application>.</para>
  </highlights>

  <section xml:id="mate-dconf-intro"><info><title>Introduzione</title></info>
    <para>Le impostazioni del vostro desktop MATE sono gestite e archiviate da <application>dconf</application>, che è un sistema di configurazione basato sulle chiavi relativo per la configurazione di hardware e software.</para>

    <para><application>dconf</application> utilizza diversi file di database nel formato binario GVDB, un database per file. Un profilo dconf consiste di un singolo file, in formato di testo semplice, che contiene un elenco di file database nel formato GVDB. Tutti i profili dconf sono archiviati nella cartella <filename class="directory">/etc/dconf/profile</filename>.</para>
    <para>In molti sistemi, non esiste alcun file di profilo per dconf in quanto essi utilizzano esclusivamente il database predefinito, user.db archiviato nella cartella ~/.config/dconf/user. In questo caso, non esiste alcuna impostazione relativa all'intero sistema, cioè ogni utente possiede il proprio settaggio delle impostazioni.</para>
    <para>Esempio di contenuto per il file di profilo utente (/etc/dconf/profile/user):</para>

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

    <para>Il precedente profilo dconf contiene 4 file GVDB, uno per linea.</para>

    <itemizedlist>
      <listitem>
        <para><database class="name">user</database> è il nome del database dell'utente che sono solitamente collocati nella cartella <filename class="directory">~/.config/dconf</filename></para>
      </listitem>
      <listitem>
        <para><database class="name">local</database>, <database class="name">site</database> e <database class="name">distro</database> sono database di sistema. Questi sono solitamente collocati nella cartella <filename class="directory">/etc/dconf/db</filename></para>
      </listitem>
    </itemizedlist>

    <para>Ciascuno di questi database memorizza coppie chiave-valore utilizzando una struttura dati tipo hashmap, che consente di mappare stringhe di testo da utilizzare come chiave a valori GVariant in un modo estremamente efficiente per la consultazione. La preferenza di ricerca è determinata dall'ordine di comparizione nel file di profilo dconf; i database degli utenti hanno la preferenza maggiore nell'esempio di file di profilo dconf mostrato in precedenza. Le chiavi provenienti da sorgenti di configurazione multiple coesistono in una struttura logica ad albero. Gli inserimenti chiave-valore hashmap relativi al Desktop MATE si trovano sotto il nodo logico /org/mate, solitamente archiviati nei database dell'utente.</para>

    <note>
      <para>Fare riferimento a <link xlink:href="man:dconf(7)"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>7</manvolnum></citerefentry></link> per maggiori informazioni sul sistema di configurazione dconf.</para>
    </note>

  <section xml:id="mate-dconf-one-read"><info><title>Leggere il valore di una chiave dconf</title></info>
    

    <para>Il valore di una chiave dconf può essere letto utilizzando gli strumenti dalla riga di comando <command>dconf</command> o <command>gsettings</command>, oppure con l'applicazione ad interfaccia grafica <application>Dconf Editor</application>.</para>

    <para>Questa sezione mostra come leggere l'immagine di sfondo del vostro desktop MATE, che è memorizzato nella chiave dconf:</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/picture-filename</para>
      </listitem>
    </itemizedlist>

    <para>L'immagine seguente mostra il percorso completo a questa chiave dconf. Notare che le altre directory non sono state espanse, o sono state rimosse, e sono solo mostrate le chiavi della directory dconf:</para>

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

    <figure xml:id="dconf-logical-full-bakgroud-keys-fig"><info><title>directory dconf /org/mate/desktop/background/</title></info>
       
      <mediaobject><imageobject><imagedata fileref="figures/org_mate_desktop_background_logical_view.png" format="PNG"/></imageobject><textobject><phrase>L'immagine mostra il contenuto della directory dconf  /org/mate/desktop/background/</phrase></textobject></mediaobject>
    </figure>

    <para>È possibile leggere il valore di una chiave dconf:</para>

    <section xml:id="read-key-dconf-using-dconf-editor"><info><title>Utilizzando l'applicazione GUI dconf-editor</title></info>
      
      <para>Per mostrare il valore di una chiave dconf utilizzando l'applicazione <application>Dconf Editor</application>, procedere come segue:</para>
      <orderedlist>
        <listitem>
          <para>Selezionare <menuchoice><guimenu>Applicazioni</guimenu><guimenuitem>Strumenti di sistema</guimenuitem><guimenuitem>dconf Editor</guimenuitem></menuchoice> dal pannello superiore.</para>
        </listitem>
        <listitem>
          <para>Fare clic sulle cartelle per ottenere il percorso completo alla directory dconf.</para>
        </listitem>
      </orderedlist>

      <figure><info><title>Dconf-Editor che mostra il valore della chiave /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-Editor che mostra il valore della chiave /org/mate/desktop/background/picture-filename</phrase></textobject></mediaobject>
        </screenshot>
      </figure>
    </section>

    <section xml:id="read-key-dconf-using-dconf"><info><title>Usare lo strumento dalla riga di comando dconf</title></info>
      
      <para>Per leggere il valore di una chiave dconf utilizzando lo strumento dalla riga di comando <command>dconf</command>, lanciare il seguente comando:</para>
      <screen>$ dconf read /org/mate/desktop/background/picture-filename
'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Dark.png'</screen>
      <para>Sinossi:</para>
      <synopsis>dconf read [-d] CHIAVE</synopsis>
      <para>Fare riferimento a <link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> per maggiori informazioni su come usare lo strumento da riga di comando <command>dconf</command>.</para>
      <tip><para>Si può utilizzare il tasto <keycap>Tab</keycap> per autocompletare il percorso alla chiave dconf.</para></tip>
    </section>

    <section xml:id="read-key-dconf-using-gsettings"><info><title>Utilizzare lo strumento dalla riga di comando gsettings</title></info>
      
      <para>Per leggere il valore di una chiave dconf utilizzando lo strumento dalla riga di comando <command>gsettings</command>, lanciare il seguente comando:</para>
      <screen>$ gsettings get org.mate.background picture-filename
'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Dark.png'</screen>
      <para>Sinossi:</para>
      <synopsis>gsettings [--schemadir SCHEMADIR] get SCHEMA[:PATH] KEY</synopsis>
      <para>Fare riferimento a <link xlink:href="man:dconf"><citerefentry><refentrytitle>gsettings</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> per maggiori informazioni su come usare lo strumento da riga di comando <command>gsettings</command>.</para>
    </section>
  </section>

  <section xml:id="mate-dconf-one-change"><info><title>Modificare il valore di una chiave dconf</title></info>
    

    <para>Il valore di una chiave dconf può essere modificato utilizzando il comando <command>dconf</command> o l'applicazione <application>Dconf Editor</application>.</para>
    <para>Questa sezione mostra come modificare l'immagine di sfondo del vostro desktop MATE, che è memorizzata nella chiave dconf:</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/picture-filename</para>
      </listitem>
    </itemizedlist>

    <para>L'immagine seguente mostra il percorso completo a questa chiave dconf. Notare che le altre directory non sono state espanse, o sono state rimosse, e sono solo mostrate le chiavi della directory dconf:</para>
    <itemizedlist>
      <listitem>
        <para>/org/mate/desktop/background/</para>
      </listitem>
    </itemizedlist>

    <figure xml:id="dconf-logical-short-bakgroud-keys-fig"><info><title>directory dconf /org/mate/desktop/background/</title></info>
      
      <mediaobject><imageobject><imagedata fileref="figures/org_mate_desktop_background_only_logical_view.png" format="PNG"/></imageobject><textobject><phrase>L'immagine mostra il contenuto della directory dconf  /org/mate/desktop/background/</phrase></textobject></mediaobject>
    </figure>

    <para>È possibile modificare il valore di una chiave dconf:</para>

    <section xml:id="modify-key-dconf-using-dconf-editor"><info><title>Utilizzando l'applicazione GUI dconf-editor</title></info>
      
      <para>Per modificare l'immagine di sfondo del vostro desktop MATE in <application>Dconf Editor</application>, procedere come segue:</para>

      <orderedlist>
        <listitem>
            <para>Selezionare <menuchoice><guimenu>Applicazioni</guimenu><guimenuitem>Strumenti di sistema</guimenuitem><guimenuitem>dconf Editor</guimenuitem></menuchoice> dal pannello superiore.</para>
        </listitem>
        <listitem>
          <para>Fare clic sulle cartelle per ottenere il percorso completo alla directory dconf, e fare clic sulla chiave dconf per modificarne il valore.</para>
        </listitem>
        <listitem>
           <para>Inserire il nuovo valore nella casella di testo <guilabel>Valore personalizzato</guilabel>.</para>
        </listitem>
        <listitem>
           <para>Fare clic sul segno di spunta per applicare la modifica.</para>
        </listitem>
      </orderedlist>

      <figure><info><title>Modificare il valore della chiave /org/mate/desktop/background/picture-filename nel dialogo Dconf-Editor.</title></info>
        
        <screenshot>
          <mediaobject><imageobject><imagedata fileref="figures/picture_filename_dconf_key_edit.png" format="PNG"/></imageobject><textobject><phrase>Modificare il valore della chiave /org/mate/desktop/background/picture-filename nel dialogo Dconf-Editor</phrase></textobject></mediaobject>
        </screenshot>
      </figure>
    </section>

    <section xml:id="modify-key-dconf-using-dconf"><info><title>Usare lo strumento dalla riga di comando dconf</title></info>
      
      <para>Per modificare l'immagine di sfondo del vostro desktop MATE, eseguire il seguente comando:</para>
      <screen>$ dconf write /org/mate/desktop/background/picture-filename \
"'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Light.png'"</screen>
      <para>Sinossi:</para>
      <synopsis>dconf write CHIAVE VALORE</synopsis>
      <para>Fare riferimento a <link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> per maggiori informazioni su come usare <command>dconf</command>.</para>
    </section>

    <section xml:id="modify-key-dconf-using-gsettings"><info><title>Utilizzare lo strumento dalla riga di comando gsettings</title></info>
      
      <para>Per modificare l'immagine di sfondo del vostro desktop MATE, eseguire il seguente comando:</para>
      <screen>$ gsettings set org.mate.background picture-filename \
"'/usr/share/backgrounds/mate/desktop/MATE-Stripes-Light.png'"</screen>
      <para>Sinossi:</para>
      <synopsis>gsettings [--schemadir SCHEMADIR] set SCHEMA[:PERCORSO] CHIAVE VALORE</synopsis>
      <para>Fare riferimento a <link xlink:href="man:dconf"><citerefentry><refentrytitle>gsettings</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> per maggiori informazioni su come usare <command>gsettings</command>.</para>
    </section>
  </section>

  <section xml:id="mate-dconf-some-changes"><info><title>Modificare il valore di diverse chiavi dconf</title></info>
    

    <para>Per modificare il valore di diverse chiavi dconf contemporaneamente, procedere come segue:</para>
    <orderedlist>
      <listitem>
        <para>Copiate il contenuto di una directory dconf in un nuovo file di testo semplice:</para>
        <screen>$ dconf dump /org/mate/desktop/background/ &gt; file.dconf</screen>
      </listitem>
      <listitem>
        <para>Apportare le modifiche al file di testo così generato</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>Caricare il contenuto del file di testo semplice in una directory dconf</para>
        <screen>$ dconf load /org/mate/desktop/background/ &lt; file.dconf</screen>
      </listitem>
    </orderedlist>
    <tip><para>È possibile anche copiare diverse directory alla volta, ad esempio per eseguire il backup e ripristinare tutte le configurazioni del vostro desktop MATE:</para>
        <screen>$ dconf dump /org/mate/ &gt; backup.dconf
$ dconf load /org/mate/ &lt; backup.dconf</screen>
    </tip>

    <para>Fare riferimento a <link xlink:href="man:dconf"><citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>1</manvolnum></citerefentry></link> per maggiori informazioni su come usare lo strumento da riga di comando <command>dconf</command>.</para>

  </section>

  </section>

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

</chapter>
