This page is for attendees of the OR2017 workshop "Getting Started with Angular UI Development for DSpace". It provides links to resources, workshop preparation, etc. |
For the hands-on portion of the workshop, 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 have a public REST API we'll be using).
If you wish to take part in the "hands-on" portion of our workshop, we recommend pre-installing the following on your laptop. (If you forget, or run into issues, don't worry. Each of these should be rather quick to install at the workshop, internet connection permitting.)
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 run global
(Install all global dependencies via yarn)yarn install
(Install all local dependencies via yarn)yarn run watch:dev
(Build and startup the DSpace Angular UI)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. During the workshop, we will point our Angular UIs at the same REST API and simply use that as our DSpace backend.
While not required, the following tools may make it easier to do basic development with the Angular UI.
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 workshop
git checkout or2017-start
git checkout -b or2017-hands-on
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 or2017-start --hard
Remove any newly created files
git clean -f -d
Sync with the solution
git merge $TAG_NAME
OR2017 Workshop Slidedeck: https://docs.google.com/presentation/d/1EsXy3ZgnJ24VeUMyui_5WT2IJRXDVeLpwpCpCFp-MOA/edit?usp=sharing