mirror of
https://github.com/oh-my-fish/oh-my-fish.git
synced 2024-11-29 03:59:48 +08:00
90 lines
2.6 KiB
Markdown
90 lines
2.6 KiB
Markdown
|
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
|
||
|
|
<img align="left" width="0" height="128px"/>
|
||
|
|
|
||
|
|
# FAQ
|
||
|
|
|
||
|
|
> Oh My Fish Documentation • Also in
|
||
|
|
> <a href="../ru-RU/FAQ.md">🇷🇺</a>
|
||
|
|
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
|
||
|
|
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
|
||
|
|
> <a href="../pt-BR/FAQ.md">🇧🇷</a>
|
||
|
|
<br>
|
||
|
|
|
||
|
|
Thanks for taking the time to read this FAQ. Feel free to create a new issue if your question is not answered here.
|
||
|
|
|
||
|
|
|
||
|
|
## What is Oh My Fish and why do I want it?
|
||
|
|
|
||
|
|
Oh My Fish is a _framework_ for the [Fishshell](http://fishshell.com/). It helps you manage your configuration, themes and packages.
|
||
|
|
|
||
|
|
|
||
|
|
## What do I need to know to use Oh My Fish?
|
||
|
|
|
||
|
|
_Nothing_. You can install Oh My Fish and keep using Fish as usual. When you are ready to learn more just type `omf help`.
|
||
|
|
|
||
|
|
|
||
|
|
## What are Oh My Fish packages?
|
||
|
|
|
||
|
|
Oh My Fish packages are themes or plugins written in fish that extend the shell core functionality, run code during initialization, add auto completion for known utilities, etc.
|
||
|
|
|
||
|
|
|
||
|
|
## What kind of Oh My Fish packages are there?
|
||
|
|
|
||
|
|
There are roughly 3 kinds of packages:
|
||
|
|
|
||
|
|
1. Configuration utilities. For example [`pkg-pyenv`](https://github.com/oh-my-fish/pkg-pyenv) checks whether `pyenv` exists in your system and runs `(pyenv init - | psub)` for you during startup.
|
||
|
|
|
||
|
|
2. Themes. Check our [theme gallery](https://github.com/oh-my-fish).
|
||
|
|
|
||
|
|
3. Traditional shell utilities. For example [`pkg-copy`](https://github.com/oh-my-fish/pkg-copy), a clipboard utility compatible across Linux and OSX.
|
||
|
|
|
||
|
|
|
||
|
|
## What does Oh My Fish do exactly?
|
||
|
|
|
||
|
|
+ Run `$OMF_CONFIG/before.init.fish` if available.
|
||
|
|
|
||
|
|
+ Autoload installed packages and themes under `$OMF_PATH/`.
|
||
|
|
|
||
|
|
+ Autoload your config path. `~/.config/omf` by default, but configurable via `$OMF_CONFIG`.
|
||
|
|
|
||
|
|
+ Autoload any `functions` directory under `$OMF_PATH` and `$OMF_CONFIG`
|
||
|
|
|
||
|
|
+ Run `$OMF_CONFIG/init.fish` if available.
|
||
|
|
|
||
|
|
|
||
|
|
## How can I upgrade from an existing Oh My Fish installation?
|
||
|
|
|
||
|
|
> :warning: Remember to backup your dotfiles and other sensitive data first.
|
||
|
|
|
||
|
|
```
|
||
|
|
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | sh
|
||
|
|
```
|
||
|
|
|
||
|
|
You can now safely remove `$fish_path`.
|
||
|
|
|
||
|
|
```fish
|
||
|
|
rm -rf "$fish_path"
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## How do I use fish as my default shell?
|
||
|
|
|
||
|
|
Add Fish to `/etc/shells`:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
||
|
|
```
|
||
|
|
|
||
|
|
Make Fish your default shell:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
chsh -s /usr/local/bin/fish
|
||
|
|
```
|
||
|
|
|
||
|
|
To switch your default shell back:
|
||
|
|
> Substitute `/bin/bash` with `/bin/tcsh` or `/bin/zsh` as appropriate.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
chsh -s /bin/bash
|
||
|
|
```
|