Add Windows Install Guide

Added comprehensive guide for installation on Windows systems
This commit is contained in:
DJ Magar 2024-09-25 22:07:49 -05:00 committed by GitHub
parent 7908a678df
commit 6d3ccbcb34
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,10 +1,10 @@
Installing # Installing
==========
`cheat` has no runtime dependencies. As such, installing it is generally `cheat` has no runtime dependencies. As such, installing it is generally
straightforward. There are a few methods available: straightforward. There are a few methods available:
### Install manually ## Install manually
#### Unix-like ### Unix-like
On Unix-like systems, you may simply paste the following snippet into your terminal: On Unix-like systems, you may simply paste the following snippet into your terminal:
```sh ```sh
@ -20,9 +20,63 @@ You may need to need to change the version number (`4.4.2`) and the archive
See the [releases page][releases] for a list of supported platforms. See the [releases page][releases] for a list of supported platforms.
#### Windows <br>
TODO: community support is requested here. Please open a PR if you'd like to
contribute installation instructions for Windows. ### Windows
Head over to the [Releases](https://github.com/cheat/cheat/releases/latest) page and download `cheat-windows-amd64.exe.zip`.
1. **Extract the archive**:
Extract the executable into your local appdata directory:
```powershell
Expand-Archive .\cheat-windows-amd64.exe.zip -DestinationPath $env:LOCALAPPDATA\cheat
```
**Note**: You can install `cheat` to any other location if preferred, simply substitute your chosen installation path in steps 2 and 3 below.
2. **(Optional) Create a symbolic link**:
To facilitate invoking `cheat` via `cheat.exe`, you can create a symbolic link:
```powershell
saps -v runas cmd -args "/c mklink %LOCALAPPDATA%\cheat\cheat.exe %LOCALAPPDATA%\cheat\cheat-windows-amd64.exe"
```
3. **Add `cheat` to your PATH**:
Check if `cheat` is already in your PATH, and if not, append it:
```powershell
if (-not (("$env:PATH" -cmatch "\\cheat") -or "$(where.exe cheat.exe 2>$null)")) {
$NEWPATH = "$env:PATH;$env:LOCALAPPDATA\cheat";
write-host $NEWPATH;
saps -v runas cmd -args "setx /M PATH `"$NEWPATH`""
} else {
write-host 'Cheat is already found on your PATH, skipping...'
}
```
4. **Restart your PC or shell**:
To apply the PATH changes, either restart your computer, or close and reopen any terminal/PowerShell sessions.
5. **Install Verification**:
In your __freshly opened__ `powershell` or `CMD` terminal, invoke `cheat`:
```powershell
cheat
```
If the install was successful, you should see the initial run dialog. This will present you with the option to generate a new config file and download community cheatsheets.
**Troubleshooting**
If `cheat` isnt running after installation:
- **Verify the PATH was applied correctly**:
Verify your `cheat` path is present in the system environment variables. If its missing, try step 3 again to add it to your PATH.
- **Loosen ExecutionPolicy**:
If at any point you run into issues with PowerShells script execution policy, you can temporarily relax it:
```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
```
This will let you run scripts for the current shell session without making permanent changes to the system policy.
- **Try another installation method**: If you're still having problems after trying the above, you can try installing `cheat` via `docker` or `go install`.
<br>
### Install via `go install` ### Install via `go install`
If you have `go` version `>=1.17` available on your `PATH`, you can install If you have `go` version `>=1.17` available on your `PATH`, you can install
@ -45,6 +99,8 @@ snap | [cheat][pkg-snap]
<!--[pacman][] |--> <!--[pacman][] |-->
<br>
## Configuring ## Configuring
Three things must be done before you can use `cheat`: Three things must be done before you can use `cheat`:
1. A config file must be generated 1. A config file must be generated
@ -56,7 +112,9 @@ automatically. After the installer is complete, it is strongly advised that you
view the configuration file that was generated, as you may want to change some view the configuration file that was generated, as you may want to change some
of its default values (to enable colorization, change the paginator, etc). of its default values (to enable colorization, change the paginator, etc).
### conf.yml ### <br>
## conf.yml
`cheat` is configured by a YAML file that will be auto-generated on first run. `cheat` is configured by a YAML file that will be auto-generated on first run.
By default, the config file is assumed to exist on an XDG-compliant By default, the config file is assumed to exist on an XDG-compliant