gardener, Interface administrators, Administrators
1,540
edits
Changes
Jump to navigation
Jump to search
In MkIV (since I don't know when) you You can run context use the <code>--synctex jobname</code> switch to use enable SyncTeX.
== MkII ==With a ConTeXt version > 2009.06.13 So in MkIV you can run texexec context --synctex jobnamethat will create a file <codei>jobname.synctex.gz</codei>.The commandand in MkII you can use ctxtools --purge --allor next run without texexec --synctex will remove the file again.<i>jobname</i>
{{Installation navbox}}=== Bugs === (In 2021-10 I didn’t manage to get ConTeXt-SyncTeX working with Skim and different editors, while it worked with LaTeX-SyncTeX; there’s also no error message. I guess the parser fails on ConTeXt’s synctex files. [[User:Hraban|Hraban]] ([[User talk:Hraban|talk]]))
add link to TeXShop, add hint about failure to setup
'''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.
== MkIV Usage ==
Alternatively you can add one of the following commands to your MkIV document:<texcode>\setupsynctex[state=start,method=min] % clickable words\setupsynctex[state=start,method=max] % more efficient clickable ranges</texcode> This will create a file <code><i>jobname</i>.synctex</code>. The command context --purgeor next run without <code>--synctex</code> will remove the file again. To see what became clickable, use one of<texcode>\enabletrackers[system.synctex.visualize]\enabletrackers[system.synctex.visualize=real]</texcode> This file can be used by your editor and PDF viewer to display jump back and forth between the proper filesource and the PDF.
== Editors & Viewers ==
=== TeXshop ===
Works quite well, but needs “magic lines” like:
% !TEX TS-program = ConTeXt2021
% !TEX useAlternatePath
% !TEX useConTeXtSyncParser
Setup see [[TeXShop|extra page on TeXshop]].
=== TeXWorks ===
You may need to modify the command for executing ConTeXt first (you need to add <code>--synctex</code> switch in preferences).
=== Evince , Okular & Kile ===Okular (the KDE PDF viewer) and Evince (the GNOME PDF viewerone) supports support SyncTeX . (The latter since version 2.32.0.) To forward something from a text editor to Okular, do okular --unique '${pdffile}#src:${linenumber} ${texfile}' Kile’s (the KDE TeX IDE) ForwardPDF function should support SyncTeX, but it doesn’t seem to work with ConTeXt at the time of writing
=== Skim.app & TextMate (Mac OS X) ===
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.)
[[Category:Text Editors]]
