Victory does dotfiles

这个 dotfiles 是 fork 自 Amo Wu's dotfiles（Amo Wu 是 fork 自 Holman's dotfiles），并根据个人的需求修改。

阅读完这个文件之后，如果有什么问题，欢迎向我提出； 如果你也有兴趣，欢迎 fork 回去配置自己的 dotfile。

更多的 dotfiles 请参考 GitHub does dotfiles。

Quick Start

• Erase and reinstall OS X 如果你打算从干净的 Mac环境开始，请参考 OS X：如何清除并安装」。

• Install Xcode

  • 更新 App Store。

  • 安裝 Xcode。

  • 开启 Terminal，安裝 Xcode Command Line Tools:

    $ xcode-select --install

• Install dotfiles

  • 下载 或 使用 git clone 一份到 $HOME 目录下的 .dotfiles 文件夹里面:

    $ git clone https://github.com/myMacDotfile/dotfiles.git

  • 进入 .dotfiles 文件夹:

    $ cd ~/.dotfiles

  • 安装 dotfiles:

    $ ./script/bootstrap

    bootstrap.sh 这个脚本会自动完成以下工作:

    1. 检查并安装 Homebrew。
    2. 检查并安装 Oh My Zsh。
    3. 检查并安装 dotfiles (.zshrc, .vimrc, .gitconfig, .gitignore, ...)。
    4. 设置好 Mac OS X 的 defaults settings。
    5. 更新并安装 Homebrew packages (binaries, fonts, apps)。

    最后，完成之后，手动安装一下 App Store 上才有的软件 (Dash, Moom, ...)。

Restore backup

使用 Mackup 进行备份恢复:

```bash
$ mackup restore
```

什么是Mackup？ TODO

How To Use

• bootstrap.sh

  执行 ~/.dotfiles/script/bootstrap 的时候，脚本会将目录下面所有的 *.symlink 文件通过 ln 命令建立链接至 $HOME 目录下:

  topic	*.symlink	.dotfiles
  git	gitconfig.symlink	~/.gitconfig
  	gitignore.symlink	~/.gitignore
  mackup	mackup.cfg.symlink	~/.mackup.cfg
  vim	vimrc.symlink	~/.vimrc
  zsh	zshrc.symlink	~/.zshrc

• Topical

  • 每一个环境的配置都是以文件夹的像是被独立分区。加入你想增加一个"Java"的配置到dotfiles，你可以简单的新增一个命名为java的文件夹，然后将配置文件保存在目录下。
  • 任何文件后缀名是 .zsh 的档案将在 shell执行时自动载入至环境中。
  • 任何文件后缀名是 .symlink 的档案将在你执行 script/bootstrap 安装时链接到 HOME目录下。

• Components

  一些在目录中比较特别的档案:

  • bin/: 任何在 bin/ 目录下的档案可以在 shell 执行的时候直接使用。
  • topic/*.zsh: 任何 .zsh 结尾的档案都会在 shell 执行的时候被载入到环境。
  • topic/path.zsh: 任何命名为 path.zsh 的档案会在 shell 执行时优先被载入至 $PATH。
  • topic/*.symlink: 任何 *.symlink 结尾的档案都会在 $HOME 目录下面建立链接。这可以让你在配置环境的时候也可以保持版本配置的有点。新增 symlink 的时候需要执行 script/bootstrap 安裝。

• macos

  bin/dot 是一个简单的脚本，会在 script/bootstrap 配置完 dotfiles 之后执行，安装自定义的 macos/OS X 程式并设定系统參數配置。

  執行 $ dot 之後，会执行以下脚本文件:

  1. $HOME/.dotfiles/osx/set-defaults.sh - macos/OS X defaults setting
  2. $HOME/.dotfiles/Brewfile - Homebrew packages
  3. 任何目录下文件名是 install.sh 的文件将被执行。

• Homebrew packages

  • 执行 $ dot 的时候，脚本会根据 Brewfile 使用 Homebrew 和 Homebrew Cask 来安装 binary、font 還有 app，可以依照个人需求更改这个档案，增加或者减少自己需要的 packages:

     # Brewfile
     ...
     brew 'git'
     brew 'tree'
     brew 'python'
     ...
    

  • 应用程式可以用 $ brew cask search some_soft_name 或者 Cask Search 网站搜索软件是否存在。

     # Brewfile
     ...
     cask 'dropbox'
     cask 'google-chrome'
     ...

  • 字体都是以 font-XXX 的形式命名，可以用 $ brew cask search /font-XXX/ 查找字体是否存在。

     # Brewfile
     ...
     cask 'font-roboto'
     ...