docs: instructions for manual install on Linux

This commit is contained in:
julesrx 2021-11-27 20:58:33 +01:00 committed by Jan De Dobbeleer
parent 39674b469e
commit 23cbc17f99
No known key found for this signature in database
GPG key ID: F6CC273CE5BA9AEE
3 changed files with 49 additions and 11 deletions

View file

@ -1,5 +1,3 @@
### Installation
A [Homebrew][brew] formula is available for easy installation.
```bash
@ -13,21 +11,15 @@ This installs two things:
- `themes` - The latest Oh My Posh [themes][themes]
If you want to use a standard theme, you can find them in `$(brew --prefix oh-my-posh)/themes`, referencing them as such
will always keep them compatible with the binary when updating Oh My Posh.
will always keep them compatible when updating Oh My Posh.
#### Preview the themes
```bash
for file in $(brew --prefix oh-my-posh)/themes/*.omp.json; do echo "$file\n"; oh-my-posh --config $file --shell universal; echo "\n"; done;
```
#### Update
## Update
```bash
brew upgrade oh-my-posh
```
### Replace your existing prompt
## Replace your existing prompt
The guides below assume you copied the theme called `jandedobbeleer.omp.json` to your user's `$HOME` folder.
When using brew, you can find this one at `$(brew --prefix oh-my-posh)/themes/jandedobbeleer.omp.json`.

View file

@ -16,8 +16,51 @@ import InstallHomebrew from "./install-homebrew.mdx";
Oh My Posh uses ANSI color codes under the hood, these should work in every terminal,
but you may have to set the environment variable `$TERM` to `xterm-256color` for it to work.
## Installation
<Tabs
defaultValue="homebrew"
groupId="install"
values={[
{ label: 'homebrew', value: 'homebrew', },
{ label: 'manual', value: 'manual', }
]
}>
<TabItem value="homebrew">
<InstallHomebrew />
</TabItem>
<TabItem value="manual">
Oh My Posh can also be installed manually by downloading the release.
Depending on your distro, this may or may not work (please refer to the homebrew installation
in case it doesn't work).
**Download Oh My Posh**
```bash
sudo wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/posh-linux-amd64 -O /usr/local/bin/oh-my-posh
sudo chmod +x /usr/local/bin/oh-my-posh
```
**Download the [themes][themes]**
```bash
mkdir ~/.poshthemes
wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/themes.zip -O ~/.poshthemes/themes.zip
unzip ~/.poshthemes/themes.zip -d ~/.poshthemes
chmod u+rw ~/.poshthemes/*.json
rm ~/.poshthemes/themes.zip
```
## Replace your existing prompt
The guides below assume you copied the theme called `jandedobbeleer.omp.json` to your user's `$HOME` folder.
When you've downloaded the themes, you can find this one at `~/.poshthemes/jandedobbeleer.omp.json`.
</TabItem>
</Tabs>
<Shells />
## Customize
@ -33,3 +76,4 @@ but you may have to set the environment variable `$TERM` to `xterm-256color` for
[iterm2]: https://www.iterm2.com/
[powershell]: https://www.powershellgallery.com/packages/oh-my-posh
[configuration]: /docs/config-overview
[themes]: https://ohmyposh.dev/docs/themes

View file

@ -16,6 +16,8 @@ import InstallHomebrew from "./install-homebrew.mdx";
As the standard terminal has issues displaying the ANSI characters correctly, we advise using
[iTerm2][iterm2] or any other modern day MacOS terminal that supports ANSI characters.
## Installation
<InstallHomebrew />
<Shells />