Knwl.js is a Javascript library that parses through text for dates, times, phone numbers, emails, places, and more.
Parser plugins are what make Knwl.js tick and give it new parsing abilities. There are many already available under ./default_plugins
and ./experimental_plugins
for a number of tasks.
Soon, you'll be able to browse community created plugins all on one website (we're still working on this). If you're interested in developing plugins for Knwl.js, ./plugin_development.md
is a great place to start.
Check out a quick demo: http://loadfive.com/os/knwl/demo
Google+ Community: https://plus.google.com/communities/108874785204246812675
-
First, load the
knwl.js
script in the<head>
of a page.<script src = 'knwl.js'></script>
Think of this script as a shell, it provides a standard API for parser plugins and some basic task functions.
-
Next, load a Knwl.js parser plugin file.
<script src = 'default_plugins/datetime.js'></script>
You can load as many as you want, they should work together just fine. Just remember to load parser plugins after
knwl.js
and you'll be set. -
Initiate Knwl.js on a String.
knwl.init("This is a string. This was written on the 2nd of June, of 2015.");
This line runs the initial parser functions that prepare the String for plugins to use. Plugins will not function without this method first being called on the String.
-
Initiate a plugin to parse the String.
var dates = knwl.get('dates');
The first parameter of
knwl.get()
is the name of the parser plugin you're trying to access (make sure you've added the plugin's .js file to the header of the page). The names of all default parser plugins are provided towards the end of this document. If you're using plugins other than the defaults, see their respective documentation.Anyways, if the parser plugin is found,
knwl.get()
will return an array of this format:var results = [ { //result //plugin-specific properties "preview": "This was written on the 2nd of June of 2015.", //the sentence of rough location of the data from the String "found": integer //the position (in words) of the result in the String } ]
For example, here's what is returned from
knwl.get('dates')
when called on the previously mentioned String:[ { "year": 2015, "month": 6, "day": 2, "preview": "This was written on the 2nd of June of 2015.", "found": 5 } ]
knwl.get('phones')
//Returns any phone numbers found in the String.
knwl.get('links')
//Returns any links found in the String.
knwl.get('emails')
//Returns any email addresses found in the String.
knwl.get('dates')
//Returns any dates found in the String.
knwl.get('times')
//Returns any times found in the String.
knwl.get('places')
//Returns any places found in the String.
These parser plugins are not as accurate as the default plugins. However, they should be stable (they shouldn't crash the page) to use if you are willing to use them. They are considerably more static and rigid than default plugins.
In the future, some of these plugins may reach a level of accuracy that promotes them from experimental status to the default plugins. However, some will merely stay as experiments.
knwl.get('english')
//Returns the simple parts (verb, subject, etc.) of basic sentences found in the String.
//WARNING: this is a rigid and simplistic plugin, thus it is merely an experiment.
knwl.get('units')
//Returns any units (grams, pounds, etc.) found in the String.
##Developing Parser Plugins
What's awesome about the new version of Knwl.js is that it makes it much easier for anyone with a little knowledge of JS to build plugins. These plugins offer new parsing abilities for Knwl.js that otherwise wouldn't exist.
If you want to try your hand at building plugins for Knwl.js, we've
provided some documentation in plugin_development.md
.
The further development of this project was possible because of the amazing community behind previous versions. Version 1.0 of Knwl.js marks a significant change in the direction of Knwl.js to the very code-base.
We've restructured and rewritten portions of the project to facilitate plugin development, but also to drastically increase the performance. Knwl.js 1.0 is significantly faster and more efficient than the previous iterations. Yet, in the process of the relaunch, certain past features have been put on hold. But don't worry, plugins such as spam detection and emotion will return soon!
We think that overall, this is a step in the right direction.
As always, we invite you to re-engineer any part of Knwl.js (including the provided plugins) in an attempt to make them better. Let's do this together.
You can reach us at [email protected] with any questions, comments, or raging complaints.