dotfiles

使用 GNU Stow 管理的 linux 配置文件.

Gnu Stow 使用两个文件夹来管理两个文件树之间的映射，分别是：

• stow dir ：默认为当前文件夹
• target dir ：默认为当前文件夹的父文件夹
• stow dir 下每一个顶层的子文件夹都是一个单独的文件树,
• target dir 下是多个这样的文件树在同一起始路径的层叠展开，后者的文件 树使用**符号链接**指向前者的文件树。

第一次收集配置文件

第一次收集配置文件时，推荐使用 --adopt 选项转移配置文件。具体操作如下：

1. 在家目录下创建 stow dir ， 比如命名为 dotfiles 。
2. 在 stow dir 下分门别类的创建好各类配置文件的文件夹，比如专门放置 bash 相关配置文件的文件夹。
3. 在 bash 文件夹下创建对应的配置文件，文件内容为空即可，比如 .bashrc ， .bash_profile 。
4. 在 stow dir 下执行 stow --adopt bash ，这一命令分别对比 target dir （也即是家目录）和 bash 目录的结构，并将家目录下同树结构的文件采纳 到 stow dir 下：将 .bashrc 移到bash目录覆盖掉对应的空配置文件，并在 家目录创建符号链接指向转移过来的配置文件。
5. 重复上述 2-4 步，陆续添加其他文件夹和配置文件。

收集到配置文件后，我们一般使用 git 来管理，这样可以方便的跟踪修改，也 可以方便的拉取到另一台电脑上。实际上，我们上面使用的 --adopt 命令可以 结合 git 来方便的对比两台电脑间配置文件的不同。=–adopt= 选项会处理 stow 遇到的冲突文件，并统一采用 target dir 下的文件 **替换** stow dir 下 的文件，当 stow dir 被 git 管理时，被替换的文件就可以方便的和仓库中的 文件对比，方面你修改，采纳，或者删除。

**注意**: --adopt 选项会修改 stow dir 下的内容，非第一次收集配置文件，或 者 stow dir 没有被版本控制软件管理前，请谨慎使用。

将收集的配置文件应用到新的系统中

将项目拉取到新的机器的家目录，切换到 stow dir ，执行 stow -S bash 可以 将bash的配置文件展开到家目录下。你也可以使用多个组合命令： stow -S pkg1 pkg2 -D pkg3 pkg4 -S pkg5 -R pkg6

• -d 指定 stow 文件夹
• -t 指定 target 文件夹
• -D 移除已创建的文件树
• -S 创建指定的文件树
• -R 移除并重新创建指定的文件树
• --ignore=regexp 忽略 stow dir 下指定匹配模式的文件
• --defer=regexp 跳过 target dir 下指定匹配模式的文件
• --override=regexp 强制替换=target dir=下指定匹配模式的文件
• --no-folding stow 默认创建最少的符号链接。这一选项会使 stow 逐一创建 每一个文件的符号链接，而不是创建一整个文件夹的链接。
• --dotfiles 在 stow dir 下的文件名如果有 dot- 前缀，在创建链接时，链 接名字会替换为以 . 为前缀，比如： ～/.zshrc -> dotfiles/zsh/dot-zshrc

GNU Stow 不会对冲突的文件做任何处理，并中断所有操作，我没有找到一个快 捷的覆盖已存在文件的选项，=-D= 和 --override=regexp 并不能对已存在的文件 进行覆盖替换，除非它是符号链接或者文件夹并已经处于 stow dir 的管理之下。

如果因为文件已经存在而发生了冲突，一个直接的办法是先删掉已存在的文件。 而另一个方法则是结合使用 --adopt 选项和 git。首先将已存在的配置文件全 部采纳到 git 管理之下的 stow dir，然后选择性的采纳，修改，或舍弃，使用 git 的 commit 和 checkout，你可以方便的取舍冲突的配置文件。如果你知道 stow更好的方法，请在 issue 中告诉我，谢谢～

更多信息请参见 GNU Stow 手册页

bash

stow -t $HOME bash -D --adopt

zsh

stow -t $HOME zsh -D --adopt

vim

stow -t $HOME vim  -D --ignore=^[^\.]+\..*vim.* --adopt

ideavimrc

stow -t $HOME ideavimrc -D --ignore=_ideavimrc\|idea_actionlist --adopt

git

stow -t $HOME git -D --adopt

tmux

stow -t $HOME tmux -D --adopt

need xclip

tmux show-options -g -s set-clipboard

nodejs

stow -t $HOME nodejs -D --adopt

ctags

stow -t $HOME ctags -D --adopt

tar

stow -t $HOME tar -D --adopt

Xresources

stow -t $HOME Xresources -D

mpv

stow -t $HOME/ mpv -D

ghostty

stow -t $HOME/ ghostty -D

base16-shell

stow -t $HOME base16-shell -D

i3

stow -t $HOME/ i3 -D

awesome

stow -t $HOME/ awesome -D

alacritty

stow -t $HOME/ alacritty -D

aria2

stow -t $HOME/ aria2 -D

xterm

xrdb ~/.Xresources

xrandr

查看当前屏幕

xrandr --current

设置屏幕位置

xrandr --output VGA1 --left-of HDMI1 --auto

rofi

stow -t $HOME/ rofi -D

X11

stow -t $HOME X11 -D

environment

stow -t $HOME/ environment -D