On Monday, June 10 from 7:00pm-9:00pm DuraSpace is holding a reception for all OR2019 attendees at the Pony Bar (near the University of Hamburg). All OR2019 attendees are welcome, you need not be a DuraSpace member or user. Drinks and snacks will be provided. For more details see: https://duraspace.org/invitation-please-come-to-a-duraspace-reception-in-hamburg-germany/ |
This page is for attendees of the OR2019 "Getting Started with DSpace 7" workshops. It provides links to resources, workshop preparation, etc. |
There are no installation requirements for either workshop. However, if you wish to be active in the "hands-on" portions
Please be aware that, as we 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.
During the code walkthrough, we will be working directly with the dspace-angular project (this is the DSpace 7 UI, built on Angular). However, don't worry. It's rather easy to install, and you do not need to install the DSpace backend (as we will be using the public, demo REST API as our backend).
(These instructions are based on the dspace-angular README)
git clone https://github.com/DSpace/dspace-angular.git
(Pulls down the code into a dspace-angular folder on your local computer)cd dspace-angular
(Move into the newly created dspace-angular folder)yarn install
(Install all local dependencies via yarn)yarn run watch
(Build and startup the DSpace Angular UI, while watching code for new changes.)yarn start
", but that command requires you restart to pick up local code changes.That's it! Again, there is no need to have the DSpace backend running or install a database, Java, Tomcat or any of the other usual DSpace prerequisites.
To follow along with the exercises run the following git commands in the project directory to get the correct starting point
git remote add workshop https://github.com/DSpace-Labs/dspace-angular-workshops.git
git fetch --tags workshop (Pulls down the dspace-angular-workshops code locally, including tags)
For the Basic Training workshop
git checkout or2019-basic-start (Checks out the starting point of the workshop, the "or2019-basic-start" tag)
git checkout -b or2019-basic (Creates a local branch named "or2019-basic" for you, based on that "or2019-basic-start" tag)
For the Advanced Training workshop
git checkout or2019-advanced-start (Checks out the starting point of the workshop, the "or2019-advanced-start" tag)
git checkout -b or2019-advanced (Creates a local branch named "or2019-advanced" for you, based on that "or2019-advanced-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:
Revert all existing files to their state at the start:
git reset or2019-basic-start --hard
Remove any newly created files
git clean -f -d
Sync with the solution
git merge $TAG_NAME
While not required, the following tools may make it easier to do basic development with the Angular UI.
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:
https://github.com/DSpace-Labs/dspace-angular-workshops/releases
We will experiment with the public demo using the HAL browser and the Postman REST Client. The Postman REST Client can be downloaded from here the free version is all you need. During the code walkthrough, we will be looking directly to the dspace-spring-rest project (this is the DSpace 7 maven module providing the REST API). However, don't worry. We will not perform any real JAVA coding or compilation, and you do not need to install the DSpace backend (as we will be using the public, demo REST API).
Hands-on exercises will be based on the REST 7 Tutorial