The following document gives a high level overview of my linux config.
This particular config has been tested on ArchLinux only (last update on 22-02-20).
Thus, only pacman
and yay
have been used and tested as arch and AUR package managers respectively.
The reader is highly adviced to search the internet and in particular the ArchWiki, EVEN in NON arch-based systems!!
First, an overview of the repo is given in section 1.
The software I use and a link to the official doc are presented and linked in section 2.
In section 3, the automatic install script is presented.
Finally, ways to contribute to this project are put forward in section 4 for who is interested and a gallery of photos is presented in section 5,
to give an idea of the final rendering of the config.
If you want a quick brief of what dotfiles really are, I recommend this video of FireShip.
- 1 Overview and architecture.
- 2 The software I use. (coming soon)
- 3 The install process (coming soon)
- 4 Contribute.
- 5 Gallery. (coming soon)
1. Overview and architecture. [toc]
This repo has been created using a bare
repository, i.e. initialization has been done with git init --bare $HOME/.dotfiles
instead of the
usual git init
. This command creates a bare repository, meaning that there is no working directory inside it, only .git
files.
This is normal as bare repositories are not meant to host working files, but only track files inside the working directory.
This makes the process of tracking dotfiles much easier! There is no need anymore to copy files into the dotfiles repository, track them
and put them back where they should be using symlinks! A simple alias
of the form cfg='/usr/bin/git --git-dir=$HOME/.dotfiles/ --work-tree=$HOME'
is enough to use git
on any file inside $HOME
.
Hence, the architecture of the files above is a perfect mirror, regarding tracked files only, of my system!
Notes:
- simply replace $HOME with whatever your personal space is called. One can issue
echo $HOME
in a terminal to check this.
If you want more information about bare git
repositories, you can check one of the following resources:
- a blog post about bare repositories.
- a video from distrotube if you want to see the creation of such a repository step by step.
2. The software I use. [toc]
COMING SOON
3. The install process. [toc]
COMING SOON
4. Contribute. [toc]
YOU can contribute to this project in the wonderfull world of linux, arch and configuration!
- if you like this overview, try to install the config and see what it looks like!
- if you like this config, please share it to whoever could be interested.
- if you stumble upon bugs, ideas, new amazing color palettes or alternatives,
- if you want to be part of the testers for my install script. do not hesitate to contact me, either via email, github issues or pull requests!
5. Gallery. [toc]
COMING SOON