dotfiles/README.adoc

108 lines
4.6 KiB
Plaintext
Raw Normal View History

2019-08-09 14:55:10 +00:00
= dotfiles
My dotfiles for my Linux-based system setup.
2019-08-10 03:39:47 +00:00
== Screenshots
image:docs/i3-multiple-windows.png[My i3 setup with multiple windows]
image:docs/i3-single-window.png[My i3 setup with single window]
image:docs/i3-no-window.png[My i3 setup with no window]
2019-08-09 14:55:10 +00:00
== Specifications
Here are the main specifications of my machine currently running this
(as of 2019-08-09):
* **Operating system**: https://www.archlinux.org/[Arch Linux]
* **Display server**: X Window System using https://www.x.org/wiki/[Xorg]
* **Window manager**: https://i3wm.org/[i3] (specifically https://github.com/Airblader/i3[i3-gaps])
* **Terminal emulator**: https://sw.kovidgoyal.net/kitty[Kitty]
* **Shell**: https://www.gnu.org/software/bash/[Bash]
* **Terminal emulator font**: https://github.com/tonsky/FiraCode[Fira Code]
== Configuration details
Here's a list of the programs with details on the config found in this repo:
2019-08-10 03:39:47 +00:00
=== https://www.x.org/wiki/[Xorg]
A display server implementing X window system.
* Config found at link:xorg/[`xorg/`] directory.
* Minimum version (from `Xorg -version`):
** `X.Org X Server 1.20.5`
** `X Protocol Version 11, Revision 0`
* The configuration is found at `.Xresources` containing the colors (0 to 15,
2019-08-09 14:55:10 +00:00
foreground, and the background)
2019-08-10 03:39:47 +00:00
=== https://www.vim.org/[Vim]
A modal text editor.
* Config located at link:vim/[`vim/`] directory.
* Minimum version (from `vim --version`):
** `8.1 (2018 May 18, compiled Jul 29 2019 20:38:53)`
* Contains my plugin list and editor configurations at `.vimrc`
* Eventually my https://github.com/sirver/UltiSnips[UltiSnips] snippets
2019-08-09 14:55:10 +00:00
will also be added
2019-08-10 03:39:47 +00:00
=== https://ranger.github.io/[Ranger]
A Vim-based file browser.
2019-08-09 14:55:10 +00:00
https://github.com/ranger/ranger/wiki[Here's their config documentation for it.]
2019-08-10 03:39:47 +00:00
* Config located at link:ranger/[`ranger/`] directory.
* Minimum version (from `ranger --version`):
** `ranger version: ranger 1.9.2`
** `Python version: 3.7.4 (default, Jul 16 2019, 07:12:58) [GCC 9.1.0]`
* All of the config files are basically default config files except with a
2019-08-09 14:55:10 +00:00
few changes.
2019-08-10 03:39:47 +00:00
* Contains keybinding in `rc.conf`. Additional keybindings include the `O`
2019-08-09 14:55:10 +00:00
keybinding and their variants for opening my go-to programs such as
https://code.visualstudio.com/[Visual Studio Code].
2019-08-10 03:39:47 +00:00
* `rifle.conf` contains configuration for opening a list of programs.
2019-08-09 14:55:10 +00:00
2019-08-10 03:39:47 +00:00
=== https://sw.kovidgoyal.net/kitty[Kitty]
A GPU-based terminal emulator.
2019-08-09 14:55:10 +00:00
https://sw.kovidgoyal.net/kitty/conf.html[Here's the configuration doc for it.]
2019-08-10 03:39:47 +00:00
* Config located at link:kitty/[`kitty/`] directory.
* Minimum version (from `kitty --version`):
** `kitty 0.14.3 created by Kovid Goyal`
* Main config file is `kitty.conf` and it simply sets the font
2019-08-09 14:55:10 +00:00
(https://github.com/tonsky/FiraCode[Fira Code]) and the color pallete in
`colors.conf`.
2019-08-10 03:39:47 +00:00
* `colors.conf` contains the same color scheme in `.Xresources`.
* As a simple reminder: unless you use other than Kitty, the colors
defined in this `colors.conf` is the one to be used as default color
pallete in terminal-based programs such as Vim or Ranger,
not the `.Xresources` file.
2019-08-09 14:55:10 +00:00
2019-08-10 03:39:47 +00:00
=== https://github.com/Airblader/i3[i3-gaps]
A fork of i3 window manager.
2019-08-09 14:55:10 +00:00
https://i3wm.org/docs[Here's the documentation page of the program.]
2019-08-10 03:39:47 +00:00
* If it's any of importance, the configuration is prone to be moved for the
2019-08-09 14:55:10 +00:00
https://github.com/i3/i3/[original version of i3] since
https://github.com/i3/i3/issues/3724[there's consideration for merging of gaps into i3].
2019-08-10 03:39:47 +00:00
* Config located at link:i3/[`i3/`] directory.
* Minimum version (from `i3 --version`):
** `i3 version 4.17 (04.08.2019) © 2009 Michael Stapelberg and contributors`
* Uses https://github.com/davatorium/rofi[`rofi`] as the application launcher and
2019-08-09 14:55:10 +00:00
serves as a replacement for https://tools.suckless.org/dmenu/[`dmenu`].
2019-08-10 03:39:47 +00:00
* The containing config (`config`) is simply the default config with my personal
2019-08-09 14:55:10 +00:00
config added into it. Not much to say here except I use `i3bar` (the default bar) and
https://github.com/i3/i3status[`i3status`] (the default status bar config) to fill in.
2019-08-10 03:39:47 +00:00
* The config for `i3status` is located in a different directory at link:i3status[`i3status/`]
2019-08-09 14:55:10 +00:00
containing a single `config` file (for now).
2019-08-10 03:39:47 +00:00
=== https://github.com/davatorium/rofi[Rofi]
The application switcher and launcher. Also serves as a replacement
for https://tools.suckless.org/dmenu/[dmenu].
* Config located at link:rofi/[`rofi/`].
* Minimum version (from `rofi -version`):
** `Version: 1.5.4`
* Main config is `config.rasi`.
* Beside the main config, I've also created my own theme (named `fds-sidebar`) which
simply makes a sidebar. Every variation of my sidebar theme should import the common
file (`fds-sidebar-common.rasi`) and only declare the colors. See `fds-sidebar-dark.rasi` for
an example.