ZSH completion

README.rdoc

@@ -287,11 +287,18 @@ Setup your presentation to serve on Heroku
 Serves the showoff presentation in the current directory
 
 
-
 ==== Options
 These options are specified *after* the command.
 
 [<tt>-p, --port=arg</tt>] Port on which to run <i>( default: <tt>9090</tt>)</i>
+
+=== ZSH completion
+You can complete commands and options in ZSH, by installing a script:
+
+    mkdir -p $HOME/.zsh/Completion
+    cp script/_showoff $HOME/.zsh/Completion
+    echo 'fpath=(~/.zsh/Completion $fpath)' >> $HOME/.zshrc
+
 = Real World Usage
 
 So far, ShowOff has been used in the following presentations (and many others):

script/_showoff

@@ -0,0 +1,62 @@
+#compdef showoff
+
+local curcontext="$curcontext" state line cmds ret=1
+
+_arguments -C \
+	'1: :->cmds' \
+	'*: :->args' && ret=0
+
+case $state in
+	cmds)
+		cmds=(
+		'add:Add a new slide at the end in a given dir'
+		'new:Add a new slide at the end in a given dir'
+		'create:Create new showoff presentation'
+		'init:Create new showoff presentation'
+		'help:Shows list of commands or help for one command'
+		'heroku:Setup your presentation to serve on Heroku'
+		'serve:Serves the showoff presentation in the current directory'
+		'static:Generate static version of presentation'
+		)
+		_describe -t commands 'showoff command' cmds && ret=0
+		;;
+	args)
+		case $line[1] in
+			(add|new)
+				_arguments \
+					'(-d --dir)'{-d,--dir}'=[Slide dir (where to put a new slide file)]:directory:_files' \
+					'(-n --name)'{-n,--name}'=[Slide name (name of the new slide file)]:basename' \
+					{-s,--source}'=[Include code from the given file as the slide body]:file:_files' \
+					'(-t --style --type)'{-t,--style,--type}'=[Slide Type/Style (default: title)]:style' \
+					'(-u --no-number)'{-u,--no-number}'[Dont number the slide, use the given name verbatim]' \
+					'1:title' && ret=0
+				;;
+			(create|init)
+				_arguments \
+					'(-d --slidedir)'{-d,--slidedir}'=[Sample slide directory name (default: one)]:arg' \
+					'(-n --nosamples)'{-n,--nosamples}'=[Dont create sample slides]' \
+					'1:dir_name' && ret=0
+				;;
+			help)
+				_values 'commands' add new create init help heroku serve static && ret=0
+				;;
+			heroku)
+				_message 'please entrer an heroku_name' && ret=0
+				;;
+			serve)
+				_arguments \
+					'(-h --host)'{-h,--host}'=[Host or ip to run on (default: localhost)]:host' \
+					'(-p --port)'{-p,--port}'=[Port on which to run (default: 9090)]:port' \
+					'1:title' && ret=0
+				;;
+			static)
+				_message 'please entrer a name' && ret=0
+				;;
+			*)
+				(( ret )) && _message 'no more arguments'
+				;;
+		esac
+		;;
+esac
+
+return ret