comparison README @ 624:4cae1118e881

Partially update main README. A section concerning overlay info was added. Translation statistics were updated.
author zas_
date Sun, 11 May 2008 10:25:04 +0000
parents 4dd932188d42
children 02e2c135ee0c
comparison
equal deleted inserted replaced
623:48bfa03502d3 624:4cae1118e881
1
2 This is Geeqie, a successor of GQview.
3
4 Geeqie has been forked from GQview project, because it was not
5 possible to contact gqview author and the only maintainer.
6 Geeqie projects goal is to move the development forward and
7 also integrate the existing patches.
8
9 Geeqie is currently in alpha state. Everybody is encouraged
10 to try the new features, however for stable software look at
11 the original project.
12
13 For more info see:
14 http://geeqie.sourceforge.net
15
16 Vladimir Nadvornik
17 Petr Ostadal
18
19 Please send any question or suggestions to
20 geeqie-devel@lists.sourceforge.net
21
22
23 Below is the original README:
24
25
26 ################################################################### 1 ###################################################################
27 ## GQview 2.1.5 (December 3, 2006) ## 2 ## Geeqie 1.0alpha1 ##
28 ## ## 3 ## ##
4 ## Copyright (C) 2008 The Geeqie Team ##
29 ## Copyright (C) 1999 - 2006 John Ellis. ## 5 ## Copyright (C) 1999 - 2006 John Ellis. ##
30 ## ## 6 ## ##
31 ## Use at your own risk! ## 7 ## Use at your own risk! ##
32 ## ## 8 ## ##
33 ## This software released under the GNU General Public License. ## 9 ## This software released under the GNU General Public License. ##
34 ## Please read the COPYING file for more information. ## 10 ## Please read the COPYING file for more information. ##
35 ################################################################### 11 ###################################################################
36 12
37 Author: John Ellis <johne@verizon.net> 13 This is Geeqie, a successor of GQview.
38 e-mail: gqview@users.sourceforge.net 14
39 homepage: http://gqview.sourceforge.net 15 Geeqie has been forked from GQview project, because it was not
40 16 possible to contact gqview author and the only maintainer.
41 17 Geeqie projects goal is to move the development forward and
42 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! 18 also integrate the existing patches.
43 19
44 The 2.1.x series are all development releases, and as such may 20 Geeqie is currently in alpha state. Everybody is encouraged
45 contain incredible bugs. Only use if interested in the new features. 21 to try the new features, however for stable software look at
46 22 the original project.
47 The stable release as of this writing is 2.0.0. 23
48 24 For more info see:
49 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! 25 http://geeqie.sourceforge.net
26
27 Vladimir Nadvornik
28 Petr Ostadal
29
30 Please send any question or suggestions to
31 geeqie-devel@lists.sourceforge.net
32
33
50 34
51 35
52 ======== README contents: 36 ======== README contents:
53 37
54 * Requirements 38 * Requirements
67 GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk 51 GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk
68 52
69 Optional libraries: 53 Optional libraries:
70 lcms, for color management support: http://www.littlecms.com 54 lcms, for color management support: http://www.littlecms.com
71 (disable with configure option: '--without-lcms') 55 (disable with configure option: '--without-lcms')
56 exiv2, for enhanced exif support: http://www.exiv2.org/
57 (disable with configure option: '--without-exiv2')
58 lirc, for remote control support: http://www.lirc.org/
59 (disable with configure option: '--disable-lirc')
72 60
73 ======== Notes and changes for this release [section:release_notes] 61 ======== Notes and changes for this release [section:release_notes]
74 62
75 Changes: 63 Changes:
76 64
93 81
94 Notes: 82 Notes:
95 83
96 For translation status list, see further below. 84 For translation status list, see further below.
97 85
98 Version in perenthesis indicates first appearance of feature or change. 86 Version in parenthesis indicates first appearance of feature or change.
99 87
88 !!! FIXME Geeqie changes !!!
89
90 Below are GQView releases:
100 (2.1.5) Add support for color profiles when lcms is installed. To 91 (2.1.5) Add support for color profiles when lcms is installed. To
101 disable color profiles and use of lcms, run configure 92 disable color profiles and use of lcms, run configure
102 with '--without-lcms'. 93 with '--without-lcms'.
103 94
104 (2.1.1) Add support for viewing jpeg images and EXIF embedded within 95 (2.1.1) Add support for viewing jpeg images and EXIF embedded within
189 dragging a directory onto the list. 180 dragging a directory onto the list.
190 181
191 Code hackers: 182 Code hackers:
192 183
193 If you plan on making any major changes to the code that will be offered 184 If you plan on making any major changes to the code that will be offered
194 for inclusion to the main source, please contact me first - so that we 185 for inclusion to the main source, please contact us first - so that we
195 can avoid duplication of effort. A good example is porting any part of 186 can avoid duplication of effort. A good example is porting any part of
196 GQview that uses deprecated widgets to GTK2 widgets, there are already 187 GQview that uses deprecated widgets to GTK2 widgets, there are already
197 several such patches floating around. This is especially true if the 188 several such patches floating around. This is especially true if the
198 change is listed in the TODO! 189 change is listed in the TODO!
199 -John ( johne@verizon.net ) 190 The Geeqie Team
200 191
201 Known bugs: 192 Known bugs:
202 193
203 see the TODO file. 194 see the Geeqie Bug Tracker at TODO file.
204 195
205 ======== Installation 196 ======== Installation
206 197
207 Compilation: ./configure ; make 198 Compilation: ./configure ; make
208 General install: make install 199 General install: make install
209 Removal: make uninstall 200 Removal: make uninstall
210 201
202 !!! FIXME !!!
211 - To build an RPM binary: 203 - To build an RPM binary:
212 204
213 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'. 205 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
214 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'. 206 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
215 on other rpm distros, it depends on which version of rpm is used, if 207 on other rpm distros, it depends on which version of rpm is used, if
218 Where the resulting package is placed is distribution specific, for 210 Where the resulting package is placed is distribution specific, for
219 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/ 211 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
220 212
221 ======== Description / Features 213 ======== Description / Features
222 214
223 GQview is a graphics file viewer. Basic features: 215 Geeqie is a graphics file viewer. Basic features:
224 216
225 - Single click image viewing / navigation. 217 - Single click image viewing / navigation.
226 - Zoom functions. 218 - Zoom functions.
227 - Thumbnails, with optional caching and .xvpics support. 219 - Thumbnails, with optional caching and .xvpics support.
228 - Multiple file selection for move, copy, delete, rename, drag and drop. 220 - Multiple file selection for move, copy, delete, rename, drag and drop.
391 383
392 Wheel up/down change to previous/next image 384 Wheel up/down change to previous/next image
393 Wheel up/down + [Shift] scroll image up/down 385 Wheel up/down + [Shift] scroll image up/down
394 Wheel up/down + [Control] zoom image in/out 386 Wheel up/down + [Control] zoom image in/out
395 387
388
396 ======== Editor command macros [section:editors] 389 ======== Editor command macros [section:editors]
397 390
398 Any one of the following filename markers may be used: 391 Any one of the following filename markers may be used:
399 392
400 %f Replaced with list of selected files, may occur once. 393 %f Replaced with list of selected files, may occur once.
411 Additional macros: 404 Additional macros:
412 405
413 %w Prevent full screen from deactivating when command is executed, 406 %w Prevent full screen from deactivating when command is executed,
414 must occur as the first two characters. 407 must occur as the first two characters.
415 408
409
410 ======== Overlay Info [section:overlay]
411
412 Overlay info format string syntax is: %tag[:max_length][:extra]%
413
414 %name% Filename of the picture.
415 %collection% Name of the collection
416 %number% Current number of image in the list
417 %total% Total number of images
418 %date% File date
419 %size% File size
420 %width% Image width
421 %height% Image height
422 %res% Image resolution
423
424 To access exif data use the exif name:
425 %Exif.Photo.DateTimeOriginal% Date of the original shot
426
427 Pre-formatted exif data is also available:
428 formatted.Camera Camera and sofware name
429 formatted.DateTime Image Date
430 formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
431 formatted.Aperture Aperture (ie. f5.6)
432 formatted.ExposureBias Exposure bias (ie. +0.3)
433 formatted.ISOSpeedRating ISO sensitivity (ie. 100)
434 formatted.FocalLength Focal length
435 formatted.FocalLength35mmFilm Focal length 35mm
436 formatted.SubjectDistance Subject distance
437 formatted.Flash Flash
438 formatted.Resolution Resolution
439 formatted.ColorProfile Color profile
440
441 You can limit the length of displayed data using :number notation:
442 %formatted.Camera:20% will truncate the displayed data to 20 characters
443 and will add 3 dots at the end to denote the truncation.
444
445 If two or more variables are connected with the |-sign, it prints available
446 variables with a separator:
447 %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
448 could show:
449 "1/20s - 400 - 80 mm"
450 or
451 "1/200 - 80 mm" if there's no ISO information in the Exif data.
452
453 If a line is empty, it is removed.
454 This allows to add lines that totally disappear when no data is available.
455
456 Extra string uses special character '*' to mark the position of the data.
457 If no '*' is present, then extra string is just appended to data.
458 Any "\n" is replaced by a newline on display.
459 Pango mark up is accepted in left and right parts.
460 If data is empty, nothing will be displayed.
461
462 Examples:
463 "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
464 "%size:\n%" -> size is displayed with a newline at end
465 "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
466 "Collection <b>*</b>\n" -> display collection name in bold prefixed by
467 "Collection " and a newline is appended
468
469
416 ======== Additional comments: 470 ======== Additional comments:
417 471
418 Advanced options: 472 Hidden options:
419 These options are not adjustable in the preferences window, to change 473 These options are not adjustable in the preferences window, to change
420 them edit $(HOME)/.gqview/gqviewrc while GQview is not running. An option 474 them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option
421 becomes 'advanced' when it is removed from the user's visibility, and 475 becomes 'hidden' when it is removed from the user's visibility, and
422 only remains so that those few users that really want it will not complain 476 only remains so that those few users that really want it will not complain
423 about it's removal :) 477 about it's removal :)
424 478
425 lazy_image_sync: false 479 lazy_image_sync: false
426 Set true to enable the old behavior of lazy image updates when changing 480 Set true to enable the old behavior of lazy image updates when changing
428 482
429 display_dialogs_under_mouse: false 483 display_dialogs_under_mouse: false
430 Set true to force dialogs to display under the current mouse position, 484 Set true to force dialogs to display under the current mouse position,
431 note that this goes against the preference set for the window manager. 485 note that this goes against the preference set for the window manager.
432 486
433 ======== Translation status:
434
435 (as of 2.1.5)
436
437 Please send po files/patches in gzipped form to ensure data integrity.
438
439 Note: completion % in the chart below may not be quite correct when fuzzy
440 translations exist but do not appear in the source.
441 comp % = trans / (trans + fuzzy + untrans)
442
443 Language Comp (%) Trans Fuzzy Untrans Warn
444 --------------------------------------------------
445 ar 60 449 192 103
446 be 95 712 18 14
447 bg 89 667 44 33
448 ca 89 667 44 33
449 cs 89 667 44 33
450 da 18 138 324 282
451 de 89 667 44 33
452 eo 95 708 22 14
453 es 89 667 44 33
454 et 27 204 322 218
455 eu 95 712 18 14
456 fi 89 669 42 33
457 fr 94 706 21 17
458 hu 50 374 226 144
459 id 27 208 323 213
460 it 94 704 23 17
461 ja 89 667 44 33
462 ko 15 114 16 614
463 nl 89 669 42 33
464 no 22 169 335 240
465 pl 84 631 22 91
466 pt_BR 94 704 23 17
467 ro 52 388 228 128
468 ru 89 667 44 33
469 sk 92 690 24 30
470 sl 20 155 341 248
471 sv 89 665 45 34
472 th 21 161 332 251
473 tr 9 71 323 350
474 uk 24 180 331 233
475 vi 94 705 22 17
476 zh_CN.GB2312 22 169 335 240
477 zh_TW 93 695 23 26
478 --------------------------------------------------
479 487
480 488
481 ======== Credits [section:credits] 489 ======== Credits [section:credits]
482 490
483 491
655 663
656 And... 664 And...
657 Thanks to the users for finding Geeqie useful. 665 Thanks to the users for finding Geeqie useful.
658 666
659 667
668 ======== Translation status:
669
670 Please send po files/patches in gzipped form to ensure data integrity.
671
672 Translations statistics
673 Date: Sun, 11 May 2008 12:03:37 +0200
674
675 Note: completion % in the chart below may not be quite correct
676 when fuzzy translations exist but do not appear in the source.
677 For exact results, run make update-po with up to date POTFILES.in.
678 comp % = trans / (trans + fuzzy + untrans)
679
680 Language Comp(%) Trans Fuzzy Untrans Total
681 fr 100.00 985 0 0 985
682 be 90.56 892 25 68 985
683 eu 68.53 675 150 160 985
684 eo 68.22 672 153 160 985
685 vi 68.02 670 156 159 985
686 it 67.82 668 154 163 985
687 pt_BR 67.82 668 154 163 985
688 zh_TW 66.90 659 150 176 985
689 sk 66.50 655 158 172 985
690 fi 64.37 634 176 175 985
691 nl 64.37 634 179 172 985
692 sv 64.16 632 175 178 985
693 bg 64.06 631 175 179 985
694 ca 64.06 631 175 179 985
695 cs 64.06 631 175 179 985
696 de 64.06 631 175 179 985
697 es 64.06 631 175 179 985
698 ja 64.06 631 175 179 985
699 ru 64.06 631 175 179 985
700 pl 60.61 597 148 240 985
701 ar 42.94 423 315 247 985
702 ro 37.56 370 342 273 985
703 hu 36.14 356 332 297 985
704 id 19.70 194 408 383 985
705 et 19.29 190 407 388 985
706 uk 17.16 169 411 405 985
707 nb 15.94 157 416 412 985
708 zh_CN.GB2312 15.94 157 416 412 985
709 th 15.13 149 413 423 985
710 sl 14.72 145 419 421 985
711 da 12.99 128 402 455 985
712 ko 11.37 112 52 821 985
713 tr 6.60 65 398 522 985
714
715
660 ======== 716 ========
661 717