================================================================================
XREADER
================================================================================
What is it?
-----------
Xreader is a document viewer capable of displaying multiple and single page
document formats like PDF and Postscript. For more general information about
Xreader please visit our website at https://github.com/linuxmint/xreader.
This software is licensed under GNU GENERAL PUBLIC LICENSE Version 2 from June
1991 (see COPYING).
Requirements
------------
GTK+-3 development packages for *nix-like platforms. These information are only
interesting for developers, for users, certain dependencies can be retrieved
via automatic tools like rpm, apt, or such ones. The following options can be
enabled during build:
- GConf Support
- GTK+ Unix Print
- Keyring Support
- DBUS Support
- SM client support
- Thumbnailer
- Previewer
- Gtk-Doc Support
- Debug mode
- GObject Introspection
Installation
------------
This package should be available through your favorite software installation
tool. If you like to build it from source start by reading the chapter
'Building Xreader from source', and the file INSTALL.
Building Xreader from source
----------------------------
1) Install prerequisites:
apt install git dpkg-dev
apt install gobject-introspection libdjvulibre-dev libgail-3-dev \
libgirepository1.0-dev libgtk-3-dev libgxps-dev \
libkpathsea-dev libpoppler-glib-dev libsecret-1-dev \
libspectre-dev libtiff-dev libwebkit2gtk-4.0-dev libxapp-dev \
mate-common meson xsltproc yelp-tools
2) Download the source-code to your machine:
git clone https://github.com/linuxmint/xreader.git
3) cd into the downloaded folder
cd xreader
4) Run meson with options you like. The following configuration installs
all binaries, libs, and shared files into /usr/local, and enables all
available options:
meson debian/build \
--prefix=/usr/local \
--buildtype=plain \
-D deprecated_warnings=false \
-D djvu=true \
-D dvi=true \
-D t1lib=true \
-D pixbuf=true \
-D comics=true \
-D introspection=true
5) Compile and install (sudo is needed for install)
ninja -C debian/build
ninja -C debian/build install
6) Now you can run and test (most executables are in /usr/local/bin):
/usr/local/bin/xreader
If you want to test the daemon, run:
/usr/local/lib/x86_64-linux-gnu/xreaderd
You can enable debugging with the G_MESSAGES_DEBUG environmental
variable.
7) You can uninstall the installed files with
ninja -C debian/build uninstall
Hacking
-------
Our Coding Guidelines can be found under
https://www.gitbook.com/book/linuxmint/coding-guidelines.
Optional Backend Libraries
--------------------------
- Poppler for PDF Backend [ http://poppler.freedesktop.org/ ]
- DjVuLibre for DjVu viewing [ http://djvulibre.djvuzone.org/ ]
- Rar for viewing CBR comics [ http://www.rarsoft.com/ ]
- libgxps for XPS documents [ https://wiki.gnome.org/libgxps ]
- GhostScript for Postscript Backend [ http://www.cs.wisc.edu/~ghost/ ]
- What about libspectre [ http://libspectre.freedesktop.org/wiki/ ]
- TIFF Backend
- DVI Backend
- Pixbuf Backend
- Comics Backend
- Impress Backend
Requirements to Run Tests
-------------------------
1) Install prerequisites:
- python-dogtail [ https://fedorahosted.org/dogtail/ ]
- python-pyatspi2 [ http://download.gnome.org/sources/pyatspi/ ]
2) Now you can run GUI test:
ninja test -C debian/build/
Optional Programs
-----------------
- Freeware unrar for viewing CBR comics [ http://www.rarsoft.com/ ]
- Gna! unrar (unrar-free) can be used too, though it can't decompress rar v3.0
files [ http://gna.org/projects/unrar/ ]
- unzip for viewing CBZ comics [ http://www.info-zip.org ]
- p7zip for viewing CB7 comics [ http://p7zip.sourceforge.net/ ]