summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorAnish Athalye <me@anishathalye.com>2016-02-14 22:39:48 -0500
committerAnish Athalye <me@anishathalye.com>2016-02-14 23:06:52 -0500
commitdaf8d82e02c2bcc476932790fa25076631c4c312 (patch)
tree1413dbbb3e810618e127a17ac3843ee9a8be653c /README.md
parentc402396c58114640745dbba132856cfd8cd7f422 (diff)
Add functionality to create relative links
This commit adds an option to the extended configuration syntax for linking files and directories. Enabling the relative option makes it so that symbolic links are created with relative paths instead of absolute paths.
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 8 insertions, 7 deletions
diff --git a/README.md b/README.md
index 00c654d..3ed74f5 100644
--- a/README.md
+++ b/README.md
@@ -83,7 +83,7 @@ The conventional name for the configuration file is `install.conf.yaml`.
- link:
~/.dotfiles: ''
~/.tmux.conf: tmux.conf
- ~/.vim: vim/
+ ~/.vim: vim
~/.vimrc: vimrc
- shell:
@@ -104,7 +104,7 @@ The conventional name for this file is `install.conf.json`.
"link": {
"~/.dotfiles": "",
"~/.tmux.conf": "tmux.conf",
- "~/.vim": "vim/",
+ "~/.vim": "vim",
"~/.vimrc": "vimrc"
}
},
@@ -147,7 +147,7 @@ files if necessary. Environment variables in paths are automatically expanded.
Link commands are specified as a dictionary mapping targets to source
locations. Source locations are specified relative to the base directory (that
-is specified when running the installer). Source directory names should contain
+is specified when running the installer). Directory names should *not* contain
a trailing "/" character.
Link commands support an (optional) extended configuration. In this type of
@@ -155,8 +155,9 @@ configuration, instead of specifying source locations directly, targets are
mapped to extended configuration dictionaries. These dictionaries map `path` to
the source path, specify `create` as `true` if the parent directory should be
created if necessary, specify `relink` as `true` if incorrect symbolic links
-should be automatically overwritten, and specify `force` as `true` if the file
-or directory should be forcibly linked.
+should be automatically overwritten, specify `force` as `true` if the file or
+directory should be forcibly linked, and specify `relative` as `true` if the
+symbolic link should have a relative path.
#### Example
@@ -164,8 +165,8 @@ or directory should be forcibly linked.
- link:
~/.config/terminator:
create: true
- path: config/terminator/
- ~/.vim: vim/
+ path: config/terminator
+ ~/.vim: vim
~/.vimrc:
relink: true
path: vimrc