9aa3c44d4e
* add config and GUI support for internal player back end switching;
* make FFmpeg player disabling option consistent with other similar
qmake options by using CONFIG;
* add a new qmake option that disables Qt Multimedia player. This is
useful for GNU/Linux distributions where Qt WebKit and Qt Multimedia
packages depend on different GStreamer versions and don't work
correctly when combined in one application.
The existing FFmpeg+libao internal player back end has a relatively
low-level implementation, which is difficult to understand and improve.
There are at least 3 open internal player issues:
1) many GNU/Linux users have to edit their libao configuration file to
make Goldendict's internal player work (issue #412);
2) libao's pulseaudio plugin does not support 32-bit audio, which
means that many MediaWiki pronunciations don't work with the most
popular GNU/Linux audio driver (issue #949);
3) Ffmpeg::DecoderContext uses deprecated FFmpeg APIs, which causes
compiler warnings and means that this internal player back end
may not compile with a future FFmpeg library version (issue #978).
The Qt Multimedia back end implementation uses the highest-level
Qt audio API and is very simple.
This new back end works flawlessly on my GNU/Linux machine.
I'm not making it the default back end because I don't know how well
it will work on other platforms with different configurations.
5.8 KiB
Introduction
GoldenDict is a feature-rich dictionary lookup program, supporting multiple dictionary formats (StarDict/Babylon/Lingvo/Dictd/AARD/MDict/SDict) and online dictionaries, featuring perfect article rendering with the complete markup, illustrations and other content retained, and allowing you to type in words without any accents or correct case.
Requirements
This code has been run and tested on Windows XP/Vista/7, Ubuntu Linux, Mac OS X.
External Deps
- Make, GCC, Git
- Qt framework. Minimum required version is 4.6. But Qt 4.7 or 4.8 is recommended.
- Qt Creator IDE is recommended for development
- Various libraries on Linux (png, zlib, etc)
- On Mac and Windows all the libraries are already included in the repository
Installing External Deps on Ubuntu Linux
sudo apt-get install git pkg-config build-essential qt4-qmake \
libvorbis-dev zlib1g-dev libhunspell-dev x11proto-record-dev \
libqt4-dev libqtwebkit-dev libxtst-dev liblzo2-dev libbz2-dev \
libao-dev libavutil-dev libavformat-dev libtiff5-dev libeb16-dev
Installing External Deps on Ubuntu Linux for Qt5
sudo apt-get install git pkg-config build-essential qt5-qmake \
libvorbis-dev zlib1g-dev libhunspell-dev x11proto-record-dev \
qtdeclarative5-dev libqtwebkit-dev libxtst-dev liblzo2-dev libbz2-dev \
libao-dev libavutil-dev libavformat-dev libtiff5-dev libeb16-dev \
libqt5webkit5-dev libqt5svg5-dev libqt5x11extras5-dev qttools5-dev \
qttools5-dev-tools qtmultimedia5-dev libqt5multimedia5-plugins
How to build
First, clone this repository, e.g.:
git clone git://github.com/goldendict/goldendict.git
And then invoke qmake-qt4 and make:
cd goldendict && qmake-qt4 && make
In case when qmake-qt4 does not exist, try using qmake but make sure it is indeed from the Qt 4 installation.
On the other hand, if you want to use qt5, make sure that qmake is from Qt 5 installation. If not, you can try
finding it at a path like /usr/lib/x86_64-linux-gnu/qt5/bin/qmake.
Alternatively, you might want to load goldendict.pro file from within Qt Creator, especially on Windows.
Note: To compile with libhunspell older than 1.5 pass "CONFIG+=old_hunspell" to qmake.
Building with Chinese conversion support
To add Chinese conversion support you need at first install libopencc-dev package:
sudo apt-get install libopencc-dev
Then pass "CONFIG+=chinese_conversion_support" to qmake
qmake "CONFIG+=chinese_conversion_support"
Building with Zim dictionaries support
To add Zim and Slob formats support you need at first install lzma-dev package:
sudo apt-get install liblzma-dev
Then pass "CONFIG+=zim_support" to qmake
qmake "CONFIG+=zim_support"
Building without extra tiff handler
If you have problem building with libtiff5-dev package, you can pass
"CONFIG+=no_extra_tiff_handler" to qmake in order to disable extra tiff support
(without such extra support some b/w tiff images will not be displayed):
qmake "CONFIG+=no_extra_tiff_handler"
Building without Epwing format support
If you have problem building with libeb-dev package, you can pass
"CONFIG+=no_epwing_support" to qmake in order to disable Epwing format support
qmake "CONFIG+=no_epwing_support"
Building without internal audio players
If you have problem building with FFmpeg/libao (for example, Ubuntu older than 12.04), you can pass
"CONFIG+=no_ffmpeg_player" to qmake in order to disable FFmpeg+libao internal audio player back end:
qmake "CONFIG+=no_ffmpeg_player"
If you have problem building with Qt5 Multimedia or experience GStreamer run-time errors (for example, Ubuntu 14.04), you can pass
"CONFIG+=no_qtmultimedia_player" to qmake in order to disable Qt Multimedia internal audio player back end:
qmake "CONFIG+=no_qtmultimedia_player"
NB: All additional settings for qmake that you need must be combined in one qmake launch, for example:
qmake "CONFIG+=zim_support" "CONFIG+=no_extra_tiff_handler" "CONFIG+=no_ffmpeg_player"
Then, invoke make clean before make because the setting change:
make clean && make
Building under Windows with MS Visual Studio
To build GoldenDict with Visual Studio take one of next library packs and unpack it to "winlibs/lib/msvc" folder in GoldenDict sources folder.
GoldenDict_libs_VS2013_x86_v4.7z - for MS Visual Studio 2013, 32 bit
GoldenDict_libs_VS2013_x64_v4.7z - for MS Visual Studio 2013, 64 bit
GoldenDict_libs_VS2015_x86_v4.7z - for MS Visual Studio 2015, 32 bit
GoldenDict_libs_VS2015_x64_v4.7z - for MS Visual Studio 2015, 64 bit
To create project files for Visual Studio you can pass "-tp vc" option to qmake.
Note: In Qt 5.6.0 and later the Webkit module was removed from official release builds. You should to build it from sources to compile GoldenDict.
Installation
Installation is an optional step since the built binary can be used as-is without installation. But you can properly install via:
make install
NB: Don't do that on Windows!
License
This project is licensed under the GNU GPLv3+ license, a copy of which can be found in the LICENSE.txt file.
Support
Users looking for support should file an issue in the official GoldenDict issue tracker, or even better: submit a pull request if you have a fix available. General questions should be asked on the official GoldenDict forum.