<?xml version="1.0" encoding="utf-8"?>
<!--
      "Table of Contents" is a Note add-in for Gnote.
      It lists a note's table of contents in a menu.

      Copyright (c)  2013  Luc Pionchon <pionchon.luc@gmail.com>

      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU Free Documentation License, Version 1.1
      or any later version published by the Free Software Foundation;
      with no Invariant Sections, with no Front-Cover Texts, and with no
      Back-Cover Texts.
      FIXME: does the statement have to show in the rendered document?

      A copy of the license is included in the section entitled "GNU
      Free Documentation License".
      FIXME: is this true? Is there a (GNOME? Yelp?) common GFDL topic?
-->
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="addin-tableofcontents" xml:lang="ca">

  <info>
    <revision status="candidate" pkgversion="gnote-addin-tableofcontents-version-1.0.0"/>
    <!-- Status:
      stub        contains little to no real content
      incomplete  outline of all information, but lacking content
      draft       all content available, but unpolished
      review      ready to be reviewed by editors
      candidate   reviewed and awaiting a final approval
      final       approved and ready for publication or distribution
      outdated    was once complete or nearly complete, but needs to be revised to reflect changes

      Other possible attributes:
      version=""        revision version
      docversion=""     enclosing document
      date="2011-03-08" revision date
    -->
    <license href="http://www.gnu.org/licenses/fdl-1.1.html"><p>Aquest <em>tema d'ajuda</em> està llicenciat sota la <link href="http://www.gnu.org/licenses/fdl-1.1.html">Llicència de documentació lliure GNU, versió 1.1</link> (GFDL). Significa que sou lliure de copiar, distribuir i/o modificar aquest document, en determinades condicions.</p>
    </license>

    <credit type="author copyright">
      <name>Luc Pionchon</name><email>pionchon.luc@gmail.com</email><years>2013</years></credit>
    <credit type="editor">
      <name>Adam Dingle</name>
      <email>adam@yorba.org</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Aurimas Cernius</name>
      <email>aurisc4@gmail.com</email>
      <years>2013,2014,2023</years>
    </credit>
    <!-- Credit type: (can have several types)
      author        somebody responsible for writing content
      editor        somebody who has provided reviews or editorial corrections
      copyright     a person or entity which holds copyright on the work
      maintainer    the person or entity currently responsible for the work
      collaborator  somebody who has provided extensive rough information
      translator    somebody who has translated the work into another language
      publisher     a person or entity who distributes formatted copies

      <credit> can have a URL, for example for a publisher, using FOAF namespace:
        <page xmlns="http://xmlns.com/foaf/0.1/">http://flossmanuals.net/</page>
    -->

    <link type="guide" xref="index#advanced"/>
    <link type="guide" xref="editing-notes#note-content"/>
    <link type="topic" xref="addins-preferences"/>
    <link type="topic" xref="searching-notes"/>
    <desc>Navega per notes llargues estructurades</desc>
  </info>


<title>Afegir una taula de continguts</title>

<note><p>Aquest és un connector de <app>Gnotes</app>. Quan aquest connector està instal·lat, hi ha una entrada <gui>Taula de continguts</gui> al menú <gui>actions</gui>. Mireu <link xref="addins-preferences"/> per a aprendre a activar un connector.</p></note>


<section id="nutshell"><title>En poques paraules</title>

<list type="numbered">
  <item>
    <p>Un encapçalament és una línia de text completa, formatada amb <gui>negreta+enorme</gui> o <gui>negreta+gran</gui>.</p>
  </item>
  <item>
    <p>Establir els encapçalaments amb <keyseq><key>Ctrl</key><key>1</key></keyseq> o <keyseq><key>Ctrl</key><key>2</key></keyseq>.</p>
  </item>
  <item>
    <p>Obre la taula de continguts amb <keyseq><key>Ctrl</key><key>Alt</key><key>1</key></keyseq> i aneu a qualsevol encapçalament.</p>
  </item>
</list>

</section>

