*[[Evince:http://projects.gnome.org/evince/]] [#fec1fb99]

#ref(http://git.gnome.org/browse/evince/plain/data/icons/256x256/apps/evince.png,right,around,nolink,Evince)

&color(White,#5F2F2F){  ''◆目次◆''  };&br;

#contents

*Evince とは [#l8fbb2e6]

Evince は PDF, PS, DVI ファイルが表示可能なドキュメント・ビューアです.~
SyncTeX に対応しています.~
ファイルの自動更新機能もあります.~

-[[Evince:http://projects.gnome.org/evince/]]
-[[Evince Document Viewer:http://library.gnome.org/users/evince/stable/index.html.en]]
--[[Evince Document Viewer › SyncTex » Supported Editors:http://library.gnome.org/users/evince/stable/synctex-editors.html.en]]
-[[evince.mirror:http://sourceforge.net/projects/evince.mirror/]]

**動作環境 [#q9c64542]

Windows, OS X, Linux

**License [#lf30b1e1]

[[GPL:http://git.gnome.org/browse/evince/tree/COPYING]]

**リリース情報 [#m8e1200a]

http://git.gnome.org/browse/evince/refs/tags を参照.~

**ChangeLog [#nb7ae766]
-[[git:http://git.gnome.org/browse/evince/]]
--[[log:http://git.gnome.org/browse/evince/log/]]

*ダウンロード/インストール [#j395f01d]

**Windows [#f2460848]

-[[Evince/Downloads - GNOME Live!:https://live.gnome.org/Evince/Downloads]]

公式サイトの Windows 版の Evince で日本語を表示したい場合はフォントを埋め込む必要があります.~
自分で Evince をビルドして使用する場合はフォントを埋め込まなくても日本語を表示することが可能です.~
Evince は [[MinGW]] でビルド可能です.~

**OS X [#y8d21820]

-[[/trunk/dports/gnome/evince/Portfile:http://trac.macports.org/browser/trunk/dports/gnome/evince/Portfile]]

**Ubuntu [#lacd43b5]

-[[Ubuntu -- パッケージ検索結果 -- evince:http://packages.ubuntu.com/ja/evince]]

**Debian [#rf817124]

-[[Debian -- パッケージ検索結果 -- evince:http://packages.debian.org/ja/evince]]

**Fedora [#jbf882d0]

-[[Fedora Package Database -- evince:https://admin.fedoraproject.org/pkgdb/acls/name/evince]]

**openSUSE [#rd040fd0]

-http://software.opensuse.org/package/evince

**Arch Linux [#eb51c4f9]

-https://www.archlinux.org/packages/?q=evince

**Beyond Linux From Scratch [#i9f92bae]

-http://www.linuxfromscratch.org/blfs/view/svn/gnome/evince.html
-http://lfsbookja.sourceforge.jp/BLFS/svn.ja/gnome/evince.html

*forward and inverse search [#ga060086]

[[Evince 2.31.5:http://git.gnome.org/browse/evince/commit/?id=EVINCE_2_31_5]] から SyncTeX による forward and inverse search が可能になりました.~
[[Evince 2.91.0:http://git.gnome.org/browse/evince/commit/?id=EVINCE_2_91_0]] で D-Bus の仕様が変更されました. → [[[shell] Add timestamp parameter to SyncView.:http://git.gnome.org/browse/evince/commit/?id=a2b36d8928c30f93f74869b294e72d2484422646]]~
[[Evince 3.5.5:http://git.gnome.org/browse/evince/commit/?id=3.5.5]] で D-Bus のインターフェースに gdbus-codegen が使用されるようになりました. → [[daemon: Use gdbus-codegen for the org.gnome.evince.Daemon interface:http://git.gnome.org/browse/evince/commit/?id=1aac15e8098f1b2197f5bcf2430395ee9843eb43]]~
fwdevince, evince_forward_search を使用して forward search ができます.~
invevince, evince_backward_search を使用して inverse search ができます.~
inverse search は Ctrl + 左クリックで対応する TeX 文書の該当箇所にジャンプします.~

**fwdevince [#ie18c015]

fwdevince は Linux の Evince で forward and inverse search を行うためのツールです.~
TeX Live 2012, Evince 3.4.0, Python 2.7.3 または Python 3.2.3 で動作確認しています.~
TeX Live 2012, Evince 3.6.0, Python 2.7.3 でも動作するようです. → [[Ubuntu 12.10: fwdevince によるEvince で forward searchうまくいきました。:https://twitter.com/ti5942/status/269820600980213760]], [[早速ですが、2012年11月17日掲載のfwdevinceを試してみる:http://blog.livedoor.jp/ti5942/archives/7580234.html]]~
fwdevince がうまく動作しない場合は

-fwdevince をうまく動作するように修正する
-evince_synctex (evince_forward_search & evince_backward_search) を使用する

などの方法で対処してください.~

----
-fwdevince
----
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 # Copyright (C) 2010 Jose Aliste
 #               2011 Benjamin Kellermann
 #
 # This program is free software; you can redistribute it and/or modify it under
 # the terms of the GNU General Public Licence as published by the Free Software
 # Foundation; either version 2 of the Licence, or (at your option) any later
 # version.
 #
 # This program is distributed in the hope that it will be useful, but WITHOUT
 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 # FOR A PARTICULAR PURPOSE.  See the GNU General Public Licence for more
 # details.
 #
 # You should have received a copy of the GNU General Public Licence along with
 # this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
 # Street, Fifth Floor, Boston, MA  02110-1301, USA
 
 import dbus
 import argparse
 import os.path
 import traceback
 import sys
 
 if sys.version_info >= (3, 0, 0):
     from urllib.parse import quote, unquote
 else:
     from urllib import quote, unquote
 
 class EvinceForwardSearch:
     def parse_args(self):
         parser = argparse.ArgumentParser(description='Forward search with Evince')
         parser.add_argument('pdf', nargs=1, help='PDF file')
         parser.add_argument('line', nargs=1, type=int, help='Line')
         parser.add_argument('tex', nargs=1, help='TeX file')
         return parser.parse_args()
 
     def run(self):
         args = self.parse_args()
         pdf = os.path.abspath(args.pdf[0]).replace(" ", "%20")
         line = int(args.line[0])
         tex = os.path.join(os.path.dirname(os.path.abspath(args.tex[0])), './', os.path.basename(os.path.abspath(args.tex[0])))
 
         try:
             import time
             bus = dbus.SessionBus()
             daemon = bus.get_object('org.gnome.evince.Daemon', '/org/gnome/evince/Daemon')
             dbus_name = daemon.FindDocument('file://' + quote(pdf, safe="%/:=&?~#+!$,;'@()*[]"), True, dbus_interface='org.gnome.evince.Daemon')
             window = bus.get_object(dbus_name, '/org/gnome/evince/Window/0')
             time.sleep(0.2)
             window.SyncView(tex, (line, 1), 0, dbus_interface='org.gnome.evince.Window')
         except dbus.DBusException:
             traceback.print_exc()
 
 class EvinceInverseSearch:
     def parse_args(self):
         parser = argparse.ArgumentParser(description='Inverse search with Evince')
         parser.add_argument('pdf', nargs=1, help='PDF file')
         parser.add_argument('editor', nargs=1, help='Editor command')
         return parser.parse_args()
 
     def run(self):
         import dbus.mainloop.glib
         from gi.repository import GObject
         args = self.parse_args()
         pdf = os.path.abspath(args.pdf[0])
         editor = args.editor[0]
         dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
         a = EvinceWindowProxy('file://' + pdf, editor, True)
         loop = GObject.MainLoop()
         loop.run()
 
 class EvinceWindowProxy:
     """A Dbus proxy for an Evince Window."""
     daemon = None
     bus = None
 
     RUNNING = range(2)
     CLOSED = range(2)
     EV_DAEMON_PATH = '/org/gnome/evince/Daemon'
     EV_DAEMON_NAME = 'org.gnome.evince.Daemon'
     EV_DAEMON_IFACE = 'org.gnome.evince.Daemon'
 
     EVINCE_PATH = '/org/gnome/evince/Evince'
     EVINCE_IFACE = 'org.gnome.evince.Application'
 
     EV_WINDOW_IFACE = 'org.gnome.evince.Window'
 
     def __init__(self, uri, editor, apawn=False, logger=None):
         self._log = logger
         self.uri = uri.replace(" ", "%20")
         self.editor = editor
         self.status = self.CLOSED
         self.source_handler = None
         self.dbus_name = ''
         self._handler = None
         try:
             if EvinceWindowProxy.bus is None:
                 EvinceWindowProxy.bus = dbus.SessionBus()
 
             if EvinceWindowProxy.daemon is None:
                 EvinceWindowProxy.daemon = EvinceWindowProxy.bus.get_object(self.EV_DAEMON_NAME,
                     self.EV_DAEMON_PATH,
                     follow_name_owner_changes=True)
             EvinceWindowProxy.bus.add_signal_receiver(self._on_doc_loaded,
                 signal_name='DocumentLoaded',
                 dbus_interface=self.EV_WINDOW_IFACE,
                 sender_keyword='sender')
             self._get_dbus_name(False)
         except dbus.DBusException:
             traceback.print_exc()
             if self._log:
                 self._log.debug('Could not connect to the Evince Daemon')
 
     def _on_doc_loaded(self, uri, **keyargs):
         if uri == self.uri and self._handler is None:
             self.handle_find_document_reply(keyargs['sender'])
 
     def _get_dbus_name(self, spawn):
         EvinceWindowProxy.daemon.FindDocument(self.uri, spawn,
                      reply_handler=self.handle_find_document_reply,
                      error_handler=self.handle_find_document_error,
                      dbus_interface = self.EV_DAEMON_IFACE)
 
     def handle_find_document_error(self, error):
         if self._log:
             self._log.debug('FindDocument DBus call has failed')
 
     def handle_find_document_reply(self, evince_name):
         if self._handler is not None:
             handler = self._handler
         else:
             handler = self.handle_get_window_list_reply
         if evince_name != '':
             self.dbus_name = evince_name
             self.status = self.RUNNING
             self.evince = EvinceWindowProxy.bus.get_object(self.dbus_name, self.EVINCE_PATH)
             self.evince.GetWindowList(dbus_interface = self.EVINCE_IFACE,
                           reply_handler = handler,
                           error_handler = self.handle_get_window_list_error)
 
     def handle_get_window_list_error (self, e):
         if self._log:
             self._log.debug("GetWindowList DBus call has failed")
 
     def handle_get_window_list_reply (self, window_list):
         if len(window_list) > 0:
             window_obj = EvinceWindowProxy.bus.get_object(self.dbus_name, window_list[0])
             self.window = dbus.Interface(window_obj,self.EV_WINDOW_IFACE)
             self.window.connect_to_signal("SyncSource", self.on_sync_source)
         else:
             #That should never happen. 
             if self._log:
                 self._log.debug("GetWindowList returned empty list")
 
     def on_sync_source(self, input_file, source_link, timestamp):
         import subprocess
         import re
         print(input_file + ':' + str(source_link[0]))
         # This is probably useless
         input_file = input_file.replace("%20", " ")
         # This is to deal with source files with non-ascii names
         # We get url-quoted UTF-8 from dbus; convert to url-quoted ascii
         # and then unquote. If you don't first convert ot ascii, it fails.
         # It's a bit magical, but it seems to work
         #input_file = unquote(input_file.encode('ascii'))
         input_file = unquote(input_file)
         print(type(input_file), input_file)
         #cmd = re.sub("%f", input_file, self.editor)
         cmd = re.sub("%f", input_file.replace('file://', ''), self.editor)
         cmd = re.sub("%l", str(source_link[0]), cmd)
         print(cmd)
         subprocess.call(cmd, shell=True)
         if self.source_handler is not None:
             self.source_handler(input_file, source_link, timestamp)
 
 if __name__ == '__main__':
     cmd = os.path.basename(sys.argv[0])
     if cmd == 'fwdevince' or cmd == 'evince_forward_search':
         synctexSearch = EvinceForwardSearch()
         synctexSearch.run()
     elif cmd == 'invevince' or cmd == 'evince_inverse_search' or cmd == 'evince_backward_search':
         synctexSearch = EvinceInverseSearch()
         synctexSearch.run()
     else:
         sys.stderr.write("rename 'fwdevince' or 'invevince'\n")
         sys.exit(1)
----

 $ chmod +x fwdevince
 $ sudo cp -p fwdevince /usr/local/bin
 $ sudo ln -s /usr/local/bin/fwdevince /usr/local/bin/invevince

fwdevince は例えば

 $ fwdevince hoge.pdf 30 hoge.tex

のように実行すると Evince が起動して PDF ファイルの対応する行が赤い枠で囲まれて表示されます.

invevince は例えば [[TeXworks]] の場合は

 $ evince hoge.pdf &
 $ invevince hoge.pdf "texworks --position=%l %f"

のように実行して Evince 上で Ctrl + 左クリックを実行すると TeXworks が起動して TeX 文書の対応する行にジャンプします.~

**evince_synctex (evince_forward_search & evince_backward_search)  [#bb04e129]

evince_synctex (evince_forward_search & evince_backward_search) は Linux の Evince で forward and inverse search を行うためのツールです.~

-[[LaTeXTools/evince at master · SublimeText/LaTeXTools · GitHub:https://github.com/SublimeText/LaTeXTools/tree/master/evince]]
-[[synctex + gedit + evince:http://www.benwhale.com/blog/2011/06/26/synctex-gedit-evince/]]
-[[[SOLVED] HOWTO: Evince + SyncTeX + vim/emacs/scite/lyx/kile/$EDITOR + forward/backward search - Ubuntu Forums:http://ubuntuforums.org/showthread.php?t=1716268]]
-[[[SOLVED] HOWTO: Evince + SyncTeX + vim/emacs/scite/lyx/kile/$EDITOR + forward/backward search [Archive]  - Ubuntu Forums:http://ubuntuforums.org/archive/index.php/t-1716268.html]]

***注意点 [#s90f2b11]

evince_forward_search で

 pdf_file = os.path.abspath(sys.argv[1])

を

 #pdf_file = os.path.abspath(sys.argv[1])
 pdf_file = os.path.abspath(sys.argv[1]).replace(" ", "%20")

に修正します.~

evince_backward_search で

 self.uri = uri

を

 #self.uri = uri
 self.uri = uri.replace(" ", "%20")

に修正して

     def on_sync_source(self, input_file, source_link):
         print input_file + ":" + str(source_link[0])

を

     def on_sync_source(self, input_file, source_link):
         input_file = input_file.replace("%20", " ")
         print input_file + ":" + str(source_link[0])

に修正します.~


TeX Live 2011 以降では SyncTeX が出力するファイル名が TeX Live 2010 とは異なっています.~
evince_forward_search で
 tex_file = os.path.abspath(sys.argv[3])
となっていますが,この場合フルパス表記 /dirname/basename.tex になってしまうので,/dirname/./basename.tex の場合に forward search ができません.~
tex_file の値を適切な値になるように修正すれば forward search が可能になります.
 #tex_file = os.path.abspath(sys.argv[3])
 tex_file = os.path.join(os.path.dirname(os.path.abspath(sys.argv[3])), './', os.path.basename(os.path.abspath(sys.argv[3])))
Evince 2.91.0 以降を使用する場合は [[D-Bus の仕様が変更されている:http://git.gnome.org/browse/evince/commit/?id=EVINCE_2_91_0]]ので evince_forward_search を
 #window.SyncView(tex_file, (line_number,1), dbus_interface="org.gnome.evince.Window")
 window.SyncView(tex_file, (line_number,1), 0, dbus_interface="org.gnome.evince.Window")
に修正して evince_backward_search を
 #    def on_sync_source(self, input_file, source_link):
     def on_sync_source(self, input_file, source_link, timestamp):
         print input_file + ":" + str(source_link[0])
         cmd = re.sub("%f",input_file,self.editor)
         cmd = re.sub("%l",str(source_link[0]), cmd)
         print cmd
         subprocess.call(cmd, shell=True)
         if self.source_handler is not None:
 #            self.source_handler(input_file, source_link)
             self.source_handler(input_file, source_link, timestamp)
に修正します.

Okular にも同様の問題が発生していたようです.
-[[Emacs/AUCTeX: Rewriting the Okular-make-url function to work with new synctex (full path + “./”) syntax:http://stackoverflow.com/questions/6898710/emacs-auctex-rewriting-the-okular-make-url-function-to-work-with-new-synctex-f]]
-[[Bug 274294 - okular's synctex support doesn't work with lua(la)tex generated output:https://bugs.kde.org/show_bug.cgi?id=274294]] → Fixed

*関連リンク [#n7670496]
-[[evinceで明朝がゴシックになる:http://d.hatena.ne.jp/mcm57/20130115/1358250271]]
-[[(W32TeX)LualatexのPDFがEvinceで日本語が表示されない:http://oku.edu.mie-u.ac.jp/tex/mod/forum/discuss.php?d=836]]