ILanguageCloud

Generate interactive wordclouds for any language, with automatic stop word detection and ability to export as svg or png.

Getting Started

On the server

Install the module with: npm install ilanguage-cloud

var ILanguageCloud = require('ilanguage-cloud');
new ILanguageCloud().render(); // returns a wordcloud object with default options

In the browser

Install the module with: bower install ilanguage-cloud --save

Or, download the production version or the development version.

In your web page:

<script src="ilanguage-cloud.min.js"></script>
<script>
  new ILanguageCloud({text: 'A cloud is a visible mass ...'}).render(); // renders the text as a cloud to a div id="cloud" if exists
</script> 

In your code, you can attach ILanguageCloud's methods to any object.

<script>
var exports = WordCloud;
</script> 
<script src="ilanguage-cloud.min.js"></script>
<script>
  new WordCloud({text: 'A cloud is a visible mass ...'}).render();
</script> 

Documentation

Optionally, you can pass an options object to ILanguageCloud.

<script>
  var myOptions = {
    element: 'cloud',
    text: 'A cloud is a visible mass of condensed droplets or frozen crystals suspended in the atmosphere.',
    font: 'FreeSans',
    nonContentWords: 'a is by in of the or'
  };
</script> 
<script src="ilanguage-cloud.min.js"></script>
<script>
  new ILanguageCloud(myOptions).render();
</script> 

Examples

• Javascript

• Angular

• Backbone

• JQuery-plugin

• Android

• Chrome App

• WordPress

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using the scripts in package.json.

More details...

Release History

• v1.0 Feb 9 2012 - Initial word cloud using CSS rotation in vanilla js
• v2.0 Jan 29 2013 - WordPress plugin with SVG generation in vanilla js
• v3.0 Nov 15 2013 - Switched to Jason Davies' d3-cloud to generate SVG Download on Google Play

License

Copyright (c) 2012-2017 iLanguageCloud Contributors. Licensed under the Apache 2.0 license.