<?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="ru">

  <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>Этот <em>раздел справки</em> находится под лицензией <link href="http://www.gnu.org/licenses/fdl-1.1.html"> GNU Free Documentation License, Version 1.1</link> (GFDL). Это означает, что вы можете свободно копировать, распространять и/или изменять этот документ при определённых условиях.</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>Навигация по длинным структурированным заметкам</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Yuri Myasoedov</mal:name>
      <mal:email>omerta13@yandex.ru</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Ser82-png</mal:name>
      <mal:email>asvmail.as@gmail.com</mal:email>
      <mal:years>2022-2025</mal:years>
    </mal:credit>
  </info>


<title>Добавление оглавления</title>

<note><p>Это подключаемый модуль к <app>Gnotes</app>. Если этот модуль установлен, в меню <gui>Активности</gui> появится надпись <gui>Оглавление</gui>. Смотрите <link xref="addins-preferences"/>, чтобы узнать, как активировать подключаемый модуль.</p></note>


<section id="nutshell"><title>Коротко</title>

<list type="numbered">
  <item>
    <p>Заголовок — это полная текстовая строка, отформатированная с использованием следующих атрибутов шрифта: <gui>Жирный+Огромный</gui> или <gui>Жирный+Большой</gui>.</p>
  </item>
  <item>
    <p>Установите заголовки с помощью комбинаций клавиш <keyseq><key>Ctrl</key><key>1</key></keyseq> или <keyseq><key>Ctrl</key><key>2</key></keyseq>.</p>
  </item>
  <item>
    <p>Откройте оглавление с помощью <keyseq><key>Ctrl</key><key>Alt</key><key>1</key></keyseq> и перейдите к любому заголовку.</p>
  </item>
</list>

</section>

<section id="screenshot"><title>Снимок экрана</title>
    <figure>
      <title>Структурированная заметка с оглавлением</title>
        <media type="image" src="figures/gnote-addin-table-of-contents.png" mime="image/png">
        </media>
    </figure>
</section>


<section id="navigating"><title>Навигация по длинным заметкам</title>

<p>Навигация по длинная заметке может быть затруднительна. Тогда будет естественным структурировать заметку, помечая разделы и подразделы заголовками.</p>

<p>Этот модуль упрощает навигацию по длинным структурированным заметкам. После того, как вы установили заголовки в своей заметке, оглавление отобразится в меню действий. И вы сможете перейти прямо из меню к любому заголовку.</p>

</section>


<section id="setheadings"><title>Структурирование заметок с помощью заголовков</title>

<p>Заголовок — это просто строка с определенным форматированием текста:</p>
<list>
  <item><p>Заголовки уровня 1, для разделов, представляют собой строки, отформатированные с атрибутами шрифта: <gui>Жирный+Огромный</gui>.</p></item>
  <item><p>Заголовки уровня 2, для подразделов, представляют собой строки, отформатированные с атрибутами шрифта: <gui>Жирный+Большой</gui>.</p></item>
</list>


<p>Чтобы отформатировать строку заголовка, выполните одно из следующих действий:</p>

<list>
  <item>
    <p>Используйте команды <gui>Заголовок 1</gui> и <gui>Заголовок 2</gui> в меню <guiseq><gui>Действия с заметками</gui><gui>Оглавление</gui></guiseq>.</p>
  </item>

  <item>
    <p>Используйте комбинации клавиш <keyseq><key>Ctrl</key><key>1</key></keyseq> и <keyseq><key>Ctrl</key><key>2</key></keyseq> для заголовков 1 и 2 уровней.</p>
 </item>
</list>

<note><p>Эти команды применяют форматирование ко всей строке. Вам не нужно выделять её. Достаточно, если курсор будет находиться на строке.</p><p>Либо установите курсор на новую строку, активируйте команду заголовка, а затем введите название заголовка.</p></note>

<p>Также вы можете использовать обычные команды форматирования из меню <gui>Текст</gui>: <gui>Жирный</gui>, <gui>Большой</gui> и <gui>Огромный</gui>, а также соответствующие им комбинации клавиши. Например, если ваша строка уже имеет атрибут шрифта <gui>Огромный</gui>, нужно просто добавить атрибут <gui>Жирный</gui>, чтобы превратить её в «Заголовок 1». Смотрите <link xref=" editing-notes"/>, чтобы узнать, как устанавливать стили текста.</p>

</section>


<section id="showtable"><title>Отображение оглавления</title>

<p>Вы можете получить доступ к оглавлению воспользовавшись одним из следующих способов:</p>
<list>
<item><p>В меню <guiseq><gui>Действия с заметками</gui><gui>Оглавление</gui></guiseq>.</p></item>
<item><p>Во <gui>всплывающем меню</gui>, используя сочетание клавиш <keyseq><key>Ctrl</key><key>Alt</key><key>1</key></keyseq>.</p>
<p>Затем вы можете перемещаться вверх и вниз по списку с помощью клавиш со стрелками, а перейти к выбранному заголовку с помощью клавиши <key>enter</key>. Или просто щёлкните мышкой по выбранному заголовку, чтобы перейти к нему.</p></item>
</list>

</section>


<section id="troubleshooting"><title>Устранение неполадок</title>
<terms>
  <item><title><em style="strong">Один заголовок не отображается в оглавлении</em></title><p>В строке заголовка могут быть некоторые символы, например пробельные символы, которые нельзя отформатировать как заголовок. Убедитесь, что в качестве заголовка отформатирована <em>вся строка</em>. Смотрите <link xref="#setheadings"/>.</p>
  </item>
  <item><title><em style="strong">В оглавлении есть пустая строка</em></title><p>Пустая строка, возможно, содержащая пробелы, отформатирована как заголовок. Перейдите к ней и удалите.</p>
  </item>

</terms>

</section>

</page>
