aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Runge <dave@sleepmap.de>2016-05-08 20:45:10 +0200
committerDavid Runge <dave@sleepmap.de>2016-05-08 20:45:10 +0200
commitf143560385292600886a4826f254a76d53b41a68 (patch)
tree8bee6646df90ac4cefba7bc199bcc8c73bf82b29
parent08845cec6393482a60493e465f0ba13727386f5b (diff)
parentcf4025b9acc61f6c61a48692e1da71f98ee73645 (diff)
downloaddotfiles-f143560385292600886a4826f254a76d53b41a68.tar.gz
dotfiles-f143560385292600886a4826f254a76d53b41a68.tar.bz2
dotfiles-f143560385292600886a4826f254a76d53b41a68.tar.xz
dotfiles-f143560385292600886a4826f254a76d53b41a68.zip
Merge branch 'master' of sleepmap.de:config/dotfiles
* 'master' of sleepmap.de:config/dotfiles: README.rst: Fixing typo. README.rst: Adding README.rst for installation and requirements.
-rw-r--r--README.rst65
1 files changed, 65 insertions, 0 deletions
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..cd73371
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,65 @@
+dotfiles
+========
+
+| dotfiles is a repository, that should go into the user's $HOME.
+| It features configurations for zsh and many others.
+
+Requirements
+------------
+Some requirements have to be met to make things work smoothly.
+As I'm using |arch_linux|, all links are Arch specific.
+
+zsh
+***
+I make extensive use of |zsh| whenever I can. The following plugins/extensions are needed for this repository to work.
+
+* |zsh-syntax-highlighting| (|aur|)
+* |zsh-completions|
+* |zsh-history-substring-search-git| (|aur|)
+
+autorandr
+*********
+For the screen setup scripts to work |autorandr| is needed.
+
+Installation
+------------
+If the $HOME is that of a new user, one can simple init an empty repository and set its remote to the correct path:
+
+ .. code:: bash
+
+ git init
+ # readonly link
+ git remote add origin git://sleepmap.de/config/dotfiles
+ # read/write link
+ git remote add origin git@sleepmap.de:config/dotfiles
+ git fetch
+ git checkout -t origin/master
+
+
+.. |autorandr| raw:: html
+
+ <a href="https://aur.archlinux.org/packages/autorandr-git" target="_blank">autorandr</a>
+
+.. |zsh| raw:: html
+
+ <a href="https://www.archlinux.org/packages/extra/x86_64/zsh/" target="_blank">zsh</a>
+
+.. |zsh-completions| raw:: html
+
+ <a href="https://www.archlinux.org/packages/community/any/zsh-completions/" target="_blank">zsh-completions</a>
+
+.. |zsh-syntax-highlighting| raw:: html
+
+ <a href="https://aur.archlinux.org/packages/zsh-syntax-highlighting-git/" target="_blank">zsh-syntax-highlighting</a>
+
+.. |zsh-history-substring-search-git| raw:: html
+
+ <a href="https://aur.archlinux.org/packages/zsh-history-substring-search-git/" target="_blank">zsh-history-substring-search</a>
+
+.. |aur| raw:: html
+
+ <a href="https://aur.archlinux.org/" target="_blank">AUR</a>
+
+.. |arch_linux| raw:: html
+
+ <a href="https://archlinux.org/" target="_blank">Arch Linux</a>