This page is for attendees of the OR2018 workshop "Getting Started with the DSpace 7 Angular UI". It provides links to resources, workshop preparation, etc.

(This workshop was based on materials from the OR2017 DSpace Angular Workshop, but slides/materials/exercises have been updated.)

Preparing for the workshop

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 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.)

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

(These instructions are based on the dspace-angular README)

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.

Optional Development Tools

While not required, the following tools may make it easier to do basic development with the Angular UI.

Creating a branch for the exercises

To follow along with the exercises run the following git commands in the project directory to get the correct starting point

  1. git remote add workshop https://github.com/DSpace-Labs/dspace-angular-workshops.git
  2. git fetch workshop               (Pulls down the dspace-angular-workshops code locally)
  3. git checkout or2018-start        (Checks out the starting point of the workshop)
  4. git checkout -b or2018-hands-on  (Creates a local branch named "or2018-hands-on" for you

At certain points during the hands-on part we'll show a git tag that corresponds to the solution so far. If you'd like to sync up to that point, run the following:

  1. Revert all existing files to their state at the start:

  2. Remove any newly created files

  3. Sync with the solution

Additional Resources