drpepper / OpenKnowledgeButton

View and contribute to the web's growing layer of open knowledge

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Open Knowledge Button

The Open Knowledge Button is a browser meta-extension that provide functionalities for multiple open knowledge projects. View and contribute to the web's growing layer of open knowledge via AnnotateIt, Hypothes.is, Knownodes, PeerLibrary, and others.

How about adding your project as well? Here how! TODO - add guidelines how to join.

Rationale

We want to create an open eco-system to grow our communities and make life easier for the people using open knowledge browser extensions: Instead of having multiple, possible conflicting extensions, we provide one customisable extension with a combined set of features.

Each application has the autonomy to freely and dynamically add or modify the features supported by the Open Knowledge Button. It functions as a public domain gateway for the functionality of each app.

People should have a good experience using the tool. To balance the benefit of the diverse functionalities vs. cost of being overwhelmed by them, end-users can turn on/off functionalities that are not useful for them. As extension developers from different project, we should try our best to see how we can work in harmony, but ultimately it will be up to the end-user to decide what functionalities he or she wants. On installation we provide a concise and user-friendly explanation of the customization functions.

We hope this initiative would motivate others to adopt the open knowledge standards and enjoy a powerful extension that provides a complete solution for growing a collaborative layer of open knowledge.

Credits

Build using great BabelExt cross browser boilerplate/library for extension development, and fancy-settings for settings interface.

Building

First, clone/download all of the source from GitHub. Then run makelinks.sh. Note that this will make hardlinks.

Safari Notes

Safari has a "security feature" that is not documented, gives no user feedback at all, and can be a huge time sink if you don't know about it! If you have any files in your extension directory that are symlinks, Safari will silently ignore them. With Safari, a hard link will work, but a symbolic link will not. If you made the links yourself instead of using the batch file, and your extension is doing nothing at all in Safari, double check that!

If the directory does not end in ".safariextension", it will not be recognized by Safari. Don't remove that from the name!

Loading/testing the Extension in Browsers

Chrome

  • Click the wrench icon and choose Tools -> Extensions.
  • Check the "Developer Mode" checkbox.
  • Click "load unpacked extension" and choose the Chrome directory.
  • You're good to go!
  • Further Chrome development information can be found at http://code.google.com/chrome/extensions/index.html.

Firefox

Opera

  • Click Tools -> Extensions -> Manage Extensions.
  • Find the config.xml file in the Opera directory of the extension, and drag it to the Extensions window.
  • You're good to go!
  • Further Opera development information can be found at http://dev.opera.com/addons/extensions/.

Safari

About

View and contribute to the web's growing layer of open knowledge

License:MIT License


Languages

Language:JavaScript 97.5%Language:Shell 2.5%Language:CSS 0.0%