Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

There are no installation requirements for the workshop. However, as the second half of the workshop is a code walkthrough (of some live development / theme customizations), you can optionally choose to install the Angular UI locally (and perform "hands-on" changes on your laptop).

Optional Installation

The second half of the workshop will be a walkthrough of making code changes to the UI (both at at a theme level, and adding new features).  While not required, some participants may wish to use this opportunity to follow along and perform the same code changes in a "hands-on" workshop fashion.  (Please be aware that, as we currently have over 40 workshop attendees, we unfortunately cannot promise any "hands-on" support on an individual basis.  But, we still welcome you to turn use this as an opportunity to try some "hands-on" changes.)

Optional Installation

During the code walkthrough, we will be working directly with the dspace-angular project (this is the in-development Angular UI for DSpace 7).  However, don't worry. It's rather easy to install, and you do not need to install DSpace itself (as we will be using the public, demo REST API as our backend). You will only need the Angular UI running locally.

Installing the Angular UI locally

...

  • Git :You'll want to have Git to simply clone and install our dspace-angular project (this is the in-development Angular UI for DSpace 7). If you don't have Git, you can choose to install either GitHub Desktop (which includes a GUI) or just plain Git. Any version of Git is fine.
  • Node.js (version 6.x or 8.x recommended) : Required to build/run the Angular UI.
  • Yarn (version 0.20.x or above) : This is an easier to use, speedier package manager that works similar to npm (Node's package manager). It's currently required to build Angular UI.
  • dspace-angular: You can now install dspace-angular itself using the command line.
    1. git clone https://github.com/DSpace/dspace-angular.git   (Pulls down the code into a dspace-angular folder on your local computer)
    2. cd dspace-angular (Move into the newly created dspace-angular folder)
    3. yarn install           (Install all local dependencies via yarn)
    4. yarn run watch:dev             (Build and startup the DSpace Angular UI)
    5. Assuming all went well, you should be able to go to http://localhost:3000 in your web browser and see the Angular UI homepage.
  • Now, to easily follow along with the workshop code changes step-by-step, you may wish to create a branch for the workshop exercises

That's it! Again, there is no need to have DSpace running or install a database, Java, Tomcat or any of the other usual DSpace prerequisites.

...