Update the README to handle the common Windows SSL certificate expired.

master
Zed A. Shaw 1 year ago
parent f0421a2976
commit 1f472d7256
  1. 35
      README.md
  2. 488
      package-lock.json

@ -12,12 +12,47 @@ You simply use `npm` to install directly from the git repository:
npm install git+https://git.learnjsthehardway.com/learn-javascript-the-hard-way/ljsthw-bandolier.git
```
### Windows Expired Certificate Error
_WARNING_: If you get an error on Windows of "SSL certificate has expired" it's because the root
certificate for Let's Encrypt expired and your `git` is too old. This happens on other platforms
but other OS keep their certificates and `git` commands updated. To fix it type this:
```
git update-git-for-windows -g
```
The `-g` option says to use the graphical installer, so you'll see this:
```
Git for Windows 2.19.0.windows.1 (64bit)
Update 2.38.1.windows.1 is available
Download and install Git for Windows 2.38.1 [N/y]? y
```
Then git will open a GUI installer window to do the installation.
_IMPORTANT_: When you get to the section that asks to use git's OpenSSL or Windows Secure Channel, pick Secure Channel. This uses the Windows encryption system which maintains accurate certificates without updating your git every time.
Once you've installed it you need to close your PowerShell/Cmdr window to register the new `git` in
the `PATH`. After that you should be able to to type `git --version` and see the new version.
## Find the Installed Package
Once it's installed you can list your packages to confirm you installed the correct one:
```
npm list
```
The list should contain something like this:
```
ljsthw-bandolier@0.1.2 (git+https://git.learnjsthehardway.com/learn-javascript-the-hard-way/ljsthw-bandolier.git#HEXNUMBER
```
Your `HEXNUMBER` will be different from mine, but the url `git+https://git.learnjsthehardway.com/learn-javascript-the-hard-way/ljsthw-bandolier.git` should be the same. If not then you installed the wrong thing, remove it immediately.
## Usage
You now have an `npx` command named `bando-up` which lets you create start your projects:

488
package-lock.json generated

File diff suppressed because it is too large Load Diff
Loading…
Cancel
Save