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

Slides :

Learning Objectives

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

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

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.

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
  2. git fetch --tags workshop        (Pulls down the dspace-angular-workshops code locally, including tags)
  3. git checkout or2018-start        (Checks out the starting point of the workshop, the "or2018-start" tag)
  4. git checkout -b or2018-hands-on  (Creates a local branch named "or2018-hands-on" for you, based on that "or2018-start" tag)

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

Optional Development Tools

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

Solution tags

Click on the commit hashes for each of the tags in the "releases" to see all code changes for each of the steps of the workshop:

Additional Resources