Author: dudley <firstname.lastname@example.org>
Date: Fri, 9 Sep 2016 18:05:31 +0100
changed all the content
|M||README.md|| | ||195||++++++++++++++++++++++++++-----------------------------------------------------|
1 file changed, 64 insertions(+), 131 deletions(-)
diff --git a/README.md b/README.md
@@ -1,96 +1,55 @@
- __ __ ___ ___
- /\ \ /\ \__ /'___\ __ /\_ \
- \_\ \ ___\ \ ,_\/\ \__//\_\\//\ \ __ ____
- /'_` \ / __`\ \ \/\ \ ,__\/\ \ \ \ \ /'__`\ /',__\
-/\ \L\ \/\ \L\ \ \ \_\ \ \_/\ \ \ \_\ \_/\ __//\__, `\
-\ \___,_\ \____/\ \__\\ \_\ \ \_\/\____\ \____\/\____/
- \/__,_ /\/___/ \/__/ \/_/ \/_/\/____/\/____/\/___/
- about custom linux config files
- author pyratebeard <email@example.com>
- code http://code.pyratebeard.net/dotfiles
- awesome > awesome wm config and collection of themes
- bash > bash settings, aliases, and functions
- dwb > dynamic web browser settings
- gtk > mod of mist theme for gtk
- irssi > custom irc settings
- moc > music on console custom theme and settings
- mpd > music player daemon setup
- mutt > minimal mutt setup
- ncmpcpp > ncurses mpc++ ui/color settings
- ranger > file manager with image previews and z3bra theme
- sublime > sublime text 2 and 3 with custom themes
- tmux > terminal multiplexer with custom status bar
- urxvt > various terminal colors and keyboard settings
- vim > wizard status bar and sourcerer color scheme
- zsh > zshell settings, aliases, and custom prompts
+ __ __ ___ ___
+ /\ \ /\ \__ /'___\ __ /\_ \
+ \_\ \ ___\ \ ,_\/\ \__//\_\\//\ \ __ ____
+ /'_` \ / __`\ \ \/\ \ ,__\/\ \ \ \ \ /'__`\ /',__\
+ /\ \L\ \/\ \L\ \ \ \_\ \ \_/\ \ \ \_\ \_/\ __//\__, `\
+ \ \___,_\ \____/\ \__\\ \_\ \ \_\/\____\ \____\/\____/
+ \/__,_ /\/___/ \/__/ \/_/ \/_/\/____/\/____/\/___/
+ about custom linux config files
+ author pyratebeard <firstname.lastname@example.org>
+ code http://code.pyratebeard.net/dotfiles
+ awesome > awesome wm config and collection of themes
+ bash > bash settings, aliases, and functions
+ dwb > dynamic web browser settings
+ gtk > mod of mist theme for gtk
+ irssi > custom irc settings
+ moc > music on console custom theme and settings
+ mpd > music player daemon setup
+ mutt > minimal mutt setup
+ ncmpcpp > ncurses mpc++ ui/color settings
+ ranger > file manager with image previews and z3bra theme
+ sublime > sublime text 2 and 3 with custom themes
+ tmux > terminal multiplexer with custom status bar
+ urxvt > various terminal colors and keyboard settings
+ vim > wizard status bar and sourcerer color scheme
+ zsh > zshell settings, aliases, and custom prompts
-##table of contents
- - [installing](#installing)
- - [how it works](#how-it-works)
- - [tl;dr](#tldr)
- - [my shell](#my-shell)
- - [vim](#vim)
+ - [how to use](#using)
+ - [terminal](#terminal)
+ - [citations](#citations)
+ - [disclaimer](#disclaimer)
-a lot of the settings and themes within these dotfiles are heavily borrowed from xero harrison <http://code.xero.nu/dotfiles>. i have stripped out anything i don't use, and modified a lot to my personal preference.
+in the world of linux everything is a file and you can create a incredibly personalised environment by modifying your dotfiles.
-in the unix world programs are commonly configured in two different ways, via shell arguments or text based configuration files. programs with many options like window managers or text editors are configured on a per-user basis with files in your home directory `~`. in unix like operating systems any file or directory name that starts with a period or full stop character is considered hidden, and in a default view will not be displayed. thus the name dotfiles.
-it's been said of every console user:
-> _"you are your dotfiles"_.
-since they dictate how your system will look and function. to many users (see [ricers](http://unixporn.net) and [beaners](http://nixers.net)) these files are very important, and need to be backed up and shared. people who create custom themes have the added challenge of managing multiple versions of them. i have tried many organization techniques. and just take my word for it when i say, keeping a git repo in the root of your home directory is a bad idea. i've written custom shell scripts for moving or symlinking files into place. there are even a few dotfile managers, but they all seem to have lots of dependencies. i knew there had to be a simple tool to help me.
+this is known as 'ricing' and can become very, very obsessive...
-i manage mine with [gnu stow](http://www.gnu.org/software/stow/), a free, portable, lightweight symlink farm manager. this allows me to keep a versioned directory of all my config files that are virtually linked into place via a single command. this makes sharing these files among many users (root) and computers super simple. and does not clutter your home directory with version control files.
-stow is available for all linux and most other unix like distributions via your package manager.
-- `sudo pacman -S stow`
-- `sudo apt-get install stow`
-- `brew install stow`
-or clone it [from source](https://savannah.gnu.org/git/?group=stow) and [build it](http://git.savannah.gnu.org/cgit/stow.git/tree/INSTALL) yourself.
-#how it works
-by default the stow command will create symlinks for files in the parent directory of where you execute the command. so my dotfiles setup assumes this repo is located in the root of your home directory `~/dotfiles`. and all stow commands should be executed in that directory. otherwise you'll need to use the `-d` flag with the repo directory location.
-to install most of my configs you execute the stow command with the folder name as the only argument.
-to install my **herbstluft** theme _greybeard_ use the command:
-this will symlink files to `~/.config/herbstluftwm` and various other places.
-but you can override the default behavior and symlink files to another location with the `-t` (target) argument flag.
-to install the **ryu-login** you need to execute the command:
+i manage my dotfiles using [stow](http://www.gnu.org/software/stow/). stow should be available in your preferred package manager.
-`stow -t / ryu-login`
+clone the repo into your home directory:
-this will symlink the file to `/etc/issue`.
-**note:** stow can only create a symlink if a config file does not already exist. if a default file was created upon program installation you must delete it first before you can install a new one with stow. this does not apply to directories, only files.
-navigate to your home directory
-clone the repo:
-`git clone http://git.xero.nu/dotfiles.git`
+`git clone http://github.com/pyratebeard/dotfiles.git ~`
enter the dotfiles directory
@@ -100,10 +59,6 @@ install the zsh settings
-install zsh settings for the root user
-`sudo stow zsh -t /root`
install awesomewm theme
@@ -112,63 +67,40 @@ uninstall awesome theme
`stow -D awesome`
+ever since i started using linux i have loved working in the terminal. i find it faster and easier than most graphical interfaces.
-etc, etc, etc...
+i have tried a number of terminal emulators over the years but i'm currently using [urxvt](). i have recently started using [zsh]() over [bash]() for my shell.
-i prefer a minimal setup, and choose to interact with my operating system via the so-called "terminal" or "command line", (read that quoting sarcastically) over a gui interface 2 times out of 3. with the web browser and video player among the noted outliers. in my opinion, using your computer should be a very personal experience. your colors, aliases, key-bindings, etc meticulously crafted to your exacting specifications. so for me, the unix shell is the most important part of my environment.
+i've also come to love [tmux]() for running multiple sessions in one window.
+because i work in the terminal i try to use as many terminal based apps as i can. here is a list of my current chosen apps:
-my terminal emulator of choice is the lightweight, unicode, 256 color [urxvt](http://linux.die.net/man/1/urxvt). i use [zsh](http://linux.die.net/man/1/zsh) as my interactive shell. it's an extensible, bash like shell with awesome completion and correction engines. i manage multiple shell sessions with [tmux](http://linux.die.net/man/1/tmux). it's a feature packed terminal multiplexer with support for buffers, split windows, detached local and remote sessions, etc. i'm a member of the cult of [vim](http://linux.die.net/man/1/vim). sing phrases to the third reincarnation of the glorious ed! lel. [mpd](http://linux.die.net/man/1/mpd) is my music server and i use [ncmpcpp](http://ncmpcpp.rybczak.net/) as it's frontend. my configs for [urxvt](http://git.io/.urxvt), [zsh](http://git.io/.zsh), [tmux](http://git.io/.tmux), [vim](http://git.io/.vim), [mpd](http://git.io/.mpd) and [ncmpcpp](http://git.io/.ncmpcpp) shown above feature my [sourcerer](http://sourcerer.xero.nu) color scheme.
+ - audio = [ncmpcpp]() ([mpd]() backend)
+ - irc = [irssi]()
+ - twitter = [turses]()
+ - email = [mutt]()
+ - rss = [snownews]()
+ - editor = [vim]()
+ - file manager = [ranger]()
-with it's tight integration to the unix shell, [vim](http://www.vim.org) has quickly become my editor of choice. once you start to master the movements and operators you quickly begin manipulating, not just editing source code files.
+i also run other apps from the terminal
-when you learn vim it's best to use a more vanilla config. if helps you focus on learning the editor and not the plugins. these are also great for [remote machines](http://git.io/.vimrc-min). but for your local dev environment, vim's vast and powerful plugin system can add many great features. i try to keep my editor slim and fast, but i find myself loving these plugins:
-- [vundle](https://github.com/gmarik/vundle.vim) - to manage other plugins
-- [you complete me](https://github.com/Valloric/YouCompleteMe) - the best completion system
-- [php complete](https://github.com/shawncplus/phpcomplete.vim) - extended php completions
-- [syntastic](https://github.com/scrooloose/syntastic) - syntax linting
-- [git gutter](https://github.com/airblade/vim-gitgutter) - git diff in the gutter
-- [match it](https://github.com/isa/vim-matchit) - extended word and regex matching
-- [lightline](https://github.com/itchyny/lightline.vim) - custom status line (for much rice)
-- [fugitive](https://github.com/tpope/vim-fugitive) - fast git integration
+ - video player = [mpv]()
+ - image viewer = [sxiv]()
+ - screenshot = [scrot]()
-- [blizzard orb xcolors](https://github.com/xero/dotfiles/blob/master/urxvt/blizzard-orb.Xcolors)
+thanks to all at [unixporn](http://reddit.com/r/unixporn) and [nixers](https://www.nixers.net/) for posting their setups and giving me ideas.
-- [sublime greybeard theme](http://git.io/sublimegreybeard)
+also thanks to [xero](https://github.com/xero/dotfiles) for having such well documented dotfiles they enabled me to make an awesome set up, and it convinced me to release my files!
-- [chroimum with cathexis gtk](http://git.io/cathexis) & [greybeard devtools](http://git.io/greybeard-devtools)
-- figlet [-f 3d](http://git.io/3d) webdev | lolcat
+feel free to clone or fork my repo but you use these files at your own risk!
-- [color scripts](http://git.io/.fun)
+i will be happy to receive details of any bugs.
+\ No newline at end of file