2.3 KiB
fisher-config(7) -- Fisherman Configuration
SYNOPSIS
This document describes how to use the available configuration options to customize Fisherman.
DESCRIPTION
Your fish user configuration, usually located in $XDG_CONFIG_HOME/fish/config.fish
is updated after installing Fisherman to add the global variables $fisher_home
and $fisher_config
.
$fisher_home
is the directory where you downloaded Fisherman. This location can be anywhere you like. If you changed this location after installing Fisherman, you need to update $fisher_home
as well.
$fisher_config
is the user configuration directory and the location of your user fishfile, cache directory and where plugins get installed to. This location must be different from $fisher_home
. The default location is $XDG_CONFIG_HOME/fisherman
.
You can also customize the debug log path, cache location, index source URL, command aliases, and other options via $fisher_*
variables.
VARIABLES
-
$fisher_home
: The home directory. This is the path where you downloaded Fisherman. -
$fisher_config
: The user configuration directory.$XDG_CONFIG_HOME/fisherman
by default. This directory is where the cache, functions and completions directories are located. -
$fisher_cache
: The cache directory. Plugins are first downloaded here and installed to$fisher_config/functions
afterwards. The cache is$fisher_config/cache
by default. -
$fisher_index
: Index source URL or file. To use a different index set this to a file or URL. Redirect urls are not supported due to security and performance concerns. The underlying request and fetch mechanism is based incurl(1)
. See alsoIndex
infisher help tour
. -
$fisher_file
: This file keeps a list of what plugins you have installed and are currently enabled.$fisher_cofig/fishfile
by default. -
$fisher_alias command=alias[,...] [command2=alias[,...]]
: Use this variable to define custom aliases for fisher commands. SeeExamples
below.
EXAMPLES
- Create aliases for fisher
install
to i, in and inst; and for fisherupdate
to up.
set fisher_alias install=i,in,inst update=up
- Set
$fisher_index
to a custom database.
set fisher_index https://raw.../owner/repo/master/index2.txt
SEE ALSO
fisher help tour