Think MLJS Workplace is hard to get started with? No longer!…
WARNING: These instructions have been superseded by the Getting Started with MLJS tutorial on this site.
MLJS Workplace is a web app that enables rapid drag-drop configuration of a web app on MarkLogic Server.
It’s very useful, but the install instructions are very involved… or were until now!
MLJS Workplace uses elements of MLJS’ Node.js support, third party Node.js libraries, the Roxy deploy tool (and thus Ruby) and MLCP (and thus Java).
This leads to a lot of complexity to learn to get started building MLJS Workplace based apps.
I’ve created a Yeoman Generator for the MarkLogic Workplace app to make installing MLJS Workplace a breeze!
Yeoman is a web application scaffolding and modular code install tools. It’s pluggable. I’ve written a Yeoman generator that installs a full end-to-end MLJS
Workplace app you can start customising in just a few steps.
You’ll of course need Node and npm installed. Pretty obvious really. Less dependencies than before.
You’ll need to install Yeoman: sudo npm install -g yo
Install the MLJS Workplace generator: sudo npm install -g generator-mljsworkplace
Now create a new application folder: mkdir myworkplaceapp ; cd myworkplaceapp
And now run Yeoman: yo mljsworkplace
This will run a whole bunch of commands for you, and ask you about your ML environment. Answer the questions and keep hitting enter.
You now have all the files for a full MLJS Workplace app… but you need to install Workplace! Oh no!
Thankfully I’ve integrated the mlnodetools project in to this app, so you just need to: ./mljsadmin install ; ./mljsadmin update ; ./mljsadmin load
Now run the Node.js web server: ./mljsserve
And point your browser at: http://localhost:5001/index.html5
Now login and click the ‘edit application’ link in the top right. Add new pages, edit them, and drag and drop widgets to your heart’s content!!!
Have a look at my MLJS Workplace Youtube video playlist for details on the widgets available, and how to configure them.
Merry Christmas!!! Enjoy!!!