Updated README

This commit is contained in:
2025-05-09 00:40:46 +01:00
parent 847a2f1578
commit f279241bb2

View File

@@ -2,37 +2,40 @@
#+author: Aryadev Chavali #+author: Aryadev Chavali
#+description: README for Dotfiles #+description: README for Dotfiles
This repository contains all of my custom configurations for programs Configurations for a variety of programs. My system is really just
I use daily. composed of two things:
- Emacs
- The bootstrap for Emacs
[[file:emacs-screenshot.png]] [[file:emacs-screenshot.png]]
* Setup instructions * Setup
1) Clone repository to =~/Dotfiles= Assumptions:
2) Construct the following directories: - You're on Linux
+ =~/.local= - This repository is located at =~/Dotfiles=
+ =src= - You have [[https://www.gnu.org/software/stow/][GNU/stow]]
+ =bin=
+ =lib=
+ =share=
+ =~/.config=
+ =~/Downloads=
+ =~/Code=
+ =~/Media=
+ =~/Projects=
+ =~/Text=
3) Install [[https://www.gnu.org/software/stow/][GNU/stow]]
4) Go into the repository then pick which modules you want to install
+ To install a module use ~stow <module>~
+ To remove a module use ~stow -D <module>~
*NOTE*: GNU/Stow just symbolically links the internals of a module to #+begin_src sh
the home directory i.e. ~stow <module>~ just symlinks mkdir -p ~/.local/src \
=~/Dotfiles/<module>/*= to =~/*=. This is why the organisation of ~/.local/bin \
each module is slightly weird. ~/.local/lib \
~/.local/share \
~/.config \
~/Downloads \
~/Code \
~/Media \
~/Projects \
~/Text;
This also means you don't need to follow step (3): you can just cd Dotfiles;
perform the symlinks yourself if you wish. stow Emacs tmux vim Shell XServer Scripts SystemD SXHkD mpv aspell ClangFormat Dunst Zathura
#+end_src
* Why use this
Please don't. If you're looking for inspiration, this is where it
dies. I don't maintain this for anyone but me; verily, I have no
shame about it. Don't expect this to work for you if you're not
willing to roll your sleeves up.
* Emacs archives * Emacs archives
On a fresh machine it takes a horrendous amount of time to completely On a fresh machine it takes a horrendous amount of time to completely
setup my Emacs configuration. This is largely due to /straight/ (the setup my Emacs configuration. This is largely due to /straight/ (the