|
1 | 1 | # LDOCE5 Viewer |
2 | 2 |
|
| 3 | +***See this fork:*** |
| 4 | + |
| 5 | +https://github.com/purboo/ldoce5viewer-pyqt5 |
| 6 | + |
| 7 | +----- |
| 8 | + |
3 | 9 |  |
4 | 10 |
|
5 | 11 | The LDOCE5 Viewer is an alternative dictionary viewer for the Longman Dictionary of Contemporary English 5th Edition (LDOCE 5). |
6 | 12 |
|
7 | | -Website: http://hakidame.net/ldoce5viewer/ |
8 | | - |
9 | 13 | It runs on Linux, Mac OS X and Microsoft Windows. |
10 | 14 |
|
11 | 15 | This software is free and open source software licensed under the terms of GPLv3. |
12 | 16 |
|
13 | | - |
14 | | -## Prerequisites |
15 | | - |
16 | | -* Longman Dictionary of Contemporary English 5th Edition (DVD-ROM) |
17 | | -* Python 2.7 or 2.6 (or 3.x) |
18 | | -* Development tools for PyQt4 |
19 | | -* lxml |
20 | | -* Whoosh 2.x |
21 | | - |
22 | | - |
23 | | -## Installation |
24 | | - |
25 | | -### Windows |
26 | | - |
27 | | -Simple download and execute the .exe file [here](https://forward-backward.co.jp/ldoce5viewer/download). |
28 | | - |
29 | | -### Linux |
30 | | - |
31 | | -If a package is yet to be available for your distro, you need to build it from source. |
32 | | - |
33 | | -#### Available Packages |
34 | | - |
35 | | -For Arch Linux, two packages [ldoce5viewer](https://aur.archlinux.org/packages/ldoce5viewer/) and [ldoce5viewer-git](https://aur.archlinux.org/packages/ldoce5viewer-git/) exist on AUR. |
36 | | - |
37 | | -#### Prequisites for building from source |
38 | | - |
39 | | -* Python 2.7 or 2.6 (or 3.x) |
40 | | - |
41 | | -* Development tools for PyQt4 |
42 | | - |
43 | | - - `pyqt4-dev-tools` (Ubuntu/Mint/Debian), `pyqt4-dev-tools` (Arch Linux) |
44 | | - |
45 | | -* lxml |
46 | | - |
47 | | - - `python-lxml` (Ubuntu/Mint/Debian), `python-lxml` (Arch Linux) |
48 | | - |
49 | | - |
50 | | -* Whoosh 2.x |
51 | | - - `python-whoosh` (Ubuntu/Mint/Debian), `python-whoosh` in AUR (Arch Linux) |
52 | | - |
53 | | - - If you are on Ubuntu 15+, the default python-whoosh to be installed is 2.7.0+, which may cause error with the application during index. Therefore,you have 2 options : |
54 | | - + Use pip to install python whoosh 2.5.`python-pip` `pip install whoosh==2.5.7` |
55 | | - |
56 | | - + Install .deb file from [here](http://packages.ubuntu.com/trusty/all/python-whoosh/download) to grab the old version (2.5.7) of python-whoosh. |
57 | | - |
58 | | - |
59 | | -* [On Linux] Python bindings for Gstreamer |
60 | | - |
61 | | - - `python-gst0.10` (Ubuntu/Mint/Debian), `gstreamer0.10-python` (Arch Linux) |
62 | | - |
63 | | -* [On Linux] Gstreamer plugins for MP3 audio playback |
64 | | - |
65 | | - - `gstreamer0.10-plugins-good` & `gstreamer0.10-plugins-ugly` (Ubuntu/Mint/Debian), `gstreamer0.10-good-plugins` & `gstreamer0.10-ugly-plugins` (Arch Linux) |
66 | | - |
67 | | -If you're using Ubuntu 15.x, you should install python-qt4-phonon to pronunce words and sentences correctly: |
68 | | - - `python-qt4-phonon` |
69 | | - |
70 | | -## Installation |
71 | | - |
72 | | -### Linux |
73 | | - |
74 | | -#### Packages |
75 | | - |
76 | | -For Arch Linux, two packages [ldoce5viewer](https://aur.archlinux.org/packages/ldoce5viewer/) and [ldoce5viewer-git](https://aur.archlinux.org/packages/ldoce5viewer-git/) exist on AUR. |
77 | | - |
78 | | -#### Manually |
79 | | - |
80 | | -1. Enter the following commands in the terminal: |
81 | | - |
82 | | - ```bash |
83 | | - $ make build |
84 | | - $ sudo make install |
85 | | - ``` |
86 | | - |
87 | | -2. Copy the 'ldoce5.data' directory from the LDOCE5 DVD-ROM to an arbitrary location in your HDD or SSD. |
88 | | - |
89 | | -3. Start the LDOCE5 Viewer. |
90 | | - |
91 | | -4. The application will ask you the location where you put 'ldoce5.data'. |
92 | | - |
93 | | -### Mac OS X |
94 | | - |
95 | | -#### Available packages |
96 | | - |
97 | | -Download and run your .app file [here](https://forward-backward.co.jp/ldoce5viewer/download) |
98 | | - |
99 | | -#### Install manually From Source |
100 | | - |
101 | | -*Homebrew*: |
102 | | -```bash |
103 | | -$ brew install pyqt |
104 | | -$ pip install lxml pyobjc-core pyobjc-framework-Cocoa whoosh py2app |
105 | | -$ # inside ldoce5viewer directory |
106 | | -$ sudo DISTUTILS_DEBUG=1 python setup.py py2app |
107 | | -$ open dist/LDOCE5\ Viewer.app/ |
108 | | -``` |
109 | | - |
110 | | -Or if you are using *MacPorts*: |
111 | | -- Install the following ports: |
112 | | - * python27 (or python3x) |
113 | | - * py27-pyqt4 |
114 | | - * py27-lxml |
115 | | - * py27-whoosh |
116 | | - * py27-pyobjc-cocoa |
117 | | -- Run the LDOCE5 Viewer |
118 | | - |
0 commit comments