dotfiles

This repository contains my personal dotfiles that I use for my system.

System Description

• arch
• i3-gaps
• rofi
• terminator
• zsh && oh-my-zsh
• polybar
• vim

Setup

For setup of this repository, first create an alias in .bashrc or zshrc:

alias dotfiles='/usr/bin/git --git-dir=$HOME/dv/an/dotfiles --work-tree=$HOME'

Then we clone this repository, but make sure to use the --bare flag:

git clone --bare [email protected]:quocanha/dotfiles.git $HOME/dv/an/dotfiles

Then source the file containing the alias above or enter manually in the current shell. We also set the showUntrackedFiles flag to no on this repository.

dotfiles config --local status.showUntrackedFiles no

Afterwards, to have git download all dotfiles into our system, run:

dotfiles checkout

Repository Dependencies

These are not package dependencies, for those, just look at the error messages and install the corresponding packages. This section is devoted to other git repositories that the dotfiles use. This section could possibly be extended in the future to as git submodules.

Tmux Plugin Manager

Repository found at https://github.com/tmux-plugins/tpm, needs to be cloned at: ~/.tmux/plugins/tmp. Run the following one-liner.

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

polybar-scripts

Repository found at https://github.com/polybar/polybar-scripts, needs to be __cloned__at: ~/dv/an/dotfiles/repositories/. Then chmod the scripts that need execute permissions, these are:

• updates-arch-combined

Setup Troubeshooting

Existing files

Git throws an error if files from the repository already exist locally. To solve this, we simply have to backup/remove them.

Fonts not rendering properly

Fonts as usual is a headache. I currently use material design icons and font awesome icons, which I have manually downloaded and put into /usr/share/fonts/TTF. I have a backup on my google drive, and I might create a custom AUR package for this.

Usage

This repository is managed as described in this blogpage, based on the comment by StreakyCobra on Hacker News.

The setup here is that a git repository is created in a sub-directory of $HOME: $HOME/dv/an/dotfiles. An alias is then created where we manually specify the git directory and the working directory. alias dotfiles="/usr/bin/git --git-dir=$HOME/dv/an/dotfiles --work-tree=$HOME".

This setup allows us to add all files in $HOME to the repostiory without the need of using symbolic links. We can simply use: dotfiles add .zshrc.