RCM
解决配置文件同步问题，轻松实现多设备配置一键同步
安装 RCM
常用命令
lsrc
列出当前所有通过 rcm 管理的 dotfile ，以及其对应的符号链接位置
lsrc [-FhqVv] [-B HOSTNAME] [-d DIR] [-I EXCL_PAT] [-S EXCL_PAT] [-s EXCL_PAT] [-t TAG] [-U EXCL_PAT] [-u EXCL_PAT] [-x EXCL_PAT] [files ...]
mkrc
将指定的 dotfile 移动至集中存储目录(默认 ~/.dotfiles)，并在原下创建相应的软链接
mkrc [-ChoqSsVvUu] [-t TAG] [-d DIR] [-B HOSTNAME] files ...
rcup
更新或创建由 rcm 管理的 dotfile 的软链接
rcup [-CfhiKkqVv] [-B HOSTNAME] [-d DIR] [-g] [-I EXCL_PAT] [-S EXCL_PAT] [-s EXCL_PAT] [-t TAG] [-U EXCL_PAT] [-u EXCL_PAT] [-x EXCL_PAT] [files ...]
rcdn
删除通过 rcm 创建的 dotfile 的软链接
rcdn [-hKkqVv] [-B HOSTNAME] [-d DIR] [-I EXCL_PAT] [-S EXCL_PAT] [-s EXCL_PAT] [-t TAG] [-U EXCL_PAT] [-u EXCL_PAT] [-x EXCL_PAT] [files ...]
命令参数含义
-B HOSTNAME: 指定特定主机的目录,而不是使用计算机的主机名对其进行操作。-C: 复制文件而不是创建软链接。-d DIR: 指定 dotfiles 目录，可以指定多个。-F: 在文件旁显示指示符号，@(文件软链接) ，$(目录软链接)，x(副本文件)。更多详细信息参考 rcrc 中的COPY_ALWAYS和SYMLINK_DIRS。-f: 如果rc文件已经存在于配置目录中，但与 dotfiles 目录中的文件不匹配，删除rc文件，然后创建软链接。-g: 仅显示rcup命令脚本的执行过程，不会修改文件系统上的任何内容。-h: 显示用法说明-I EXCL_PAT: 指定不被-x排除的文件。 该项在-x选项之后应用,使用与-x相同的语法格式。可能需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。-i: 如果rc文件已经存在于配置目录中，但是与dotfiles目录中的文件不匹配，提示如何处理它。这是默认选项。-K: 跳过 pre-hooks 和 post-hooks-k: 运行 pre-hooks 和 post-hooks , 这是默认选项。-o: 将 dotfiles 安装到主机特定的目录中。-q: 减少详细信息。更多详细信息参考DIRECTORY LAYOUT。-S EXCL_PAT: 指定以软链接形式创建的目录。此选项可重复使用，需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。-s EXCL_PAT: 指定递归创建的目录而不是软链接式的目录。与-S选项相反，可用于撤消它或rcrc中的SYMLINK_DIRS设置。 此选项可重复使用，需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。-t TAG: 指定标签-U EXCLUDE: 指定不创建软链接和以点 (.) 开头命名的rc文件或目录。此选项可重复使用，需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。-u EXCL_PAT: 指定必须使用点 (.) 开头命名的 rc 文件或目录。 与-U选项相反，可用于撤消它或 rcrc 中UNDOTTED设置。 此选项可重复使用，需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。-V: 显示版本号。-v: 添加详细信息。 可以重复此操作以获取更多的详细信息。-x EXCL_PAT: 指定排除的文件。此选项可重复使用，需要用引号使其不被 Shell 忽略。更多详细信息参考EXCLUDE PATTERN。files ...: 指定的文件列表。
配置
~/.rcrc
可以使用主目录中的 .rcrc 文件配置rcm dotfile 管理器。 可通过设置 RCRC 环境变量来更改此位置。
支持以下变量:
COPY_ALWAYS: 复制列表中的glob相匹配的文件，而非使用软链接。DOTFILES_DIRS: dotfile 的源目录。列表中的第一个将被mkrc用于创建dotfile目录，默认值为:~/.dotfiles。EXCLUDES: 排除列表。HOSTNAME: 计算机的主机名。 通常通过hostname命令获得，但此命令并非标准的，获取的主机名或许会有差异，因此使用HOSTNAME变量强制使用已知的主机名。TAGS: 默认标签表。SYMLINK_DIRS: 列表中目录是软链接，而不是源文件。UNDOTTED: 列表中的文件是软链接且不用点 (.) 开头命名。如果是SYMLINK_DIRS中含有的目录，则该目录将为软链接且不用点 (.) 开头命名。
.rcrc 样例:
1 | COPY_ALWAYS="ssh/id_* weechat/* netrc" |
EXCLUDE PATTERN (排除列表)
使用冒号 (:) 分隔 dotfile 目录和 glob (由普通字符、通配字符组成的字符串，用于匹配文件路径) 。可选择带 dotfile 目录，如果省略则默认为 * ，代表从所有 dotfile 目录匹配。 glob 是相对于 dotfile 目录的相对路径。
例如，要忽略 Thoughtbot-dotfiles 目录中所有与 emacs 相关的项目，使用：
thoughtbot-dotfiles:*emacs*
要忽略所有 bash_profile 文件使用：
*:bash_profile
或者简写为:
bash_profile
注意,通常通过 hostname 命令获得主机名，但此命令并非标准的，获取的主机名或许会有差异，在macOS上，主机名是不可预测的，甚至可能在 DHCP 握手被更改,强烈建议在 rcrc 中,因此使用 HOSTNAME 变量强制使用已知的主机名。
DIRECTORY LAYOUT (目录布局)
dotfiles 目录下的任何非点 (.) 开头的、非元文件或目录都将作为点 (.) 开头的文件安装。 例如，.dotfiles/zshrc 将安装到 ~/.zshrc 。 文件安装为软链接。 目录通过建立目录来安装。-C 选项指定文件通过复制安装而不是软链接。 rcrc 中的 COPY_ALWAYS 可用于列出只能复制的文件。
支持三个元文件: host-specific (特定主机文件), tagged (标记文件), hooks 。
host-specific: 以host-前缀加主机名命名的目录，存放特定主机的文件，如，.dotfiles/host-scarlett包含主机名为 scarlett 的计算机 dotfile 文件，且这些文件将仅安装在主机名为scarlett的计算机上。tagged: 以tag-前缀加标签名命名的目录，存放标记该标签的文件，如，仅在指定使用git标签时安装.dotfiles/tag-git下的文件。hooks: 名为hooks的目录，存放 hooks 。 rcup 支持两个hooks：pre-up和post-up。它们存放到预设文件名的文件或目录中：.dotfiles/hooks/pre-up和.dotfiles/hooks/post-up，或.dotfiles/hooks/pre-up/*和.dotfiles/hooks/post-up/*。 这些文件必须是可执行文件。 它们在每次rcup运行时都运行，因此必须是幂等(执行后结果还为本身)的。hooks 按字母顺序排序,一次只执行一次。 如，hooks/pre-up/animals将在hooks / pre-up/aquariums之前运行，hooks/pre-up/4-eyes将在hooks/post-up/2-u-nothing-compares之前运行。
日常使用
1 | # 创建管理(管理.vimrc配置) |
