MathML Cloud API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api
config
doc
spec
tasks
test/features
.dockerignore
.editorconfig
.gitignore
.sailsrc
6379.conf
Dockerfile
Gruntfile.js
LICENSE.txt
README.md
app.js
docker-compose.yml
kue.js
package.json

README.md

MathMLCloud

MathMLCloud is an open-source tool to help content developers and technology developers deliver accessible math. It converts math expressions from AsciiMath or LaTex to accessible MathML, text descriptions, SVGs and PNGs.

For more background on the project, visit the Benetech site.

Getting Started

MathMLCloud API is a Sails app that runs in a Docker-defined environment.

Dependencies:

Installation

git clone https://github.com/benetech/mmlc-api.git yourProjectName
cd yourProjectName
docker-compose up

This will start the containers that make up the app. The application container runs "sails lift" as its command.

The API should be running at http://localhost:1337.

Users

The app can be used to convert equations from anonymous users, but also supports creating registered users, and has administrative features available to users with an admin role.

Anonymous Users

Anyone can use the API to convert individual equations or upload HTML files of equations, but the results are only available at the time of the conversion. To be able to retrieve past conversions, you must be a registered user.

Registered Users

Anyone can register with the app by providing their username and a password, along with optional information about their organization and its role. The organization information is intended to be available for hosting sites to better understand the population they are serving with the app.

Registered users are able to retrieve past conversions that they have done.

Admin Users

Registered users who have been given the admin role are able to perform some other functions:

  • Retrieve a list of all equations converted
  • Retrieve a list of all feedback entered
  • Retrieve a list of all HTML files uploaded for conversion

Hosting

An instance of the application is hosted by Benetech in Microsoft Azure:

If you wish to run the application in your own environment, feel free to clone or fork this repository. The Vagrantfile in the project has a provider definition that allows you to provision an instance in Microsoft Azure, but you are free to host it wherever you like. Documentation on provisioning in other virtual machine environments, like Docker, Hyper-V or AWS, is available on the Vagrant site.

License

See the LICENSE.txt file for use information.