This is a project to process text, in English and Portuguese, and generates word clouds.
I have decided to create this app, since I could not find an app that I could put move idioms. Also, I had problems with stop words and similar words polluting the word cloud. Another motivation was to study JavaScript (Nodejs, Aurelia and D3), Continous Integration and environment provisioning.
- VirtualBox - 4.3.30
- Vagrant - 1.7.4 or higher
- ansible - 1.9.3 or higher
- Configures the environment variable JSPM_GITHUB_AUTH_TOKEN with a github personal access token(don't forget to mark access to repos). The token needs to be encoded using Base64. The project uses jspm which needs to access github, because it this configuration is required.
- Clone this repository to your local drive:
git clone git@github.com:brunoleite/word-clouds.git
- Go to /word-clouds:
cd word-clouds
- Install required Ansible roles:
ansible-galaxy install -r requirements.txt
- Create a Vagrant machine (it may take a while):
vagrant up
- Access the virtual machine:
vagrant ssh
- Go to /app:
cd app
- Run the app:
npm start
The app should be available in localhost:8000, accessed from your local machine.
Describe and show how to run the tests with code examples.
This project uses Snap-CI to perform Continous Integration you can check the pipeline. Every commint pushed to master is going to publish a new version.
The project is published in heroku on word-clouds and uses the custom build pack for nodejs and jspm.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Also, fell free to registry any idea or defect in github issues You can reach me out on twitter @bleitea
This project rocks and uses the MIT LICENSE.