Add manual installation to README.md
This commit is contained in:
parent
a227f134a5
commit
8c7d0081b1
47
README.md
47
README.md
|
@ -53,6 +53,29 @@ read about the [available modules] and tweak your `.zshrc` file.
|
||||||
If you have a different shell framework installed (like oh-my-zsh or prezto),
|
If you have a different shell framework installed (like oh-my-zsh or prezto),
|
||||||
*uninstall those first to prevent conflicts*.
|
*uninstall those first to prevent conflicts*.
|
||||||
|
|
||||||
|
### Manual installation
|
||||||
|
|
||||||
|
1. Set Zsh as the default shell:
|
||||||
|
|
||||||
|
chsh -s =zsh
|
||||||
|
|
||||||
|
2. Start a Zsh shell
|
||||||
|
|
||||||
|
zsh
|
||||||
|
|
||||||
|
3. Copy https://raw.githubusercontent.com/zimfw/zimfw/develop/zimfw.zsh to
|
||||||
|
`${ZDOTDIR:-${HOME}}/.zim/zimfw.zsh`.
|
||||||
|
|
||||||
|
4. Add the lines in the following templates to the respective dot files in the
|
||||||
|
`${ZDOTDIR:-${HOME}}` directory:
|
||||||
|
* [.zimrc](https://github.com/zimfw/install/blob/develop/src/templates/zimrc)
|
||||||
|
* [.zlogin](https://github.com/zimfw/install/blob/develop/src/templates/zlogin)
|
||||||
|
* [.zshrc](https://github.com/zimfw/install/blob/develop/src/templates/zshrc)
|
||||||
|
|
||||||
|
5. Install the modules defined in `.zimrc` and build the static `init.zsh` script:
|
||||||
|
|
||||||
|
source ${ZDOTDIR:-${HOME}}/.zim/zimfw.zsh install
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
-----
|
-----
|
||||||
|
|
||||||
|
@ -64,23 +87,29 @@ The modules are loaded in the same order they are defined. Add:
|
||||||
zmodule <url> [-n|--name <module_name>] [options]
|
zmodule <url> [-n|--name <module_name>] [options]
|
||||||
|
|
||||||
where <url> is the required repository URL or path. The following formats
|
where <url> is the required repository URL or path. The following formats
|
||||||
are equivalent: *name*, zimfw/*name*, https://<em></em>github.com/zimfw/<em>name</em>.git
|
are equivalent: `name`, `zimfw/name`, `https://github.com/zimfw/name.git`.
|
||||||
|
|
||||||
By default, the module name is the last component in the <url>. Use the
|
By default, the module name is the last component in the <url>. Use the
|
||||||
`-n`|`--name` <module_name> option to set a custom module name.
|
`-n`|`--name` <module_name> option to set a custom module name.
|
||||||
|
|
||||||
#### Repository options
|
#### Repository options
|
||||||
|
|
||||||
* `-b`|`--branch` <branch_name>: Use specified branch when installing and updating the module. Overrides the tag option. Default: `master`
|
* `-b`|`--branch` <branch_name>: Use specified branch when installing and
|
||||||
* `-t`|`--tag` <tag_name>: Use specified tag when installing and updating the module. Overrides the branch option.
|
updating the module. Overrides the tag option. Default: `master`.
|
||||||
* `-z`|`--frozen`: Don't install or update the module
|
* `-t`|`--tag` <tag_name>: Use specified tag when installing and updating the
|
||||||
|
module. Overrides the branch option.
|
||||||
|
* `-z`|`--frozen`: Don't install or update the module.
|
||||||
|
|
||||||
#### Startup options
|
#### Startup options
|
||||||
|
|
||||||
* `-f`|`--fpath` <path>: Add specified path to `fpath`. The path is relative to the module root directory. Default: `functions`, if the subdirectory exists
|
* `-f`|`--fpath` <path>: Add specified path to `fpath`. The path is relative to
|
||||||
* `-a`|`--autoload` <function_name>: Autoload specified function. Default: all valid names inside all the module specified `fpath` paths
|
the module root directory. Default: `functions`, if the subdirectory exists.
|
||||||
* `-s`|`--source` <file_path>: Source specified file. The file path is relative to the module root directory. Default: the file with largest size matching `{init.zsh|module_name.{zsh|plugin.zsh|zsh-theme|sh}}`, if any exists
|
* `-a`|`--autoload` <function_name>: Autoload specified function. Default: all
|
||||||
* `-d`|`--disabled`: Don't use or clean the module
|
valid names inside all the module specified `fpath` paths.
|
||||||
|
* `-s`|`--source` <file_path>: Source specified file. The file path is relative
|
||||||
|
to the module root directory. Default: the file with largest size matching
|
||||||
|
`{init.zsh|module_name.{zsh|plugin.zsh|zsh-theme|sh}}`, if any exists.
|
||||||
|
* `-d`|`--disabled`: Don't use or clean the module.
|
||||||
|
|
||||||
### zimfw
|
### zimfw
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue