Code Monkey home page Code Monkey logo

zutilo's Introduction

Zutilo

Zutilo is a plugin for Zotero. Zutilo adds several functions not available in base Zotero through extra menu items and keyboard shortcuts. Here are some of Zutilo's features:

  • Copy, paste, and remove sets of tags
  • Select and right-click to relate several items
  • Copy items to the clipboard in several formats
  • Keyboard shortcuts for editing items and focusing and hiding different elements of the Zotero user interface

Zutilo strives to enable whatever Zotero workflow is desired and otherwise to get out of the way. All of Zutilo's graphical elements can be disabled individually, so that unwanted features do not clutter the user interface.

NOTE: As of version 3.0, Zutilo is distributed from the GitHub releases page. New updates will not be published to the location checked by previous versions of Zutilo (the Mozilla Add-ons page). To receive new Zutilo updates, please update to the latest version of Zutilo.

Installation

Download the Zutilo zutilo.xpi file from Zutilo's GitHub releases page. Then go to Tools->Add-ons in Zotero Standalone. Click on the gear button in the upper right area of the Add-ons Manager window that appears and choose "Install Add-on From File." Then select the downloaded zutilo.xpi file.

NOTE for Firefox users: Firefox treats .xpi files as Firefox add-ons and tries to install them. Rather than clicking on the .xpi file, you can try right-clicking and choosing to save the link as a file. In some cases (particularly on Linux), Firefox does not allow right-clicking and saving the .xpi link either. In that case, you must download it either with a different browser or with a command-line tool like curl or wget.

Getting started

Zutilo can be customized via its preferences window, which can reached via the Zotero Addons Manager or the Tools menu.

Zotero item menu

By default, Zutilo adds a set of menu items to a submenu (named Zutilo) of the menu that appears when an item is right-clicked in Zotero. Which items appear can be set in Zutilo's preferences window. Items can be set to appear in the Zutilo submenu or directly in the Zotero item menu. Not all available functions are visible in Zutilo submenu by default.

Keyboard shortcuts

All of the functions that can appear in the item menu can also be called by keyboard shortcuts. Zutilo also provides some additional keyboard shortcut functions that are not available from the item menu. By default, no keyboard shortcuts are defined. A shortcut key combination can be set for each function in Zutilo's preferences. If the key combination is already assigned for another function, a warning will be displayed.

Usage notes

For additional notes on usage, see USAGE.

Command reference

For a detailed list of Zutilo's commands, please see the command reference.

Support

For guidelines regarding bug reports, feature requests, and translation help, please see the feedback page.

Development

For notes on working with the Zutilo code, please see the build document.

Credits

For a list of acknowledgments, please see the author page.

Changes

For a summary changes by version number, please see the changelog.

How to Contribute

  1. Star the repository on GitHub. The number of stars on GitHub is one of the most visible metrics for gauging the level of interest in project.
  2. Encourage others to use the project, either directly or by writing a blog post. Besides GitHub stars, the other metric for gauging interest in the project is the total number of downloads of the xpi.
  3. Submit new features or translations. However, keep in mind that new features add to the maintenance burden of the project. So get in contact before putting a lot of time into a new feature.

zutilo's People

Contributors

acsr avatar bjohas avatar bwiernik avatar davidk55 avatar dependabot[bot] avatar dstillman avatar fflamerie avatar gracile-fr avatar harshita-gupta avatar knavynde avatar masteranza avatar qqobb avatar retorquere avatar specter119 avatar vancleve avatar willsalmanj avatar wshanks avatar zaeph avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

zutilo's Issues

Removing all tags prevents adding new ones afterwards

The title pretty much sums it up: Under OS X 10.11.2 and in Zotero Standalone 4.0.28.8 with Zutilo 1.3.0 and by using a previously set keyboard shortcut (cmd+alt+ctrl+shift+e; but that is probably not it…) Zutilo initially does what it should and removes all Tags from an entry. Alas, there's problems when I afterwards want to add new tags: I can start to add them, meaning, I can add a new tag, fill in the title field of the new tag, but when I press return, the tag appears to have never been created in the first place.

EDIT: I should've added, that a workaround for the bug is to restart Zotero.

Copying Tags from Clipboard

Hello, Thanks for the shared work. I have Tags in a clipboard entry separated by a comma ( - expecting convert comma separated String to Tag list -), the copy(?) does not parse at a comma nor semi-colon, ... is that correct, Best,

Feature request : "Copy select item links" for attachments providing absolute directory paths

Hi,

I think Zotero users would benefit from a function similar to "Copy select item links" but which provides the absolute path to an attachment (it could be called, e.g., "Copy select attachment links"). Since there may be several attachments linked to a Zotero item, this function could be triggered by clicking on the attachment that we want to get the address.

The underlying idea is that I have many files in Zotero that I need to upload, so being able to get the absolute address of the attachments would enable me to paste that information directly into the upload dialog box. Currently, I need to click on "show file" which open the explorer and then get the address for each file.

Thank you very much for developing such application; it really helps!

Best,

Aleix

Multiprocess (e10s / electrolysis) compatibility

At some point, Zutilo needs to be made compatible with e10s as described in these documents:

https://developer.mozilla.org/en-US/Add-ons/Working_with_multiprocess_Firefox
https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/The_message_manager
https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/Limitations_of_chrome_scripts

Complete compatibility testing can not take place until Zotero itself is made e10s compatible and that likely won't happen until Mozilla announces the time line for e10s being merged into Firefox Beta and Release.

According to the links, web page content is no longer accessible to the main add-on code. Also, there is a comment about loading XUL into a tab needing to be done in a different way. Here are the issues that will likely need to be addressed for e10s compatibility:

  • Attach page to Zotero item (right now Zutilo access the current page's url via window.content which is no longer accessible).
  • The way Zutilo loads content into separate windows (the README and warning) need to be checked.
  • The way Zutilo works with the browser tab version of Zotero needs to be checked (once Zotero is e10s compatible).

Network drive?

Has the "Modify attachment paths" function in Zutilo been tested with networked drives? I have tried without success. I go through the motions, but the link does not change. I have also tried with the UNC path as opposed to the mapped drive letter.

Context menu items doesn't appear on Zotero in a separate tab

I use Zutilo 1.2.4 on Zotero 4.0.12, FF 23.0.1, and OS X 10.8.4. As in the title, Zutilo context menu items doesn't appear on Zotero in a separate tab, but does appear on the pane mode. I tried both Zotero context menu & Zutilo context menu modes, but both didn't work on the separate tab.

Suggestion: Zutilo feature to change the type of an entry after creation (e.g. from website to blog-post)

I have not found a similar functionality yet in zotero. I started to save my own manuscripts as Zotero manuscripts, Quotes as "instant-Messages" and so on. Saving Books from Firefox is now very cool even from shops like O'Reilly. Very cool.

So using the dedicated types would make it much easier to scan items in the list when they have appropriate icons, fields etc. Then you need not to "invent" personal tags to reflect these.

So the target is to select an existing type and do a smart migration to another type by selecting from a menu.

This is just a proposal.

Can't disable manual shortcut for "Duplicate entry" function.

I exprimented with local shortcuts for Zutilo function via the Zutilo prefs interface. Under "Duplicate entry" (I'm using a German localisation and FF interface) I added "spacebar" as the shortcut – an admittedly daft idea. However, trying to disable the shortcut I find that I cannot do so. What works with every other entry (add/disable personal shortcuts via the interface) does not work for duplicate entry. (The the shortcut slot for Duplicate entry neither shows "disabled" nor what the spacebar would produce in any other field, which is "VK_space". A reinstall of the add-on doesn't help – my preferences including the buggy one are preserved somewehre. I'm using ZoteroQuicklook and its spacebar functions many times a day – and now duplicate all my viewed entries... Had to deactivate Zutilo to stop this from happening but would love to keep it's very useful funtionality. Any ideas how to fix this? Delete my prefs and start anew? Thanks

Suggestion: add a feature to cut/paste notes from one citation to another

Hi!

Zutilo is such a useful add-on! So time saving. However there is still one issue, I can get solved with Zutilo.

I often have to move notes from one citation to another ones and I find it very difficult to do. I have to find a way to get the two citations in the central windows (usually I tag them with a dummy tag) and then at last I can drag the note from one citation to another.

I wonder if it would be possible to add a feature in Zutilo that will make this procedure a lot easier. A simple right-click, cut the note (or move the note to another citation) would ba a very welcome feature!

Thanks a lot for your time!

Feature request: batch edit selected items

Frequently, I have several items that are book chapters and I want to update a field in all of them - such as adding the city of the publisher. Is there any way (or can it be planned) to copy/paste other fields, or even to have a user-selected group of fields copy/pasted? Or is this what "QuickCopy items to clipboard" is supposed to do? I didn't see any mention of quickcopy in the documentation and I can't figure it out.

Thanks!

open select item links with zotero standalone (Linux)

In the documentation it is said explilcitly for "Copy select item links": "Following links from other applications and having the links select items in the Zotero Standalone client may also be achievable but might require additional set up."

However, I wonder if there is any indication of how to proceed in Linux. I understand that I'd eventually need to define a URI handler for xdg-open. However, even before that, it seems that Zotero Standalone, in Linux, ignores any additional arguments when called, regardless of whether or not Zutilo is installed. So there seems to be no way of having Zotero Standalone to follow a link in Linux. (This is in contrast to Firefox, where a call from the shell as
firefox zotero://select/items/ID will do the expected thing, whether or not Zutilo is not installed).

(Note: for the record, I've asked this in the Zotero forum , but the question there did not involve Zutilo. I am asking here in case Zutilo provides some additional functionaly that might make this work with standalone).

Does not load for Zotero in separate/app tab or Zotero Standalone.

Currently, Zutilo works fine when Zotero is used as a browser pane in Firefox. However, when Zotero is set to open in a separate tab or the app tab, Zutilo does not seem to be initialized properly. The item it adds to Zotero's actions menu (which launches Zutilo's preferences window) is not present and Zotero.Zutilo.init() is not called (a window load eventListener should launch it).

Some parts of Zutilo are being loaded though because its preferences window can still be accessed via the Addons Manager. Parts of this window are generated dynamically by methods of Zotero.Zutilo defined in zutilo.js, so it seems like the Zotero.Zutilo object is being created.

The issues are all basically the same with Zotero Standalone, except that it does not populate the preferences window. This might just be because Zutilo never loads properly and so never creates its preferences. Then when the functions that populate the preferences window try to access these undefined preferences it crashes.

Feature request: shortcut for adding stored pdf files

Hello,

First, let me thank you for creating such a useful add-on. However, there is a common feature I would like to have as a shortcut, which is adding a pdf file stored in my computer.

I have to do this for every single reference I add, and I believe there are many people like me. I believe it would be fairly easy to make.

Please take this into consideration :) Thank you.

Remove tags from multiple items via context menu

Add "Remove tags" to the context menu when items are selected in the center pane. This has been brought up a number of times on the forums and I figured it would be a fitting addition to Zutilo.

Make chapter entries from book entry with one click

There is a discussion at the zotero forum about a "one-click" option for making a chapter from a book. The current way is a multiple-click workflow: dublicate the book item, change the item type of the book item into book section (and maybe confirm the loose of some information).

A one-click option sounds for me similar to some functionalities you already have implemented in zutilo. Would it be possible to add such a feature?

Turn README into README.md

This looks quite useful, but the Readme is a pain to read online. If you just add a markdown extension (.md) things like line breaks will look nice automatically on github & you can add things like headers using markdown.

Provide menu item for item URI and zotero select link

Sometimes one wants to insert into a note a link to a zotero item. Either a link to the item in the local zotero (i.e. a link of the form zotero://select...), or a link to the item on the zotero web site (of the form http://zotero.org/users/nnnnn/items/..... It would be nice if Zutilo could provide a menu items for copying such links to the clipboard. I think this functionality is a good fit for Zutilo.

Currently that functionality is only available via custom translators, see http://zoteromusings.wordpress.com/2013/04/23/zotero-item-uris-from-client/ for a description. But that is inconvenient because one can then only use that functionality or the usual bibliography quick copy functionality.

Book item from book section

As suggested in #27, a function to create a book from a book section could be implemented as the reverse of the function for create a book section from a book.

Zotero Standalone context menu

Zutilo is extremely useful for me. Many thanks for the extension!

Zutilo is not working properly for me on Zotero Standalone.

I have Zutilo installed on both Zotero Firefox and Zotero Standalone (I did 'install add-on from file for the latter). Zutilo shows in an item's right-click context menu in Zotero for Firefox, both in pane/frame and tab views. However, in Zotero standalone, there is no 'Zutilo' item in the item right-click context menu. I tried reinstalling Zotero standalone. I tried variations on the options for Zutilo menu items being in Zotero/Zutilo/hide. I am sharing the Zotero Firefox and Zotero Standalone data directory, so that should bet the same.

I'm running Win 7 x64. I have installed: Zutilo 1.1.11, Zotero 3.0.11, Zotfile 2.2.4, and Zotero Word for Windows integration 3.1.9.

Thanks for your help.

Turn README into README.md

This looks quite useful, but the Readme is a pain to read online. If you just add a markdown extension (.md) things like line breaks will look nice automatically on github & you can add things like headers using markdown.

Install from unreleased unzipped or git fails for Zotero Standalone 4.0.4

The latest commit changing the version check of Zotero during install to "*" is not released. Trying to follow alternate install methods was not successfull.

I used Zotero Standalone 4.0.4 on MacOSX 10.8.2.

The german version came up again with something similar to:

"The Installation failed"
"The extension "%S" could not be installed. It may be incompatible with this version of Zotero Standalone."

This using both install methods:

  1. from xpi archive (checked out from github and rezipped)
  2. from local clone (checked out from github and linked via the file in the extension folder).

Hint: this file may be deleted by Mozilla during startup! Take care of a backup before.

Thank you for this product! Waiting for the next release.

Armin

GitHub doesn't follow symbolic links

The symlinked documentation files just show up as symlinks with no way to click through. It should be as easy as possible to get to the documentation.

2.0.1 stopped working in Palemoon

2.0.1 still works fine in Zotero Standalone but disappeared from the context menu in Palemoon 26.2.2 64bit. No error message. Options in Addons works OK.

Zutilo and Zotero standalone

Hi, I am sorry but i have tried for a while to work out how to install Zutilo into my zotero standalone. at this point I am wondering whether it is really possible, and how I can do that. Is there anyone that can help me in this matter?
Thanks a lot,
Alfredo

Copy tags from standalone note

It is not possible to copy tags from a standalone note (or other child items). Why not? I sometimes tag them also and then find a website, etc. with similiar topic, so I want to copy the tags from a note (or other child item) too.

Automatic keyword generation

I can fairly easily generate a Python module that takes a file name and, if it is a PDF, extracts the text, analyzes it, and generates tags to add to the library item. I do not, however, have the expertise to integrate that code into Zutilo or a new Zotero add-on without a steep learning curve.

If this is a reasonable match for Zutilo, and anyone is interested in doing the integrating, please contact me and I'll get to work on the keyword generation.

Switch the documentation source from HTML to reStructuredText or Markdown

Working in HTML directly for writing docs is quite hard. I am using Sphinx http://sphinx-doc.org/ and reStructuredText to create my docs and it is much more efficient and readable.

We can transfer the existing HTML in one step _[1] to reStructuredText or Markdown using pandoc. Both markups are supported by github to render the pages online. I can do this experimentally in the german translation.

.. _[1] Important for all languages after they are in one state to keep diffs working from that point on.

Personally I would prefer reStructuredText because you can use then use Sphinx to generate the HTML and a documentation website automatically and independent from githubs rendering. But that may interfere with other workflows so I am comfortable to earn as well.

Shortcuts for "Edit item info" vs. "Add tag"

Hello,

I have an issue with Zotero stand alone (latest version, OS X) and Zutilo (latest version).

When I install Zutilo, and assign keys for "Edit item info" and "Add tag", both work. When I then restart Zotero, "Edit item info" no longer works, while "Add tag" works as before.

(When using the corresponding Zotero / Zutilo functions via keyconfig, I believe this issue didn't occur. That is to say, if I create a shortcut, and call the relevant javascript directly, I believe that the issue didn't occur.)

Thanks!

Attachment path changes not saved

This is a follow-up to previous issue #6.

After using "modify attachment paths" to change drive letters from a network to local drive for linked pdfs and then using "show attachment paths" to confirm the change, everything seemed to be ok. However, after shutting down Firefox and restarting, the changes are not saved.

I learned this when changes that I knew I had made in linked pdfs were not showing up when re-visited. The changes had actually been made on the (old) network copy of the pdf.

This may not be an issue with Zutilo, but any suggestions are welcome.

Zutilo feature request: Actions in context of autocreated 'Amazon.com Link' objects

When you visit a book on Amazon or other sites with proper dublin.core metadata markup, you can e.g. auto create Zotero entries of the matching type "book", by clicking the "book" icon in the address bar of Chrome and Firefox. On Amazon.com, inside of a book entry a sub entry object is created with the stereotypic name 'Amazon.com Link'.

  • the object has an editable name, the link and a richtext field as properties.
  • Additional to the minimum link target, the whole session information is contained in the captured link. This leads to unwanted leakage of user information if the Zotero entry is clicked, shared or copied.
  • Unfortunately the link cannot be edited. Even rightclicking does not allow copying and instead rightclicking visits the link at once.

Feature for Zutilo:

add menu commands/actions in context of the 'Amazon.com Link' or parent to:

  • Allow limiting the link to the main content. by stripping out the session info, as long as the link is matching the current schema. -> "Strip session data from Amazon.com Link..."
  • Make the link editable in a dialog window. -> "Edit Amazon.com Link..."
  • Move the Amazon link into the (empty) URL field of the parent book object. -> "Copy Amazon.com Link to empty parent book URL..."
  • "Copy Amazon.com Link..."

(the menu reading is in the quotes after the -> symbol)

Documentation / UI clean up

As features have been added, things have been getting a little cluttered. Some things I would like to see done:

  • Main README section trimmed down to a digestible summary of Zutilo features aimed at new users.
    • It should include an overview of the kinds of functions present in Zotero along with links to the detailed documentation, the attachments discussion, the contributors page, and the changelog.
    • The installation instructions will likely remain in this main section. They should include also a getting started section mentioning the configurability of Zutilo's item menu functions and shortcuts.
  • Detailed documentation page with sections for
    • Item menu functions
    • Firefox browser functions
    • Keyboard shortcuts (broken into subsections of similar functionality)
  • Attachments discussion moved to separate page
  • Changelog moved to separate page
  • Contributors information moved to separate page
    • Remove all .html files from the git repository once this page exists and is updated to describe the build script that generates them.
  • Set the default item menu function visibility on a per function basis. Right now, all functions default to the Zutilo submenu, but some of them are low use enough that they could start off hidden
  • Assign categories to keyboard shortcuts and display them in the preferences tree view. Then have the tree sort by category, so that there is more organization rather than just one long list of shortcuts.
  • Update translations for documentation and recent UI strings.

New keyboard shortcuts

This issue is just a reminder that PR #24 is still open and needs to be merged in. -- Sorry for the long delay. I haven't had much time for Zutilo recently and I want to finish streamlining the translation workflow before merging this patch because it requires strings that will need to be localized.

Zutilo Copy Tags Issue

I have Zotero Standalone 4.0.29.10 installed and Zutilo 2.0.1 plugin.

If I select a document in my Zotero Library, right click and select Zutilo -> Copy Tags, I get the following error:

Zutilo: item selection error
Please select at least one regular item or note.

If I select a parent item, the error does not occur.

Can I use Zutilo to copy tags directly on items?
Most of my Library does not use Parent Item.

Brett

attachment path only showing "storage:name_of_file"

I think this is not the intended behavior: when I click on an entry or on its attachment and I request to be shown the attachment path I get something like storage:name_of_file. So what is missing is the full directory path. In case it matters, I use a custom data directory location (~/Zotero-data) and, from it, the storage subdirectory is a link to another place (~/Zotero-storage). I am running Zotero Standalone in Linux.

Workflow for reformatting sections of the README with improved markup

There are some sections of the README that can be made more readable if they are split from prose to bullet points or definition lists.

see ticket #20 "Switch the documentation source from HTML to reStructuredText or Markdown" for making these changes easier.

This leads to make every fact a line and much easier to scan and find. Especially when functions are described with keywords an description.

Switching only in the translation leads to confusion. So the best would be to update the canonical text in EN appropriate (what I can do as well) and then make the diffs checkable for translators.

Shortcuts gone/not working

Zotero: 4.0.29.5, Zutilo last Updated 05/09/2016 on OSX.

My shortcuts don't work anymore. In about:config they are still there, but not available in Zotero or in the Add-On dialogue.

Add shortcut for Open Style Editor

Too many clicks to open it at the moment (with Standalone;  with Firefox, you can bookmark csledit.xul).
I wish I'd do it myself but I'm stuck. I tried win.Zotero_Preferences.openInViewer('chrome://zotero/content/tools/csledit.xul', true) without success (undefined).

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.