update

.gitignore

@@ -15,6 +15,7 @@ pnpm-debug.log*
 # Editor directories and files
 .idea
 .vscode
+.obsidian
 *.suo
 *.ntvs*
 *.njsproj

.nvmrc

@@ -0,0 +1 @@
+14

README.md

@@ -1,2 +1,175 @@
-# homepage
-This is the homepage of unterrainer.info
+# Homepage Of unterrainer.info
+
+## Project setup
+
+```
+npm install
+```
+
+##### Compiles and hot-reloads for development
+
+```
+npm run serve
+```
+
+##### Compiles and minifies for production
+
+```
+npm run build
+```
+
+##### Lints and fixes files
+
+```
+npm run lint
+```
+
+### List of installed packages and their respective versions
+
+```bash
+npm list
+```
+
+### Customize configuration
+
+See [Configuration Reference](https://cli.vuejs.org/config/).
+
+### Runtime Environment Configuration
+
+Webpack, or any other packer for that matter, minifies and packs files while compiling.
+That is somewhat troublesome if you'd like to load configuration AFTER compiling (remember that the build-step is done BEFORE deploying and that it makes no sense to bake the configuration into the image for every deployment, since you'd have to change images...).
+
+# Installation as of 2022-07
+
+This project runs on NodeJS v14.15.0 and we cannot update it.
+So chances are that you already have some newer version of NodeJS installed on your development machine.
+To be able to switch between NodeJS versions you'll have to install a manager like [NVM (Node Version Manager)](https://github.com/coreybutler/nvm-windows).
+Install that and restart all your IDEs, since they hold consoles that were started before you've installed the new program.
+Then you can then enter your installation directory (of this project) and type:
+```bash
+# Install node v14.15.0
+nvm install 14.15.0
+# Get the list of installed NodeJS versions.
+nvm list
+# Switch the current NodeJS version to a particular one
+nvm use 14
+# When you want to run the other version, you can switch to that any time in a similar way.
+
+# Install npm v8.3.0
+npm install
+npm install -g [email protected]
+npm install [email protected]
+npm install @vue/cli
+npm install -D jest
+npm install -D jest-environment-jsdom
+
+# jest - retry often. Don't know how many of those are required :)
+npm i -D [email protected]
+npm i -D [email protected]
+npm i -D @types/[email protected]
+npm i -D [email protected]
+npm i -D [email protected]
+npm i -D @babel/[email protected]
+npm i -D @babel/[email protected]
+npm i -D google-charts
+
+# npm install [email protected]
+npm install typeface-roboto
+
+# Run it
+npm run serve
+
+# here are the versions of a running system, for reference:
+PS C:\code-js\cms-gui> npm list
+[email protected] C:\source\js\js-cms-gui
+├── @babel/[email protected]
+├── @babel/[email protected]
+├── @babel/[email protected]
+├── @babel/[email protected]
+├── @babel/[email protected]
+├── @fortawesome/[email protected]
+├── @fortawesome/[email protected]
+├── @fortawesome/[email protected]
+├── @fortawesome/[email protected]
+├── @fortawesome/[email protected]
+├── @jest/[email protected]
+├── @types/[email protected]
+├── @typescript-eslint/[email protected]
+├── @typescript-eslint/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── @vue/[email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected] extraneous
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected] extraneous
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected] extraneous
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+├── [email protected]
+└── [email protected]
+google-charts
+```
+
+# Debugging
+
+`launch.json` for adding a new launch-config.
+Uses the standard Microsoft JavaScript Debugging Plugin, that should be already installed by default.
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "vuejs: chrome",
+      "url": "http://localhost:8080",
+      // 'old' way of connecting allowing you to actually login to google, albeit in another window.
+      // "port": 12345,
+      "webRoot": "${workspaceFolder}/src",
+      "runtimeExecutable": "C:/Program Files/Google/Chrome/Application/chrome.exe",
+      "breakOnLoad": true,
+      "sourceMapPathOverrides": {
+        "webpack:///src/*": "${webRoot}/*"
+      }
+    }
+  ]
+}
+```