From 8127bf73501c335519dae40101c3b850c4a64e54 Mon Sep 17 00:00:00 2001 From: James Pannacciulli <jpnc@jpnc.info> Date: Sun, 11 Jun 2017 11:06:44 -0700 Subject: ariketa first commit ariketa: bash example code quickloader for presentations --- USAGE | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 USAGE (limited to 'USAGE') diff --git a/USAGE b/USAGE new file mode 100644 index 0000000..7403d76 --- /dev/null +++ b/USAGE @@ -0,0 +1,36 @@ +ariketa: bash example code quickloader for presentations +======================================================== + +usage +----- + To load ariketa, source it into the bash session you wish to use for the + presentation: + source ./ariketa.sh + + When an example is displayed, it may be edited like any command line and + executed normally by pressing enter. Use the following key bindings to + navigate through your examples: + + alt-H: display this USAGE text + + alt-w: load previous example + alt-e: load next example + alt-a: reload current example + alt-h: display current example with syntax highlighting + + alt-W: load previous example without clearing the screen + alt-E: load next example without clearing the screen + alt-A: reload current example without clearing the screen + + alt-s: side by side diff of previous and current example + alt-S: side by side diff of prev/cur examples with highlighting + alt-P: toggle between ariketa PS2 header and original setting + +configuration +------------- + To load examples into ariketa, edit the 'examples.sh' file in the + 'config' directory. This file should be a sourceable bash script which + creates an indexed array named '_examples', whose elements have values + beginning with a tag, delineated from the example itself by a ':' character + followed by a newline. An sample config is located in + 'config/examples.sh.sample'. -- cgit v1.2.3