#Introduction

This repository contains my configuration files, some of which are tangled from documents that better highlight the design and functionality of my personal computing environment. It also contains non-configuration packages, such as archlinux, which cannot and should not be stowed as they do not configure any particular package.

Visit the dotfiles sitemap to browse the comprehensive articles from which many of the dotfiles are generated.

#Getting started

To keep everything central, and abide by the rules of stow, we must place our source directory somewhere underneath $HOME.

git clone https://git.sr.ht/~grtcdr/dotfiles ~/.dotfiles

Top-level directories such as sway, zathura and others are referred to by stow as packages.

Stowing a package will apply the appropriate symlink(s) between the source i.e. ~/.dotfiles and target tree i.e. primarily ~/.config.

To install the sway package, run the following in a shell:

cd ~/.dotfiles
stow sway

~/.config/sway should now be soft-linked to ~/.dotfiles/sway/.config/sway, modifications to one file are reflected in the other.

To stow the entire tree, execute the stow script.

For more information, consider reading the GNU Stow manual.

#Support

If you come across an issue, wish to give feedback or voice your support, please send an email to my public inbox.