News

- Most TeX distributions (TeXLive 2008 and MikTex 2.7) have now been updated to support SyncTeX. The option is activated with the -synctex switch at the command-line as follows:
pdflatex -synctex=-1 mybook.tex

This command produces a file name 'mybook.synctex' which can then be used to perform PDF<->TEX synchronization. The file can be large so you can instead produce a compressed version (mybook.synctex.gz) with:
pdflatex -synctex=1 mybook.tex

- The SyncTeX patch that I've developed is now maintained in the main development branch of SumatraPDF; it is part of the latest official release (version 0.9.2).

I will still continue to publish my own builds of SumatraPDF to my website (the executable is updated regularly even though I am not posting about it): at the moment the only difference with the official release is the presence of a dialog box to let the user configure the inverse-search command. (In the official release this has to be done via the command line by passing parameters to SumatraPDF.exe.)

- I wrote a short documentation to help you configure your favourite editors for synchronization with SumatraPDF:

Links:
- Editors configuration
- My own build of SumatraPDF: SumatraPDF-sync.exe
- SumatraPDF official build
- MikTeX and TeXLive

[ 4 comments ] ( 33 views )   |  permalink  |   ( 3 / 5 )

---

The author of the pdfsync TeX package, Jérôme Laurens, has developed a new technology called SyncTex that will eventually replace pdfsync. SyncTex is directly integrated in pdftex. This has many benefits: there is no need to load a special package in your .tex document, there is no more incompatibilities with latex packages, and the synchronization is more precise. One disadvantage is that the generated synchronization file can be huge, and for that reason it has an option to zip it.

Installing SyncTex

SyncTex is not yet released in current TeX distributions (TeXLive 2007), but you can install it by following these steps:
1- install the TexLive distribution
2- replace the following three files:
C:\TeXLive2007\bin\win32\pdftex.exe
C:\TeXLive2007\bin\win32\pdftex.dll
C:\TeXLive2007\bin\win32\kpathsea356.dll
by pdftex.dll, pdftex.exe, and kpathsea356.dll.
3- Regenerate the format files using the setup program from the TexLive CD

Using SyncTex

Now to generate .synctex files you just need to specify the --synctex command-line argument to pdftex as follows:
pdflatex --synctex=-1 test.tex

Synchronizing with SumatraPDF

The author has provided a reference parser implementation for synchronization files generated by SyncTex. I have integrated it in SumatraPDF. If people are interested to test it, a binary version is available here.

I plan to commit my changes to the Sumatra code base in the coming days if I see that it works well with me.

[ 10 comments ] ( 346 views )   |  permalink  |  related link  |   ( 3.2 / 54 )

---

Update 21 May 2008: script file for emacs added

This is the dual of the previous post: I have now implemented forward-search in SumatraPDF, i.e. the ability to go from the source .tex file to the corresponding location in the PDF. The communication between the TeX editor and SumatraPDF relies on the DDE protocol. (Most TeX editors such as WinEdt and TeXnicCenter support it.)

Binary

If you want to give it a try, the updated binary can be downloaded here.

Configuring with WinEdt

For WinEdt, I have created a macro file to do all the stuff automatically. To install it, proceed as follows:

1- Download the macro file Sumatra-Find.edt.
2- Save it in the folder: C:\Program Files\WinEdt Team\WinEdt\Exec\
3- Edit the file: goto line 22 and replace the string 'd:\Tools\SumatraPDF-sync.exe' by the path to your local copy of Sumatra.
4- Go to the menu 'Option\Menu setup'. Create a new macro menu somewhere (under 'Accessories' for instance) and fill the options as follows:
Name: Sumatra Find
Macro: Exe('%b\Exec\Sumatra-Find.edt');
Requires File Filter: %P\%N.pdf
Start in: %P
Shortcut: F8

That's it! Now you can just press F8 anywhere in your .tex sources files and it will automatically locate the corresponding position in the PDF.

Configuring with TeXnicCenter

To setup forward-search with TeXnicCenter proceed as follows:
1- Menu 'Build\Define output profiles...'
2- Select the profile "Latex=>PDF"
3- Select the tab 'Viewer'
4- Fill the options as follows:
Path of executable: c:\tools\SumatraPDF-sync.exe
Forward search: select DDE command
Command: [ForwardSearch("%bm.pdf","%nc",%l,0)]
server: SUMATRA
topic: control

