mirror/yacreader
1
0
Fork 0
mirror of https://github.com/YACReader/yacreader synced 2025-07-25 16:34:56 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update install instructions

Browse Source
This commit is contained in:
Felix Kauselmann
2018-01-17 21:09:11 +01:00
parent b87d5180c4
commit d1238bd22c
3 changed files with 46 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
INSTALL.md
View File

@ -7,7 +7,7 @@ program, run:
> make
> make install
from the source dir. For seperate builds of YACReader or YACReaderLibrary,
from the source dir. For separate builds of YACReader or YACReaderLibrary,
enter their respective subfolders and run the commands from there.
The headless version of YACReaderLibrary is located in the YACReaderLibraryServer
@ -35,14 +35,14 @@ folder. To build it, enter the folder and run the steps as described above.
Please note that not all of these dependencies are needed at build time.
A good example for this is YACReaderLibrary's GridView mode which will
silently fail and only show a white page if the proper qml modules
(declarative, quickcontrols) are not missing.
(declarative, quickcontrols) are missing.
## Backends
### Decompression
YACReader uses [(lib)unarr](https://github.com/selmf/unarr) for comic book
decompression. Most Linux distributions don't ship this library yet, so will
decompression. Most Linux distributions don't ship this library yet, so you will
probably have to build it yourself.
We recommend using (lib)unarr as a shared library, but we also support static
@ -53,10 +53,10 @@ for more information on this topic.
Starting with version 9.0.0 YACReader supports the following pdf render engines:
- poppler (Linux default)
- pdfium (Default for Windows and MacOS)
- pdfkit (macOS only)
- no_pdf (disables pdf support)
- poppler (Linux/Unix default)
- pdfium (default for Windows and MacOS)
- pdfkit (MacOS only)
- no_pdf (no pdf support)
To override the default for a given platform add CONFIG+=[pdfbackend] as an options
when running qmake.
@ -64,12 +64,12 @@ when running qmake.
While the Poppler backend is well tested and has been the standard for YACReader
for a long time, it's performance is a bit lacking. The pdfium engine offers
much better performance (about 10x faster on some pdf files we tested).
However, at the time of this writing, it is not a software that is available
However, at the time of this writing, it is not a library that is available
prepackaged for Linux.
### Other build options:
You can adjust the installation prefix as well als the path make install uses
You can adjust the installation prefix as well als the path "make install" uses
to install the files.
>qmake PREFIX=DIR
@ -91,7 +91,7 @@ the no_opengl config option:
qmake-qt5 CONFIG+=no_opengl
This will remove any dependency on desktop OpenGL and hardlock YACReader's
coverflow to software rendering. Please note that it doesn't actually remove
coverflow to software rendering. Please note that it does not actually remove
OpenGL from the build, the Qt toolkit will still make use of it.
@ -101,10 +101,12 @@ If you're compiling YACReader because there is no package available for your
Linux distribution please consider creating and submitting a package or filing a
package request.
While we do provide packages for .deb based distributions as well as an AUR
package for Archlinux, we are in need of packagers especially for RPM based
distributions. If you are interested, please contact @selmf on the YACReader
forums or write an email to info@yacreader.com
While we do provide packages for .deb and .rpm based distributions as well as an
AUR package for Archlinux and it's derivates, we are in need of downstream packagers
that are willing to make YACReader available as a standard package for their distro.
If you are interested, please contact @selmf on the YACReader forums or write
an email to info@yacreader.com
If you have already created a package please let us know so we can add it to
our downloads list ;)