Referencer (
http://icculus.org/referencer/) is a rather nice reference manager for Linux. I figure it would be even nicer if it integrated well with my Iliad, so I've started working on a plugin to do exactly that. This plugin is still in very early developement, so bugs are likely and there is little error handling. However, it should be useable, so I'm uploading an initial release. Currently, it supports sending documents to your shared Iliad directory, complete with metadata from your referencer library.
Installation:
Unzip the attached files in you referencer plugin directory (~/.referencer/plugins). Start referencer, and enable the Iliad plugin. Click configure to open a settings window where you can set the output directory, and if you want documents to open fullscreen.
You should have an Iliad icon on you toolbar, and a "Send to Iliad" entry in your documents menu and the context menu for your documents. Click on any of these to send the selected document to your sync directory.
Limitations:
This does not check file type, so it will happily send PS files which the Iliad can't open. I plan to add transparent conversion of these files in the next few days.
If you try to send a file that is already in the outbox, that file will be silently skipped. I should probably give the option of overriding.
This uses local paths for files. Files accessed through the VFS (such as ones on a windows share on a different computer) will not work.
I have done only very basic testing, and there is very little error handling logic. This means that there are likely bugs. If you encounter problems not mentioned here, please let me know.
Future Plans:
Transparent conversion of PS files (should be done in the next few days).
Automatic cropping of PDFs, using the pdfcrop tool packaged with LaTeX (also in the next few days). Done.
Icons. While I could easily add thumbnails, it seems rather pointless (pretty much all academic papers will look the same). I'd like to use a thumbnail of the journal cover, but I'm not sure where I can pull these from. Suggestions would be appreciated.
Support USB connections. Currently, this is written with wireless sync in mind. At some point, I'd like to add an option of sending files to a connected drive. I'm not really sure when I'll manage this, though.
VFS support (windows shares, etc). Ubuntu does not have python binding for gio, and I am not interested in learning a depreciated vfs system, so this will likely not be in the near future.
More metadata and organisation. I can't do much here without more features being added to Referencer's plugin system.
Manage snippets/annotationed version. This is currently stalled due to bugs in Referencer's plugin system, but willl be a high priority once those are fixed.