<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="plugin-synctex">

  <info>
    <link type="guide" xref="index#pluma-additional-plugins"/>
    <revision version="1.25" date="2021-03-29" status="review"/>

    <credit type="author">
      <name></name>
      <email its:translate="no"></email>
    </credit>

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

    <desc>Quickly switch between TeX source files and rendered PDF documents
    in atril.</desc>
  </info>

  <title>SyncTeX</title>

  <p>SyncTeX is a method that enables synchronization between a TeX source file
  and the PDF output generated by a TeX/LaTeX compiler. This plugin allows to
  use SyncTeX in <app>pluma</app> to quickly switch from an opened TeX source
  file to a PDF document opened in <app>atril</app> and vice versa.</p>

  <steps>
    <title>To enable the <app>SyncTeX</app> plugin:</title>
    <item>
      <p>Select <guiseq><gui style="menu">Edit</gui>
      <gui style="menuitem">Preferences</gui>
      <gui style="tab">Plugins</gui></guiseq>.</p>
    </item>
    <item>
      <p>Select <gui style="menuitem">SyncTeX</gui> to enable the
      plugin.</p>
    </item>
  </steps>

  <note>
  <p>To be useful, this plugin requires a TeX/LaTeX compiler and SyncTeX to be
  installed. Both are provided by TeX distributions such as TeX Live.
  Also <app>atril</app> must be installed.</p>
  </note>

  <list>
    <item>
      <p>Some basic information on setting up SyncTeX and compiling LaTeX
      documents can be found in the
      <link xref="help:atril#synctex"><app>atril</app>-SyncTeX
      documentation</link>.</p>
    </item>
    <item>
      <p>Key shortcuts and mouse controls are also documented in the
      <link xref="help:atril/synctex-search">
      <app>atril</app>-SyncTeX documentation</link>.</p>
    </item>
    <item>
      <p><app>Gnome-LaTeX</app> and <app>Gummi</app> are alternative text editors specifically designed for writing TeX code.</p>
    </item>
  </list>

</page>
