stephanrauh#415 updated the "how to build" walkthrough

Author: stephanrauh

README.md

@@ -20,21 +20,5 @@ Bringing Mozilla's pdf.js to the Angular world. That's not only the core PDF vie
 
 There's a showcase at <a href="https://pdfviewer.net">https://pdfviewer.net</a>. Check this page for live demos, source code examples, and a handbook.
 
-
-
-Now the (tiny) demo app will automatically reload if you change any of the source files.
-
 ## Build or update the library from scratch
-If you want to use the library, install it via npm:
-
-```
-npm i ngx-extended-pdf-viewer --save
-```
-
-
-If you want to send a pull request or if you're simply curious, there are two options:
-- Simple changes to the HTML or JavaScript code:
-   -  `npm run unix-package` (or `npm run win-package` if you're running Windows)
-   -  `ng serve -o` (to start the demo project)
-- Changes including the core library (pdf.js) itself:
-  - see the [how-to-build walkthrough](projects/ngx-extended-pdf-viewer/how-to-build.md).
+See the [how-to-build walkthrough](projects/ngx-extended-pdf-viewer/how-to-build.md).

projects/ngx-extended-pdf-viewer/how-to-build.md

@@ -1,20 +1,45 @@
+# Preparations
+You need a current node.js and roughly 20-30 minutes of time. Most of the build process is automated. This recipe shows the Unix and MacOS scripts, but there are also Windows batch files you can use. Sometime the two sets of files diverge. If you run into trouble, have a look at the Unix files. I use them much more often, so they are the "source of truth".
+
+## Build ngx-extended-pdf-viewer without modifying pdf.js
 1. Create a new folder "embedded-pdf". It must be in the same folder as ngx-extended-pdf-viewer.
 2. cd embedded-pdf
-3. git clone https://github.com/mozilla/pdf.js.git
-4. mv pdf.js mozillas-pdf.js (or rename pdf.js mozillas-pdf.js if you're using Windows)
-5. cd mozillas-pdf.js
+3. git clone https://github.com/stephanrauh/ngx-extended-pdf-viewer
+4. cd ngx-extended-pdf-viewer
+5. npm install
+6.  npm run win-package (or npm run unix-package, depending on your OS) (this command copies the viewer files to the dist folder so you can run the demo)
+7. npm run start
+
+## Use the showcase to test your changes of ngx-extended-pdf-viewer
+Follow the recipe above first to install your local copy of ngx-extended-pdf-viewer.
+
+1. cd embedded-pdf
+2. git clone https://github.com/stephanrauh/extended-pdf-viewer-showcase
+3. cd extended-pdf-viewer-showcase
+4. npm install
+5. cd ..
+6. cd ngx-extended-pdf-viewer
+7. npm run showcase
+8. cd ..
+9. cd extended-pdf-viewer-showcase
+10. ng serve -o
+
+Instead of changing the directory all the time, you can also open multiple terminal windows. The showcase updates automatically each time you execute `npm run showcase`.
+
+## Build ngx-extended-pdf-viewer with a custom version of pdf.js
+I assume you've already followed the first recipe above.
+
+1. cd embedded-pdf
+3. git clone https://github.com/stephanrauh/pdf.js.git
+4. mv pdf.js mypdf.js (or rename pdf.js mypdf.js if you're using Windows)
+5. cd mypdf.js
 6. npm install -g gulp-cli
 7. npm install
-8. gulp server (steps 9 - 11 only check if the installation went well)
-9. open http://localhost:8888/web/viewer.html
+8.  gulp server (steps 9 - 11 are not necessary; they only check if the installation is healthy)
+9.  open http://localhost:8888/web/viewer.html. Note that the source-code version of pdf.js is a lot slower than the production version. It takes a while until the PDF file shows.
 10. stop the server (CTRL+C)
-11. gulp generic
-12. cd ..
-13. cd ngx-extended-pdf-viewer
-14. sh ./updateMozillasPdfViewer.sh
-15. examine the history of https://github.com/mozilla/pdf.js/blob/master/web/viewer.html and copy the changes to ngx-extended-pdf-viewer.component.html. Warning: ngx-extended-pdf-viewer.component.html has a lot of additions to the original file. Proceed with care.
-
-16. npm run win-package (or npm run unix-package, depending on your OS) (this command copies the viewer files to the dist folder so you can run the demo)
-17. ng serve
-
-Note to myself: to deploy the library on npm, change to the folder `dist/ngx-extended-pdf-viewer` and run `npm publish` from there. Or: run `npm run unix-package` followed by `npm run release`.
+11. cd ..
+12. cd ngx-extended-pdf-viewer
+13. sh ./updateMozillasPdfViewer.sh
+14. npm run win-package (or npm run unix-package, depending on your OS) (this command copies the viewer files to the dist folder so you can run the demo)
+15. npm run start