38
edits
Changes
→Editors & Viewers Jim Diamond added the emacs+auctex section, including the synctex replacement shell script and related comments.
== 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).
=== Emacs + auctex ===
To implement forward search with auctex (i.e., open the viewer at the right page from emacs)
creating a shell script called '''synctex''' in some directory which precedes one containing
the "usual" synctex (if any) in your $PATH with the following contents has been demonstrated
to work on at least Slackware64 15.0:
#! /bin/zsh
# synctex replacement to allow forward search from emacs+auctex to (at least) evince
# Emacs + auctex calls synctex up to three times.
# For example, attempting to view the PDF of <FILE>.tex would cause
# emacs to run the following commands ($PWD is the path to the
# current directory):
# synctex view -i <LINE>:<COL>:$PWD/./<FILE>.tex -o <FILE>.pdf
# synctex view -i <LINE>:<COL>:<FILE>.tex -o <FILE>.pdf
# synctex view -i <LINE>:<COL>:$PWD/<FILE>.tex -o <FILE>.pdf
line_number=${3%%:*}
tex_file=${3##*:}
synctex_file=${tex_file%.tex}.synctex
# Transmogrify the output format of mtxrun into something that emacs+auctex
# (and maybe other editors?) recognizes:
mtxrun --script synctex --find \
--file=$tex_file --line=$line_number $synctex_file \
| sed 's/.*page=/Page:/'
(Note: this has only been tested with simple document structures.)
=== Evince, Okular & Kile ===
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.)
=== 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]]))
[[Category:Text Editors]]