From 03f469d7a4be7426d7a9e6f92df74eb651e887b2 Mon Sep 17 00:00:00 2001 From: Bill Erickson Date: Wed, 5 Sep 2018 11:26:03 -0400 Subject: [PATCH] LP#1775466 Angular6 updated inline cheat sheet Signed-off-by: Bill Erickson --- Open-ILS/src/eg2/{README.adoc => CHEAT_SHEET.adoc} | 61 +++------------------- 1 file changed, 7 insertions(+), 54 deletions(-) rename Open-ILS/src/eg2/{README.adoc => CHEAT_SHEET.adoc} (53%) diff --git a/Open-ILS/src/eg2/README.adoc b/Open-ILS/src/eg2/CHEAT_SHEET.adoc similarity index 53% rename from Open-ILS/src/eg2/README.adoc rename to Open-ILS/src/eg2/CHEAT_SHEET.adoc index 8a69ae713a..11ec9cb453 100644 --- a/Open-ILS/src/eg2/README.adoc +++ b/Open-ILS/src/eg2/CHEAT_SHEET.adoc @@ -1,36 +1,6 @@ -= Evergreen Angular6 App = += Evergreen Angular App Cheatsheet = -NOTE: Angular v6 requires NodeJS v8. Node v8 appears to work fine -with the AngularJS client, but for now, you may wish to build this code -on a separate VM to avoid disruption. - -== Setup - -=== Apache Configuration === - -Update /etc/apache2/eg_vhost.conf following the changes at the -bottom of Open-ILS/examples/apache_24/eg_vhost.conf.in, starting -with "/eg2/ client setup" - -=== Install Node v8 - -[source,sh] ---------------------------------------------------------------------- -$ cd /tmp -$ wget 'https://nodejs.org/dist/v8.11.1/node-v8.11.1-linux-x64.tar.xz' -$ sudo tar -C /usr/local --strip-components 1 -xJf node-v8.11.1-linux-x64.tar.xz -$ sudo npm update -$ sudo npm install -g @angular/cli ---------------------------------------------------------------------- - -== Install Evergreen - -=== Checkout Branch - -* Checkout and deploy the working branch as usual. -* Currently 'collab/berick/lp1775466-ang6-base-app' @ working but this may change. - -=== Install Angular Dependencies +== Install Angular Dependencies [source,sh] --------------------------------------------------------------------- @@ -39,20 +9,7 @@ $ npm update $ npm install --------------------------------------------------------------------- -=== OPTIONAL: Installing on an existing Evergreen server - -* Rebuild the AngularJS dependencies using Node v8. - -[source,sh] ---------------------------------------------------------------------- -$ cd $EVERGREEN/Open-ILS/web/js/ui/default/staff/ -$ rm -r node_modules -$ npm update -$ npm install -$ npm run build # or build-watch ---------------------------------------------------------------------- - -=== Compile Angular App -- Dev Mode +== Compile Angular App -- Dev Mode * Compile in "dev" mode using the just-in-time (JIT) compiler. * Dev mode compilation is faster, but requires the browser fetch @@ -63,7 +20,7 @@ $ npm run build # or build-watch $ ng build [--watch] --------------------------------------------------------------------- -=== Compile Angular App -- Prod Mode +== Compile Angular App -- Prod Mode * Compile in production mode. * Uses the ahead-of-time (AOT) compiler and other optimizations, which @@ -74,7 +31,7 @@ $ ng build [--watch] $ ng build --prod --------------------------------------------------------------------- -=== Running Unit Tests +== Running Unit Tests [source,sh] --------------------------------------------------------------------- @@ -82,14 +39,14 @@ $ ng build --prod npm run test --------------------------------------------------------------------- -=== Test code formatting (OPTIONAL) +== Verify Code Formatting [source,sh] --------------------------------------------------------------------- ng lint --------------------------------------------------------------------- -=== OPTIONAL: Building for an alternate locale +== OPTIONAL: Building for an alternate locale * Using fr-CA as an example. * An fr-CA configuration is supplied by default. Additional configs @@ -105,10 +62,6 @@ npm run merge-strings -- fr-CA npm run build-fr-CA --------------------------------------------------------------------- -=== Deploy - -Build and install Evergreen code as usual. Restart Evergreen and Apache. - == Access The Interface Navigate to https://HOSTNAME/eg2/staff/login -- 2.11.0