/zshorg

org-mode literate programming zsh config

Primary LanguageMakefile

My literate zsh configuration.

This is my zsh configuration as org-mode document, based off of my previous oh-my-zsh setup. So the setup presented here is at the moment almost completly owed to the crazy and wonderful croud assambled there. And to Sven Guckes and Julius Plenz – their book “zsh - Die magische Shell” is a helpful resource in setting up zsh.

Not everything is explained in prose yet, but I’ll get there, for my own good.

This is, and will be, a work in progress. And somtime I hope a work of beauty.

The whole configuration setup is in zshrc.org, the file is split during tangling.

Prerequisites

  • emacs 24
  • org-mode >= 7.8.03 (exported after 23d january 2012)
  • make

Installation

  • Clone the github repository
    cd $HOME
    git clone git://github.com/tomterl/zshorg.git .zshorg
        
  • Read the file zshrc.org and tinker with the settings.
  • Backup your existing config
    mkdir -p ~/Backups
    tar cfvz ~/Backups/zsh-config-$(date +"%F-%T") ~/.zshrc ~/.zsh.d
        
  • Generate the new config Either C-c C-v C-t while visiting the file zshrc.org in emacs, or
    cd ~/.zshorg
    make tangle
        

    this will overwrite ~/.zshrc and a couple of files in ~/.zsh.d; make sure you have backups. If you use the makefile, you have to tweak the ORGINSTALL variable or provide it at the commandline

    cd ~/.zshorg
    make tangle ORGINSTALL=your/actual/path/to/the/org/elc/files
        
  • Install external addons
    make externals
        

External addons

Syntax highlighting and substring search a la fish can be installed via make externals; the repositories will be cloned to ~/.zsh.d/addons/.

org-mode config