help/C/synctex-search.page

   1 <page xmlns="http://projectmallard.org/1.0/"
   2       type="topic" style="task"
   3       id="synctex-search">
   4
   5   <info>
   6     <link type="guide" xref="index#synctex" group="fifth"/>
   7     <desc>Flip between <app>Evince</app> and <app>Gedit</app>.</desc>
   8
   9     <revision pkgversion="2.32" version="0.1" date="2010-09-28" status="draft"/>
  10     <credit type="author">
  11       <name>Tiffany Antopolski</name>
  12       <email>tiffany@antopolski.com</email>
  13     </credit>
  14     <license>
  15       <p>Creative Commons Share Alike 3.0</p>
  16     </license>
  17
  18   </info>
  19
  20 <title>Search with SyncTex</title>
  21 <p>
  22    After you <link xref="synctex-compile">compile your TeX file with SyncTex</link>, you will be able to search.  SyncTex even supports forward and backward search from an included file.
  23 </p>
  24
  25 <section id="forward-search">
  26     <title>Forward Search: From TeX to PDF (<app>Gedit</app> to <app>Evince</app>)</title>
  27      <p>
  28      Forward search allows you to click on a specific section of TeX source code, and jump to the associated position in the PDF.  To perform forward search:
  29  </p>
  30 <steps>
  31 <item>
  32 <p>
  33   Click on a line in the TeX file.
  34 </p>
  35 </item>
  36 <item>
  37 <p>
  38   In <app>Gedit</app>, click <guiseq><gui>Tools</gui> <gui>Forward Search</gui></guiseq>.  The corresponding line in the PDF will be outlined in red.
  39 </p>
  40 <p>
  41 Alternatively, you can click <keyseq><key>Ctrl</key><key>Alt</key><key>F</key></keyseq>. The corresponding line in the PDF will be outlined in red.
  42 </p>
  43 </item>
  44 </steps>
  45 <note>
  46 <p>
  47    If the corresponding PDF file is not open, performing a forward search will open the PDF in <app>Evince</app>.
  48 </p>
  49 </note>
  50 <p>
  51  If you add a complex project with several TeX files you can put
  52 </p>
  53 <code>% mainfile: mainfile.tex</code>
  54 <p>
  55 either in the first or last three lines of each included TeX file, and forward search will work. Backward search should always work, even if you don't add the modeline.
  56 </p>
  57
  58 </section>
  59
  60 <section id="backward-search">
  61     <title>Backward Search: From PDF to TeX (<app>Evince</app> to <app>Gedit</app>)</title>
  62      <p>
  63  Backward search allows you to click on a specific line in the PDF file, and jump to the associated line in the TeX source code.
  64 </p>
  65 <p>
  66 You can perform a backward search by pressing <key>Ctrl</key>+ Left Click in <app>Evince</app>. The corresponding line in the TeX source code will be hightlighted.
  67      </p>
  68 </section>
  69
  70 </page>