GNOME Bugzilla – Bug 127545
Printable Evolution Quick reference card
Last modified: 2005-01-08 10:48:04 UTC
Evolution has a quick reference section in the manual, but it's not obvious and it's not printable. It should have a link from the Help menu and it should be easy to print out on a single page and tape to the wall. This bug is part of the Integrated Collaborative Desktop Bounty Hunt. For more information on prizes, contest rules, and other bounty tasks, visit: http://www.gnome.org/bounties/ If you would like to start working on this bounty, please create a bugzilla account and append your intention to work on this bounty to this bug. If multiple people declare their intentions to work on a task, we encourage you to join forces and work together. Please do not close this bug. The contest organizers will mark this bug as FIXED when the prize is claimed.
Please see http://www.gnome.org/bounties/Documentation.php3#127545 for more information.
I'd like to make this happen. Zach
I'm going to try my hand at this one.
Created attachment 21711 [details] Rough quick reference card (warning: PDF)
I just uploaded a rough version of a quick reference card in PDF format. One question: I used the Evolution logo from ximian.com. I'm not sure about the license on this image (it looks like the same image used in the splash screen). Does anyone more clueful than I know if this is ok?
I'm going to have a go at this one as well.
I like the use of the logo-- it's certainly fine to use it. You'll need to check the shortcuts though: Ctrl-E creates a new event, and ctrl-F creates a new folder. Keep up the good work!
Aaron, I'll fix the shortcuts and I'll upload the Photoshop file as well (yes I know, Photoshop is not a page layout app, but it's what I've got....) My current issue is getting the menu item working. I've patched the xml file and have a stub in evolution/shell/e-shell-view-menu.c, but I'm having a hard time using the mime database. Do you know of where I can find an example of this or some sample code? It looks like I need to call gnome_vfs_application_registry_get_applications("application/pdf").
Zach: I'm not sure. Ask in the evolution-hackers@ximian.com list (join at lists.ximian.com)...
Created attachment 21820 [details] [review] cvs build system and help menu patch
Created attachment 21821 [details] quick reference card tarball to be unpacked in evo cvs root directory
Hi, Here's my rough submission, developed in cooperation with David Trowbridge (trowbrds@cs.colorado.edu). Included in the previous two attachments: * A patch to add proper functionality to the help menu item, using the standard gnome-vfs mime handling capabilities. * Changes to the build system to insure proper installation. (NOTE: The Makefile.am in evolution/doc was for old code - the current evolution/Makefile.am didn't even recurse into it. However, in order to include quickref.* in the distribution and allow it to install into the data dir, doc needed to be traversed. As such, the old directives (including ChangeLog.pre-1-4 and recursing into doc/devel) were removed, and doc added back into the root Makefile.am. All the other changes are straightforward.) * The quick reference card tarball, containing the pdf and the LaTeX source file necessary to generate it. Included in the source file are directions on how to go about doing so. I'd be happy to include the evolution logo, but I decided to wait because a) I'd rather not just up and steal Zach's good idea b) I'm hoping to be able to find a vector graphic version of the icon to include at a later point. Thanks, I look forward to getting some feedback on this.
One other note: comparing the shortcuts in the menus with a quick glance through the documentation seemed to hint that the documentation had some holes in it. Instead, I sifted through the ui/*.xml files looking for the keyboard accelerators, there were a fair number there that weren't mentioned in the help files, including some that had been implemented. I realize that since it's a development version, these may change, but I'll just have to check back periodically to update this.
Note about shortcuts: Yes, the docs probably had at least a few mistakes (my fault) even before the development changes began. If you submit a card that's correct now, and the software changes under your feet, that's not your fault-- it's almost guaranteed to happen. That's docs. So the docs need to be maintainable by anyone (I'd love for you to keep maintaining them, but even so, if you're busy I need to be able to do it too). That's why we need to make sure it's possible to change the card later on (You can make the card in whatever format you want, but we should have a version available in a format that can be edited by a Free program that's available on Linux.)
Created attachment 22306 [details] [review] menu and build-system patch
Created attachment 22307 [details] updated quickref tarball ('help/' instead of 'doc/')
Created attachment 22450 [details] updated quickref card with evolution logo
Created attachment 22451 [details] [review] updated patch with evolution logo
Created attachment 23364 [details] quickref card w/ i18n
Created attachment 23365 [details] [review] quickref patch w/ i18n
Created attachment 23821 [details] [review] do i18n more portably
This bounty was completed by David Trowbridge. Congratulations David!