Document Conversion Demo
The Document Conversion service transforms HTML, PDF, and Microsoft™ Word documents into normalized HTML, plain text, or sets of Answer units. The Answer units can be run through a utility to convert it to the Solr JSON file type needed to train the Retrieve and Rank service.
Give it a try! Click the button below to fork into IBM DevOps Services and deploy your own copy of this application on Bluemix.
Getting Started
- Create a Bluemix Account
Sign up in Bluemix, or use an existing account. Watson Services in Beta are free to use.
-
Download and install the Cloud-foundry CLI tool
-
Edit the
manifest.yml
file and change the<application-name>
to something unique.
applications:
- services:
- document-conversion-service
name: <application-name>
path: .
memory: 256M
The name you use will determinate your application url initially, e.g. <application-name>.mybluemix.net
.
- Connect to Bluemix in the command line tool
$ cf api https://api.ng.bluemix.net
$ cf login -u <your user ID>
- Create the Document Conversion service in Bluemix
$ cf create-service document_conversion experimental document-conversion-service
- Push it live!
$ cf push
- Update sample files'
ids
. runnode setup.js
and update the returnedids
indemo.js
$ node setup.js
Running locally
The application uses Node.js and npm so you will have to download and install them as part of the steps below.
-
Copy the credentials from your
document-conversion-service
service in Bluemix toapp.js
, you can see the credentials using:$ cf env <application-name>
Example output:
System-Provided: { "VCAP_SERVICES": { "document_conversion": [{ "credentials": { "url": "<url>", "password": "<password>", "username": "<username>" }, "label": "document_conversion", "name": "document-conversion-service", "plan": "experimental" }] } }
You need to copy
username
,password
andurl
. -
Install Node.js
-
Go to the project folder in a terminal and run:
npm install
-
Start the application
-
node app.js
-
Go to
http://localhost:3000
Troubleshooting
To troubleshoot your Bluemix app the main useful source of information are the logs, to see them, run:
$ cf logs <application-name> --recent
License
This sample code is licensed under Apache 2.0. Full license text is available in COPYING.
Contributing
See CONTRIBUTING.
Open Source @ IBM
Find more open source projects on the IBM Github Page