Configuring with ntEmacs

1- Download the script file sumatra-forward.el and load it from your init.el file.
2- Make sure that you have the ddeclient tools. (It is bundled with ntemacs)
3- Press F8 in the TeX document to trigger a forward-search

Synchronization in action

Screenshot

Enjoy! And feel free to post a comment to let me know how it works for you.


[ 8 comments ] ( 220 views )   |  permalink  |   ( 3.1 / 202 )

---

I am currently in the process of writing up my PhD thesis using Latex. I just realized how spoiled Mac users are when it comes to TeX tool support: nearly all Tex editors support viewing PDF files with source synchronization (iTeXMac2, TextMate, TeXniscope, TeXShop, PDFViewer). On the windows platform, until recently, not a single PDF viewer was capable of doing that including Acrobat, PDF-XChange Viewer, Foxit reader, and SumatraPDF.

Of course under the Windows platform we have the Yap DVI viewer that comes with the MikTeX distribution. Ah, Yap,... This crappy piece of software that becomes less and less usable as the version increases: poor responsiveness when browsing the document, no pre-caching of the images, polling the .dvi file thousands times a millisecond to check whether its content has changed instead of using the proper Windows API, blocking of the .dvi file preventing latex from compiling, and last but not least: loads of modal error messages forcing you to switch to the mouse to get rid of them when you just want to be typing your latex document.

A quick browsing journey on the web suggested me that I was not the only person to feel that frustrated about the current TeX viewing facilities on Windows. But since no one seemed to be interested in implementing the desired features, I decided to give it a try.

So here we are: I have proposed several patches for SumatraPDF that were accepted by the author: the first one implements autorefresh: when you recompile your tex document to pdf, the viewer automatically refreshes itself without any need for user interaction.

The second feature is inverse-search synchronization based on pdfsync: when you double-click on the pdf file it brings you directly to the .tex source file corresponding to that location in the pdf. By default the WinEdt editor is invoked. This can be configured (Menu 'File\set inverse search command line'). For instance the string to start TeXnicCenter is

"C:\Program Files\TeXnicCenter\TEXCNTR.EXE" /ddecmd "[goto('%f', '%l')]"

For WinEdt it is:

"C:\Program Files\WinEdt Team\WinEdt\winedt.exe" "[Open(|%f|);SelPar(%l,8)]"

I have also updated LatexDaemon to make it compatible with pdfsync.

If you want to give it a try, you can download the binary file here.
The changes to the source code have been submitted to the SVN repository at Google Code.

See also these forum posts

[ 5 comments ] ( 101 views )   |  permalink  |   ( 3 / 61 )

---

Recently I have tried to learn how to use the Docbook toolchain to produce documentation. My overall impression is not so good. I have many complaints but I am mainly concerned with its poor performance.

Take the editors: I have tried many of them including (XMLMind and Oxygen). On my machine (Athlon XP 1.25GHz, 1.5GB RAM, XP SP2), they all seem to struggle to analyze the XML document as I am typing it. With Oxygen, for instance, there is a noticeable delay of up to 5s when I type which makes it almost useless.
Of course you don't have to use an XML editor as you can edit your document with Notepad. However as the XSLT tools are very strict on the syntax (not like the way browsers interpret HTML), it can be quite hard to edit your document without assistance. Moreover since XML is by nature very verbose, you may end-up spending more time opening and closing corner brackets that actually typing your documents.

Now concerning the XSLT parser, the results speak for themselves: Processing 36.7KB of XML into a 33.3KB HTML file took 34.172s with the xsltproc parser and 38.719s with saxon.net 9.0.0.2. For such a simple file (it's a very small document, not even a book) that's just ridiculous! To give an element of comparison, on the same machine, to compile the TeX book (by Don Knuth) from a 1.35MB file TeX file into a 500-page PDF file weighting 2.23MB it just takes 7.25s!!! Conclusion, if Knuth had written his book using Docbook back in the 70s, he would probably still be waiting for the compilation to finish...

Note:As most of these tools are written in Java (IDE and XSLT included) I guess that part of the poor performance has to be imputed to Java.

[ add comment ] ( 14 views )   |  permalink  |   ( 3.1 / 156 )

---

| 1 | 2 | Next> Last>>