|
|
<img src="../logo.png" align="left" width="192px" height="192px"/>
|
|
|
<img align="left" width="0" height="192px" hspace="10"/>
|
|
|
|
|
|
> The <a href="http://fishshell.com">Fishshell</a> Framework
|
|
|
|
|
|
[](/LICENSE.md) [](http://fishshell.com) [](https://travis-ci.org/oh-my-fish/oh-my-fish) [](https://oh-my-fish-slack.herokuapp.com)
|
|
|
|
|
|
Oh My Fish 提供核心基础设施的配置，允许每个人可以轻松安装插件或随心所欲更换 Shell 外观样式，它的速度敏捷和可扩展性让你**如鱼得水**。
|
|
|
|
|
|
<br><br>
|
|
|
|
|
|
<p align="center">
|
|
|
<a href="../../README.md">English</a> •
|
|
|
<b>简体中文</b>
|
|
|
</p>
|
|
|
|
|
|
# 安装
|
|
|
|
|
|
```fish
|
|
|
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | fish
|
|
|
omf help
|
|
|
```
|
|
|
|
|
|
或者 _下载脚本_ 后自己执行：
|
|
|
|
|
|
```fish
|
|
|
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install > install
|
|
|
fish install
|
|
|
```
|
|
|
|
|
|
## 更新方法
|
|
|
|
|
|
我们最近把Oh My Fish代码仓库移到了我们自己组织的帐号下。所以，你们也需要更新一下你们Oh My Fish代码仓的remote设置。对于Oh My Fish的早期用户，非常推荐你按照以下步骤干净地重新安装一次：
|
|
|
|
|
|
1. __首先备份所有你自定义的东西__
|
|
|
2. `mv ~/.config/fish/config{,_old}.fish`
|
|
|
3. `rm -rf ~/.oh-my-fish`
|
|
|
4. [重新安装Oh My Fish](#install)
|
|
|
5. 复制文件`~/.config/fish/config_old.fish`中所有以`Plugin`和`Theme`开始的行
|
|
|
6. 把它们粘贴到文件`$OMF_CONFIG/bundle`中。如果这个文件不存在，就自己创建一下
|
|
|
7. 把所有`Plugin "name"`这样的行转换成`package name`这种形式，其中"name"是包名字
|
|
|
8. 把所有`Theme "name"`这样的行转换成`theme name`这种形式，其中"name"是主题名字
|
|
|
9. `omf install`
|
|
|
|
|
|
如果你在更新过程中遇到困难，可以到[Slack](https://oh-my-fish-slack.herokuapp.com)上来寻求我们的帮助。
|
|
|
|
|
|
# 快速入门
|
|
|
|
|
|
Oh My Fish 自带的辅助命令工具 `omf` 可以帮助你快速获取安装新插件和主题。
|
|
|
|
|
|
#### `omf update`
|
|
|
|
|
|
更新自身和已安装的所有插件和默认主题。
|
|
|
|
|
|
#### `omf install` _`[<name>|<url>]`_
|
|
|
|
|
|
安装 _一个或多个_ 插件。
|
|
|
|
|
|
- 你可以通过输入指定的 URL 直接安装插件 `omf install URL`
|
|
|
- 当没有执行没有传入任何参数，将会从 [bundle](#dotfiles) 文件检索并安装本地尚未安装的插件和主题。
|
|
|
|
|
|
#### `omf list`
|
|
|
|
|
|
显示本地已安装的插件列表。
|
|
|
|
|
|
#### `omf theme` _`<theme>`_
|
|
|
|
|
|
应用一个主题。查看全部可用主题执行 `omf theme`。安装之前你也可以[预览现有主题](../Themes.md)。
|
|
|
|
|
|
#### `omf remove` _`<name>`_
|
|
|
|
|
|
移除主题或插件。
|
|
|
|
|
|
> 插件如果注册(subscribed)过 `uninstall_<pkg>` 事件将会在插件移除前触发，因此你可以自定义自身清理和扫尾的工作以保证插件干净移除。
|
|
|
详见[卸载部分](Packages.md#uninstall)获取更多信息。
|
|
|
|
|
|
#### `omf new pkg | theme` _`<name>`_
|
|
|
|
|
|
创建新插件和主题的生成工具。
|
|
|
|
|
|
> 创建的模板会新创建并保存于 `$OMF_CONFIG/{pkg | themes}/` 文件夹下面。
|
|
|
|
|
|
#### `omf submit` _`pkg/<name>`_ _`[<url>]`_
|
|
|
|
|
|
添加一个新的插件。提交新主题请使用 `omf submit` _`themes/<name>`_ _`<url>`_。
|
|
|
|
|
|
新插件或新主题需要托管于 Git 仓库，上面命令 url 需要输入 git 仓库的 url 地址。
|
|
|
此命令仅仅是把 git 仓库地址保存与 Oh My Fish 的 db 数据库，同时还需要[提交 PR][omf-pulls-link]让组织把你的插件或主题归于框架。
|
|
|
|
|
|
#### `omf doctor`
|
|
|
|
|
|
使用前[开馆问题][omf-issues-new] 解决。
|
|
|
|
|
|
#### `omf destroy`
|
|
|
|
|
|
卸载 Oh My Fish.
|
|
|
|
|
|
# 高级用法
|
|
|
|
|
|
Oh My Fish 安装脚本会把自身启动代码加载到 fish 的配置文件 (`~/.config/fish/config.fish`).
|
|
|
|
|
|
## 启动脚本
|
|
|
|
|
|
每次你新打开 Shell 都会从 _配置文件_ (默认：`~/.config/omf`) 加载 Oh My Fish 的启动脚本([`init.fish`](../../init.fish)) 进行初始化：
|
|
|
自动加载插件，主题和你自定义的配置文件。更多信息请查看[FAQ](FAQ.md#oh-my-fish-包大概包含哪些类型).
|
|
|
|
|
|
## Dotfiles
|
|
|
|
|
|
`$OMF_CONFIG` 目录存储用户使用 Oh My Fish 的重要配置参数，这是最完美的方式把该目录的所有文件加入你的 dotfiles 或加入到版本控制。
|
|
|
有四个重要文件：
|
|
|
|
|
|
- __`theme`__ - 当前主题
|
|
|
- __`bundle`__ - 显示当前已安装的插件/主题列表
|
|
|
- __`init.fish`__ - 壳开始后执行的自定义脚本
|
|
|
- __`before.init.fish`__ - 壳开始前执行的自定义脚本
|
|
|
|
|
|
它强烈建议您自定义的启动命令进入 `init.fish` 文件而不是 `~/.config/omf/config.fish`，因为这可以让你保持在版本控制整个 `$OMF_CONFIG` 目录。
|
|
|
|
|
|
如果你需要的Starup命令来运行*之前*噢，我的鱼开始加载插件，将它们放置在 `before.init.fish` 代替。如果你不确定，通常最好把东西 `init.fish` 。
|
|
|
|
|
|
### 关于 bundle
|
|
|
|
|
|
每次当有插件和主题被安装或移除都会更新 `bundle` 文件。你也可以手动编辑该文件并执行 `omf install` 保证变更状态。
|
|
|
需要注意的是当有插件、主题被添加到 bundle 文件会自动被安装。但从 bundle 中移除掉它们却不会从用户安装路径移除物理文件。
|
|
|
|
|
|
## 创建插件
|
|
|
|
|
|
Oh My Fish 使用了友好的插件架构能够简化插件的开发，其中包括初始化、卸载事件和函数的自动加载。[查看相关文档](Packages.md) 获取更多信息。
|
|
|
|
|
|
[fishshell]: http://fishshell.com
|
|
|
|
|
|
[contributors]: https://github.com/oh-my-fish/oh-my-fish/graphs/contributors
|
|
|
|
|
|
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
|
|
|
|
|
|
[omf-issues-new]: https://github.com/oh-my-fish/oh-my-fish/issues/new
|