Open main menu


Revision as of 09:53, 27 November 2012 by Esteis (talk | contribs) (Explain what the heck SyncTeX does.)

SyncTeX is a program that puts a lot of anchors in the output file that link to the corresponding position in the source file. This allows you to quickly jump from PDF to source. SyncTeX currently does not work with MKIV.

With a ConTeXt version > 2009.06.13 you can run

texexec --synctex jobname

that will create a file jobname.synctex.gz. The command

ctxtools --purge --all

or next run without --synctex will remove the file again.

This file can be used by your editor to display the proper file.

Editors & Viewers


You may need to modify the command for executing ConTeXt first (you need to add --synctex switch in preferences).


Evince (the GNOME PDF viewer) supports SyncTeX since version 2.32.0. & TextMate (Mac OS X)

In Skim/Preferences/Sync choose TextMate. The key combination

Shift + Apple + MouseClick

will bring you to the corresponding line in text editor.

In TextMate I have created my own command inside the ConTeXt bundle:

  • Save: Nothing
  • Command(s)
/Applications/ -r "$TM_LINE_NUMBER" "${pdf}"
  • Input: None
  • Output: Discard
  • Activation: Key Equivalent (choose one; I used Ctrl+Alt+Apple+O)
  • Scope Selector: text.tex.context

If you use Apple+R for typesetting that needs to be modified as well (to account for --synctex switch).

Hopefully this functionality will become part of the official ConTeXt bundle one day. (The recipe given above is too specific. The code needs to be written to handle more different viewers and different locations, not only a single viewer at a specified location.)