<section id="screenshot"><title>Captures de pantalla</title>
    <figure>
      <title>Una nota estructurada amb la seva taula de continguts</title>
        <media type="image" src="figures/gnote-addin-table-of-contents.png" mime="image/png">
        </media>
    </figure>
</section>


<section id="navigating"><title>Navegar per notes llargues</title>

<p>Una nota llarga pot ser difícil de revisar. Aleshores és natural estructurar la nota marcant seccions i subseccions amb encapçalaments.</p>

<p>Aquest connector fa que sigui fàcil navegar a través de notes estructurades llargues. Una vegada que hàgeu establert encapçalaments a la nota, la taula de continguts de la nota es mostrarà al menú d'accions. Després podeu saltar directament des del menú a qualsevol encapçalament.</p>

</section>


<section id="setheadings"><title>Estructura les notes amb encapçalaments</title>

<p>Un encapçalament és simplement una línia completa amb un format de text específic:</p>
<list>
  <item><p>Els encapçalaments de nivell 1, per a seccions, són línies formatades amb un tipus de lletra <gui>negreta + enorme</gui>.</p></item>
  <item><p>Els encapçalaments de nivell 2, per a les subseccions, són línies formatades amb un tipus de lletra <gui> negreta + gran</gui>.</p></item>
</list>


<p>Per a formatar una línia d'encapçalament:</p>

<list>
  <item>
    <p>Use the commands <gui>Heading 1</gui> and <gui>Heading 2</gui>
       in the <guiseq><gui>Note Actions</gui><gui>Table of Contents</gui></guiseq> menu.</p>
  </item>

  <item>
    <p>Utilitzeu les tecles de drecera <keyseq><key>Ctrl</key><key>1</key></keyseq> i <keyseq><key>Ctrl</key><key>2</key></keyseq> per als encapçalaments de nivell 1 i 2.</p>
 </item>
</list>

<note><p>
  These commands apply the formatting to the complete line.
  You don't need to select it first.
  It is enough if the cursor is on the line.
</p><p>Com a alternativa, amb el cursor en una nova línia, activa encapçalament i, a continuació, introdueix el títol de l’encapçalament.</p></note>

<p>Fins i tot podeu utilitzar les ordres de format normals del menú <gui>Text</gui>: <gui>Negreta</gui>, <gui>Gran</gui> i <gui>Enorme</gui> i les seves respectives dreceres de teclat. Si, per exemple, la línia ja té el format <gui>Enorme</gui>, només heu de convertir-la també en <gui>Negreta</gui> per a convertir-la en un encapçalament 1. Vegeu <link xref="editing-notes"/> per a aprendre a configurar estils de text.</p>

</section>


<section id="showtable"><title>Mostrar la taula de continguts</title>

<p>Podeu accedir a la taula de continguts:</p>
<list>
<item><p>In the menu <guiseq><gui>Note Actions</gui><gui>Table of Contents</gui></guiseq>.</p></item>
<item><p>En un <gui>menú emergent</gui> amb la drecera de teclat <keyseq><key>Ctrl</key><key>Alt</key><key>1</key></keyseq>.</p>
<p>A continuació, podeu navegar amunt i avall amb les tecles de fletxa i saltar a l'encapçalament seleccionat amb <key>Retorn</key>. O simplement feu clic amb el ratolí a l’encapçalament.</p></item>
</list>

</section>


<section id="troubleshooting"><title>Resolució de problemes</title>
<terms>
  <item><title><em style="strong">Un títol no apareix a la taula de continguts</em></title><p>Pot haver-hi alguns caràcters a la línia d'encapçalament, com ara els caràcters en blanc, que no estan formatats com a encapçalament. Assegureu-vos que <em>tota la línia</em> tingui el format d'encapçalament. Vegeu <link xref="#setheadings"/>.</p>
  </item>
  <item><title><em style="strong">Hi ha una línia buida a la taula de continguts</em></title><p>Una línia buida, que pot incloure espais en blanc, té el format d'encapçalament. Aneu a aquesta línia i elimineu l'àrea.</p>
  </item>

</terms>

</section>

</page>
