mirror of
https://github.com/cheat/cheat.git
synced 2024-11-23 14:31:36 +01:00
Add Windows Install Guide
Added comprehensive guide for installation on Windows systems
This commit is contained in:
parent
7908a678df
commit
6d3ccbcb34
@ -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` isn’t running after installation:
|
||||||
|
|
||||||
|
- **Verify the PATH was applied correctly**:
|
||||||
|
Verify your `cheat` path is present in the system environment variables. If it’s missing, try step 3 again to add it to your PATH.
|
||||||
|
|
||||||
|
- **Loosen ExecutionPolicy**:
|
||||||
|
If at any point you run into issues with PowerShell’s 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
|
||||||
|
Loading…
Reference in New Issue
Block a user